DSH WorkBuddy Connect

English | 中文

将已登录的 WorkBuddy / WorkBuddy AI 桌面应用中可用的模型接入 DeepSeek Harness；两版分别显示各自的模型分组，并沿用各自的账号登录与积分。

本仓库是个人 fork：基于 corrinehu/dsh-workbuddy-connect 0.7.6（MIT）修改，新增多账号账号池、额度用尽自动切换、一键/每日签到。原项目版权归 Corrine Hu 所有；本 fork 的修改同样以 MIT 发布，详见 NOTICE。0.9.0 面向 DSH 0.2.1-rc.2（pi-ai 1.x）；0.2.0-rc.2 / 0.2.1-rc.1 请用 v0.8.1。不是官方项目，与腾讯、WorkBuddy、DeepSeek 均无关联。README 中的截图 1–7 沿用上游 0.7.6，账号池与一键签到截图为本 fork 实拍。

安装

本 fork 没有发布到 npm（npm 上的 dsh-workbuddy-connect 是上游项目）。先确认你的 DSH 内核：

• 0.2.1-rc.2：装 main（0.9.0）
• 0.2.0-rc.2 / 0.2.1-rc.1：装 v0.8.1

# 0.2.1-rc.2
dsh plugin --profile web add github:jyh5555/dsh-workbuddy-connect-pro
# 0.2.0-rc.2 / 0.2.1-rc.1
dsh plugin --profile web add github:jyh5555/dsh-workbuddy-connect-pro#v0.8.1

Desktop 版 profile 一般由桌面 App 管理，按下面说明让本机 Agent 协助；不要安装 npm 上的同名上游包（那是 0.7.6，不带本 fork 的功能）。

前置：本机已安装并登录 WorkBuddy（国内版）或 WorkBuddy AI 桌面 App。插件直接复用 App 的登录状态，账号切换自动跟随，两版互不影响。

推荐：把安装交给本机已有的 Agent——任何具备终端与文件操作能力的助手（DSH Agent、Codex、Claude Code、Cursor 等）都可以，把下面这段话原样发给它：

请帮我安装并验证 DSH（DeepSeek Harness）插件 dsh-workbuddy-connect 的这个 fork（项目地址：https://github.com/jyh5555/dsh-workbuddy-connect-pro）：
先阅读项目 README，确认我实际使用的界面（Web / Desktop / TUI）与 DSH 内核版本，桌面版以 App 内置核心为准，不要用独立 CLI 的版本代替；
本 fork 的 0.9.0 面向 DSH 0.2.1-rc.2（pi-ai 1.x），0.2.1-rc.1 及更早的 0.2.x 请安装 v0.8.1 标签；未发布 npm，请从 GitHub 安装，不要安装 npm 上的同名上游 0.7.6；
部分 Desktop 发行版（尤其官方 Electron 版）的 profile 由 App 管理，各发行版规则未必相同，先确认我所用的发行版，再探查其合规的安装方式，但不得绕过其校验；
任何本地文件或配置改动，先征得我同意并做好备份；
装完后验证模型选择器里出现 WorkBuddy 分组，并陪我完成一次简短对话；
若 Desktop 安装因 generation 或兼容性校验失败，请如实报告，不要修改依赖包或绕过校验。

内核与插件版本速查（完整对应表见文末「版本兼容与历史版本」）：

DSH 内核	推荐插件版
0.2.1-rc.2	0.9.0（本 fork，pi-ai 1.x）
0.2.1-rc.1	0.8.1（本 fork，pi-ai 0.87）
0.2.0-rc.2	0.7.6（上游 npm latest）/ 0.8.1（本 fork）
0.2.0-rc.1	0.7.0
0.1.5 – 0.1.7	0.6.5

手动安装（命令行，仅 Web / TUI）

# Web（本 fork，面向 DSH 0.2.1-rc.1，从 GitHub 安装）
dsh plugin --profile web add github:jyh5555/dsh-workbuddy-connect-pro
dsh web

# TUI（示例为 0.1.x 内核；该 profile 需用 pnpm 11 安装，如 npx pnpm@11）
dsh plugin --profile dsh-tui add dsh-workbuddy-connect@0.6.5
dsh --profile dsh-tui

TUI 版本搭配：终端壳 @deepseek-harness-tui/dsh-tui 需 0.10.0-beta.5 及以上，更早版本装本插件会启动失败（events is not iterable）；推理档位的手动检测仅 Web / Desktop 提供，TUI 没有。

Desktop：部分 Desktop 发行版（尤其官方 Electron 版）的 desktop profile 由 App 管理，官方版会直接拒绝独立 CLI 的 --profile desktop；其他发行版规则未必相同，请先检查你所用的发行版，不要盲用独立 CLI 的 --profile desktop。可以让 Agent 探查是否有合规的非市场安装路径，但不保证可行；切勿盲改 App 管理的目录或绕过其校验。

验证：重启对应界面后，模型选择器出现「WorkBuddy / WorkBuddy AI」分组（只装一版就只验对应一组），并从分组里选一个模型完成一次简短对话、能正常回复，才算安装成功。

功能

• 开箱即用：安装并启用插件后即可在 DSH 中直接使用，无需额外配置。

• 国内版与国际版并存：国内版显示为「WorkBuddy」分组，国际版（WorkBuddy AI）显示为「WorkBuddy AI」分组，两版的模型、账号和积分互不混用。各自默认跟随对应 App 的当前登录：只装国际版就只出现 WorkBuddy AI，两版都装则两组并存。设置里两张卡片分别展示各自账号与余额。

• 多账号账号池：同一产品可同时保存多个账号。在桌面 App 里登录账号 B 后，到卡片里点「保存当前登录」，即把 B 的凭据复制进插件；也可用「导入令牌文件」导入另一份 .info / .json 登录文件。卡片会列出每个账号的来源、余额、令牌有效期与最近一次签到结果，可随时切换当前账号或删除。账号池按产品、按账号分别存于 $DSH_HOME/.workbuddy-accounts.json（国际版为 .workbuddy-ai-accounts.json，权限 0600），桌面 App 自己的登录文件始终只读。

• 额度用尽自动切换：请求默认使用当前账号；上游返回额度不足（402 / 积分不足等）、限流或会话失效时，插件会把该账号冷却一段时间（额度不足 1 小时、限流 1 分钟、会话失效 5 分钟），自动换下一个可用账号重发同一条请求，对话里不会看到这次失败。冷却到期后自动恢复；余额读数已为 0 的账号会被预先跳过。切换只作用于对话请求，模型目录与推理档位检测仍使用当前账号。

• 一键签到 + 每日自动签到：账号池上方提供「一键签到」，依次为所有账号领取 WorkBuddy 每日签到积分（100 积分/天，连续第 7 天 1000），并显示每个账号的结果；「每天自动签到」默认开启，每天首次运行插件时自动补签，已签到或当天重复调用由上游幂等返回，不会重复领取。签到结果按账号记录，失败会在后续轮次自动重试。

• 图片输入：大部分模型支持在对话里直接粘贴或拖入图片（GLM-5.3-Flash、GLM-5.2、DeepSeek-V4 系列等）；少数纯文字模型（如 GLM-5.1）会明确提示不支持。

• 推理档位：WorkBuddy 明确声明的档位会直接显示，例如 GLM-5.3 和 GLM-5.3-Flash 可选 low / high / max。未声明档位的模型可在 Web 和 Desktop 的模型选择器中手动检测（发送少量请求，可能消耗积分）；未检测或没有可用档位的模型使用 WorkBuddy 默认档位。

• 余额速览：选中 WorkBuddy / WorkBuddy AI 模型时，输入框底部在模型选择器旁显示当前账号的剩余积分（如 WB.3,401（积分）、国际版 WB AI.3,401（积分））。积分不自动轮询（每次读取都是真实计费查询），挂载时读取一次后可点旁边的 ↻ 手动刷新。切换会话时组件可能短暂隐藏，模型选择就绪后自动恢复；即使模型没有推理档位检测入口或余额读取失败，刷新按钮仍保留。

• 信息查看与检测：设置 → 插件 → 对应卡片可查看账号、令牌有效期、剩余积分和模型优惠，也可手动刷新模型列表并查看当前列表来自上游还是内置兜底，或对可检测模型手动检测推理档位。DSH 0.1.5 的入口在「设置 → 插件」，0.1.6+ 移到主界面左侧栏「插件」面板（workbuddy-connect → 查看）；「设置 → 模型」页两代都不显示 WorkBuddy 条目，属有意设计。

• 模型显隐：两张卡片的「上下文窗口」标签里可勾选要在模型选择器中显示的模型。隐藏配置按登录账号分别保存：切换账号自动切换各自配置，切回后恢复；新账号和新上架模型默认显示。隐藏只影响选择器中的可选性，正在使用该模型的已有会话不受影响。

同一份界面在 DSH 0.1.5 的设置卡片中原样生效：

• 企业账号积分：国内版企业账号（enterpriseId 非空）走企业计费接口读取周期额度，卡片显示「企业额度」与周期重置时间。

• 费率比例：每个模型名后直接显示积分倍率（如 GLM-5.2 · x0.79、Hy3 · x0.00），/model 弹窗与输入框的模型下拉都能看到；倍率仅用于显示，不影响实际请求。

• 徽章展示：促销徽章（限时免费、夜间折扣）直接跟在模型名后（如 Hy4 preview · x0.00 · 限时免费），设置卡片会汇总当前有优惠的模型，数据以 WorkBuddy 服务端为准、每次启动 DSH 时同步。国际版促销来自服务端 modelPromotions（含生效时段），过期后徽章自动撤销；由于服务端把折后价直接写进模型的倍率字段，原价无法还原，此时该模型倍率显示为「价格未知 — 刷新后更新」，而不是继续显示折扣价或「免费」。

卡片展开后分「状态 / 上下文 / 明细」三个标签：状态页展示账号、令牌有效期、合计积分、模型列表来源与推理档位检测；上下文页列出各模型上下文窗口，国际版可在这里关闭「使用上游声明的最大上下文窗口」（默认开启，DSH 按上游最大窗口安排上下文压缩；关闭后改用上游默认窗口，偏好持久化）；明细页展示各套餐余量与模型优惠。国内版与国际版各有一张自己的卡片。

推理档位为什么这样设计

WorkBuddy 中模型的推理档位信息目前分散在上游接口与客户端自身的私有 UI 逻辑中，且模型目录变化很快。若插件根据经验为所有未声明模型补齐统一档位，就需要持续追赶这些未公开、没有稳定契约的产品逻辑。

实测还发现，有些模型虽然接受 reasoning_effort 参数，却可能忽略未知值并回退到默认行为；一次请求返回成功，并不能证明某个档位真实可用。

因此，对于没有声明档位的模型，Web 和 Desktop 采用用户主动授权触发、动态获取档位的方式：先确认上游会校验该参数，再逐项确认哪些规范档位被接受。检测会发送少量请求，可能消耗积分；结果只表示当前上游接受该档位，不承诺它一定改变推理效果、速度或积分消耗。

命令行

dsh plugin --profile <web|dsh-tui> exec dsh-workbuddy-connect status：登录状态与剩余积分（--json 输出机器可读格式；另有 doctor 诊断、logout 清理凭据）。desktop profile 一般由桌面 App 管理，CLI（含 exec）对其不可用（见安装章节的 Desktop 说明）。

默认操作国内版；加 --provider workbuddy-ai 操作国际版：

dsh plugin --profile web exec dsh-workbuddy-connect status --provider workbuddy-ai
dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-ai

logout 只删除该版插件自留的凭据副本，不动桌面 App 自己的登录，也不承诺一定让模型分组消失（App 的凭据文件仍在时依然生效）。

已知限制

• 在 macOS 的 DSH Web / Desktop / TUI 下验证通过（0.3.2 起要求 0.1.5-rc.1+、Node 22+；TUI 需终端界面插件 0.10.0-beta.5 及以上，见安装章节说明）。Windows 会依次探测 Local 与 Roaming AppData；WSL 会优先从挂载的 Windows 用户目录读取登录凭据。若 Windows 与 Linux 用户名不同且 Windows 环境变量未传入 WSL，请通过 WORKBUDDY_AUTH_FILE（国际版为 WORKBUDDY_AI_AUTH_FILE）指定实际位置。
• 加密桌面凭据的解密程序定位：解密程序在 macOS 与 Windows 上会自动探测；Windows 上国内版先查默认路径 %LOCALAPPDATA%\Programs\WorkBuddy\WorkBuddy.exe，再查卸载注册表记录，国际版没有已验证的默认路径、仅查注册表。自动探测失败时，可用 WORKBUDDY_ELECTRON_BIN（国内版）或 WORKBUDDY_AI_ELECTRON_BIN（国际版）显式指定可执行文件，设置后需完全退出并重启 DSH 才生效。Linux 无法自动发现，需显式指定。WSL 下调用 Windows 侧解密程序时，插件会自动把子进程 WSLENV 中的 ELECTRON_RUN_AS_NODE 条目规范化为单一安全旗标（含 /w 转发、不做路径转换，其余条目原样保留），无需手动设置。此改动已通过离线回归测试，尚未完成 WSL2 / Windows 真机验证。
• 国际版的模型目录来自 App 界面接口：服务端按 User-Agent 分流下发，属私有实现，上游改动可能使其失效。届时插件按「本账号上次成功目录 → 内置目录」降级，并在卡片上标明来源（实时 / 已保存 / 内置）、更新时间与失败原因，但不能保证长期兼容。国内版目录走官方 CLI 同款接口，不受此影响。
• 国际版仍未覆盖的环境：Windows / WSL / Linux 下国际版 App 的版本读取尚未找到可靠来源，会退回最近保存的版本或内置值。macOS 上已通过真实 shim 验证 GPT 系完整回复、工具调用与续轮。
• 无凭据时的行为变化：某版 App 从未登录、也没留下插件自留副本时，该版模型分组不再显示。此前国内版会显示一份内置兜底列表，但那些模型选了必然报错。
• 企业账号积分目前仅覆盖国内版：国际版企业账号的计费接口尚未验证，仍按个人版接口读取；待有实测结论后再扩展。企业账号分支在本机无法自测（开发机为个人账号），依据官方 App 的接口契约实现，欢迎企业账号用户反馈实测结果。
• 设置入口随 DSH 版本而异：0.1.5 / 0.1.6 上插件照常安装 authFile / authFileAI 等设置分区（settings.yaml 与 TUI /settings 均可读写）；0.1.7+ / 0.2.0 的设置服务不再提供该接口，插件降级为无设置项的 provider——模型、选择器、模型显隐与上下文窗口照常工作，只是「使用上游声明的最大上下文窗口」这一偏好不再可持久化。
• 多账号的添加方式：只在插件内提供「保存当前桌面登录」与「导入令牌文件」两条路径，不提供扫码登录。前者需要你在桌面 App 里切换登录后逐个保存；后者接受桌面 .info、插件自留副本或粘贴的 JSON 令牌。账号池文件保存的是真实 access/refresh token（权限 0600），请勿外传或提交仓库。
• 自动切换只覆盖对话请求：额度/限流/会话失效触发的换号只发生在对话链路；模型目录刷新与推理档位检测仍用当前账号，失败不会自动换号。额度判定以错误为准，余额读数为 0 的账号会被预先跳过，但「刚耗尽、缓存未刷新」的账号仍会先试一次再切换。
• 签到接口为客户端私有接口：billing/meter/daily-checkin 的返回码（0 成功、10001 今日已签）来自社区实测，国内版可用性已确认；国际版只是按同一域名形状尝试，未做真机验证。上游改版后签到可能失效，插件会如实显示失败原因。
• 依赖 WorkBuddy 客户端接口（非官方开放 API），WorkBuddy 更新后插件可能需要随之调整。

版本兼容与历史版本

插件版本必须与 DSH 内核匹配，不匹配的组合会导致 DSH 启动失败；桌面版按其内置核心选择插件版本。npm 上的最新版不一定适合你，以实际内核的匹配关系为准：

DSH 内核	推荐插件版	注意事项
0.2.1-rc.2	0.9.0（本地增强版）	该版把 dsh-llm-pi-ai 的 pi-ai 升到 1.x；0.9.0 已适配（pi-ai 1.3.0），功能与 0.8.x 相同。
0.2.1-rc.1	0.8.1（本地增强版）	多账号账号池、额度用尽自动切换、一键/每日签到；peer 同时声明 0.2.0-rc.2 与 0.2.1-rc.1（pi-ai 0.87.1）。
0.2.0-rc.2	0.7.6（上游 npm latest）/ 0.8.1（本 fork）	当前 npm 最新线；0.8.1 同样覆盖这一内核，并带多账号与签到。
0.2.0-rc.1	0.7.0	0.7.1 起不再支持 rc.1，请停留本版。
0.1.5 – 0.1.7	0.6.5	旧内核最终版；0.7.0 起仅面向 0.2.0。
0.1.2-rc.1	0.3.1	更早旧线，仅历史维护。
0.1.1-rc.2	0.2.6	更早旧线，仅历史维护。

历次更新（0.7.x 及更早的完整记录见上游 releases）：

• 0.9.0（面向 DSH 0.2.1-rc.2）：适配该内核把 dsh-llm-pi-ai 升级到 pi-ai 1.x（固定 1.3.0），pi-ai 版本守卫同步到 1.3.0，跨实例测试放宽超时；peer 改为接受 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2——此前只声明精确的 0.2.1-rc.2，内核版本字符串稍有差异就会被兼容性检查拦下，表现为功能正常但插件页不显示卡片。功能与 0.8.1 相同（多账号池、额度切换、一键/每日签到）。0.2.0-rc.2 / 0.2.1-rc.1 请继续用 v0.8.1。
• 0.8.1：兼容范围从「仅 0.2.1-rc.1」扩到 0.2.0-rc.2 || 0.2.1-rc.1，修复自动签到定时器在测试中提前触发导致的偶发失败；没有功能改动。面向 0.2.1-rc.2 的 pi-ai 1.x 适配放在 0.9.0。
• 0.8.0（本地增强版，面向 DSH 0.2.1-rc.1）：新增同一产品的多账号账号池（保存当前桌面登录 / 导入令牌文件，卡片内切换与删除）；请求在额度不足、限流或会话失效时自动冷却当前账号并切换到下一个可用账号重发；账号卡片支持「一键签到」与每日自动签到，签到结果按账号记录并在失败后重试。账号池按产品隔离，存于 $DSH_HOME（权限 0600）。
• 0.7.6：修复企业账号模型目录缺少 glm-5.3-flashx（#123），修复国际版对话请求被上游渠道校验拦截（#139 / #142）。
• 0.7.5：修复切换会话后输入框余额与刷新按钮消失（#125 / #132），修复 WSL 调用 Windows 凭据解密程序的环境转发（#133），README 收录社区项目（#130）。
• 0.7.4：Windows 诊断与稳定性改进：注册表子进程输出超限准确分类、跨平台测试假设修正（#62），安装说明重排。
• 0.7.3：修复 Windows 非默认安装路径下注册表自动发现失败（#105）。
• 0.7.2：pi-ai 改为插件自带依赖，并修复推理字段请求被拒（#92）；该版存在 Windows 注册表回归，请使用 0.7.4 或更新的正式版本。
• 0.7.1：收窄 pi-ai 依赖范围。
• 0.7.0：适配 DSH 0.2.0 的设置服务改造，不再支持 0.1.x。
• 0.6.5：0.1.x 线最终版本。

固定版本安装示例：dsh plugin --profile web add github:jyh5555/dsh-workbuddy-connect-pro#v0.8.0。

不要把 profile 级的 @earendil-works/pi-ai 升到 1.x：本插件与 0.2.0-rc.2 这一代内核都要求 ^0.87.1（0.7.2 起由插件自带），第三方插件管理器的「可更新」提示不校验 peer 约束、不能照做（#86）；为此历史遗留的 overrides: {'@earendil-works/pi-ai': '0.87.1'} 在确认其他插件不依赖前也不要盲目移除。

免责声明

• 本项目仅供个人学习和研究使用，仅驱动使用者自己的 WorkBuddy 账号在本机调用，请勿用于商业用途或超出个人合理使用的场景。
• 使用者需遵守 WorkBuddy 的服务条款；因使用本项目产生的任何后果（包括但不限于账号被限制、额度被清空、服务中断），由使用者自行承担。
• 本项目作者不对任何因使用或滥用本项目产生的直接或间接损失负责。
• 本项目与腾讯、WorkBuddy、DeepSeek 均无关联，未获其授权或认可；文中出现的名称仅用于描述兼容关系，其商标权利归各自所有。

致谢

本 fork 的工作建立在这几个项目之上：

• corrinehu/dsh-workbuddy-connect（MIT）— 原作者项目。本 fork 基于它的 0.7.6 派生：模型接入、WorkBuddy 凭据读取、provider 注册、卡片与探针这套骨架都由原作者完成，本 fork 只在其上增加账号池、额度切换与签到。版权归 Corrine Hu 所有，详见 NOTICE。
• Sliverkiss/workbuddy2api（MIT）— WorkBuddy 上游协议的参照实现，原作者项目同样参考了它。
• franksong2702/dsh-codex-connect（Apache-2.0）— DSH 插件结构与 provider 注册的参照。

许可证

MIT