workbuddy-to-dsh

WorkBuddy 本地 API 桥 🌏 English summary: README.en.md

把本机 WorkBuddy 的模型能力（DeepSeek / GLM / Kimi / MiniMax 等）， 经一个本地桥变成本机的 OpenAI 兼容、Anthropic 兼容与 OpenAI Responses 三套接口 —— Claude Code、Codex、opencode、Cursor、Trae、 Cherry Studio、NextChat、LobeChat、Open WebUI 等任何支持自定义 Base URL 的客户端都能直连。

凭据有两种来源：已登录的 WorkBuddy 桌面端，或者 dsh 插件里的「插件登录」—— 没装过桌面端也能用，只需在浏览器完成一次授权（凭据由插件加密保管：Windows 用 DPAPI，其他平台用文件密钥）。

另附一个网页控制台（状态 / 启停 / 诊断 / 模型注册 / 用量 / 体检 / 对话测试）， 中 / 英双语（右上角切换，选择记在本机）， 以及一个可选的 DeepSeek Harness（dsh）原生插件（见下方说明）。 一句话：WorkBuddy 的模型额度 → 本地 API → 你惯用的任意 AI 客户端。

关键词（便于检索，按关心的问题分组）： DeepSeek Harness 用户：一个插件装下全部能力

在 DeepSeek Harness（dsh） 里用上 WorkBuddy 的模型，本仓库提供的是 原生 dsh 插件 + 本地 API 桥 + 可视化控制台的完整组合 —— 装完模型直接出现在 dsh 的模型选择器里，日常需要的接入、管理、监控、运维能力也全在同一个插件内。 一键即用：装完插件，三步开始对话 没装桌面端也能用：插件内设备码登录，不下载、不安装 WorkBuddy 客户端。 装了桌面端更省事：已登录的账号自动复用，第 2 步都可以跳过。 不填任何东西：不需要 API Key、Base URL、令牌、端口或环境变量；桥由插件自动拉起，控制台在第一次打开数据页时按需拉起。 国内 / 国际版自动预选：登录区域跟随现有账号或桌面端域名，不用每次手动切。 模型选择器即时刷新：登录、切号、重启桥后自动广播目录更新，不需要重启 dsh。 聊天页闭环：未登录时空会话里直接「连接 WorkBuddy」；已有对话遇到凭据失效时，顶部胶囊位会变成登录入口。对话页顶部常驻「积分 N」（悬停看套餐余量 / 今日已用 / 最近一次，点一下刷新）；每轮回复末尾显示本轮积分（优先按本轮 tokens 与本地账本核对）。 7 天内有积分到期时，胶囊会变黄（≤1 天变红），悬停可看到期明细；概览积分卡也会出现可关闭的到期提醒。 限流看得见：账号页显示当前账号的额度上限/账号风控（带恢复时刻）；模型页给被限流/繁忙/排队的模型加标记；请求页可「仅看需要处理」，失败悬停直接给下一步建议。 模型名自带倍率：选择器/聊天顶部直接显示 DeepSeek-V4.1-Flash · ×0.11，免费模型标「免费」，不用再翻模型详情。 凭据不裸奔：DPAPI / 文件密钥 + AES-GCM 加密保存；同一账号的桌面/插件双凭据自动合并，401/403 自动接管。

聊天页里，常用的都在手边 ×0.11 是积分消耗倍率，不是人民币单价；免费模型直接标「免费」。 积分胶囊、登录入口、每轮成本都在 dsh 对话页；完整用量曲线、请求明细和 CSV 仍在设置页的「用量 / 请求」里。

能力清单： 在 dsh 里直接装：设置 → 插件 → 添加插件，填

安装源保持默认即可（GitHub 地址由 pnpm 直接拉取，国内镜像只影响 npm 依赖）。 也可以走命令行（安装路线、验收清单与故障排查见 docs/INSTALL.md）： npm 包名 workbuddy-to-dsh 已按可发布形态准备好；发布后「添加插件」里直接填 workbuddy-to-dsh 即可（npm 名 dsh-plugin-workbuddy 已被他人占用，不要填它）。

装完重启一次 dsh，模型选择器里直接多出 WorkBuddy。 插件登录需要 v1.8.0 或更高版本。从 dsh 市场安装时请确认上架版本； 旧版（≤1.7.0）仍要求 WorkBuddy 桌面端登录态。 ### ⚠️ 请先读这一段（免责与边界） 这是一个自托管的开源工具：欢迎自用、欢迎分享源码，但它是非官方路径，风险自担。 - 非官方路径。 它依赖 WorkBuddy 未公开的上游协议与登录凭据格式（插件登录 不需要桌面端，但同样走非官方设备码接口）。上游随时可能改动协议或收紧风控 （已经发生过——见故障排查里的真实案例），可用性 无任何保证，且不承诺任何兼容性。把它当作「随时可能需要更新甚至失效的 互操作性实现」，而不是稳定服务。 - 只驱动你自己的账号。 它只读取你自己机器上已登录的桌面账号，或你在插件里 明确授权的那一个插件账号，消耗该账号自身的配额。请勿用它做多账号池化、 代他人调用、或任何形式的转售 / 托管服务 —— 那既违背本项目的设计初衷，也最容易 触发上游风控（殃及所有用户）。 - 请确认你符合 WorkBuddy 的服务条款。 使用前请自行阅读并确认；若条款不允许， 请不要使用本项目。 - 无担保。 按 MIT 许可"按现状"提供。作者不对账号风控、额度异常或任何损失负责。 若你需要长期稳定、可商用的模型接入，请申请官方 API。 - 自担风险的分享是欢迎的：转发仓库链接、写教程、提 PR 都可以；但请不要 打包转售、绑定付费，或以本项目名义收集任何人的凭据。 兼容性分档见 docs/COMPATIBILITY.md；上游失效/项目停更时 怎么退回官方客户端、数据在哪，见 docs/SUNSET.md。安全报告方式见 .github/SECURITY.md。 这个项目与同类工具的关系 方向与 claude-code-router 相反： CCR 把别家的 API 注入 Claude Code；本项目把 Claude Code 等发给 WorkBuddy 的 模型额度导出成标准 API——两者互补而非竞争。 与 WorkBuddy2API 集群（社区 20+ 同目标项目）的差异：本项目刻意保持 单账号 · 不落明文凭据 · 零运行时依赖 · 自包含（桌面凭据现取现解； 插件登录凭据以 DPAPI / 文件密钥 + AES-GCM 加密保存）；默认不提供多账号池化与 任务自动化——如果你的需求是后者，社区里已有更对口的工具。限流自动切号是显式 opt-in 的本机自有账号切换（默认关闭，见插件配置），不导出凭据、不做公网中转， 也不代表支持池化或转售。 上游协议是未公开接口：所有同类项目都在同一片雷区里，失效与修复是常态。 本项目的对策是把排查写

本仓库还提供一个 DeepSeek Harness 原生插件（dsh-plugin/）： 装进 dsh 后，模型选择器里直接多出 provider WorkBuddy，设置里多一页 9 个标签页的数据面板； 插件自带桥与控制台，拷一个文件夹就能用。它是可选的 —— 不用 dsh 的话， 前面说的本地 API 照常可用，只是没有那个原生集成。

只在本机回环地址上工作，不对外暴露，不内置任何密钥。