用途：KWeaver 平台的命令行工具，用于认证、平台业务域配置、知识网络管理与查询、Agent 管理与对话、数据源与资源管理、Dataflow 流程、Skill 管理、工具箱与工具注册、Vega 可观测查询等。
安装：npm install -g @kweaver-ai/kweaver-sdk，需 Node.js 22+，也可用 npx kweaver 临时运行。
用法：kweaver [--base-url <url>] [--token <access-token>] [--user <userId|username>] <command> [subcommand] [options]。完整子命令以当前安装版本为准，运行 kweaver --help 查看；子命令细节用 kweaver <group> <subcommand> --help。别名：kweaver curl 等同 kweaver call，kweaver context 等同 kweaver context-loader。
主要命令组：auth（多账号登录、切换、改密）、token、config（业务域 show/list-bd/set-bd）、bkn（知识网络校验、推送、Schema、查询、Action、指标）、agent（CRUD、发布、对话、会话历史、Trace 四视图）、resource（vega-backend 资源 list/find/get/query/delete）、dataflow（list/run/runs/logs）、model（模型工厂与大/小模型调用）、skill（list/market/register/content/read-file/install）、toolbox 与 tool（创建、上传 OpenAPI、启停、发布）、vega（health、catalog、resource、query、sql）、context-loader（MCP 分层检索）、call（通用 API 调用）。
认证与业务域：凭据由 ~/.kweaver/ 管理，存在 refresh_token 时自动换发 access_token；认证优先级为全局 --token + --base-url、KWEAVER_TOKEN/KWEAVER_BASE_URL、本地凭据、KWEAVER_USER。多数请求依赖 x-business-domain，登录后应先执行 kweaver config show，列表为空时用 config list-bd 查看再 config set-bd <uuid>。
限制与注意：不要猜测 business_domain；Action 执行有副作用，执行前需向用户确认；不要运行 kweaver auth status 做预检；Token 1 小时过期，401 时 CLI 自动尝试刷新，失败才需重新登录；object-type query 必须限制 limit、用 search_after 分页并用 condition 过滤。ds 命令组已移除，数据连接迁至 vega catalog，CSV 流程合并进 bkn create-from-csv。