用途：KWeaver CLI 是 KWeaver 平台的命令行工具，覆盖认证、知识网络管理与查询、Agent CRUD 与对话、数据源管理，并新增 Vega 可观测平台、BKN push/pull 等功能，替代旧版 kweaver-core（旧版仍可用但不再更新）。
安装：npm install -g @kweaver-ai/kweaver-sdk，需 Node.js 22+，也可用 npx kweaver 临时运行。用法为 kweaver <command> [subcommand] [options]。
主要命令组：auth（认证管理）、token（打印当前 access token）、bkn（知识网络管理、Schema、查询、Action）、agent（Agent CRUD、发布、对话）、ds（数据源管理）、vega（可观测平台，如 vega health、vega catalog list）、config（平台配置）、context-loader（MCP 分层检索）、call（通用 API 调用）。需要子命令完整参数时读取对应 reference 文件。
认证：凭据通过 ~/.kweaver/ 管理并支持自动刷新；优先级为 KWEAVER_TOKEN + KWEAVER_BASE_URL 环境变量（静态 Token，不自动刷新）→ ~/.kweaver/ 凭据（kweaver auth login 写入，推荐）。Token 1 小时过期，存在 refresh_token 时自动刷新；仅 Playwright cookie 登录时需重新运行 kweaver auth login <url>。
限制与注意：不要猜测 business_domain，首次使用运行 kweaver config show 确认，必要时用 kweaver config set-bd <uuid> 设置。Action 执行有副作用，执行前需向用户确认。object-type query 的 limit 必须 ≤ 30（BOM 建议 ≤ 10，宽表建议 ≤ 20），更多数据用 search_after 分页，尽量用 condition 过滤，优先使用 ==、like、in 操作符。
适用场景：知识网络/知识图谱构建与查询、语义搜索、Agent 对话与编排、Vega 健康巡检等。其他细节暂未提供。