kweaver-ai KWeaver Admin CLI
Overview
kweaver-admin covers platform administration: authentication, org/user/role,
model config, audit, and raw API passthrough.
This skill uses progressive disclosure:
- Read this file for command-group selection.
- Read
references/*.mdfor exact command/parameter details. - Read routing/fallback reference when debugging deployment differences.
references/ is the source of truth for this skill. When answering detailed
questions (flags, payload shape, fallback behavior), read the corresponding
reference first, then execute.
安装
npm install -g @kweaver-ai/kweaver-admin
# or
npx -y @kweaver-ai/kweaver-admin --help
使用方式
kweaver-admin [--json] [--base-url <url>] [-k] <group> <subcommand> [options]
命令组总览
| 组 | 说明 | 详细参数 |
|---|---|---|
auth |
登录、状态、whoami、改密、token | references/auth.md |
user |
用户 CRUD、角色绑定、重置密码 | references/user.md |
org + role |
部门管理、角色与成员管理 | references/org-role.md |
llm + small-model |
模型配置管理与连通性测试 | references/models.md |
audit + config + call |
审计、配置、原始请求透传 | references/audit-config-call.md |
| 路由与回退 | REST/ShareMgnt 回退和已知异常 | references/routing-and-fallbacks.md |
References 使用规则（关键）
references/ 是该 skill 的细节层，按以下顺序读取：
- 先看本文件，决定命令组与执行顺序。
- 再读对应
references/*.md，获取参数和示例。 - 遇到部署差异（404/501/errID）时，额外读
routing-and-fallbacks.md。
当用户问到参数语义、命令细节、实现逻辑时，必须先读对应 reference，再执行。
执行策略
- 先跑只读命令（
list/get/tree/status/whoami）确认环境。 - 写操作前记录关键 ID，并优先使用
--json。 - 每次写操作后立刻用读命令验收。
- 遇到 404/501/errID 错误时，按 routing reference 判断是否是后端可用性差异。
触发示例
/kweaver-admin 列出所有用户并按关键词过滤
/kweaver-admin 给用户分配角色并验证结果
/kweaver-admin 创建部门并查看组织树
/kweaver-admin 重置 testcli1 密码到默认值
/kweaver-admin 用 call 检查某个 REST 接口是否可达