refactor(cli): 替换所有 kscli 命令为 bl CLI 命令

- README 文档中将管理面 CLI 名称由 kscli 改为 bl CLI
- 包描述与说明中更新 CLI 名称与对应命令用法
- 技能文档及其命令参考全面替换 kscli 为 bl
- 所有子命令示例和用法文档同步改为 bl 及对应子命令路径
- 更新服务发现命令由 kscli 改为 bl knowledge service list
- 更新鉴权说明改为 bl auth login 及相关配置命令
- 维护命令结构一致性，保证用户可无缝使用 bl 替代原 kscli

Author: clark-fc

README.md

@@ -1,6 +1,6 @@
 # bailian-kb-dsh
 
-阿里云百炼知识库能力的 [DeepSeek Harness (dsh)](https://github.com/deepseek-ai/deepseek-harness) 插件 bundle：三个 API 直连模型工具（`kb_service_list` / `kb_search` / `kb_chat`）+ kscli 管理面 skill。
+阿里云百炼知识库能力的 [DeepSeek Harness (dsh)](https://github.com/deepseek-ai/deepseek-harness) 插件 bundle：三个 API 直连模型工具（`kb_service_list` / `kb_search` / `kb_chat`）+ bl CLI 管理面 skill。
 
 设计文档：[docs/specs/2026-08-15-bailian-kb-bundle-design.md](docs/specs/2026-08-15-bailian-kb-bundle-design.md) · 实现计划：[docs/plans/2026-08-15-bailian-kb-bundle.md](docs/plans/2026-08-15-bailian-kb-bundle.md)
 

packages/tool-bailian-kb/README.md

@@ -1,6 +1,6 @@
 # dsh-tool-bailian-kb
 
-百炼知识库的 dsh 插件包（同时是 dsh bundle）：在 `ctx.tools` 注册两个检索模型工具（kb_search、kb_chat），并在 skills 服务可用时注册管理面 skill。服务发现通过 kscli CLI 完成。
+百炼知识库的 dsh 插件包（同时是 dsh bundle）：在 `ctx.tools` 注册两个检索模型工具（kb_search、kb_chat），并在 skills 服务可用时注册管理面 skill。服务发现通过 bl CLI（bailian-cli）完成。
 
 ## Bundle 声明
 
@@ -33,6 +33,9 @@
 
 - **DashScope API Key** — write-only，`type=password` 遮罩输入草稿，仅显示 configured/来自环境变量 徽标；写 `~/.dsh/.credentials.yaml`
 - **Bailian Workspace ID / 默认检索服务 ID / 默认对话服务 ID** — 回显：读写 `bailian-kb` settings 用户层，预填当前解析值；清空保存 = 移除用户层，回退 entry config → credential
+- **自动获取（bl CLI）** — 按钮调 Host 桥接路由 `/bailian-kb/autofill`：宿主机读 `~/.bailian/config.json`（`bl auth login` 的落盘），把 `api_key` 写入凭据存储、`workspace_id` 写入 settings，明文 key 不过浏览器；文件里没有 key 时在宿主机拉起 `bl auth login --console` 浏览器登录，完成后再次点击即可回填
+
+首次接入 seed：启动时若 API key / workspaceId 从未被设置过（settings、credential、env 均无值），自动从 `~/.bailian/config.json` 采纳一次；`seededFields` 字段（settings 文档内，面板不可编辑）记账已消费/已由用户管理的字段，用户主动清空的值永不会被重新填回。
 
 降级：远程浏览器（非 loopback，settings RPC 不可达）或未组合 settings 服务时，ID 字段退回旧的 write-only credential 控件，页面顶部显示提示。
 
@@ -73,18 +76,18 @@ Config 同时注册为 `bailian-kb` settings namespace（`installSettingsSection
 | `kb_search` | `query`、`agent_id`（**必填**；程序化省略时回退 defaultRetrieveAgentId）、`top_k?`（默认 5，**客户端截断**——服务端无此参数）、`images?` | chunks（text/score/来源）+ total |
 | `kb_chat` | `message`、`agent_id`（**必填**；程序化省略时回退 defaultChatAgentId） | 完整答案（内部消费 SSE 流缓冲返回）+ request_id |
 
-服务发现（`kb_service_list` 已移除）：通过 `kscli service list` CLI 命令查询可用检索/对话服务及其 agent_id。
+服务发现（`kb_service_list` 已移除）：通过 `bl knowledge service list` CLI 命令查询可用检索/对话服务及其 agent_id。
 
 ## 错误语义
 
-- HTTP 错误：原始错误透传，模型可通过 `kscli service list` 发现可用服务以纠正无效 `agent_id`；
+- HTTP 错误：原始错误透传，模型可通过 `bl knowledge service list` 发现可用服务以纠正无效 `agent_id`；
 - 凭证缺失：指向 `~/.dsh/.env` / `.credentials.yaml` 配置方式与控制台取 key 页面；
 - chat 超时：说明服务端多轮检索特性，建议重试或改用 `kb_search`；
 - 服务端错误体截断至 500 字符进入错误信息（优先 `code: message`）。
 
 ## 管理面 skill
 
-`skills/bailian-kb-management/SKILL.md` 随包分发，插件通过 `ctx.inject(['skills'])` 在 skills 服务可用时以 `source: 'bundled'` 运行时注册；无 skills 服务的组合（headless 最小装配）不受影响。内容：kscli 安装/鉴权/workspace 解析、建库→上传→部署工作流、agent_id 固定最佳实践。
+`skills/bailian-kb-management/SKILL.md` 随包分发，插件通过 `ctx.inject(['skills'])` 在 skills 服务可用时以 `source: 'bundled'` 运行时注册；无 skills 服务的组合（headless 最小装配）不受影响。内容：bl CLI 安装/鉴权/workspace 解析、建库→上传→部署工作流、agent_id 固定最佳实践。
 
 ## Known Limitations
 

packages/tool-bailian-kb/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ali/bailian-kb-dsh",
-  "version": "0.1.6",
-  "description": "Bailian knowledge-base tools for DeepSeek Harness: kb_search and kb_chat over the DashScope RAG API, plus the kscli management skill.",
+  "version": "0.1.7",
+  "description": "Bailian knowledge-base tools for DeepSeek Harness: kb_search and kb_chat over the DashScope RAG API, plus the bl CLI management skill.",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

packages/tool-bailian-kb/skills/bailian-kb-management/SKILL.md

@@ -1,66 +1,64 @@
 ---
 name: bailian-kb-management
 description: >-
-  管理阿里云百炼知识库（建库、上传文档、部署检索服务、Chunk 运维、数据中心文件管理），命令行工具为 kscli。
+  管理阿里云百炼知识库（建库、上传文档、部署检索服务、Chunk 运维、数据中心文件管理），命令行工具为 bl（bailian-cli）。
   当用户要创建/更新/删除知识库、上传或导入文档（本地/OSS）、创建/部署/调参检索或问答服务、
   增删改查 Chunk、管理数据中心类目/文件/集合时使用本 skill。
   检索与问答不走本 skill——用原生工具 kb_search（取证据）/ kb_chat（成品问答）；
-  kscli search / chat 仅用于部署后的验证调试（如 --agent-version beta 调试草稿版）。
+  bl knowledge search / chat 仅用于部署后的验证调试（如 --agent-version beta 调试草稿版）。
   普通问答、编程、写作、翻译、泛搜索不触发本 skill。
 ---
 
-# 百炼知识库管理（kscli）
+# 百炼知识库管理（bl）
 
 检索面与管理面的分工：**查知识用 `kb_search`（取证据）/ `kb_chat`（成品问答）原生工具；本 skill 只覆盖管理长尾**——知识库全生命周期、文档、检索服务、Chunk、数据中心。
 
 ## 前置检查
 
-1. 安装校验：运行 `kscli kb list --help`。若报 `Unknown command` 或 kscli 未安装，执行
-   `npm install -g knowledge-studio-cli@knowledge`（需 Node.js ≥ 18.17）。
-   **管理命令（kb/doc/service/chunk/category/file/collection）只在 `knowledge` 发行通道；
-   `latest` 通道只有 search/chat/config，装错通道会导致所有管理命令不可用。**
+1. 安装校验：运行 `bl knowledge list --help`。若报 `Unknown command` 或 bl 未安装，执行
+   `npm install -g bailian-cli`（需 Node.js ≥ 18.17）；已安装但命令缺失时先 `bl update` 升级。
    安装失败时把错误原样报告给用户，不要静默跳过。
-2. 鉴权：需要 `DASHSCOPE_API_KEY`（环境变量，或 `kscli config set --key api_key --value sk-xxx`）。
-3. workspace 解析优先级：`--workspace-id` 参数 > 环境变量 `BAILIAN_WORKSPACE_ID` > `kscli config set --key workspace_id --value ws-xxx`。
+2. 鉴权：需要 `DASHSCOPE_API_KEY`（环境变量，或 `bl auth login --api-key sk-xxx`，或 `bl config set --key api_key --value sk-xxx`）。
+3. workspace 解析优先级：`--workspace-id` 参数 > 环境变量 `BAILIAN_WORKSPACE_ID` > `bl config set --key workspace_id --value ws-xxx`。
 
 ## 何时用哪个命令
 
 | 用户意图 | 命令 | 备注 |
 | --- | --- | --- |
-| 查知识 / 问答（日常检索） | 原生工具 `kb_search` / `kb_chat` | 不走 kscli |
-| 建库 / 查看 / 改名 / 删库 / 监控 | `kscli kb create/list/info/update/delete/stats` | [reference/kb.md](reference/kb.md) |
-| 上传本地文档、看解析状态、删文档、打标签 | `kscli doc upload/list/status/delete/tag` | [reference/doc.md](reference/doc.md) |
-| 从 OSS 批量导入 | `kscli doc import-oss` | Bucket 需预先授权服务角色 |
-| 创建 / 部署 / 调参检索（问答）服务 | `kscli service create/update/deploy/…` | [reference/service.md](reference/service.md) |
-| 修正错误切片、屏蔽某段内容 | `kscli chunk add/list/update/delete` | [reference/chunk.md](reference/chunk.md) |
-| 数据中心类目 / 文件 / 集合管理 | `kscli category/file/collection …` | [reference/datacenter.md](reference/datacenter.md) |
-| CLI 配置、升级 | `kscli config show/set`、`kscli update` | [reference/config.md](reference/config.md) |
-| 部署后验证、调试草稿版服务 | `kscli search/chat --agent-version beta` | [reference/query.md](reference/query.md) |
+| 查知识 / 问答（日常检索） | 原生工具 `kb_search` / `kb_chat` | 不走 bl |
+| 建库 / 查看 / 改名 / 删库 / 监控 | `bl knowledge create/list/info/update/delete/stats` | [reference/kb.md](reference/kb.md) |
+| 上传本地文档、看解析状态、删文档、打标签 | `bl knowledge doc upload/list/status/delete/tag` | [reference/doc.md](reference/doc.md) |
+| 从 OSS 批量导入 | `bl knowledge doc import-oss` | Bucket 需预先授权服务角色 |
+| 创建 / 部署 / 调参检索（问答）服务 | `bl knowledge service create/update/deploy/…` | [reference/service.md](reference/service.md) |
+| 修正错误切片、屏蔽某段内容 | `bl knowledge chunk add/list/update/delete` | [reference/chunk.md](reference/chunk.md) |
+| 数据中心类目 / 文件 / 集合管理 | `bl knowledge category/file/collection …` | [reference/datacenter.md](reference/datacenter.md) |
+| CLI 配置、升级 | `bl config show/set`、`bl update` | [reference/config.md](reference/config.md) |
+| 部署后验证、调试草稿版服务 | `bl knowledge search/chat --agent-version beta` | [reference/query.md](reference/query.md) |
 
 ## 核心工作流：建库到可检索
 
 ```bash
-kscli doc upload --file ./docs/ --workspace-id ws-xxx                # 1. 上传本地文件/目录 → 得 fileId
-kscli kb create --name my-kb --doc-id <fileId> --wait                # 2. 建库并导入 → 得 index-id (pipelineId)
-kscli service create --name my-search --scene search --index-id <index-id>   # 3. 建检索服务 → 得 agent-id（draft）
-kscli service deploy --agent-id <agent-id> --yes                     # 4. 发布服务（此后可被默认版本调用）
-kscli service list --scene search --status deployed                  # 5. 确认服务可见
+bl knowledge doc upload --file ./docs/ --workspace-id ws-xxx                # 1. 上传本地文件/目录 → 得 fileId
+bl knowledge create --name my-kb --doc-id <fileId> --wait                # 2. 建库并导入 → 得 index-id (pipelineId)
+bl knowledge service create --name my-search --scene search --index-id <index-id>   # 3. 建检索服务 → 得 agent-id（draft）
+bl knowledge service deploy --agent-id <agent-id> --yes                     # 4. 发布服务（此后可被默认版本调用）
+bl knowledge service list --scene search --status deployed                  # 5. 确认服务可见
 ```
 
-部署完成后用原生工具 `kb_search` 带该 `agent_id` 验证检索；若要在部署前调试草稿配置，用 `kscli search --agent-id <id> --agent-version beta`。
+部署完成后用原生工具 `kb_search` 带该 `agent_id` 验证检索；若要在部署前调试草稿配置，用 `bl knowledge search --agent-id <id> --agent-version beta`。
 
-已有文件再入库的简写：`kscli doc upload --file ./a.md --index-id <index-id> --wait`（上传+导入一步完成）。
+已有文件再入库的简写：`bl knowledge doc upload --file ./a.md --index-id <index-id> --wait`（上传+导入一步完成）。
 
 ## ID 速查（极易混淆）
 
 | ID | 来源 | 用在哪 |
 | --- | --- | --- |
-| `index-id` | `kb create` 返回的 pipelineId / `kb list` | 所有 kb/doc/chunk 命令的 `--index-id` |
-| `fileId` | `doc upload` / `doc import-oss` 返回 | 数据中心命令（`file get/delete`、`kb create --doc-id`、`doc tag`） |
+| `index-id` | `knowledge create` 返回的 pipelineId / `knowledge list` | 所有 knowledge/doc/chunk 命令的 `--index-id` |
+| `fileId` | `doc upload` / `doc import-oss` 返回 | 数据中心命令（`file get/delete`、`knowledge create --doc-id`、`doc tag`） |
 | `doc_id`（库内文档 ID） | `doc list` 输出 | `doc delete`、`chunk add/update` 的 `--doc-id`；**可能带 workspace 后缀，≠ fileId** |
 | `job-id` | 导入命令返回的 ingestionId | `doc status`（必须同时给 `--index-id` 和 `--job-id`） |
 | chunk id | `chunk list` 输出的 `metadata._id` | `chunk update/delete` 的 `--chunk-id` |
-| `agent-id` | `service create/list` | `service *`、`kb_search`/`kb_chat`、`kscli search/chat` |
+| `agent-id` | `service create/list` | `service *`、`kb_search`/`kb_chat`、`bl knowledge search/chat` |
 
 ## 命令参考（权威）
 
@@ -69,14 +67,14 @@ kscli service list --scene search --status deployed                  # 5. 确认
 - [reference/index.md](reference/index.md) — 全命令速查表、全局 flag、鉴权说明
 - reference/&lt;group&gt;.md — 按命令组分文件（kb / doc / service / chunk / datacenter / config / query）
 
-执行不熟悉的命令前，先读对应 reference 或跑 `kscli <命令> --help`。**不要猜 flag。**
+执行不熟悉的命令前，先读对应 reference 或跑 `bl <命令> --help`。**不要猜 flag。**
 全部命令支持 `--output json`（结构化输出）、`--dry-run`（预览请求）、`--quiet`、`--verbose`。
 
 ## 危险与不可逆操作
 
 执行以下操作前须向用户确认，脚本化时才用 `--yes` 跳过交互确认：
 
-- `kb delete`：不可逆，库和全部索引内容永久删除（数据中心源文件保留）。
+- `knowledge delete`：不可逆，库和全部索引内容永久删除（数据中心源文件保留）。
 - `file delete`：不可逆，且引用该文件的知识库文档索引会失效；只想从单个库移除用 `doc delete`。
 - `chunk delete`：不可逆。
 - `service deploy`：发布影响线上调用方；`service delete` 后 agent_id 不可再用（软删、幂等）。
@@ -87,6 +85,6 @@ kscli service list --scene search --status deployed                  # 5. 确认
 
 - 用户反复使用同一检索服务时，建议其把 agent_id 写入项目指令（如 AGENTS.md）或让 agent 记住，后续 kb_search / kb_chat 直接携带。
 - 服务有 draft/deployed 两种状态：只有 deployed 可被默认版本调用；draft 调试用 `--agent-version beta`。改已发布版本的配置：先改 beta 草稿（`service update`），验证后 `service deploy` 发新版本。
-- 导入类命令（`kb create`、`doc upload --index-id`、`doc status`）优先带 `--wait` 轮询到终态，避免手工轮询；文档解析失败（如 PARSE_FAILED）会以非零退出码透传错误。
+- 导入类命令（`knowledge create`、`doc upload --index-id`、`doc status`）优先带 `--wait` 轮询到终态，避免手工轮询；文档解析失败（如 PARSE_FAILED）会以非零退出码透传错误。
 - `chunk add` 有 10 QPS 限流，批量脚本注意节流；响应不带 chunk id，需要 `chunk list` 反查。
 - `service list` 必须带 `--scene chat|search`，两个场景要分别查询。

packages/tool-bailian-kb/skills/bailian-kb-management/reference/chunk.md

@@ -1,14 +1,14 @@
-# `kscli chunk` — Chunk 运维
+# `bl knowledge chunk` — Chunk 运维
 
 > 通用鉴权/全局 flag 见 [index.md](index.md)。以下 Flags 只列命令专属项。
 > chunk id = `chunk list` 输出的 `metadata._id`；文档 id = `metadata.doc_id`。
 
-## `kscli chunk add`
+## `bl knowledge chunk add`
 
 直接向库内添加 chunk。
 
 ```
-Usage: kscli chunk add --index-id <id> (--content <text> | --field <k=v>) [flags]
+Usage: bl knowledge chunk add --index-id <id> (--content <text> | --field <k=v>) [flags]
 ```
 
 | Flag | 说明 |
@@ -29,16 +29,16 @@ Notes：
 - 响应不带 chunk id；添加后用 `chunk list` 反查。
 
 ```bash
-kscli chunk add --index-id idx-xxx --content "chunk text" --title intro --doc-id file-xxx
-kscli chunk add --index-id idx-xxx --field 列A=v1 --field 列B=v2
+bl knowledge chunk add --index-id idx-xxx --content "chunk text" --title intro --doc-id file-xxx
+bl knowledge chunk add --index-id idx-xxx --field 列A=v1 --field 列B=v2
 ```
 
-## `kscli chunk list`
+## `bl knowledge chunk list`
 
 列出 chunk 内容与状态。
 
 ```
-Usage: kscli chunk list --index-id <id> [flags]
+Usage: bl knowledge chunk list --index-id <id> [flags]
 ```
 
 | Flag | 说明 |
@@ -51,15 +51,15 @@ Notes：
 - 后续 update/delete 用输出中的 `metadata._id`（chunk id）与 `metadata.doc_id`（文档 id）。
 
 ```bash
-kscli chunk list --index-id idx-xxx --doc-id file-xxx --page-size 50
+bl knowledge chunk list --index-id idx-xxx --doc-id file-xxx --page-size 50
 ```
 
-## `kscli chunk update`
+## `bl knowledge chunk update`
 
 改 chunk 内容或切换检索可见性。
 
 ```
-Usage: kscli chunk update --index-id <id> --chunk-id <id> --doc-id <id> [flags]
+Usage: bl knowledge chunk update --index-id <id> --chunk-id <id> --doc-id <id> [flags]
 ```
 
 | Flag | 说明 |
@@ -78,16 +78,16 @@ Notes：
 - 只切 `--exclude/--include` 不给新内容时，自动重提交现有内容。
 
 ```bash
-kscli chunk update --index-id idx-xxx --chunk-id chunk-xxx --doc-id file-xxx --content "corrected text"
-kscli chunk update --index-id idx-xxx --chunk-id chunk-xxx --doc-id file-xxx --exclude
+bl knowledge chunk update --index-id idx-xxx --chunk-id chunk-xxx --doc-id file-xxx --content "corrected text"
+bl knowledge chunk update --index-id idx-xxx --chunk-id chunk-xxx --doc-id file-xxx --exclude
 ```
 
-## `kscli chunk delete`
+## `bl knowledge chunk delete`
 
 删除 chunk。**不可逆，执行前须向用户确认。**
 
 ```
-Usage: kscli chunk delete --index-id <id> --chunk-id <id> [flags]
+Usage: bl knowledge chunk delete --index-id <id> --chunk-id <id> [flags]
 ```
 
 | Flag | 说明 |
@@ -96,5 +96,5 @@ Usage: kscli chunk delete --index-id <id> --chunk-id <id> [flags]
 | `--yes` | 跳过交互确认 |
 
 ```bash
-kscli chunk delete --index-id idx-xxx --chunk-id chunk-a --chunk-id chunk-b --yes
+bl knowledge chunk delete --index-id idx-xxx --chunk-id chunk-a --chunk-id chunk-b --yes
 ```