dsh-router-codebuddy

<h1 align="center">dsh-router-codebuddy</h1><p align="center">dsh-router 的 CodeBuddy 族供应商插件（国内 CodeBuddy + 国际版 WorkBuddy）</p><p align="center"> <a href="https://www.npmjs.com/package/dsh-router-codebuddy"><img src="https://img.shields.io/npm/v/dsh-router-codebuddy?style=flat-square&logo=npm&label=npm" alt="npm version"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-10b981?style=flat-square" alt="MIT license"></a> <a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="支持的 DSH 版本：0.1.5-rc.1+" src="https://img.shields.io/badge/DSH-0.1.5--rc.1%2B-4d6bfe" /></a> </p><p align="center"> <a href="#快速安装">快速安装</a> · <a href="#两个供应商">两个供应商</a> · <a href="#能力">能力</a> · <a href="https://github.com/CARVIN94/dsh-router#readme">dsh-router 核心</a> </p>

为 dsh-router 提供腾讯 CodeBuddy 族的两个供应商 （OAuth 轮询登录，OpenAI 兼容网关）。单独装它没用——它只是向核心注册供应商，面板、账号池、 组合回退都在核心里。

两个供应商

供应商 id	面板名	上游	别名前缀
codebuddy	CodeBuddy	copilot.tencent.com（国内版）	codebuddy/
codebuddy-en	CodeBuddyEN	www.workbuddy.ai（WorkBuddy 国际版）	codebuddy-en/

WorkBuddy 是腾讯的国际版 AI 办公工作台，与国内 CodeBuddy 同族同契约：同样的 OAuth 轮询登录、同样的 /v2/chat/completions 网关、同样的 /billing/meter/* 签到积分。 因此两者共用同一份实现（src/core.ts），差异只落在各自的 profile 上：

src/
  core.ts       共享实现 —— OAuth 登录、单账号 chat、token 刷新、签到、积分、模型拉取
  cn.ts         codebuddy profile    （copilot.tencent.com：/v2 单路径、CLI 指纹头）
  en.ts         codebuddy-en profile （www.workbuddy.ai：/console→/v2 回退、桌面端指纹头、接口归一）
  index.ts      插件入口（host 半，一次注册两个供应商）
  contract.ts   供应商契约（自含，与 dsh-router 契约同步）
  types.ts      通用类型（SupplierStatus / ChatRequest 等）
cordis.patch.yml  bundle patch，把插件插入 DSH cordis bundle stack

快速安装

需要 DSH 0.1.5-rc.1 及以上。先装核心，再装本插件，然后重启 dsh web：

dsh plugin --profile web add dsh-router-core
dsh plugin --profile web add dsh-router-codebuddy

dsh plugin add 会在 profile 里 pnpm add，并自动把声明了 dsh.bundle.patch 的包加入 dsh.profile.bundles（本插件即声明了，即 cordis.patch.yml）。

重启后本插件以 cordis service router.suppliers 向 dsh-router 注册两个供应商， 面板「供应商」出现 CodeBuddy 与 CodeBuddyEN 两张卡片。

本地开发版：不用 npm，直接 dependencies 加 "dsh-router-codebuddy": "link:/path/to/dsh-router-codebuddy" 指向本地仓库。

能力

能力	说明
OAuth 轮询登录	生成登录链接 → 浏览器登录 → 后台轮询 token（每 5s，最多 5 分钟），自动落盘凭证。无粘贴回调步骤。
模型列表	「获取模型」从上游 GET /v3/config 实时拉取（带账号 token，服务端下发，新模型上游一上线就能刷出来）；上游不可达时回退内置兜底表；仍可手动添加自定义模型。
接口归一（仅国际版）	chat 出站前 developer → system、tool_choice 对象形态 → string、首条非 system 时前置兜底 system —— 规避上游 11128 first message is not system prompt / 11101 Unmarshal chat params failed。
连接池	多账号由核心按池顺序/策略（fallback / round-robin）选号回退，本插件只报告单个账号的成败与语义状态。
token 自动刷新	到期前 24 小时内用 refresh token 刷新（X-Refresh-Token 头），刷新失败继续用旧 token。
签到领积分	每日 100 积分（连续第 7 天 1000），核心遍历所有链接逐个调用。已签到上游返回 code=10001（HTTP 400 + 该码），幂等视为成功。
积分显示	面板账号积分 = get-user-resource 各额度包的剩余求和（CapacityRemain，会续期的基础包取 CycleCapacityRemain），内存缓存 10 分钟，签到后自动刷新。注意 TotalDosage 是累计已消耗，不是剩余。积分的持久化由核心统一做（supplier-config.json），本插件拿不到时报 -1 让核心顶上次的值。

使用

1. 重启 dsh web
2. 面板 → 供应商 → CodeBuddy / CodeBuddyEN 卡片 → 添加链接 → 浏览器登录 → 完成添加

新增账号会出现在面板账号池中；模型在供应商详情页点「获取模型」从上游拉取 （列表随服务端下发更新，无需升级插件），仍可手动添加自定义模型。 /v1/chat/completions 请求模型可写 glm-5.3-flash 或带别名前缀 codebuddy/glm-5.3-flash（插件自动剥前缀）。

模型从哪来：GET <base>/v3/config —— 官方客户端取云端产品配置的同一接口。 它不鉴权也返回 200，但 data.models 只有在带账号 accessToken 时才下发；所以必须 先添加链接再点获取模型，没账号时只会拿到内置兜底表。回包里的生图/视频模型 （tags 含 text-to-image 等）走不了 chat 端点，会被过滤掉。

上游

国内 CodeBuddy（https://copilot.tencent.com）：

• chat：POST /v2/chat/completions（强制流式，非流式上游拒绝；转成 OpenAI SSE 交回核心写）
• 模型：GET /v3/config → data.models[]（id / maxInputTokens / tags）
• 登录：POST /v2/plugin/auth/state 生成链接 → 浏览器登录 → 轮询 GET /v2/plugin/auth/token?state=... 换 token 落盘
• 刷新：POST /v2/plugin/auth/token/refresh（X-Refresh-Token 头，到期前 24 小时内触发）
• 积分/签到：POST /v2/billing/meter/get-user-resource、POST /billing/meter/daily-checkin
• 凭证：auths/codebuddy/{uid}.json（{nickname, accessToken, refreshToken, expiresAt}）

国际版 WorkBuddy（https://www.workbuddy.ai）—— 与上面同契约，差异在路径与指纹：

• chat：POST /console/chat/completions，404/405 回退 POST /v2/chat/completions；出站前做接口归一（见上表）
• 积分/签到：POST /billing/meter/*（无 /v2 前缀），404 回退 /v2/billing/meter/*
• 出站指纹头：UA WorkBuddy/5.5.4 WorkBuddy AI/5.5.4 CLI/2.137.1、同域 Origin/Referer、Accept-Language: en-US、X-No-Enterprise-Id: 1
• 凭证：auths/codebuddy-en/{uid}.json

与核心的分工

本插件只管对单个账号调通上游：OAuth 协议、token 刷新、SSE 转换、签到、积分。

策略全在核心（AccountPool）：选号、冷却、禁用、连续错误累计、遍历回退、 响应写入。所以：

• chatOnce(uid, req) 一次只服务一个账号，不遍历账号、不维护冷却表、不写响应
• 失败时返回语义状态（rate_limit / quota / session_dead / unavailable / transport / unknown / no_such_model / bad_request），由核心决定冷却多久、 是否禁用、要不要换号。bad_request = 请求本身被上游拒（参数错 / 图片认不出 / tool_call 配对断裂），同一个请求对池里每个号都会失败，所以核心不惩罚账号—— 否则一次坏请求会把整个池冷掉（2026-09-15 读图事故）。
• status() 只报「现在状态」（凭证 + 积分），冷却/禁用由核心叠加后给面板
• 积分只报值，不落盘：拿不到时报 -1（不是 0），核心保留上次持久化的值

完整契约见 dsh-router 的 docs/suppliers.md。

架构

通过 cordis service router.suppliers 的共享聚合表向 dsh-router 注册两个供应商工厂 （cordis 每个 service name 只允许一个插件 provide，本插件 inject 等核心先提供该表后 追加并广播 internal/service 触发重扫，与加载顺序无关）。

两个供应商 id 即凭证与配置的存储键：凭证在 credentials.sqlite、配置与积分缓存在 supplier-config.json，均以 supplier id 寻址，故两个供应商各自独立、互不影响。

开发

pnpm install
pnpm build        # lib/index.js
pnpm typecheck
pnpm test         # 行为回归闸门（node --test）

src/core.test.ts 锁的是 profile 边界：国内侧不多发 system、不动 tool_choice、 只打 /v2；国际侧三个接口归一存在且顺序正确（补 system 必须在改 role 之后）； 端点回退只在 404/405 触发；两个 id / 存储键 / uid 前缀不变。改 profile 改错会直接变红。

致谢

• decolua/9router —— codebuddy-cn（open-sse）实现的参考来源。
• Sliverkiss/workbuddy2api —— 国际版 WorkBuddy 的路径/指纹/接口归一参考。

许可证

MIT

免责声明

本项目仅用于学习与技术研究，请勿用于商业用途。