mirror of https://github.com/modelstudioai/cli.git synced 2026-09-14 19:49:23 +08:00

Files

T

zeyu.fz 8a09881626 refactor(tool-bailian-kb): 重构默认服务配置管理及设置页同步逻辑

- 替换默认服务配置字段为 defaultRetrieveAgentId 和 defaultChatAgentId，支持分别管理检索和对话服务
- 增加 Bailian knowledge base 插件设置命名空间，配置支持用户层叠覆盖和实时生效
- 统一凭证与设置配置的回退链，新增一阶段设置用户层优先读取字段
- 实现凭证值向设置文档的单次迁移，辅助设置页首次展示历史值
- Bailian 页面控制器支持基于设置作用域的双域同步，回显设置字段且支持删除操作
- 工具代码切换为从设置作用域异步解析默认服务 id，agent_id 在运行时均为可选但调用时必填
- README 与文档更新，包含配置项扩展、回退链说明以及 UI 配置页操作说明
- 底层依赖由 `dsh-client-ui-settings-plugins` 切换为 `dsh-client-ui-settings`
- 修正 patch 配置与 API 参数命名，完善错误提示和超时配置读取

2026-08-17 13:52:05 +08:00

4.0 KiB

Raw Blame History

bailian-kb-dsh（分发包）

dsh bundle 分发面：package.json 的 dsh.bundle.patch 声明 + cordis.patch.yml，向 profile 插入 tool-bailian-kb row，并随包分发浏览器端配置页（dsh.client → lib/client.js）。

Patch row

- insert:
    - id: tool-bailian-kb
      name: dsh-tool-bailian-kb
      config:
        workspaceId: !!js process.env.BAILIAN_WORKSPACE_ID

workspaceId 只是解析链的一层，不是唯一来源：Config 同时注册为 bailian-kb settings namespace，patch entry 作 base 层，设置页/设置文档的用户层叠在其上；都未设置时 per-call 回退到 BAILIAN_WORKSPACE_ID credential。同样回退覆盖 defaultRetrieveAgentId（BAILIAN_DEFAULT_RETRIEVE_AGENT_ID）、defaultChatAgentId（BAILIAN_DEFAULT_CHAT_AGENT_ID）与 API key（DASHSCOPE_API_KEY，无 settings 面）。

四个值的解析链

值	1️⃣ settings 用户层（设置页可编辑、回显）	2️⃣ entry config（本 patch 或用户覆盖，作 base 层）	3️⃣ credential（`~/.dsh/.credentials.yaml` / env）	4️⃣ 都缺失时
`DASHSCOPE_API_KEY`	—（无 settings 面）	—（无 config 面）	✅	工具调用报错并引导配置
`BAILIAN_WORKSPACE_ID`	✅ `workspaceId`	✅ `workspaceId`	✅	工具调用报错并引导配置
`BAILIAN_DEFAULT_RETRIEVE_AGENT_ID`	✅ `defaultRetrieveAgentId`	✅ `defaultRetrieveAgentId`	✅	`kb_search` 的 `agent_id` 参数变必填（schema 恒 optional，运行时校验）
`BAILIAN_DEFAULT_CHAT_AGENT_ID`	✅ `defaultChatAgentId`	✅ `defaultChatAgentId`	✅	`kb_chat` 的 `agent_id` 参数变必填（schema 恒 optional，运行时校验）

行为参数（endpointHost/agentVersion/chatTimeoutMs）在 config/settings 层（设置文档可改，实时生效），见 tool-bailian-kb README。

Web UI 配置页

装进 profile 后，Settings 左侧导航出现“百炼知识库”页（settings.section 槽位）：

DashScope API Key — write-only（凭据域 wire 结构上无值位，永不回显），type=password 遮罩输入草稿，仅显示 configured/来自环境变量徽标；写 ~/.dsh/.credentials.yaml
Bailian Workspace ID / 默认检索服务 ID / 默认对话服务 ID — 回显：读写 bailian-kb settings 用户层（设置文档），预填当前解析值；清空保存 = 移除用户层，回退 entry config → credential；每个默认服务 ID 附“清除”按钮（同时 unset settings 用户层与 credential，避免回退链复活旧值）

降级：远程浏览器（非 loopback，settings RPC 不可达）或未组合 settings 服务时，ID 字段退回旧的 write-only credential 控件，页面顶部显示提示。

用户覆盖

用户 patch 层在本 bundle 之上，按 id 覆盖时替换整个 config（无 deep-merge），覆盖后的 config 成为 settings namespace 的新 base 层（设置页的用户层仍叠在其上）。workspaceId/defaultRetrieveAgentId/defaultChatAgentId 均为可选，只需重述想显式固定的字段：

# ~/.dsh/cordis.patch.yml 或 profile 的 cordis.patch.yml
- id: tool-bailian-kb
  config:
    defaultRetrieveAgentId: aid-search-service   # 检索服务；省略 workspaceId 走 credential
    defaultChatAgentId: aid-chat-service         # 对话服务
    chatTimeoutMs: 600000

禁用：- id: tool-bailian-kb + disabled: true。

安装（本地 checkout 链接）

bundle 是 dsh.bundle 声明层，真正的插件包 dsh-tool-bailian-kb 是它的依赖；link: 安装不携带传递依赖，两个包都要 add（第二个无 bundle 声明，dsh 会以 plain dependency 装入，CLI 的 warning 即预期行为）：

dsh plugin --profile web add /path/to/bailian-kb-dsh/packages/bundle
dsh plugin --profile web add /path/to/bailian-kb-dsh/packages/tool-bailian-kb

卸载

dsh plugin --profile <name> remove bailian-kb-dsh dsh-tool-bailian-kb

4.0 KiB Raw Blame History Unescape Escape