dsh-connect

一个 DSH 插件：把 WorkBuddy（含企业版，账号数不限）、Trae、Qoder CN 三个渠道的模型 一次接进 DSH，并给它们配一块统一面板 —— 看状态、签到、增删渠道，都在这一块里完成。

2026-09-24 由四个插件合并而来：dsh-workbuddy-connect + dsh-trae-connect + dsh-qoder-connect + dsh-connect-hub。

这是干什么的

这三个渠道各自都有官方客户端，但在 DSH 里用起来是三套东西：分别装、凭据散在三处、 状态要在不同地方看。这个插件把三件事收拢在一起：

• 模型：三家模型进同一个模型选择器，选谁就是谁，不用来回切插件；
• 状态：所有账号的登录、额度、今日签到，一屏看完；
• 渠道：加号、换号、停用、删除，在一个面板里点完。

有什么功能

三家都能由本插件直接领取（不需要回各自的桌面 App）：

⚠️ Qoder 那条依赖 Cosy-ClientType: 10。写成 5 时服务端不报错，只回一份 「没有任何活动」的空文档，看起来就像"这个账号没有签到活动" —— 2026-09-27 踩过一次。 细节见 lib/providers/qoder/index.js 的 COSY_OPENAPI_CLIENT_TYPE。

⚠️ WorkBuddy 的「今天签没签」没有只读来源：它的签到看板 （/v2/billing/meter/checkin-status）在活动未开放时整份都是默认值，当天已签到也依然如此 （active:false / today_checked_in:false / week_progress 全 false）；唯一可靠来源是幂等的 daily-checkin。所以侧栏角标和面板必须走同一条带 auto=1 的请求 —— 曾经角标不带， 结果角标恒显示「可签 2」而面板显示「已签」，看起来就是"角标不准"（2026-09-27 用户报障）。 两处注释都标了「别改回去」，细节见 lib/panel-client.js 的 useHubStatus。

怎么用

一、看状态：左侧栏的「渠道中心」

入口在左侧栏底部，和「用量统计」「上下文洞察」「记忆」排在一起。有可领的额度时， 它右边会亮一个「可签 N」的标签；侧栏收成图标条时，就是一个带小圆点的图标。

点开是面板：

• 顶部一句话汇总：已登录几个、已签几个、哪些不适用；
• 中间每个渠道一行：左边状态点 + 账号（打码显示），右边是这一行的签到动作； 下一行是额度进度、重置时间、模型数；
• 底部是「一键签到」，以及两个开关 —— 打开面板时自动签到、在左侧栏显示入口。

面板开着时每两分钟自动刷新；关掉就不再轮询，不会在后台一直打接口。

二、管渠道与凭据：认证页

点面板右上角「认证」切过去，这里列出每个渠道的凭据落点和当前登录状态。

每行右边四个动作：

• 改名 —— 只改显示名，不动凭据；
• 粘贴 —— 把凭据内容贴进去，直接写进该渠道的文件，最多 30 秒生效；内容不会回显， 也不会进 DSH 的设置文件；
• 停用 —— 该渠道的所有模型从模型选择器消失、也不参与一键签到，但凭据留着， 随时可以启用回来（立刻生效）；
• 删除 —— 连凭据一起删掉（要点两次确认），槽位回到空闲，可以重新添加。

底部「创建槽位」用来加新渠道：选类型、填一个 id、写个显示名。WorkBuddy 能加任意多个， Trae 和 Qoder 各一个。新增之后面板里立刻能看到这一行，但要重启 DSH 之后， 它的模型才会进模型选择器。

扫码登录：不需要桌面 App

WorkBuddy 渠道可以自己扫码登录，不再依赖桌面 App —— 机器上没装 WorkBuddy、 或者它装在另一台机器上，都能接。

在认证页对着那一行点 「扫码」，弹窗会给出一个链接：

https://copilot.tencent.com/login?platform=CLI&state=…

那个页面自带二维码，用微信/QQ 扫；也可以直接用浏览器打开，它有手机号 + 短信登录。 授权完成后令牌由容器内的插件写进它自己的副本 ~/.dsh/.<渠道 id>-auth.json （如 .workbuddy1-auth.json，0600）—— 令牌既不经过浏览器，也不经过驱动脚本。 弹窗自己轮询，成功即写入，不用再点任何按钮。

不想开面板也可以在宿主机跑 scripts/wb-login.mjs（-v 2 换国际版、 --open 直接打开浏览器、--wait 改超时），它走的是同一对路由。

三条要知道的：

• 授权码 15 分钟有效，而且腾讯那边不区分「还在等」和「码根本不存在」 —— 两者都回 code 11217。所以过期时间只能我们自己算，那个 15 分钟是本地时钟； 弹窗上的倒计时状态也是它。
• 一个码只消费一次：拿到授权就作废；即使写盘失败也要重新扫，不会重复写凭据。
• 扫码会「接管」这个槽位：授权完成后该槽位就用你扫的号 —— 即使那个槽位上 已经有别的账号（connect-auth/workbuddy<N>.json 那份「粘贴」凭据）。 原凭据文件不会被改动，弹窗会说明替换了谁；想退回原账号， 删掉插件副本 ~/.dsh/.<渠道 id>-auth.json 即可（双向可逆）。

怎么扫码登录一个新账号

• 空闲槽位（workbuddy4/5/6…）：直接点它的「扫码」。每个槽位有自己的凭据文件， 互不影响 —— 这就是加新号的正路。
• 换掉某个槽位上的账号：直接点那一行的「扫码」，会接管。
• 刚新增的槽位：要先重启 DSH（见下面的警告），认证页会把还没装载的槽位置灰并说明。

⚠️ 别在等待扫码时重启 DSH：登录会话只在内存里（TTL 15 分钟）， 重启会把已发出的授权码作废，只能重新点「扫码」。

⚠️ 刚新增的槽位要重启 DSH 之后才能扫码：provider 侧只在启动时按注册表装载渠道， 面板的行却是每次现读注册表 —— 所以新槽位立刻会出现在认证页，但它的路由（status/login） 都还不存在。认证页对这种槽位会把「扫码」置灰并说明原因（重启后自动可点）。

凭据放在哪

三家读同一个目录：容器里是 /root/.dsh/connect-auth/，宿主机就是 ~/.dsh/connect-auth/。 一个渠道一个文件，都是 0600 明文 —— 所以别提交进 git，也别贴到公开的地方。

凭据的格式

workbuddy1.json —— 就是桌面 App 存的那份结构，外层是账号、里层是令牌：

{
  "account": { "nickname": "…", "phoneNumber": "…", "type": "personal" },
  "auth": {
    "accessToken": "…",
    "refreshToken": "…",
    "expiresAt": 1790000000000,
    "tokenType": "Bearer",
    "domain": "www.workbuddy.cn"
  }
}

企业版账号在这个结构里带企业标识，插件据此改发企业版请求头、并改问企业版额度接口 —— 个人版接口对企业号会返回空账户表，界面上就成了"0 积分"。

trae.json —— 由导出脚本生成，字段固定：

{
  "formatVersion": 1,
  "gateway": "https://…",
  "appVersionCode": 1227681842690,
  "token": "…",
  "refreshToken": "…",
  "userId": "…",
  "deviceId": "…",
  "account": { "username": "…", "scope": "marscode" }
}

三个字段是承重的：deviceId 缺了签到会被上游拒（9004）；appVersionCode 是倍率接口的 筛选键，写错或漏掉不报错，只是倍率整列空白；token 过期则模型直接不可用。

qoder-session.json：

{ "token": "dt-…", "refreshToken": "…", "expiresAt": "2026-10-23T17:10:56Z", "uid": "…" }

怎么获取

凭据都在各个桌面 App 的加密存储或系统钥匙串里，所以只能在装了对应 App 的机器上导， 导完直接落在上面那个目录，30 秒内生效，不用重启。导出脚本随插件一起发布 （就在本仓库的 scripts/ 下），统一入口是一条命令：

node scripts/export-connect-credentials.mjs                          # 能自动导的全导 + 只读校验
node scripts/export-connect-credentials.mjs workbuddy --account 2    # 只导某个账号
node scripts/export-connect-credentials.mjs trae
node scripts/export-connect-credentials.mjs qoder                    # 自动解 App 登录态
node scripts/export-connect-credentials.mjs qoder --pat pt-xxxx      # 或直接给官方 PAT
node scripts/export-connect-credentials.mjs verify                   # 只校验，不写文件

各家要注意的地方：

• WorkBuddy —— 凭据由 App 自带的 Electron 解封。App 同时只保持一个登录， 要导哪个账号就先在 App 里切到哪个；个人号与企业号各导一次。
• Trae —— 登录态在客户端本地库里，解密是纯算法、不碰系统钥匙串，装过 Trae 就能导。
• Qoder —— 优先解 App 的本地会话，读钥匙串时系统可能弹一次授权框； 解不出来就用官方 PAT 兜底。

不想跑脚本：认证页每行的「粘贴」接受凭据原文，直接写进对应文件 —— 适合从别的机器拷一份过来、或者临时换账号。

脚本默认去连名为 dsh-harness 的容器读面板状态（只读校验那一步），换个部署名用 DSH_CONTAINER=… 覆盖即可；在容器里跑时这一步会自动跳过，不影响导出本身。

三、选模型：倍率就在名字里

模型选择器里每个模型名后面跟着它当前的倍率，一眼能看出哪家便宜。

• 倍率是实时取的，不是写死的常量 —— 各家调价后会跟着变；
• 写法跟各自平台一致：WorkBuddy 是 x0.11 这种，Trae 是 x0.72，Qoder 是 0.5×；
• 个别模型后面没有倍率，是上游本身没给（比如 Qoder 的 Qwen3.8-Flash），不是漏了。

四、挑模型：不想看的可以关掉

渠道行上有个「模型 N」按钮，点开是勾选列表：勾上就出现在模型选择器里，取消就不出现， 改完立刻生效。整条渠道都不想要，「认证」页的「停用」更省事。

什么时候需要重启

排错

先看面板：每一行的状态点和文字已经说明了大半问题，那一行异常时下面通常还会跟一句错误说明。

更多

• docs/ 里放着面板设计、各渠道的接入方案与排错笔记；
• 想看实现细节（倍率从哪取、为什么这么接线、踩过哪些坑），看源码注释 —— 每个文件头部 和关键函数上都有说明。