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 插件里的「插件登录」—— 没装过桌面端也能用，只需在浏览器完成一次授权（凭据由插件 DPAPI 加密保管）。

另附一个网页控制台（状态 / 启停 / 诊断 / 模型注册 / 用量 / 体检 / 对话测试）， 中 / 英双语（右上角切换，选择记在本机）， 以及一个可选的 DeepSeek Harness（dsh）原生插件（见下方说明）。

一句话：WorkBuddy 的模型额度 → 本地 API → 你惯用的任意 AI 客户端。

关键词（便于检索，按关心的问题分组）：

你在找什么	相关词
把 WorkBuddy 用起来	WorkBuddy · WorkBuddy 本地 API · WorkBuddy 模型桥 · WorkBuddy 中转 · WorkBuddy 插件
接某个客户端	WorkBuddy 接入 Claude Code · WorkBuddy 接入 Codex · WorkBuddy OpenAI 兼容 API · WorkBuddy Anthropic Messages 兼容 · WorkBuddy Responses 兼容 · Claude Code 自定义 API · opencode / Cursor / Trae / Cherry Studio / NextChat / LobeChat / ChatBox / Open WebUI 接入
接 DeepSeek Harness	DeepSeek Harness 插件 · 在 DSH 里用 WorkBuddy · WorkBuddy 接入 dsh · dsh workbuddy · dsh 模型路由 · provider workbuddy
技术特性	openai-compatible · anthropic-compatible · llm proxy · local model bridge · 零依赖 Node.js · 仅监听 127.0.0.1 · 本机凭据自用

DeepSeek Harness 用户：一个插件装下全部能力

在 DeepSeek Harness（dsh） 里用上 WorkBuddy 的模型，本仓库提供的是 原生 dsh 插件 + 本地 API 桥 + 可视化控制台的完整组合 —— 装完模型直接出现在 dsh 的模型选择器里，日常需要的接入、管理、监控、运维能力也全在同一个插件内。

一键即用：装完插件，三步开始对话

步骤	操作	需要配置
1	安装插件（dsh「添加插件」填 GitHub 地址 / dsh plugin add ... / tgz）	无
2	设置 → WorkBuddy → 「账号」→「开始登录」（授权页自动打开）	无
3	浏览器授权完成，回模型选择器选一个模型	无

• 没装桌面端也能用：插件内设备码登录，不下载、不安装 WorkBuddy 客户端。
• 装了桌面端更省事：已登录的账号自动复用，第 2 步都可以跳过。
• 不填任何东西：不需要 API Key、Base URL、令牌、端口或环境变量；桥与控制台由插件自动拉起。
• 国内 / 国际版自动预选：登录区域跟随现有账号或桌面端域名，不用每次手动切。
• 模型选择器即时刷新：登录、切号、重启桥后自动广播目录更新，不需要重启 dsh。
• 聊天页闭环：未登录时空会话里直接「连接 WorkBuddy」；已有对话遇到凭据失效时，顶部胶囊位会变成登录入口。对话页顶部常驻「积分 N」（悬停看套餐余量 / 今日已用 / 最近一次，点一下刷新）；每轮回复末尾显示本轮积分（优先按本轮 tokens 与本地账本核对）。
• 模型名自带倍率：选择器/聊天顶部直接显示 DeepSeek-V4.1-Flash · ×0.11，免费模型标「免费」，不用再翻模型详情。
• 凭据不裸奔：DPAPI + AES-GCM 加密保存；同一账号的桌面/插件双凭据自动合并，401/403 自动接管。

<img src="docs/plugin-panel-first-run-login.png" width="100%" alt="首次安装的 dsh「账号」页：插件登录卡直接排在账号列表前面，区域已自动预选，点「开始登录」即可在浏览器授权">

聊天页里，常用的都在手边

位置	显示	说明
模型名	DeepSeek-V4.1-Flash · ×0.11 / · 免费	倍率来自模型目录，选模型时就能看到；不用点进详情
对话页顶部	积分 715	悬停看套餐余量 / 今日已用 / 最近一次调用；余量 ≤30% 变黄、≤10% 变红；点一下强制刷新。读取失败时保留上次余额并标红；已有对话但未登录/凭据异常时，这里直接变成登录入口
每轮回复末尾	本轮 0.03 积分	优先用宿主给出的本轮 tokens 与本地请求账本核对，拿到实际扣费；旧宿主或核对不上时退回「最近一次已完成请求」估算并标 ≈（悬停有说明）
空会话欢迎区	连接 WorkBuddy	未登录时直接发起浏览器授权，不用先进设置页；成功后模型选择器自动刷新

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

能力清单：

…