前言¶
DeepSeek Harness（DSH）的生态理念是「一切皆插件」。在使用 dsh-router 时，若需接入腾讯 CodeBuddy 族服务（包含国内版 CodeBuddy 与国际版 WorkBuddy），dsh-router-codebuddy 是必要的供应商注册插件。该插件由开发者 CARVIN94 维护，核心功能是通过 dsh-router 向 DSH 注册两个供应商，提供 OAuth 轮询登录、模型列表获取及 OpenAI 兼容的网关能力。
核心功能¶
该插件通过 router.suppliers 服务向核心注册供应商，具备以下能力：
- OAuth 轮询登录：生成登录链接，浏览器登录后后台每 5 秒轮询一次 token，最多 5 分钟，自动落盘凭证，无需手动粘贴回调。
- 模型列表：通过
GET /v3/config实时拉取上游模型，不可达时回退内置兜底表，支持手动添加自定义模型。 - 接口归一（仅国际版）：针对国际版 WorkBuddy 做接口归一处理，将
developer映射为system，处理tool_choice对象形态，规避参数报错。 - 连接池：多账号管理由核心负责，本插件仅报告单个账号的成败与语义状态。
- token 自动刷新：在 token 到期前 24 小时内自动使用 refresh token 刷新，失败则继续使用旧 token。
- 签到领积分：每日签到 100 积分（连续 7 天 1000 积分），核心遍历所有账号逐个调用。
- 积分显示：面板显示
get-user-resource的剩余额度（CapacityRemain），积分持久化由核心统一处理。
安装与启用¶
本插件依赖 dsh-router-core 核心，安装前请确保已安装。安装并启用后，必须重启 dsh web 才能生效。
- 安装核心：
dsh plugin --profile web add dsh-router-core
- 安装本插件：
dsh plugin --profile web add dsh-router-codebuddy
- 重启服务：
dsh web
典型用法¶
重启完成后，在面板中操作：
- 进入面板的「供应商」页面，找到
CodeBuddy或CodeBuddyEN卡片。 - 点击「添加链接」，系统会打开浏览器窗口进行 OAuth 登录，登录成功后账号会自动添加到账号池。
- 在供应商详情页点击「获取模型」，从上游拉取模型列表。
- 在发起请求时，模型名称可使用
glm-5.3-flash，或带别名前缀使用codebuddy/glm-5.3-flash（插件会自动剥离前缀）。
适用场景与注意¶
- 依赖关系：单独安装此插件无法工作，必须先安装
dsh-router-core。 - 重启要求：安装命令执行完毕后，必须重启
dsh web，插件才会向核心注册供应商。 - 积分机制：积分的持久化存储由核心统一处理，插件仅在获取不到数据时返回
-1，由核心保留上次的持久化值。 - 本地开发：本地开发时，请在
dependencies中添加"dsh-router-codebuddy": "link:/path/to/dsh-router-codebuddy"，而非使用 npm 安装。
结语¶
dsh-router-codebuddy 为 DSH 用户提供了接入 CodeBuddy 族服务的标准接口。它通过统一的实现类处理国内与国际版的不同差异，配合 dsh-router 的连接池与回退策略，实现了稳定的多账号管理与模型调用。更多细节可参考项目源码或目录页。
