WorkBuddy 本地 API 桥 + dsh 插件：把你的 WorkBuddy 额度，变成手边随手可用的模型

面向的是谁：想要 WorkBuddy 额度、但不想忍受"开着客户端才能用 / 没有标准 API / 不知道自己花了多少"的你。 一句话：WorkBuddy 的模型 → 本地 API → 你惯用的任何 AI 客户端，Claude Code、Codex、opencode、Cherry Studio… 都能直连；装进 DeepSeek Harness（dsh）还能成为"一等公民"。 最新版本：v1.8.2（本文章按 1.8.x 写，最新功能以 CHANGELOG 为准）

1. 先说痛点：以前你得这样折腾 WorkBuddy

2. 为什么值得用（按"你会真正摸到的东西"说）

2.1 接入：装完就能用，不写配置

• 一条命令：dsh plugin --profile desktop add github:Ianzhyh/workbuddy-to-dsh
• 不写 settings.yaml：插件运行时注册 provider: workbuddy，模型加减自动跟随。
• 不用填 API Key / Base URL / 令牌：桥由插件自动拉起，配置现取现用。
• 没装桌面端也行：设备码登录（浏览器授权一次即可），登录区域会根据现有账号/桌面端域名自动预选国内或国际版。
• 凭据加密落盘：DPAPI（当前 Windows 用户）保护密钥 + AES-256-GCM 信封；换机器/换 Windows 用户解不开，不把令牌明文扔在磁盘上。

2.2 聊天页：把最常用的信息放在手边（v1.8 起的重头戏）

• 模型名直接标倍率：DeepSeek-V4.1-Flash · ×0.11，免费模型标 · 免费。选模型时一眼就知道贵不贵，不用点进详情页。
• 对话页顶部常驻积分胶囊：显示「积分 N」；悬停能看到套餐余量、今日已用、最近一次调用的积分；套餐余量 ≤30% 变黄、≤10% 变红；点击强制刷新。
• 每轮回复末尾显示「本轮 0.03 积分」：聊完立刻知道这轮成本。它是按最近一次已完成的模型请求估算的（并发多个窗口时可能对到另一窗口，悬停有说明）。
• 空会话直接登录：未登录时 hero 区出现「连接 WorkBuddy」，点击就发起浏览器授权，成功后模型选择器自动刷新，不用先进设置页。
• 以上能力注册在 dsh 的会话头/hero/turn-tail 槽位上；旧版 dsh 缺槽位时会自动跳过，不影响设置页。

2.3 管理：多账号、用量、明细、体检，一站式

• 多账号一键切换：自动重启桥、清缓存；生效中的那一行有"使用中"标记，同账号的桌面/插件双凭据合并显示并可一键对齐。

• 同账号自动接管：桌面端与插件端是同一账号时，一条凭据 401/403 会自动改用另一条重试（钱包不变）；不同账号默认不乱切。

• 用量统计：1 / 7 / 30 天趋势、按模型积分排行、CSV 导出。

• 请求明细：逐条记录模型/耗时/token/积分/结果，失败标红、错误码一键复制；有首字耗时与桥自身开销的拆分。
• 模型体检：可用性、消耗倍率、实测成本；勾选启用/禁用，同步到 dsh。
• 环境诊断：按优先级给出"红色项不解决模型就不出现"的清单；能识别"两个客户端装进同一目录"这种真实事故。

• 每日签到：桥侧自动签（不开控制台也签）+ 手动领取。
• 中英双语：控制台与 dsh 设置页 9 个标签页全部双语。

2.4 底层桥：像样的本地服务，不是玩具

• 三套协议：OpenAI 兼容、Anthropic Messages 兼容、OpenAI Responses 兼容（Codex 用）——流式、工具调用、多轮工具结果都支持。
• 本地回环：只监听 127.0.0.1，带本地令牌；不做账号池化，不对外服务。
• 韧性：上游 5xx 自动重试、连接中断如实报错、取消立即生效、令牌过期自动续期并加密回写。
• 零运行时依赖：桥是单文件 Node 脚本（Node ≥ 18），没有 npm install。

3. 30 秒上手（dsh 用户）

▼
sh
复制代码
# 方式一：直装
dsh plugin --profile desktop add github:Ianzhyh/workbuddy-to-dsh

# 方式二：tgz（无构建、无需 allowBuilds 授权）
# 从 GitHub Releases 下载 dsh-plugin-workbuddy-1.8.2.tgz
dsh plugin --profile desktop add ./dsh-plugin-workbuddy-1.8.2.tgz

1. 装完重启一次 dsh（插件模块会被 ESM 缓存）。
2. 打开 dsh 设置 → WorkBuddy：
   • 已装 WorkBuddy 且登录过：基本无事可做，模型已经在了；
   • 没装桌面端：点「开始登录」，浏览器授权一次即可。
3. 回到对话页，选一个模型，开聊。顶部就是余额，模型名自带倍率。

CLI/其它客户端用户：双击 启动.cmd（或 node dashboard/server.mjs），打开 http://127.0.0.1:8792 在「客户端接入」里拿 Base URL 与令牌。

4. 数据与隐私的边界

• 只连本机回环，不上报任何数据；账本/日志在本地。
• 单账号设计：只驱动你自己的账号额度，不做、也不支持多账号池化、转售、托管。
• 凭据加密保管；「退出登录」只删插件自己保存的那份，不会注销上游账号。
• 诊断只读取账号/长度/有效期这类非敏感信息。

5. 必须说清的风险（这不是"官方功能"）

• 本项目依赖 WorkBuddy 未公开的上游协议与登录凭据格式（插件登录不需要桌面端，但同样走非官方设备码接口）。上游随时可能改协议或收紧风控，可用性无任何保证。
• ×0.11 是积分消耗倍率，不是人民币单价；是否与客户端内口径完全一致取决于上游，建议自行对比用量页核对。
• "本轮积分"是估算值，来源是最近一次已完成的模型请求；并发多窗口时可能对应到另一个会话。
• 使用前请自行确认符合 WorkBuddy 的服务条款；若条款不允许，请不要使用。要长期稳定的商用接入，请申请官方 API。

6. 给不同人群的小贴士

• dsh 重度用户：直接装插件；模型体检 + 请求明细能帮你把"哪个模型值得用"量化出来。
• CLI 用户（Claude Code / Codex / opencode）：用面板的「客户端接入」一键写入，比手改配置省心；配置文件改动有备份和一键撤销。
• 多账号用户：给账号起名字、拖动排序、隐藏不用的；切账号会自动重启桥并清缓存，不会把 A 账号的积分挂到 B 账号头上。
• 预算敏感用户：盯着顶部胶囊和"本轮积分"，免费模型直接标了「免费」；低余额变色会提醒你。

7. 链接

• 仓库：https://github.com/Ianzhyh/workbuddy-to-dsh
• Release（本版本）：https://github.com/Ianzhyh/workbuddy-to-dsh/releases/tag/v1.8.2
• 安装与验收清单：docs/INSTALL.md
• 常见故障排查：docs/TROUBLESHOOTING.md
• 安全说明：docs/SECURITY.md
• 完整更新记录：CHANGELOG.md

本项目与 WorkBuddy / DeepSeek 官方无关。请自担风险、自审条款、自查额度。