dsh-workbuddy-bridge
把 WorkBuddy 桌面 App 的模型接进 DSH 对话窗口
WorkBuddy desktop models in DeepSeek Harness
各版本改动 → Releases（与 npm 版本一一对应）
简体中文 · English
> [!NOTE]
> 凭据不出本机：登录状态取自 WorkBuddy 桌面 App 自己的凭据文件，插件只在本机留一份加密副本；
> 浏览器半边拿不到令牌，界面里也永远不出现凭据原文。
国内版 WorkBuddy 与国际版 WorkBuddy AI 并存：装哪个 App 就出现哪个模型分组，两个都装就两组并排，
各自用自己的账号与积分。模型直接出现在 DSH 的模型选择器里，不必为它单独配一个 provider。
中文界面截图：国内版在模型选择器中自成一组，模型名后直接跟积分倍率与促销徽章；装国际版则出现「WorkBuddy AI」组。
能力
- 开箱即用 —— 装完启用，模型分组自己出现。
- 两版隔离 —— 国内版与国际版各自分组，模型、账号、积分互不混用，只跟随各自 App 的登录状态。
- 推理档位 —— 上游声明了档位的模型直接可选；没声明的可在插件页手动检测。
灯泡表示能切档位；上游已声明的模型也亮着，只是不需要检测。
能切档位的模型会带一个默认档位（上游声明了就按声明，否则取high），因此选择器里不再出现「Default」这一项。
档位里的 Off 表示「不发送档位参数」：两个接口都不接受这个字面量，所以插件不会把它发出去；
实际是否关闭思考由上游决定，插件不做保证。 - 积分可见 —— 每条回复下方显示本次消耗，模型选择器旁常驻剩余积分。拿不到数字时不显示。
- 模型显隐 —— 卡片「模型」标签里勾选哪些模型出现在选择器里，按登录账号分别保存。
- 图片输入 —— 多数模型可直接粘贴或拖入图片；纯文字模型会明确说明。
- 三种界面 —— Web / Desktop / TUI；仅 TUI 无手动检测。
中文界面截图：对话窗口里每天看到的样子：币图标与余额、推理档位灯泡，再往右是模型名——都排在同一行。
中文界面截图：插件页：上面是配置表单，下面两张卡片各跟随自己 App 的登录状态。
安装
前置只有一条：已安装并登录 WorkBuddy 桌面 App（国际版为 WorkBuddy AI App）—— 插件复用 App 的登录状态。
dsh plugin --profile web add dsh-workbuddy-bridge
dsh web
Desktop 与 TUI 把 --profile web 换成 desktop / dsh-tui（TUI 需较新版本的终端插件
@deepseek-harness-tui/dsh-tui，版本要求见其文档）。
也可以从源码安装：
git clone https://github.com/dsh-plugin-lab/dsh-workbuddy-bridge.git
cd dsh-workbuddy-bridge
pnpm install && pnpm build
dsh plugin --profile web add "$PWD"
⚠️ 上面那步 pnpm install 不能省：按路径挂载时依赖要由仓库自己装好（见本地开发装法），
漏装则插件显示「未运行」（ERR_MODULE_NOT_FOUND）。
插件页
侧边栏 插件（Plugins） → 已安装 → 点 DSH WorkBuddy Bridge。配置区在描述下面，保存即生效：
- 登录文件路径（国内版 / 国际版）—— 留空即用 App 自己的位置。
- 允许推理档位检测、使用上游声明的最大上下文窗口 —— 两个开关。
中文界面截图：「模型」标签：勾选哪些模型出现在选择器里，同时看窗口与倍率。
中文界面截图：左「检测」：每个推理模型一行，点按钮确认它接受哪些推理档位；右「积分」：总余额，下面是各套餐的余量条。
为什么是手动检测
WorkBuddy 接口不保证档位信息可靠——有的模型接受 reasoning_effort 却忽略未知值。
所以插件不猜：按需对单个模型发少量真实请求确认；结果只表示上游当前接受该档位，
不承诺它改变推理行为。已声明档位的模型跳过这一步，直接用声明值。
机制与取舍见 docs/ARCHITECTURE.md。
中文界面截图：已声明档位的模型：灯泡点亮、档位直接可选，检测按钮禁用。
兼容与限制
无凭据的分组不显示。宿主版本下限、平台支持、模型清单从哪来与已知缺口
→ docs/COMPATIBILITY.md。
设计取舍 → docs/ARCHITECTURE.md；发版流程 → docs/PUBLISHING.md；
维护者文档地图 → AGENTS.md。
免责声明
- 本项目仅供个人学习和研究使用，仅驱动使用者自己的 WorkBuddy 账号在本机调用，请勿用于商业用途。
- 使用者需遵守 WorkBuddy 的服务条款；因使用本项目产生的任何后果，由使用者自行承担。
- 本项目与腾讯、WorkBuddy、DeepSeek 均无关联，未获其授权或认可；文中出现的名称仅用于描述兼容关系，其商标权利归各自所有。
致谢
- Sliverkiss/workbuddy2api（MIT）— WorkBuddy 上游协议的参照实现。
- franksong2702/dsh-codex-connect（Apache-2.0）— DSH 插件结构与 provider 注册的参照。
许可
MIT。
贡献
缺陷与需求走仓库 Issues。
