WorkBuddy 模型接入 molly-ovo/dsh-workbuddy-oauth

dsh-workbuddy-oauth

把 WorkBuddy / CodeBuddy 的模型接入 DeepSeek Harness。

国内版与国际版各一套端点，自己走 OAuth 设备码流程——不读桌面 App 的凭据文件，所以不用装桌面 App，也不受它的安装位置、凭据加密格式与版本号影响。密码不经过本插件：授权在浏览器完成，插件只拿令牌。

- 多账号——同时登录多个，选号时自动跳过被限流的；某个账号额度耗尽只停它一个，其余照常服务。
- 会话粘性——同一个对话粘住同一个账号，不会中途换人；但不粘坏账号，下一条消息就换到健康的那个，上下文不丢。

安装

前置：pnpm 在 PATH 上、Node.js ^22.19.0 || >=24.0.0，以及一个 WorkBuddy / CodeBuddy 账号（国内版或国际版均可）。不需要安装桌面 App——登录由本插件自己走 OAuth 设备码流程完成。

要求 DSH 0.2.0-rc.2 或更高。 本插件的 peer 依赖声明为 ^0.2.0-rc.2，不再支持 0.1.x 与 0.2.0-rc.1：DSH 在 0.2.0 把设置服务换成了 Config 表单门面，同时把 pi-ai 升到 0.87（Context 类型收窄），跨代混用会出现两套 pi-ai 并存。只跟最新一代，省掉这层兼容负担。

从 GitHub 安装（推荐）

dsh plugin --profile web add github:molly-ovo/dsh-workbuddy-oauth
dsh web

本仓库包含构建好的 lib/，所以这一步不需要 pnpm install、也不需要构建，装完即可用。

从本地源码安装

git clone https://github.com/molly-ovo/dsh-workbuddy-oauth.git
dsh plugin --profile web add ./dsh-workbuddy-oauth

两种方式的共同点

dsh plugin 会把参数转发给 pnpm 在 profile 目录里执行，成功后自动对账 dsh.profile.bundles——本插件声明了 dsh.bundle.patch，装上即接管模型目录，无需手改 profile 文件。web profile 首次使用时自动从模板初始化。

装完刷新浏览器。模型 provider 目录在进程启动时组成；若模型没出现，重启 dsh web。

升级：重新执行一次安装命令即可。GitHub 形式的依赖在 lockfile 中锁定 commit SHA，不会自动跟随新提交，需要重新 add 来重新解析。

确认已生效——运行 /wb-status 应有输出。若没有：确认该 profile 的插件行 enabled、llm-workbuddy-oauth 已注册，并检查「插件」页是否能看到本条目。

卸载：

dsh plugin --profile web remove dsh-workbuddy-oauth

账号凭据与插件状态都在 $DSH_HOME/workbuddy-oauth/ 下，卸载不会删除；要彻底清理请手动删该目录（见隐私）。

用法

登录：卡片顶部「登录 · 国内版 / 国际版」→ 浏览器完成授权 → 回卡片点「我已完成授权」。也可以直接用命令，两条路径走的是同一套实现。

| 命令 | 作用 |
| /wb-login [cn \| global] | 登录（默认 cn），会弹出可直接点击的授权链接 |
| /wb-status | 查看已登录账号、区域、令牌有效期 |
| /wb-account [enable\|disable] <uid 前缀> | 启用 / 停用账号 |
| /wb-logout [uid 前缀] | 退出登录（只删本插件保存的凭据，不动上游账号） |

登录、状态、账号管理与积分查询也可在 设置 → 插件 → DSH WorkBuddy OAuth 卡片中完成。composer 输入区右侧另有一个探测控件，用于探测当前模型的推理档位。

探测会向上游发出真实请求并消耗少量积分，因此有二次确认。

工作原理

DSH 模型选择器 └─ pi-ai adapter（注册 provider route） └─ 回环端点 127.0.0.1，进程内，带一次性共享密钥 └─ 上游 copilot.tencent.com / www.workbuddy.ai 等

- 无常驻进程、无对外端口。 回环端点在本插件进程内，只绑 127.0.0.1，并校验进程内生成的共享密钥。
- 凭据每账号一文件，原子写入，权限 0600。
- 令牌刷新惰性触发（过期前 5 分钟），进程内单飞 + 跨进程文件锁——上游会轮换 refresh token，并发刷新会让第二个请求送出已被消费的令牌。
- 设备指纹按 uid 稳定派生，同账号恒定、跨账号隔离；登录流程不带指纹。

同类方案的凭据来源主要有三种，本插件选了第一种：

| 路线 | 凭据来源 | 需要桌面 App | 代表实现 |
| 本项目 | 自己的 OAuth 设备码流程 | 不需要 | — |
| 读桌面凭据 | 桌面 App 的本地文件 | 需要 | dsh-workbuddy-connect |
| 外部代理进程 | 本地网关进程 | 视实现而定 | workbuddy2api 系（如 tearslee/dsh-workbuddy2api） |
代价是要自己维护登录流程；换来的是不依赖桌面端的安装位置、凭据加密格式与版本号。

为什么不 fork

本插件没有 fork dsh-workbuddy-connect，而是把它需要的模块移植（vendor）进来。

主要原因是两者的取舍不同：connect 复用桌面 App 的凭据文件，本插件改为自己走 OAuth 设备码流程。改动集中在凭据来源这一层，但会牵动登录、刷新、状态落盘等多处，改到后来已经不太像同一个项目。

另一个考虑是我自己的：fork 在 GitHub 上是一种公开的关联，会出现在上游的 fork 列表里。我的这种做法上游作者未必认同，不想因为自己的选择给他添麻烦，所以没有走 fork。

代价是上游后续的修复不会自动进来，需要自己留意。另外，移植部分的出处与重合度都逐文件标注在鸣谢中，LICENSE 也声明了本项目包含来自其他 MIT 项目的代码——如果其中有任何不妥，欢迎指出，我会调整。

跟进上游

本仓库没有配置 upstream remote。想对比上游改动时可以临时加一个只读远程：

git remote add upstream https://github.com/corrinehu/dsh-workbuddy-connect.git
git fetch upstream
git diff upstream/main -- src/upstream.ts

只用来查看差异、手动挑拣，不推送。

二次开发

改了 src/ 之后需要重新构建：

cd /path/to/dsh-workbuddy-oauth
pnpm install
pnpm build # 重新生成 lib/index.js 与 lib/client.js

pnpm 对本地目录默认以链接方式安装，所以构建完 profile 会即时拿到新产物，无需重装。改完客户端半边刷新浏览器即可；改动宿主半边（lib/index.js）需要重启 dsh web。

提交产物就意味着要一起提交。 改完 src/ 请务必 pnpm build 并把 lib/ 一并提交，否则仓库里的产物会落后于源码——而别人 clone 到的正是那份产物。

隐私

账号昵称在上游常常就是手机号或邮箱。所有会显示昵称的地方（/wb-status、/wb-account、设置页卡片、状态文档）都经过同一层脱敏：

| 类型 | 原始 | 显示 |
| 手机号 | 13800138000 | 13*00 |
| 邮箱 | alice1990@example.com | al90@example |

手机号只保留前 2 位与末 2 位（11 位中隐藏 7 位）；邮箱保留本地部分前 2 位与末 2 位、中间固定一个星号，并去掉域名末段（.com）。

邮箱之所以不做成 a@example.com 那样「按实际长度打星」，是因为账号名要出现在列表里——星号数随地址长度增长，会把整列撑宽。固定成一个星号，标签宽度才有上界。

脱敏只作用于显示：凭据文件里保留原始值，功能不受影响。日志里只记录 uid 的前 8 位，从不记录昵称。

登出会删掉什么：/wb-logout（以及设置页的「登出」）清除该账号的全部痕迹，而不只是凭据文件：

| 位置 | 内容 |
| accounts/workbuddy-<uid>.json | 访问令牌、刷新令牌、昵称、企业 id |
| cooldowns.json | 该账号的失败冷却记录 |
| disabled-accounts.json | 该账号的启用 / 停用状态 |
| probe-<region>.json | 该账号的推理档位探测记录 |

这四类都以 uid 为键，只删凭据会让 uid 继续留在其余文件里——既是隐私问题（uid 是账号标识），也会在同一个账号再次登录时让旧的停用状态或探测结论悄悄生效。

所有状态都在 $DSH_HOME/workbuddy-oauth/ 下，删除该目录即可完全重置。

注：/wb-account disable 是可逆的，只把账号移出选择，凭据与状态都保留；只有登出才会删除。

配置

插件行接受以下配置（在 profile 的 cordis.patch.yml 中设置）：

| 字段 | 默认 | 说明 |
| region | cn | 默认区域，cn 或 global |
| appVersion | "" | 出站身份中的客户端版本号，留空用内置兜底值 |
| cliVersion | "" | 出站身份中的 CLI 版本号，留空用内置兜底值 |

已知限制

- 依赖上游非公开接口。 WorkBuddy / CodeBuddy 更新后，本插件可能需要随之调整。
- 推理档位需手动探测。 上游未提供档位元数据，只能靠实际请求试出来；探测会消耗积分。
- 国际版与国内版是两套账号体系，额度互不通用，需分别登录。
- 模型目录随上游变化，本地缓存可能滞后。
- 失败换号要等到下一次请求。 某账号被限流或额度耗尽时，当前这次请求仍会返回错误；该账号被冷却后，下一次请求才会自动落到另一个可用账号上。

插件不做请求内重试：流式响应一旦开始就无法透明重发，且同一个请求体换账号重发会放大上游风控风险。DSH 自身的重试层在重试时会重新走一遍选号，所以实际体验通常是「偶发一次报错后自动恢复」。

同一个对话也不例外——会话粘性不会把你钉在坏账号上，下一条消息就会换到健康账号，上下文不丢（消息由 DSH 持有，不在账号上）。

- 「最大上下文窗口」开关只影响国际版。 国内版没有任何模型声明多档窗口，因此该开关只在国际版区块出现。

免责声明

- 本项目仅供个人逆向学习与技术研究使用，请勿用于商业用途或超出个人合理使用的场景。
- 使用者需遵守任一官方的服务条款，并自行承担因使用本项目产生的任何后果（包括但不限于账号被限制、额度被清空、服务中断）。
- 本插件只使用你自行登录后获得的令牌，不收集、不上传任何凭据到第三方服务器。
- 本项目与任一官方均无关联，未获其授权或认可；文中出现的名称仅用于描述兼容关系，商标权利归各自所有。
- 本项目作者不对因使用或滥用本项目产生的任何直接或间接损失负责。
- 本项目由 AI 参与移植与改写，可能存在缺陷，请自行评估风险。若无意侵犯任意一方的权益，请联系我，我会立即删除相关内容。

鸣谢

本插件站在若干开源项目的肩膀上。以下项目或提供了被移植的代码，或提供了关键的对照实现与线路行为参考——没有它们，这个插件不会存在。

| 项目 | 作者 | 本插件使用了什么 |
| dsh-workbuddy-connect | Corrine Hu | 最主要的上游。核心模块直接移植自此上游。 |
| Sliverkiss/workbuddy2api | Sliverkiss | 设备指纹派生算法 derive_id；线路行为经 connect 间接源自此项目。 |
| workbuddy2api-hub | ardeyouxipianyi | 指纹方案的实测依据；登录流程、刷新单飞、惰性刷新等防风控规则的对照实现 |
| workbuddy2api-panel | linguo2625469（fork） | 登录状态落盘防混域、登录 TTL 与轮询限速等对照实现 |

关于 Sliverkiss/workbuddy2api：该上游项目已删除。

特别感谢 Corrine Hu——dsh-workbuddy-connect 是这一切的起点，本插件与它的差别只在于去掉桌面端凭据解密（desktop-credential-protection.ts 未被使用），其余绝大部分逻辑都源于它的实现与逆向工作；Sliverkiss——workbuddy2api 系列对上游接口的整理与指纹方案，是本插件能与 WorkBuddy 通信的前提；ardeyouxipianyi——workbuddy2api-hub 提供的指纹实测依据与防风控对照实现，让选号与刷新策略有据可循。

本插件运行在 DSH（DeepSeek Harness） 之上，并依赖其客户端插件体系（@deepseek-ai/dsh）。设置卡片的按钮交互样式对齐了 DSH 自带的 dsh-client-ui-primitives，主题色全部使用其 --dsw-alias- 令牌。

许可

MIT，见 LICENSE。