DSH WorkBuddy Connect

English | 简体中文

把 WorkBuddy（国际版 / 国内版）的模型接入 DeepSeek Harness（DSH）的社区插件。一个插件同时服务两条 WorkBuddy 产品线：一张设置卡片（卡片内用页签切国际版 / 国内版，和 Qoder 卡片同一套交互），各有一个 provider、一套凭证与模型目录，互不混用：

变体	provider id	卡片页签	上游站点
国际版	workbuddy-global	国际版	www.workbuddy.ai
国内版	workbuddy	国内版	copilot.tencent.com / www.codebuddy.cn

国际版当前限时免费：实测目录里有三个模型倍率是 x0.00——deepseek-v4.1-flash（DeepSeek-V4.1-Flash，300K/128K）、hy3（192K/64K）、step-5-preview（300K/64K）；另有 deepseek-v4.1-flash-sg 是 x0.03。免费是上游的活动，插件读取的是实时倍率——活动结束后卡片会自己把「免费」标记去掉，而不是继续挂着一个过期的承诺。

为什么需要插件，而不是直接配一个 provider

WorkBuddy 的网关是一套只认官方客户端的封闭接口，DSH 的原生适配器够不着它：

1. User-Agent 门闸：网关按 UA 分流，deepseek-harness/* 直接被拒（业务码 11128）。DSH 自己的适配器写死了这个 UA。
2. 首条消息必须是 system：国际版缺了就 400 / 11128。
3. 字段方言：developer 角色、store 字段、对象形态的 tool_choice、max_completion_tokens 别名、裸字符串的 stop、非字符串的 tool-call arguments——每一个都会被上游拒。
4. 一整套归属头：X-Product、X-Domain、X-User-Id、X-Enterprise-Id/X-Tenant-Id、X-IDE-*，以及三个会一起校验的会话头（X-Conversation-ID、X-Conversation-Request-ID、X-Conversation-Message-ID）——只给一个仍然 11128。

所以插件在宿主与上游之间插一层回环 shim：pi-ai 用标准 OpenAI-completions 跟 shim 说话，shim 用 WorkBuddy 的方言跟网关说话。

DSH (pi-ai)  ──OpenAI 协议──▶  127.0.0.1 shim  ──WorkBuddy 协议──▶  网关
                 共享密钥         方言改写              真实 accessToken

真实令牌从不离开这台机器，也从不交给 pi-ai：shim 自己从凭据库里取。

功能

• 两种登录方式：
  • 设备授权（主路径）：卡片上点「登录 WorkBuddy」→ 打开 WorkBuddy 授权页 → 回到卡片即完成，全程不需要 API Key。accessToken 到期前 5 分钟自动续期，续期失败时仍用未过期的旧令牌，不打断正在进行的对话。
  • 从桌面 App 导入（便捷路径）：本机装了 WorkBuddy 桌面版且已经登录时，卡片上会多一个「从桌面 App 导入」——插件直接采用桌面版自己的登录态，免去浏览器往返。桌面版把令牌加密存盘（WorkBuddy 5.6.0 起），插件调用桌面版自己的原生模块取密钥来解密，不内置任何与构建相关的常量；桌面版没装、没登录或取不到密钥时，这一项不会出现。已登录状态下这一项也一直可用——桌面版会自己重新登录并轮换会话，插件手里那份副本会随之作废，这时再点一次「从桌面 App 导入」就能接上新的会话，不必先退出登录。
• 会话失效会自己说：上游拒收这份凭据时（例如桌面版换过会话），卡片会直接提示「上游拒绝了这份凭据」，而不是继续挂着「已登录」的假象。
• 两个 realm 各自独立：两版各有自己的凭据文件、路由、已保存目录与额度。workbuddy.ai 的令牌在 codebuddy.cn 上无效，反之亦然，两套永不互串。
• 模型目录三级降级（live → saved → fallback）：卡片明示当前列表来自哪里——「实时列表（更新于 …）」、「上次保存的模型列表」、「内置模型列表（尚未从 WorkBuddy 更新）」；最近一次拉取失败时附带原因，并可手动「刷新目录」。
• 模型自由开关：按名称/ID 即时搜索，单个开关，或「全部开启 / 全部关闭」；关闭的模型从 DSH 的模型选择器里消失。
• 价格倍率与免费标记：模型名后直接拼上游倍率（Deepseek-V4.1-Flash · x0.00），免费模型额外挂一个「免费」角标。活动过期的倍率不会被继续显示为当前价格——插件会把它标成「价格暂不可用」。
• 额度明细：按资源包逐行给出「剩余 / 总量 + 进度条」，标注到期时间与下一轮刷新时间。读的是周期额度而不是池额度——池额度在月度资源用完之后仍会报「一点没动、全部还在」。
• 上下文窗口开关：可选择按上游声明的默认窗口（300K）或最大窗口（1M）发请求，两版各自独立保存。
• 推理档位：上游声明了可用档位的模型才有档位可选；上游用单数形态声明的档位会被折算成完整阶梯，而不是整个丢掉。

安装

前置条件：DSH 核心 0.2.0-rc.2 及以上；Node.js ^22.19.0 || >=24.0.0。

# 从本地目录安装（开发用）
dsh plugin --profile web add "file:/绝对路径/接入workbuddy"

# 或从 npm 安装
dsh plugin --profile web add dsh-workbuddy-connect

按你使用的 profile 换 --profile 的值（web / desktop / tui）。装到哪个 profile，数据就落在哪个 profile 目录里，web / desktop / tui 各自独立。

装完要重启 DSH。 插件是启动时按 package.json → dsh.profile.bundles 装载的，热重载只覆盖 client 侧的模块，不覆盖 bundle 本身。

使用

1. DSH → 设置 → 插件设置 → 展开 WorkBuddy 卡片。
2. 卡片顶部有「国际版 / 国内版」两个页签，页签前的小圆点就是这个版本的登录状态（绿=已登录，灰=未登录）。默认停在国际版。
3. 点「登录 WorkBuddy」，在新标签页里完成 WorkBuddy 授权；本机装了桌面版的话还有「从桌面 App 导入」一键接入。
4. 回到卡片，状态变成「已登录」，模型目录自动刷新。
5. 在会话里用模型选择器挑一个模型——国际版当前有免费模型可用。

切到「国内版」页签管理国内线路，站点换成 codebuddy.cn，两边的凭证、目录、额度、开关互不影响。

数据与隐私

插件的全部自有文件收在数据目录一处：<profile>/.dsh-workbuddy-connect/

<profile>/.dsh-workbuddy-connect/
├── .workbuddy-auth.json          # 国内版凭据（{version, region, auth{…}, account{…}}）
├── .workbuddy-ai-auth.json       # 国际版凭据
├── .workbuddy-settings.json      # 国内版设置（模型开关、上下文窗口）
├── .workbuddy-ai-settings.json   # 国际版设置
└── state/
    ├── .workbuddy-catalog.json          # 国内版按账号保存的模型目录
    ├── .workbuddy-ai-catalog.json       # 国际版
    ├── .workbuddy-app-version.json      # 国内版 App 版本缓存
    └── .workbuddy-ai-version.json       # 国际版 App 版本缓存

凭据文件权限 0600，目录 0700，写入用「临时文件 + rename」保证不会读到半截文件。

数据目录按 profile 归属（在 $DSH_HOME/profiles/ 下找声明本插件的 profile），无法确定时回落到 Harness home；环境变量 DSH_WORKBUDDY_DATA_DIR 可显式覆盖。

凭据的来源只有两种：插件自己的设备授权登录（主路径），或用户主动点的「从桌面 App 导入」。后者读的是桌面版自己的加密登录态——密钥由桌面版的原生模块现取，插件不内置任何与构建相关的常量，也从不写入磁盘。桌面版没装时，插件照常工作。

实现要点

环节	做法
登录	POST {base}/v2/plugin/auth/state?platform=CLI → 轮询 GET {base}/v2/plugin/auth/token?state=；业务码 11217 = 等待中。每次尝试一个独立 cookie jar——两版同时登录不会互相应答。
刷新	POST {base}/v2/plugin/auth/token/refresh，X-Refresh-Token + X-Auth-Refresh-Source: workbuddy
对话	POST {base}/v2/chat/completions，SSE；choices[0].delta.reasoning_content 是思考内容
目录	GET {base}/v3/config（优先）；旧的 /v2/enterprises/personal/models 与 /console/enterprises/personal/models 只作兜底——旧文档给的是 CLI 渠道的名单，会把同样叫「Hy4 preview」的免费 hy4-preview-f（x0.00）换成付费的 hy4-preview（x0.29）
额度	POST {base}/v2/billing/meter/get-user-resource，读 CycleCapacity* + *Precise
错误码	14018 额度耗尽（终态，不是限流）· 14003 模型级限流 · 6004 账号级限流 · 12153 会话失效 · 11128 渠道被拒 · 11133 参数被拒 · 11101 非流式
回环安全	只绑 127.0.0.1；校验 Host / Origin；每次进程一个随机 bearer 密钥；只收 application/json；请求体上限 32 MiB
桌面登录态	AES-256-GCM，12 字节 nonce、16 字节 tag，AAD 是「方案 / 套件 / keyId / 分帧」的长度前缀转写；密钥 = sha256(桌面版原生模块给出的 base64 字符串)，只存在内存里

模型身份是一个容易被忽略的坑：两个区域的模型都声明同一个身份 workbuddy，而路由分别是 workbuddy 和 workbuddy-global。pi-ai 只在「provider + api + 模型 id」三者全同的时候才保留历史思考块，所以跨区域续聊时身份必须一致；但身份同时又必须是每个区域注册表里的一个键，否则国际版每个请求都会以 Unknown provider: workbuddy 收场。两件事一起做才成立。

上游没有服务端会话：每一轮都要把完整历史发回去，插件不会替它压缩。

模型身份之外还有一处容易漏的：supportsImages 是平台标记而不是能力标记——上游几乎给每一行都标 true，包括根本收不了图片的模型。所以图片能力另有一张逐 id 复核的表；否则会两头出错：对纯文本模型发图（上游在消息已经落库之后才拒），或者对真能看图的模型收掉图（用户白白少一个能力）。

还有一处是国内版专属的坑：上游的渠道校验会读消息的行首，凡是「自报家门成别的客户端」的行首一律拒（400 / 11128「Illegal API invocation from an unapproved channel」）——DSH 系统提示词的第一行恰好就是 "You are an AI agent powered by DeepSeek Harness."，所以国内版每一条消息都会被拦，而国际版不查这一行、毫发无损。

这里有三层，少修一层都会复发：

1. system 消息：首行是该标记就拒（前面多一行、或多一个空格就放行，是字面前缀）。
2. assistant 消息：同样按行首查。这一层最阴——模型只要把自己的指令复述进回复，下一轮起这整条对话就一直失败，而代码一个字没改。你遇到的就是这个：第 1 轮正常，切到国内版后的第 2 轮就 11128。
3. content 形状：content 既可能是字符串，也可能是 [{type:'text',text:…}] 这样的数组块，两种形态都会查。只处理字符串的消毒器在数组形态下等于没生效。

插件因此把这句话改写成 "You are an AI coding assistant."：system 消息整条替换，assistant 消息只改行首、不动句中（实测句中不拦），user / tool 一律不碰（那是你的原话，改了就是篡改对话），数组块只改 text 部分、保留图片等结构。国际版那条路径同样受益。

渠道身份会自己过期：客户端身份里的版本号来自本机桌面版，而桌面版会自己升级（实测当晚 5.7.6 → 5.8.4、CLI 2.156.0 → 2.161.0）。所以身份每 10 分钟重新解析一次，而不是进程启动时定死——否则 App 升了级，宿主还在拿旧版本号冒充客户端。

开发

node test/smoke.mjs     # 纯逻辑的回归用例（目录解析、请求改写、额度归一、错误分类、加密信封）

插件本身是纯 ESM JavaScript，无构建步骤。

开发时把依赖写成 link: 而不是 file:：

"dsh-workbuddy-connect": "link:/绝对路径/接入workbuddy"

file: 走的是「把文件硬链接进 node_modules」——编辑器替换文件会换 inode，硬链接随之断开，改动不会生效；link: 是一条真符号链接，改完刷新页面即可。两种写法安装出来的包都能用，区别只在这条。

bundle 层（package.json / cordis.patch.yml）的改动需要重启 DSH：插件是启动时按 dsh.profile.bundles 装载的，热重载只覆盖 client 侧的模块。

出处与许可

上游行为来自对真实部署的实测，以及这几个开源实现的交叉验证：

• masknull/dsh-workbuddy-connect（MIT）——国内版 / 国际版双变体的连接器骨架
• dingminhua/dsh-connect-workbuddy（MIT）——模型身份与注册表键的处理
• corrinehu/dsh-workbuddy-connect（MIT）——请求头的取值
• ardeyouxipianyi/workbuddy2api-hub——上游请求形态与模型目录

本项目按 MIT 许可发布。本仓库与 WorkBuddy、腾讯、DeepSeek 官方均无关联，是社区适配器——非官方实现。

免责声明

• WorkBuddy 的接口来自上游：上游随时可能改动、限流或封禁调用方，导致本插件部分或全部功能失效。
• 本工具仅供个人学习研究，用于驱动使用者自己的 WorkBuddy 账号；请勿用于商业转售或任何超出个人合理使用的场景。使用即表示你自行承担账号被限制、额度损失、服务中断等一切后果，并遵守 WorkBuddy 的服务条款。
• 作者不对因使用或滥用本插件产生的任何直接或间接损失负责。文中出现的 WorkBuddy、DeepSeek 等名称与商标归各自权利人所有，仅作兼容性描述之用。