dsh-connect-workbuddy

<h1 align="center">dsh-connect-workbuddy</h1> <p align="center"><b>把本机登录的 WorkBuddy 模型接入 DeepSeek Harness，并提供只读的积分概览与模型管理。</b></p>

<a href="README.en.md">English</a> · <a href="#安装">安装</a> · <a href="#工作原理">工作原理</a> · <a href="CHANGELOG.md">更新日志</a> · <a href="https://github.com/dingminhua/dsh-connect-workbuddy/issues">问题反馈</a>

一个独立的 DeepSeek Harness (DSH) bundle 插件。它把本机已登录的 WorkBuddy 账号（国内版与国际版 WorkBuddy AI 均支持）接到 DSH 的模型选择器，同时提供只读的积分概览与可勾选的模型管理界面。国内版与国际版是两个并行的供应商（workbuddy / workbuddy-global），可同时使用；插件设置卡片以 tab 区分两者，方便统一管理。

功能特性

• 双供应商并行接入（国内版 + 国际版） —— 国内版注册为 workbuddy provider（GLM-5.3、DeepSeek-V4-Pro、Kimi-K3、MiniMax-M3、Hy3 等），国际版注册为 workbuddy-global provider（GPT-5.6、Gemini-3.5-Flash、GLM-5.3、Kimi-K3 等）。有账号的区域其模型会出现在 DSH 模型选择器里：两边都有账号时两组同时可选，不同会话可以各选一边，互不干扰。本机没有账号的区域不列出任何模型（该区域一个请求也发不出去，列出来只会点到就失败）；只要在该区域登录一次，「重新检测账号」或重启后模型就会自动出现——provider 本身始终注册着，因为它的设置卡片与账号选择器正是登录的入口。模型名内嵌上游积分倍率（如 GLM-5.3 · x0.79），与 WorkBuddy 自身模型菜单一致。
• 插件卡片 tab 切换 —— 设置卡片顶部为「国内版 / 国际版」两个 tab，各含独立的账号选择、积分概览与模型管理；每个 tab 的账号、目录、勾选与未保存草稿完全隔离——在一个 tab 里切账号或刷新模型，不会触碰另一边的运行时目录与会话。
• 可单独关闭任一版本供应商 —— 每个 tab 右侧有一个勾选框（默认都勾选）。取消勾选即把该供应商从 DSH 模型选择器里彻底撤掉（不是只藏起 tab）：它的路由与「设置 → 模型」页的目录条目一并摘除，启动时也不再为它发无用请求。账号、积分、目录与勾选全部保留，重新勾选即完整恢复。典型用法是「我根本用不到国际版」——关掉它，让选择器干净。注意：若某会话此前选中的正是被关闭供应商的模型，该会话再调用会报 NO_ADAPTER，卡片会在关闭态的 tab 上明确提示这一点，不会静默失败。
• 模型管理 —— 从上游刷新完整模型目录，逐项勾选启用或禁用；刷新是草稿操作，点保存才生效。上游同时给出积分倍率、上下文/输出上限与推理档位；图片输入按模型手动勾选（默认不勾选）。
• 本机账号切换 —— 自动发现 WorkBuddy 桌面端留下的多个登录凭据，可按区域切换账号；Token 不写入 DSH 设置。
• 凭据失效时给出可执行的建议 —— 上游拒绝当前账号的 token 时，插件会实际探测本机其他账号：若有账号仍然可用，就直接告诉你「切换到它即可」（并附一键切换），而不是笼统地让你重新登录——被钉在一个作废的旧备份上时，重新登录并不能解决问题。只有本机确实没有别的账号可切换时，才会提示重新登录。
• 只读积分概览 —— 按套餐聚合展示剩余积分，并列出每个模型的积分倍率。查询不消耗积分。
• 凭据路径多候选 —— macOS / Windows / Linux 逐一探测默认位置，也支持环境变量与卡片内直接指定。未登录时卡片会列出「探测过哪些路径、各自为什么没成」：五档原因（不存在 / 读不了 / 没有可用 token / 字段已加密且拿不到密钥 / 属于另一个地区）分开呈现，因此「已经登录了、但桌面 App 不在场」这种最容易误判的情况会明说需要 App 在场，而不是叫你重新登录一次。属于另一个地区那一档尤其不同：登录信息是真实可用的，只是挂在另一个标签页下，卡片会直接给出结论「切换标签页即可，不用重新登录」。列表只讲一次——提示段落说结论，折叠列表给路径细节，两处不重复同一件事。
• 安全 loopback shim —— 每区域一个随机端口 + 进程内随机 secret，真实 WorkBuddy token 不交给 pi-ai。
• 命令行诊断 —— status / doctor / logout，按区域报告登录与积分，无需浏览器即可确认宿主状态。

工作原理

DSH PiAiAdapter（每个 provider 一套）
  -> 安全 loopback shim（每区域一个随机端口 + 进程内随机 secret）
  -> WorkBuddyUpstreamClient
  -> 国内版 https://copilot.tencent.com/v2/chat/completions
  -> 国际版 https://www.workbuddy.ai/v2/chat/completions
  -> WorkBuddy SSE
  -> DSH 本地执行工具并回传结果

国内版与国际版各持一套完整的运行时栈——凭据 store、模型 catalog、回环 shim、adapter——按凭据域名（workbuddy.ai / codebuddy.ai → 国际版，其余 → 国内版）隔离可见账号，所以两个区域的账号可以同时在线、同时被不同会话使用。国际版有两个品牌域名：桌面端登录在 workbuddy.ai，CodeBuddy CLI 登录在 codebuddy.ai，两者都是国际版。

模型目录按区域取自各自的正确来源：国内版走 /v2/enterprises/personal/models，国际版走 <国际网关>/v3/config（配置服务按客户端渠道返回不同清单，国际版必须用桌面端 User-Agent 才能取到账号真实的 20 个模型，含免费的 deepseek-v4.1-flash）。积分概览走 https://www.codebuddy.cn/v2/billing/meter/get-user-resource（国际版账号自动路由到其凭据所属的国际网关，workbuddy.ai 或 codebuddy.ai——两个品牌域名的凭据互不通用），均为只读接口。

凭据读取自 WorkBuddy 桌面 App 自身的 auth 文件（只读）；刷新得到的 token 按区域存放在 $DSH_HOME/.workbuddy-auth.cn.json 与 $DSH_HOME/.workbuddy-auth.global.json（双账号同时在线互不覆盖；旧的单文件 .workbuddy-auth.json 作为迁移来源保留读取），桌面端文件永不被写入。

…