DSH WorkBuddy Provider

为 DeepSeek Harness（DSH）增加 WorkBuddy 中国区 Provider。插件通过 WorkBuddy 提供的 API Key，或 WorkBuddy 中国站的网页登录令牌调用模型，并在 DSH WebUI 中管理模型和认证方式。

[!IMPORTANT] API Key 来自 WorkBuddy，用于调用供 WorkBuddy 使用的模型服务。本插件是第三方 适配器，不属于 WorkBuddy 或 DSH 官方项目。

功能

• 在 DSH WebUI 中使用 WorkBuddy 中国区；
• 支持 WorkBuddy API Key 和 WorkBuddy 中国站账号令牌；
• 两种认证模式互相独立，可以随时切换；
• API Key 支持环境变量、多个 DSH 保存值，并可通过下拉列表切换；
• 令牌支持浏览器登录、多个账号持久化、账号名称展示和下拉切换；
• 令牌模式显示剩余积分、今日请求次数和今日积分用量；
• 自动兼容 modlens-workbuddy-cn 等带有 WorkBuddy/CodeBuddy 标识的包装 Provider；
• 用量信息与 DSH 的 Token/缓存统计显示在输入框底部同一行；
• 自动从 WorkBuddy 获取当前账号可用模型；
• 支持编辑模型 ID、名称、上下文窗口、最大输出 Token 和模型思考档位；
• 支持添加、删除模型以及恢复在线模型目录；
• 不依赖本机 WorkBuddy CLI。

环境要求

• 已安装 DSH；
• Node.js >= 22.19.0；
• Windows、Linux 或 macOS。

插件 1.3.7 及以上版本要求 DSH >= 0.1.2-alpha.2。1.3.9 起兼容新版 DSH 的 settings 注册接口。该版本不再携带旧版 DSH 运行时副本，而是复用宿主 DSH 的运行时，避免更新 DSH 后出现 Provider 目录接口 （llm/listProviders）不兼容。1.3.10 起，WorkBuddy 认证助手同时兼容新旧 DSH 的 signal 调用约定。升级插件后请重新安装一次并重启 DSH。

插件兼容旧版 DSH 和 0.1.7-rc.1（next）的按插件条目管理配置方式。 旧版由插件接管 llm-pi-ai；next 保留内置 llm-pi-ai 处理自定义提供方， WorkBuddy 使用自己的配置条目。升级后请完整退出并重新启动 DSH，再检查模型卡片与凭证模式。 在 next 上，命令行 login 只保存令牌；认证模式需在 WorkBuddy 模型卡片中选择 “令牌登录”，不会再写入旧版 settings.yaml。next 的模型页通过插件扩展位显示 WorkBuddy 专属认证与模型管理区域；旧版 DSH 继续使用原有编辑界面。

安装

在 PowerShell 或终端执行：

npx --yes @axiaohungry/dsh-llm-workbuddy@latest install

安装器会为 DSH 的 web 和 headless Profile 安装插件。安装完成后重启 DSH。 只使用 WebUI 时，也可以单独安装 Web Profile：

dsh plugin --profile web add @axiaohungry/dsh-llm-workbuddy@latest

从旧版升级

插件 npm 包现在是 @axiaohungry/dsh-llm-workbuddy。重新执行上面的安装命令时，安装器会在 web 和 headless Profile 中自动移除旧包（包括 dsh-llm-workbuddy 和 dsh-llm-codebuddy），再安装新包；已有 Provider、模型、 API Key 和令牌凭据会保留。

新版本内部 Provider ID 为 workbuddy-cn。旧配置中的 codebuddy-cn 会在运行时兼容，并在 切换认证模式时迁移为新 ID。

WebUI 配置

打开 设置 → 模型。在 next 中，点击“添加模型提供商”，从“第三方模型提供商” 选择 WorkBuddy 中国区；已配置后直接编辑它的模型卡片。旧版 DSH 继续从提供方列表 添加或编辑。认证区域有两个模式按钮：

• API Key：只显示 API Key 来源和新增 Key 功能；
• 令牌登录：只显示令牌账号、登录、切换以及账号用量信息。

切换模式后，另一种模式的账号或 Key 控件会隐藏，不会同时占用页面空间。

可选：会话级账号/API Key

认证区域提供“会话级账号/API Key”开关：

• 关闭（默认）：保持旧版行为。所有会话共用模型设置中当前选中的全局账号或 API Key； 不会改变已有配置和调用方式。
• 打开：模型设置中选择的账号或 API Key 作为未绑定会话的默认预选。每个会话也可以在 输入框底部单独选择“令牌 / API Key”以及对应账号或 Key。切换当前会话的凭证不会修改 其他会话，也不会中断已有会话上下文。

会话级绑定只保存会话 ID 与账号 ID/API Key 引用，不会把令牌或 API Key 写入会话路由配置。 关闭开关后，已保存的绑定会暂时停用；重新打开后会继续生效。新增或删除账号、Key 时， 对应的无效绑定会自动清理。

开启后，点击“新会话”时会在输入框上方显示“新会话默认凭证”，可以在发送第一条消息前 选择令牌账号或 API Key。新会话或历史未绑定会话第一次调用 WorkBuddy 模型时，插件会先把 当时的默认预选固化到该 sessionId，再发出模型请求。固化后，即使模型设置中的默认预选发生 变化，该会话仍继续使用自己的绑定；也可以在会话底部再次切换或解除绑定。解除后，下一次发送 会重新固化当时的默认预选。运行时请求如果缺少 sessionId，则使用原有全局认证配置。

模型目录仍由 DSH 统一管理，模型选择本身按会话保存。更换会话凭证后，如果该账号的模型 权限不同，请在模型设置中重新获取一次在线模型目录。

方式一：WorkBuddy API Key

使用环境变量中的 Key

插件会自动检测：

WORKBUDDY_API_KEY

如果这个环境变量存在，API Key 来源下拉列表会显示“环境变量 WORKBUDDY_API_KEY”。 选择它即可使用；密钥值不会显示在页面中，也不会写入 settings.yaml。

旧版插件使用的 CODEBUDDY_API_KEY 仍会作为兼容环境变量自动识别，但新配置建议统一使用 WORKBUDDY_API_KEY。

在 DSH 中保存新的 Key

1. 选择 API Key 模式；
2. 在“新增 API Key”输入框粘贴 WorkBuddy Key；
3. 可填写一个名称，例如“工作账号”或“测试账号”；
4. 点击“添加并使用”；
5. 新 Key 会出现在“当前 API Key”下拉列表中，并立即切换为当前 Key。

DSH 保存的 Key 存放在 DSH 凭据服务中。可以保存多个 Key 并随时切换；环境变量 Key 和 DSH 保存的 Key 互不覆盖。删除操作只允许删除 DSH 保存的 Key，不会删除环境变量。

方式二：WorkBuddy 账号令牌

1. 选择 令牌登录 模式；
2. 点击“令牌登录”（已有账号时为“添加账号”），插件会打开 WorkBuddy 中国站；
3. 在浏览器完成账号登录；
4. 返回 DSH 后，账号会保存到本地凭据并自动启用。

…