DSH WorkBuddy Provider

在 DeepSeek Harness（DSH）桌面端和 WebUI 中使用 WorkBuddy 中国区模型，支持 API Key 和账号登录。

本插件是第三方适配工具，不属于 WorkBuddy 或 DSH 官方项目。使用前需准备有效账号或 API Key。

功能

功能	说明
两种认证方式	支持 API Key、浏览器账号登录，可随时切换
多凭据管理	添加、切换和删除多个 API Key 或登录账号
会话独立选择	可为不同会话分别指定账号或 API Key
模型管理	获取可用模型，添加、编辑、删除模型或恢复在线目录
模型参数	按模型配置上下文窗口、最大输出 Token 和思考档位
账号用量	令牌模式下查看剩余积分、今日请求次数和积分用量
多端支持	支持桌面、Web 和 Headless 使用方式，兼容 ModLens 包装模型

不需要安装本机 WorkBuddy CLI。模型可用范围及用量以当前账号权限和服务返回结果为准。

环境要求

• 已安装 DSH，支持已声明兼容的旧版和 0.2.x 系列。
• Node.js >= 22.19.0。
• 支持 Windows、Linux、macOS。

DSH 升级到新版本系列后，请先确认插件兼容性。

安装与更新

桌面端

在 设置 → 插件 → 添加插件 中安装：

@axiaohungry/dsh-llm-workbuddy

也可以在终端执行，更新时使用同一条命令：

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

Web / Headless

一键安装或更新这两个 Profile：

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

仅安装 Web Profile：

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

安装或更新后，完整退出并重新启动 DSH。 只刷新页面不会完成更新。 更新可保留已有模型、账号和 Key 配置。

使用方法

1. 打开配置

桌面端进入 设置 → 插件 → WorkBuddy 插件详情。 WebUI 进入 设置 → 模型，添加或编辑 WorkBuddy 中国区。 具体入口可能随 DSH 版本略有不同。

2. 选择认证方式

API Key

1. 选择 API Key 模式。
2. 在“新增 API Key”中粘贴 Key，可填写便于识别的名称。
3. 点击“添加并使用”，或从下拉列表中选择已有 Key。

也可选择环境变量 WORKBUDDY_API_KEY；兼容已有的 CODEBUDDY_API_KEY。 API Key 模式不显示账号令牌积分。

令牌登录

1. 选择 令牌登录。
2. 点击登录或添加账号，在浏览器中完成登录。
3. 返回 DSH，选择要使用的账号。

支持保存多个账号。删除账号会移除该账号的本地登录凭据。

3. 选择模型

点击“获取可用模型”，选择需要的模型，再点击“保存模型”。 可按需修改模型名称、上下文窗口、最大输出 Token 和思考档位。

更换账号或 Key 后，建议重新获取可用模型。手动添加模型时，请确认模型 ID 和账号权限。 “恢复在线目录”会取消手工覆盖的模型列表。

4. 可选：为会话单独选择凭据

打开“会话级账号/API Key”开关后，可在新会话或输入框附近选择凭据。

• 未绑定会话首次调用时，使用当前默认选择。
• 已绑定会话继续使用自己的选择，不随全局默认值变化。
• 可单独切换或解除当前会话绑定。
• 关闭开关后使用全局选择；重新开启后恢复已有绑定。

账号模型权限不同时，还需选择该账号可用的模型。

近期解决的问题

1.3.25 主要改善：

• 部分会话出现 400 / 11128、请求失败的问题。
• 新旧 DSH 版本下系统指令、工具调用的兼容性。
• API Key 和令牌两种方式的调用一致性。

已完成自动化检查，并验证两种认证方式均可获取模型、发送请求及接收回复。 上游服务或 DSH 发生变化时，仍可能需要更新插件。

常见问题

问题	处理方法
找不到 WorkBuddy 提供方或设置入口	确认安装到正在使用的 Profile，完整重启 DSH 后再查看插件详情或模型设置
更新后仍是旧版本或旧界面	重新执行对应 Profile 的更新命令，完整退出并重新打开 DSH
API Key 下拉列表没有新 Key	在插件自己的“新增 API Key”区域提交，点击“添加并使用”
登录成功但调用使用了其他账号	检查是否启用了会话级凭据，并核对当前会话的绑定
获取模型失败或找不到模型	核对当前账号或 Key，重新获取目录；手动添加时检查模型 ID 和账号权限
返回 401 / 403	检查 Key 是否有效、账号是否过期，以及是否具有目标模型权限；必要时重新登录
返回 400 / 11128	更新到最新版本并完整重启；仍失败时记录业务码、插件版本和使用的模型后反馈
返回 500、空响应或请求长时间无结果	更新并重启，检查网络；使用包装模型时，也检查相应服务状态
不显示积分，或显示“暂不可用”	确认使用令牌模式；积分服务暂时不可用不一定影响模型调用
思考档位选项与其他模型不同	属于正常情况，按该模型显示的可用选项选择
ModLens 模型慢、超时或返回 429	检查 ModLens 视觉引擎的登录、网络和额度；纯文本任务可先切换 WorkBuddy 直连验证

查看桌面 Profile 的安装版本：

dsh plugin --profile desktop list --depth 0

Web 用户将 desktop 改为 web。ModLens 用户也可运行：

modlens doctor --json

反馈问题时，请提供插件版本、DSH 版本、模型名称、认证方式和脱敏后的错误信息。 不要公开 API Key、登录令牌或未经脱敏的完整日志。

卸载

桌面 Profile：

dsh plugin --profile desktop remove @axiaohungry/dsh-llm-workbuddy

Web / Headless 安装器：

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

卸载后重启 DSH。安装器默认保留凭据，便于后续重新安装。

License

MIT