{"id":"dc230f2b-6fc1-4a6c-b9f3-af9f610e3556","shortId":"TcagQW","kind":"skill","title":"kweaver-core","tagline":">-","description":"# KWeaver CLI\n\nKWeaver 平台的命令行工具，覆盖认证、平台业务域（`config`）、知识网络管理与查询、Agent CRUD 与对话、数据源管理。\n\n## 安装\n\n```bash\nnpm install -g @kweaver-ai/kweaver-sdk\n```\n\n需 Node.js 22+。也可用 `npx kweaver` 临时运行。\n\n## 使用方式\n\n```bash\nkweaver [--user <userId|username>] <command> [subcommand] [options]\n```\n\n**完整子命令与参数以当前安装的 CLI 为准**：运行 `kweaver --help`（或 `-h`）查看与代码同步的用法列表；查版本用 `kweaver --version` / `-V` / `kweaver version`。子命令细节用 `kweaver <group> <subcommand> --help`（例如 `kweaver auth --help`、`kweaver bkn push --help`）。\n\n本 skill 下的 `references/*.md` 与 CLI 行为对齐；**表格与 reference 为速查**，新增标志（如 `auth` 的 `--alias`、BKN `validate`/`push` 的编码选项）在 reference 中有说明。\n\n**别名**：`kweaver curl` 等同于 `kweaver call`；`kweaver context` 等同于 `kweaver context-loader`。\n\n**业务域（business domain）**：多数请求依赖 `x-business-domain`。`kweaver auth login` 后应优先执行 `kweaver config show`；列表为空时用 `config list-bd` 查看平台可选域，再 `config set-bd <uuid>`。详见 [`references/config.md`](references/config.md)。\n\n## 使用前提\n\n**认证凭据通过 `~/.kweaver/` 管理。默认操作：在存在 `refresh_token` 时，用 OAuth2 `refresh_token` 授权换发新的 `access_token`（过期或临近过期时自动执行，无需额外参数）。禁止提前检查环境变量，禁止询问用户提供密码或 Token。**\n\n### 认证优先级\n\n1. `KWEAVER_TOKEN` + `KWEAVER_BASE_URL` 环境变量 → 静态 Token（如存在则优先使用，**不会**用 refresh 换发）\n2. `~/.kweaver/` 凭据（`kweaver auth login` 写入）→ **默认**用 refresh_token 换发 access_token（推荐）\n3. `KWEAVER_USER` 环境变量（或全局 `--user` 参数）→ 使用指定用户的凭证，不切换活跃用户\n\n### 业务域优先级（与认证独立）\n\n1. `KWEAVER_BUSINESS_DOMAIN` 环境变量  \n2. 当前平台 `config.json` 中的 `businessDomain`（`kweaver config set-bd`）  \n3. 默认 `bd_public`（首次登录后 CLI 可能已自动写入更合适的值）\n\n## 命令组总览\n\n| 命令组 | 说明 | 常用命令 | 详细参考 |\n|--------|------|---------|---------|\n| `auth` | 认证管理（支持多账号） | `auth login <url> [--alias name]`（简写：`auth <url> [--alias …]`）；可选 `-u`/`-p` 或 `--playwright`；`auth list`（树形展示所有平台及用户）；`auth users`（列出用户名）；`auth switch --user <username>`（按用户名切换）；全局 `--user <name>` 可免切换使用指定用户凭证（env: `KWEAVER_USER`）；`auth use` / `status` / `logout` / `delete` 支持平台 URL 或别名 | `references/auth.md` |\n| `token` | 打印当前 access token（自动刷新） | `token` | — |\n| `config` | **平台业务域（优先于多数 bkn/agent/ds 操作）** | `config show`, `config list-bd`, `config set-bd <uuid>` | `references/config.md` |\n| `bkn` | BKN 知识网络管理、Schema、查询、Action | `bkn validate`/`push` 默认检测 `.bkn` 编码并规范为 UTF-8，可用 `--no-detect-encoding` 或 `--source-encoding gb18030`；另有 `pull`、`object-type`、`search`、`create-from-ds`/`create-from-csv` 等，见 `references/bkn.md` | `references/bkn.md` |\n| `agent` | Agent CRUD、发布、对话、Trace、模板、分类 | `agent list`, `agent get <id>`, `agent create --name <n> --profile <p> --config <json>`, `agent publish <id> --category-id <cid>`, `agent chat <id> -m \"...\"`、`agent category-list`, `agent template-list`, `agent template-get <tpl_id>`、`agent sessions <agent_id>`、`agent history <conversation_id>`、`agent trace <conversation_id>` | `references/agent.md` |\n| `ds` | 数据源管理 | `ds list`, `ds get <id>`, `ds import-csv <ds_id> --files <glob> [--recreate]` | `references/ds.md` |\n| `dataview` | 原子/自定义数据视图（mdl-data-model） | `dataview list`、`find --name`、`get`、`query`（SQL / mdl-uniquery）、`delete` | `references/dataview.md` |\n| `skill` | Skill 注册、市场查找、渐进式读取、下载与安装 | `skill list`、`market`、`register --zip-file`、`content`、`read-file`、`install` | `references/skill.md` |\n| `vega` | Vega 可观测平台 | `vega health`, `vega catalog list`, `vega resource list` | `references/vega.md` |\n| `context-loader` | MCP 分层检索 | `context-loader config show`, `context-loader kn-search <query>` | `references/context-loader.md` |\n| `call` | 通用 API 调用 | `call <url> [-X POST] [-d '...']`（可用 `curl` 别名；支持 `--url`、`--data-raw` 等，见 `kweaver --help`） | `references/call.md` |\n\n## 操作指南\n\n| 场景 | 说明 | 详细参考 |\n|------|------|---------|\n| 登录后确认业务域 | `config show`；若异常或列表为空 → `config list-bd` → `config set-bd <uuid>` | [references/config.md](references/config.md) |\n| 从数据库/CSV 构建 KN | 连接数据源 → CSV 导入 → 创建 KN → 构建索引 → 查询验证 → 绑定 Agent | [references/build-kn-from-db.md](references/build-kn-from-db.md) |\n| CLI 排障速查 | 权限、pull、build、import、dataview SQL 等 | [references/troubleshooting.md](references/troubleshooting.md) |\n| 列/查数据视图 | `list` 浏览；`find --name` 按名搜索（`--exact`/`--wait`）；`query` 对视图跑 SQL | [references/dataview.md](references/dataview.md) |\n| Trace 数据分析 | `agent trace <conversation_id>` 获取 trace 数据，构建证据链 | — |\n| 管理 Skill | `list` / `market` 查找 Skill；`content` / `read-file` 渐进式读取；`install` 下载并解压本地使用 | [references/skill.md](references/skill.md) |\n\n**按需阅读**：需要子命令完整参数或编排示例时，读取对应的 reference 文件。\n\n## 调用示例\n\n```\n/kweaver-core 列出所有知识网络\n/kweaver-core 查看 Vega 健康状况\n/kweaver-core 有哪些 Agent\n/kweaver-core 跟 Agent xxx 对话，问他\"今天库存情况\"\n/kweaver-core 搜索知识网络 xxx 中关于\"供应链\"的内容\n/kweaver-core 用 dataview find 模糊搜索名字含 BOM 的数据视图\n/kweaver-core 列出所有 Agent 模板\n/kweaver-core 基于 \"数据分析助手\" 模板创建一个新的 Agent\n/kweaver-core 在 skill market 里查找名字包含 kweaver 的 skill\n/kweaver-core 读取 skill xxx 的 SKILL.md 并保存到本地目录\n```\n\n## 注意事项\n\n- **不要自行猜测 business_domain 值**。首次使用时运行 `kweaver config show` 或 `kweaver config list-bd` 确认当前 business domain。如果返回 `bd_public (default)` 但命令结果为空，可能需要用 `kweaver config set-bd <uuid>` 设置正确的值（也可用 `config list-bd` 从平台列出后再 `set-bd`，或从平台 UI 请求头中获取 `X-Business-Domain`）\n- Action 执行有副作用，执行前向用户确认\n- **禁止运行 `kweaver auth status` 做预检**。直接执行目标命令，CLI 会自动处理认证和 token 刷新\n- Token 1 小时过期。当 `~/.kweaver/` 中存在 `refresh_token`（通过 OAuth2 登录获得）时，CLI 会**自动刷新**；仅 Playwright cookie 登录（无 `refresh_token`）时需要用户重新运行 `kweaver auth login <url>`。遇到 401 错误时 CLI 会自动尝试刷新，刷新失败才提示用户重新登录\n\n## 查询策略（object-type query）\n\n调用 `object-type query` 时必须限制 `limit`、用 `search_after` 分页、用 `condition` 过滤，避免宽表 JSON 截断。完整规则与示例见 [`references/bkn.md`](references/bkn.md#object-type-query-strategy-for-llm-and-agent)。","tags":["kweaver","core","dip","kweaver-ai","agent-skills","agents","digital-worker","ontology","openclaw"],"capabilities":["skill","source-kweaver-ai","skill-kweaver-core","topic-agent-skills","topic-agents","topic-digital-worker","topic-ontology","topic-openclaw"],"categories":["kweaver-dip"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/kweaver-ai/kweaver-dip/kweaver-core","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add kweaver-ai/kweaver-dip","source_repo":"https://github.com/kweaver-ai/kweaver-dip","install_from":"skills.sh"}},"qualityScore":"0.508","qualityRationale":"deterministic score 0.51 from registry signals: · indexed on github topic:agent-skills · 117 github stars · SKILL.md body (5,518 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T06:55:20.141Z","embedding":null,"createdAt":"2026-04-18T22:14:46.695Z","updatedAt":"2026-05-02T06:55:20.141Z","lastSeenAt":"2026-05-02T06:55:20.141Z","tsv":"'-8':295 '/.kweaver':133,168,672 '/csv':488 '/kweaver-core':556,558,562,565,572,578,585,589,594,602 '/kweaver-sdk':24 '1':153,193,669 '2':167,198 '22':27 '3':182,208 '401':695 'access':145,179,262 'action':287,655 'agent':12,324,325,332,334,336,341,346,349,353,357,361,363,365,499,529,564,567,587,593,733 'ai':23 'alia':81,225,229 'api':450 'auth':60,79,111,171,220,223,228,235,238,241,251,660,692 'base':157 'bash':17,33 'bd':121,127,207,210,276,280,480,484,623,628,637,643,647 'bkn':63,82,282,283,288,292 'bkn/agent/ds':269 'bom':583 'build':506 'busi':103,108,195,611,625,653 'businessdomain':202 'call':94,448,452 'catalog':425 'categori':344,351 'category-id':343 'category-list':350 'chat':347 'cli':5,41,72,213,502,664,680,697 'condit':717 'config':10,115,118,124,204,266,271,273,277,340,439,474,477,481,616,620,634,640 'config.json':200 'content':413,541 'context':96,100,432,437,442 'context-load':99,431,436,441 'cooki':685 'core':3 'creat':313,317,337 'create-from-csv':316 'create-from-d':312 'crud':13,326 'csv':319,377,492 'curl':91,457 'd':455 'data':386,462 'data-raw':461 'dataview':381,388,508,580 'default':630 'delet':255,398 'detect':299 'domain':104,109,196,612,626,654 'ds':315,368,370,372,374 'encod':300,304 'env':248 'exact':520 'file':378,412,416,544 'find':390,517,581 'g':20 'gb18030':305 'get':335,360,373,392 'h':47 'health':423 'help':45,57,61,65,467 'histori':364 'id':345 'import':376,507 'import-csv':375 'instal':19,417,546 'json':720 'kn':445,490,495 'kn-search':444 'kweaver':2,4,6,22,30,34,44,50,53,56,59,62,90,93,95,98,110,114,154,156,170,183,194,203,249,466,599,615,619,633,659,691 'kweaver-ai':21 'kweaver-cor':1 'limit':711 'list':120,236,275,333,352,356,371,389,407,426,429,479,515,537,622,642 'list-bd':119,274,478,621,641 'llm':731 'loader':101,433,438,443 'login':112,172,224,693 'logout':254 'm':348 'market':408,538,597 'mcp':434 'md':70 'mdl':385,396 'mdl-data-model':384 'mdl-uniqueri':395 'model':387 'name':226,338,391,518 'no-detect-encod':297 'node.js':26 'npm':18 'npx':29 'oauth2':141,677 'object':309,702,707,726 'object-typ':308,701,706 'object-type-query-strategy-for-llm-and-ag':725 'option':39 'p':232 'playwright':234,684 'post':454 'profil':339 'public':211,629 'publish':342 'pull':307,505 'push':64,84,290 'queri':393,522,704,709,728 'raw':463 'read':415,543 'read-fil':414,542 'recreat':379 'refer':69,75,87,553 'references/agent.md':367 'references/auth.md':259 'references/bkn.md':322,323,723,724 'references/build-kn-from-db.md':500,501 'references/call.md':468 'references/config.md':129,130,281,485,486 'references/context-loader.md':447 'references/dataview.md':399,525,526 'references/ds.md':380 'references/skill.md':418,548,549 'references/troubleshooting.md':511,512 'references/vega.md':430 'refresh':137,142,165,176,674,688 'regist':409 'resourc':428 'schema':285 'search':311,446,713 'session':362 'set':126,206,279,483,636,646 'set-bd':125,205,278,482,635,645 'show':116,272,440,475,617 'skill':67,400,401,406,536,540,596,601,604 'skill-kweaver-core' 'skill.md':607 'sourc':303 'source-encod':302 'source-kweaver-ai' 'sql':394,509,524 'status':253,661 'strategi':729 'subcommand':38 'switch':242 'templat':355,359 'template-get':358 'template-list':354 'token':138,143,146,151,155,161,177,180,260,263,265,666,668,675,689 'topic-agent-skills' 'topic-agents' 'topic-digital-worker' 'topic-ontology' 'topic-openclaw' 'trace':329,366,527,530,532 'type':310,703,708,727 'u':231 'ui':649 'uniqueri':397 'url':158,257,460 'use':252 'user':35,184,187,239,243,246,250 'userid':36 'usernam':37 'utf':294 'v':52 'valid':83,289 'vega':419,420,422,424,427,560 'version':51,54 'wait':521 'x':107,453,652 'x-business-domain':106,651 'xxx':568,574,605 'zip':411 'zip-fil':410 '下的':68 '下载与安装':405 '下载并解压本地使用':547 '不会':163 '不切换活跃用户':190 '不要自行猜测':610 '与':71 '与对话':14 '与认证独立':192 '业务域':102 '业务域优先级':191 '中关于':575 '中存在':673 '中有说明':88 '中的':201 '临时运行':31 '为准':42 '为速查':76 '也可用':28,639 '仅':683 '今天库存情况':571 '从平台列出后再':644 '从数据库':487 '优先于多数':268 '会':681 '会自动处理认证和':665 '会自动尝试刷新':698 '但命令结果为空':631 '使用前提':131 '使用指定用户的凭证':189 '使用方式':32 '例如':58 '供应链':576 '值':613 '做预检':662 '健康状况':561 '全局':245 '再':123 '写入':173 '凭据':169 '分层检索':435 '分类':331 '分页':715 '列':513 '列出所有':586 '列出所有知识网络':557 '列出用户名':240 '列表为空时用':117 '创建':494 '别名':89,458 '刷新':667 '刷新失败才提示用户重新登录':699 '原子':382 '参数':188 '发布':327 '另有':306 '可免切换使用指定用户凭证':247 '可用':296,456 '可能已自动写入更合适的值':214 '可能需要用':632 '可观测平台':421 '可选':230 '后应优先执行':113 '命令组':216 '命令组总览':215 '在':86,595 '在存在':136 '场景':470 '基于':590 '多数请求依赖':105 '如':78 '如存在则优先使用':162 '如果返回':627 '子命令细节用':55 '安装':16 '完整子命令与参数以当前安装的':40 '完整规则与示例见':722 '对视图跑':523 '对话':328,569 '导入':493 '小时过期':670 '市场查找':403 '常用命令':218 '平台业务域':9,267 '平台的命令行工具':7 '并保存到本地目录':608 '当':671 '当前平台':199 '或':46,233,301,618 '或从平台':648 '或全局':186 '或别名':258 '截断':721 '打印当前':261 '执行前向用户确认':657 '执行有副作用':656 '按名搜索':519 '按用户名切换':244 '按需阅读':550 '换发':166,178 '授权换发新的':144 '排障速查':503 '推荐':181 '搜索知识网络':573 '操作':270 '操作指南':469 '支持':459 '支持多账号':222 '支持平台':256 '数据':533 '数据分析':528 '数据分析助手':591 '数据源管理':15,369 '文件':554 '新增标志':77 '无':687 '无需额外参数':148 '时':139,679 '时必须限制':710 '时需要用户重新运行':690 '有哪些':563 '本':66 '权限':504 '构建':489 '构建索引':496 '构建证据链':534 '查找':539 '查数据视图':514 '查版本用':49 '查看':559 '查看与代码同步的用法列表':48 '查看平台可选域':122 '查询':286 '查询策略':700 '查询验证':497 '树形展示所有平台及用户':237 '模板':330,588 '模板创建一个新的':592 '模糊搜索名字含':582 '注册':402 '注意事项':609 '浏览':516 '渐进式读取':404,545 '环境变量':159,185,197 '用':140,164,175,579,712,716 '登录':686 '登录后确认业务域':473 '登录获得':678 '的':80,600,606 '的内容':577 '的数据视图':584 '的编码选项':85 '直接执行目标命令':663 '知识网络管理':284 '知识网络管理与查询':11 '确认当前':624 '禁止提前检查环境变量':149 '禁止询问用户提供密码或':150 '禁止运行':658 '等':320,464,510 '等同于':92,97 '简写':227 '管理':134,535 '绑定':498 '编码并规范为':293 '自动刷新':264,682 '自定义数据视图':383 '若异常或列表为空':476 '获取':531 '行为对齐':73 '表格与':74 '覆盖认证':8 '见':321,465 '认证优先级':152 '认证凭据通过':132 '认证管理':221 '设置正确的值':638 '详细参考':219,472 '详见':128 '说明':217,471 '请求头中获取':650 '读取':603 '读取对应的':552 '调用':451,705 '调用示例':555 '跟':566 '过期或临近过期时自动执行':147 '过滤':718 '运行':43 '连接数据源':491 '通用':449 '通过':676 '遇到':694 '避免宽表':719 '里查找名字包含':598 '错误时':696 '问他':570 '需':25 '需要子命令完整参数或编排示例时':551 '静态':160 '首次使用时运行':614 '首次登录后':212 '默认':174,209 '默认操作':135 '默认检测':291","prices":[{"id":"9b5821dd-3b18-4818-ba9e-a2cae1899de1","listingId":"dc230f2b-6fc1-4a6c-b9f3-af9f610e3556","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"kweaver-ai","category":"kweaver-dip","install_from":"skills.sh"},"createdAt":"2026-04-18T22:14:46.695Z"}],"sources":[{"listingId":"dc230f2b-6fc1-4a6c-b9f3-af9f610e3556","source":"github","sourceId":"kweaver-ai/kweaver-dip/kweaver-core","sourceUrl":"https://github.com/kweaver-ai/kweaver-dip/tree/main/skills/kweaver-core","isPrimary":false,"firstSeenAt":"2026-04-18T22:14:46.695Z","lastSeenAt":"2026-05-02T06:55:20.141Z"}],"details":{"listingId":"dc230f2b-6fc1-4a6c-b9f3-af9f610e3556","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"kweaver-ai","slug":"kweaver-core","github":{"repo":"kweaver-ai/kweaver-dip","stars":117,"topics":["agent-skills","agents","ai","business-knowledge-network","digital-worker","ontology","openclaw"],"license":"apache-2.0","html_url":"https://github.com/kweaver-ai/kweaver-dip","pushed_at":"2026-05-01T05:38:33Z","description":"KWeaver DIP is an enterprise-level digital employee platform, built on KWeaver Core. It provides an AI-native environment for developing and managing digital employees on business knowledge networks—for enterprise intelligence that is understandable, executable, and governable.","skill_md_sha":"2fcdd93432c7cdf01c07055193f42bbbd7dd992d","skill_md_path":"skills/kweaver-core/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/kweaver-ai/kweaver-dip/tree/main/skills/kweaver-core"},"layout":"multi","source":"github","category":"kweaver-dip","frontmatter":{"name":"kweaver-core","description":">-"},"skills_sh_url":"https://skills.sh/kweaver-ai/kweaver-dip/kweaver-core"},"updatedAt":"2026-05-02T06:55:20.141Z"}}