双线账号接入 zz991/dsh-workbuddy

dsh-workbuddy

把 WorkBuddy / CodeBuddy 账号接进 DeepSeek Harness 的模型选择器 —— 国内版（codebuddy.cn）和国际版（workbuddy.ai）两条链路，装一条或两条都装。

不用 API Key，不用改 DSH 源码，一条命令装完，右下角有状态胶囊，模型选择器里直接多出两个分组。

git clone https://github.com/zz991/dsh-workbuddy
cd dsh-workbuddy

install\install.cmd # Windows
bash install/install.sh # macOS / Linux

Windows 上别直接跑 pwsh -File install/install.ps1：系统默认的 Restricted 执行策略会在安装器打印任何提示之前就把它拦下。install.cmd 不受该策略约束，它会自己带上 -ExecutionPolicy Bypass 调起安装器。

English documentation: README.en.md

装完你会得到什么

| | 国内版 | 国际版 |
| 账号来源 | WorkBuddy / CodeBuddy 国内站（腾讯账号） | WorkBuddy 国际站 |
| 本地网关 | workbuddy2api（Python）· 127.0.0.1:8787 | wb2api（Go）· 127.0.0.1:8788 |
| DSH 里挂在 | workbuddy provider（本插件的 LLM 适配器） | llm-pi-ai 的 globalwb provider（DSH 内置能力） |
| 模型选择器分组 | WorkBuddy | WorkBuddy-Global |
| 登录态文件 | <网关根>/session.json | <网关根>/upstream-go/auths/workbuddy-<uid>.json |
| 登录方式 | 插件内置 login_workbuddy.py 设备流 | login_bin 的 url / poll 设备流 |

三条实用能力：

- 模型即插即用：网关通了就实时拉 /v1/models，平台新上架的模型刷新即出现，不用等插件发版。支持推理的模型（DeepSeek-V4、GLM、Kimi、MiniMax、Hy3…）带 Low / Medium / High 推理等级下拉。
- 右下角状态胶囊：常驻显示登录与代理状态，未登录时点一下就在新标签页开授权页，登完自动变绿 —— 全程不用回终端。
- 诊断与用量：胶囊的 ⚙️ 菜单里有 🔍 诊断（真实发一次模型请求，戳穿「胶囊绿了但模型全 500」）、📊 用量（今日 / 累计 token 与积分消耗）、🔄 刷新模型、🔑 重新登录。

架构

┌──────────────────────── DSH Web GUI（127.0.0.1:3080）────────────────────────┐ │ │ │ 模型选择器 右下角状态胶囊 │ │ ├─ WorkBuddy 分组 ────────┐ ├─ 登录 / 重新登录 │ │ └─ WorkBuddy-Global 分组 ─┼─┐ ├─ 🔍 诊断 / 📊 用量 │ │ │ │ └─ 🔄 刷新模型 │ └─────────────────────────────┼─┼──────────────────────────────────────────────┘ │ │ ┌─────────────────────┘ └──────────────────────┐ ▼ ▼ dsh-llm-workbuddy 插件 llm-pi-ai（DSH 内置） provider: workbuddy provider: globalwb /api/workbuddy/* 路由 settings.yaml 里配的 OpenAI 兼容端点 │ │ ▼ ▼ 127.0.0.1:8787 ◀──────────────────────────▶ 127.0.0.1:8788 国内版 Python 网关 国际版 Go 网关 hawklithm/workbuddy2api Sliverkiss/workbuddy2api ▲ ▲ └────────── wb-gateway-manager 插件 ───────────┘ 每次 DSH 后端启动后探测端口、按需拉起

wb-gateway-manager 是那个"省事"的部件：DSH 改设置会重启后端，重启会连带杀掉它进程树里的网关子进程。这个插件在每次后端启动后重新探测两个端口，没在监听就拉起来 —— 所以只要 DSH 活着，模型路由就是通的，你不需要开一堆终端窗口守着网关。

安装器做了什么

install/setup.mjs（install.ps1 / install.sh 只是它的外壳）按顺序跑六步，全部幂等，重复执行不会重复写、不会覆盖你自己改过的设置值：

1. 环境体检 —— Node ≥ 18、DSH_HOME、profile 是否存在，顺带报出 python / uv / go / dsh CLI 的位置。
2. 装插件 —— 两个包复制进 <DSH_HOME>/plugins/，再在 profile 的 node_modules 里建 junction 指过去。
3. 挂载 profile —— 幂等追加 <profile>/cordis.patch.yml 的 insert 行（保留文件原有注释，不整段重写）。
4. 写设置 —— 用 DSH 自带的 js-yaml 合并 settings.yaml：只补缺失的键，已存在就原样保留；写之前自动备份成 settings.yaml.bak.<时间戳>。
5. 准备网关 —— 找到就用；国内版缺失时给出 uv tool install 指引，国际版缺失时可从 Release 下载。
6. 引导授权 —— 国内版跑 login_workbuddy.py，国际版跑 login_bin，把授权链接打给你，登录态自动落盘。

网关根目录不用你填：安装器会从 settings.yaml 里 llm-workbuddy.sessionFile 反推，找不到才回落到 $DSH_HOME/workbuddy。已经装过网关的机器会被无损接管，不会另起一个空目录。

常用参数：

node install/setup.mjs --realm=both # cn / global / both，不给就交互询问
node install/setup.mjs --realm=cn --yes # 国内版，全默认不交互
node install/setup.mjs --plugins-only # 只装插件，不碰网关和登录
node install/setup.mjs --dry-run # 只打印将要做的事，一个字节都不写
node install/setup.mjs --force-settings # 用安装器的值覆盖已存在的设置项
node install/setup.mjs --dsh-home=D:\my-dsh # 指定 DSH 家目录
node install/setup.mjs --uninstall # 卸载：撤掉挂载、链接、插件目录与设置项

装完重启 DSH 后端（关掉 dsh web / 桌面版再打开），插件与网关会自己挂上。

前置条件

- DeepSeek Harness，且至少跑过一次（DSH_HOME 与 profile 要存在）。
- Node.js ≥ 18 —— 只给安装器用，插件本身零依赖、无构建步骤。
- 网关（第三方项目，本仓库不打包它们的源码）：
- 国内版：uv tool install -U workbuddy2api（需 ≥ 2.0.4；2.0.3 及更早缺登录所需请求头，登录最后一步会 401）
- 国际版：从 Release 下 wb2api.exe，或按 docs/GLOBAL.md 自行 go build
- 国内版登录需要系统里有 python3（纯标准库，Python 3.7+ 即可）。

日常使用

登录、重登、诊断、刷新模型都在 Web GUI 右下角的胶囊里点，不用命令行。要手动跑也行：

国内版登录（会话写入 <网关根>/session.json）
python3 <DSH_HOME>/plugins/dsh-llm-workbuddy/login_workbuddy.py --session-file <网关根>/session.json

国际版登录
cd <网关根>/upstream-go && ./login.sh --realm=global

看两个网关的监听状态
curl http://127.0.0.1:3080/api/wb-gateway/status

关于「🎁 签到」：入口只在网关真的实现了 /v1/checkin-status 与 /v1/checkin 时出现。国内版网关（workbuddy2api Python）至今没有这两个端点，插件探测到 404 后自动隐藏入口并停止每日重试，不会留一堆失败记录。国际版网关自带排程签到，走它自己的 schedule 配置。

配置参考

设置写在 $DSH_HOME/settings.yaml（安装器会自动合并，这里是给你手改的参考）：

llm-workbuddy: # 国内版：本插件的适配器 baseURL: http://127.0.0.1:8787/v1 # 网关端点 sessionFile: <网关根>/session.json # 会话文件（胶囊据此判断登录态） discovery: true # 实时拉 /v1/models（30s 缓存）

llm-pi-ai: # 国际版：DSH 内置的 OpenAI 兼容适配器 providers: globalwb: displayName: WorkBuddy-Global apiKeyEnv: WB_GLOBAL_API_KEY # 网关不校验时可留空 api: openai-completions baseURL: http://127.0.0.1:8788/v1 models:
- { id: global:glm-5.3, name: GLM-5.3 (Global) }
- { id: global:gpt-5.6-terra, name: GPT-5.6 Terra (Global) }

网关侧的端口、账号池、冷却策略在 <网关根>/upstream-go/config.json（国际版）和网关命令行参数（国内版）里，见 docs/GLOBAL.md。

排错速查

| 现象 | 处理 |
| 右下角没有胶囊 | DSH 后端没重启 → 重启；或 curl http://127.0.0.1:3080/plugins/dsh-llm-workbuddy/client.js 应返回 200 |
| 胶囊红 + 代理未运行 | 网关没起 → curl http://127.0.0.1:3080/api/wb-gateway/status 看是哪个，再按提示补装 |
| 胶囊绿但模型全 500 | 典型的「网关活着但指向旧路径」假象 → 点胶囊 🔍 诊断，看「模型出字」一行 |
| 点登录返回 alreadyLoggedIn 但 token 已失效 | 本地判定是启发式 → 用 ⚙️ → 🔑 重新登录 强制重跑设备流 |
| 模型选择器里没有新模型 | 网关的模型清单来自本机 WorkBuddy 应用 → 更新应用后点 🔄 刷新模型 |
| 启动报 EPERM ... cordis.yml | DSH_HOME 所在卷受保护 → 换 DSH_HOME 或修权限 |

完整清单见 docs/TROUBLESHOOTING.md。

目录结构

dsh-workbuddy/
├─ package.json 根包 = dsh-llm-workbuddy 插件本体 ├─ lib/index.js LLM 适配器 + /api/workbuddy/* 路由 ├─ lib/client.js 零依赖浏览器小部件（状态胶囊） ├─ login_workbuddy.py 国内版设备流登录脚本 ├─ cordis.patch.yml 本包的 Cordis bundle 挂载声明 ├─ packages/ │ └─ wb-gateway-manager/ 双网关守护插件（路径自动探测） ├─ install/ 一键安装器（ps1 / sh 外壳 + setup.mjs 内核） ├─ scripts/ 辅助工具（清理重复包裹、构建国际版网关） ├─ test/plugin-smoke.mjs 加载冒烟测试：两个包各跑一次真实 apply() └─ docs/ CN.md · GLOBAL.md · FAQ.md · TROUBLESHOOTING.md

自检

node test/plugin-smoke.mjs # 需要本机装过 DSH（peer 依赖取自它的 node_modules）

它把仓库里两个包的入口分别复制到临时目录、把各自的 node_modules/@deepseek-ai 指向你的 DSH 运行时，然后真实加载插件、对着 mock 的 Cordis 上下文调一次 apply()，断言注册了什么（共 37 项）—— 覆盖 headless（没有 webServer）与无 entry config 两条路径；网关守护插件还会真的调一次 /api/wb-gateway/status 的 handler，校验响应 JSON 与 405 分支。

node --check 查不出「新版 harness 删掉了某个具名导出」这类问题，因为那是加载期的 SyntaxError，会把整个插件拖下水。这个测试能。

许可与声明

MIT（见 LICENSE）。

本仓库只做 DSH 侧的适配与安装编排，不打包也不修改第三方网关的源码：

- 国内版网关 hawklithm/workbuddy2api（Python）
- 国际版网关 Sliverkiss/workbuddy2api（Go，MIT）

Release 里附带的 wb2api / login_bin 二进制由上游源码构建，遵循上游 MIT 许可。

这是非官方工具，与腾讯 / CodeBuddy / WorkBuddy 官方无关。请只在自己的账号、自己的机器上使用。