用途:KWeaver CLI 是 KWeaver 平台的命令行工具,用于认证、平台业务域配置、知识网络管理与查询、Agent 增删改查与对话、数据源管理、Skill 注册与安装,以及 Vega 可观测平台查询。
安装:npm install -g @kweaver-ai/kweaver-sdk,需 Node.js 22+,也可用 npx kweaver 临时运行。
用法:kweaver [--user <userId|username>] <command> [subcommand] [options]。完整子命令以当前安装版本为准,运行 kweaver --help 查看;版本用 kweaver --version。子命令细节用 kweaver <group> <subcommand> --help。别名:kweaver curl 等同 kweaver call,kweaver context 等同 kweaver context-loader。
主要命令组:auth(多账号登录、切换、登出)、token(打印当前 access token)、config(业务域 show/list-bd/set-bd)、bkn(知识网络校验、推送、拉取、Schema、查询、Action)、agent(CRUD、发布、对话、Trace、模板、分类)、ds(数据源列表、导入 CSV)、dataview(数据视图查询)、skill(注册、市场查找、渐进式读取、下载安装)、vega(健康与资源查询)、context-loader(MCP 分层检索)、call(通用 API 调用)。
认证:凭据存于 ~/.kweaver/,存在 refresh_token 时自动换发 access_token;优先级为 KWEAVER_TOKEN + KWEAVER_BASE_URL 环境变量、~/.kweaver/ 凭据、KWEAVER_USER 环境变量。业务域优先级为 KWEAVER_BUSINESS_DOMAIN 环境变量、config.json 中的 businessDomain、默认 bd_public。
限制与注意:不要猜测 business_domain,首次使用先运行 kweaver config show 或 config list-bd 确认;Action 执行有副作用,需先向用户确认;不要运行 kweaver auth status 做预检;Token 1 小时过期,仅 Playwright cookie 登录时需重新登录;object-type query 必须限制 limit、用 search_after 分页并加 condition 过滤。更多细节见各 references 文件。