dsh-router-codebuddy
dsh-router 的 CodeBuddy 供应商插件
快速安装 · 能力 · dsh-router 核心
为 dsh-router 提供 codebuddy 供应商（OAuth 轮询登录，OpenAI 兼容网关）。
单独装它没用——它只是向核心注册一个供应商，面板、账号池、组合回退都在核心里。
快速安装
先装核心，再装本插件，然后重启 dsh web：
dsh plugin --profile web add dsh-router-core
dsh plugin --profile web add dsh-router-codebuddydsh plugin add 会在 profile 里 pnpm add，并自动把声明了 dsh.bundle.patch
的包加入 dsh.profile.bundles（本插件即声明了，即 cordis.patch.yml）。
重启后本插件以 cordis service router.suppliers 向 dsh-router 注册 codebuddy
供应商，面板「供应商」出现 CodeBuddy 卡片。
本地开发版：不用 npm，直接
dependencies加
"dsh-router-codebuddy": "link:/path/to/dsh-router-codebuddy"指向本地仓库。
能力
| 能力 | 说明 |
|---|---|
| OAuth 轮询登录 | 生成登录链接 → 浏览器登录 → 后台轮询 token（每 5s，最多 5 分钟），自动落盘凭证。无粘贴回调步骤。 |
| 模型列表 | 「获取模型」从上游 GET /v3/config 实时拉取（带账号 token，服务端下发，GLM-5.3 / Kimi-K3 这类新模型上游一上线就能刷出来）；上游不可达时回退内置兜底表；仍可手动添加自定义模型。 |
| 连接池 | 多账号由核心按池顺序/策略（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 让核心顶上次的值。 |
使用
- 重启
dsh web - 面板 → 供应商 → CodeBuddy 卡片 → 添加链接 → 浏览器登录 → 完成添加
新增的 CodeBuddy 账号会出现在面板账号池中；模型在供应商详情页点「获取模型」从上游
拉取（列表随服务端下发更新，无需升级插件），仍可手动添加自定义模型。
/v1/chat/completions 请求模型可写 glm-5.3-flash 或带别名前缀
codebuddy/glm-5.3-flash（插件自动剥前缀）。
模型从哪来：
GET https://copilot.tencent.com/v3/config—— CodeBuddy 官方客户端
取云端产品配置的同一接口。它不鉴权也返回 200，但data.models只有在带账号
accessToken 时才下发；所以必须先添加链接再点获取模型，没账号时只会拿到内置兜底表。
回包里的生图/视频模型（tags含text-to-image等）走不了/v2/chat/completions，
会被过滤掉。
与核心的分工
本插件只管对单个账号调通上游：OAuth 协议、token 刷新、SSE 转换、签到、积分。
策略全在核心（AccountPool）：选号、冷却、禁用、连续错误累计、遍历回退、
响应写入。所以：
chatOnce(uid, req)一次只服务一个账号，不遍历账号、不维护冷却表、不写响应- 失败时返回语义状态（
rate_limit/quota/session_dead/unavailable/
transport/unknown），由核心决定冷却多久、是否禁用、要不要换号 status()只报「现在状态」（凭证 + 积分），冷却/禁用由核心叠加后给面板- 积分只报值，不落盘：拿不到时报
-1（不是 0），核心保留上次持久化的值
完整契约见 dsh-router 的 docs/suppliers.md。
上游
- chat：
POST /v2/chat/completions（强制流式，非流式上游拒绝；转成 OpenAI SSE 交回核心写，成败与语义状态报给核心换号） - 模型：
GET /v3/config→data.models[]（id/maxInputTokens/tags）；不鉴权也 200 但models为 null，必须带账号 token - 登录：
POST /v2/plugin/auth/state生成链接 → 浏览器登录 → 轮询GET /v2/plugin/auth/token?state=...（每 5s，最多 5 分钟）换 token 落盘 - 刷新：
POST /v2/plugin/auth/token/refresh（X-Refresh-Token头，到期前 24 小时内触发） - 凭证：
auths/codebuddy/{uid}.json（{nickname, accessToken, refreshToken, expiresAt}）
架构
通过 cordis service router.suppliers 的共享聚合表向 dsh-router 注册 codebuddy
供应商工厂（cordis 每个 service name 只允许一个插件 provide，本插件 inject 等其它
插件先提供该表后追加并广播 internal/service 触发重扫，与加载顺序无关）。
src/
index.ts 插件入口（host 半，通过 cordis service router.suppliers 暴露供应商工厂表）
plugin.ts codebuddy 供应商实现（OAuth 登录、单账号 chat、token 刷新）
contract.ts 供应商契约（自含，与 dsh-router 契约同步）
types.ts 通用类型（SupplierStatus / ChatRequest 等）
cordis.patch.yml bundle patch，把插件插入 DSH cordis bundle stack开发
pnpm install
pnpm build # lib/index.js
pnpm typecheck致谢
- decolua/9router —— codebuddy-cn（open-sse）实现的参考来源。