The project's README from github.com/corrinehu/dsh-workbuddy-connect. As one markdown file: README.md.
English | 中文
将已登录的 WorkBuddy / WorkBuddy AI 桌面应用中可用的模型接入 DeepSeek Harness;两版分别显示各自的模型分组,并沿用各自的账号登录与积分。
前置:本机已安装并登录 WorkBuddy(国内版)或 WorkBuddy AI 桌面 App。插件直接复用 App 的登录状态,账号切换自动跟随,两版互不影响。
推荐:把安装交给本机已有的 Agent——任何具备终端与文件操作能力的助手(DSH Agent、Codex、Claude Code、Cursor 等)都可以,把下面这段话原样发给它:
请帮我安装并验证 DSH(DeepSeek Harness)插件 dsh-workbuddy-connect(项目地址:https://github.com/corrinehu/dsh-workbuddy-connect):
先阅读项目 README,确认我实际使用的界面(Web / Desktop / TUI)与 DSH 内核版本,桌面版以 App 内置核心为准,不要用独立 CLI 的版本代替;
再按版本对应关系从 npm 正式包安装(0.2.1-rc.2→0.7.8、0.2.1-rc.1→0.7.7、0.2.0-rc.2→0.7.6、rc.1→0.7.0、0.1.5–0.1.7→0.6.5),优先走本机受支持的非插件市场渠道;部分 Desktop 发行版(尤其官方 Electron 版)的 profile 由 App 管理,各发行版规则未必相同,先确认我所用的发行版,再探查其合规的安装方式,但不得绕过其校验;
任何本地文件或配置改动,先征得我同意并做好备份;
装完后验证模型选择器里出现 WorkBuddy 分组,并陪我完成一次简短对话;
若 Desktop 安装仍因 generation 校验失败(如 @types/retry 误报),请如实报告、参照上游 dataelement/dsh-desktop#688,并建议我改用独立的 Web / TUI,不要修改依赖包或绕过校验。
内核与插件版本速查(完整对应表见文末「版本兼容与历史版本」):
| DSH 内核 | 推荐插件版 |
|---|---|
| 0.2.1-rc.2 | 0.7.8(npm latest) |
| 0.2.1-rc.1 | 0.7.7 |
| 0.2.0-rc.2 | 0.7.6 |
| 0.2.0-rc.1 | 0.7.0 |
| 0.1.5 – 0.1.7 | 0.6.5 |
# Web(按实际内核固定版本,示例为 0.2.1-rc.2 → 0.7.8;也可用 github:corrinehu/dsh-workbuddy-connect 从源码安装)
dsh plugin --profile web add [email protected]
dsh web
# TUI(示例为 0.1.x 内核;该 profile 需用 pnpm 11 安装,如 npx pnpm@11)
dsh plugin --profile dsh-tui add [email protected]
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 版)的
desktopprofile 由 App 管理,官方版会直接拒绝独立 CLI 的--profile desktop;其他发行版规则未必相同,请先检查你所用的发行版,不要盲用独立 CLI 的--profile desktop。可以让 Agent 探查是否有合规的非市场安装路径,但不保证可行;切勿盲改 App 管理的目录或绕过其校验。
验证:重启对应界面后,模型选择器出现「WorkBuddy / WorkBuddy AI」分组(只装一版就只验对应一组),并从分组里选一个模型完成一次简短对话、能正常回复,才算安装成功。


图片输入:大部分模型支持在对话里直接粘贴或拖入图片(GLM-5.3-Flash、DeepSeek-V4 系列等);少数纯文字模型(如 GLM-5.1、GLM-5.2)会明确提示不支持。
推理档位: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 的凭据文件仍在时依然生效)。
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)指定实际位置。%LOCALAPPDATA%\Programs\WorkBuddy\WorkBuddy.exe,再查卸载注册表记录,国际版没有已验证的默认路径、仅查注册表。自动探测失败时,可用 WORKBUDDY_ELECTRON_BIN(国内版)或 WORKBUDDY_AI_ELECTRON_BIN(国际版)显式指定可执行文件,设置后需完全退出并重启 DSH 才生效。Linux 无法自动发现,需显式指定。WSL 下调用 Windows 侧解密程序时,插件会自动把子进程 WSLENV 中的 ELECTRON_RUN_AS_NODE 条目规范化为单一安全旗标(含 /w 转发、不做路径转换,其余条目原样保留),无需手动设置。此改动已通过离线回归测试,尚未完成 WSL2 / Windows 真机验证。authFile / authFileAI 等设置分区(settings.yaml 与 TUI /settings 均可读写);0.1.7+ / 0.2.0 的设置服务不再提供该接口,插件降级为无设置项的 provider——模型、选择器、模型显隐与上下文窗口照常工作,只是「使用上游声明的最大上下文窗口」这一偏好不再可持久化。插件版本必须与 DSH 内核匹配,不匹配的组合会导致 DSH 启动失败;桌面版按其内置核心选择插件版本。npm 上的最新版不一定适合你,以实际内核的匹配关系为准:
| DSH 内核 | 推荐插件版 | 注意事项 |
|---|---|---|
0.2.1-rc.2 |
0.7.8 |
仅适配这一内核;0.2.0-rc.2 与 0.2.1-rc.2 不同,请核对 App 内置版本。 |
0.2.1-rc.1 |
0.7.7 |
内核升级到 @earendil-works/pi-ai 1.3.0,插件同步自带 1.3.0,历史遗留的 0.87.1 overrides 必须移除(见下方 pi-ai 说明)。 |
0.2.0-rc.2 |
0.7.6 |
上一代内核线;修复企业账号模型目录缺项与国际版对话被渠道校验拦截,勿停留在有注册表回归的 0.7.2。 |
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 |
更早旧线,仅历史维护。 |
历次更新(完整记录见 releases):
@earendil-works/pi-ai 随内核升级到 1.3.0(profile 级历史遗留的 0.87.1 overrides 必须移除,否则插件无法加载);修复国际版与国内版推理档位检测停留「检测未完成」——上游把档位拒绝码改拼为 invalid_parameter_value(#143 / #148,PR #145);修复中文 Windows 控制台下注册表缺键诊断因 GBK 编码被误判(zh-CN 实机验证)。glm-5.3-flashx(#123),修复国际版对话请求被上游渠道校验拦截(#139 / #142)。固定版本安装示例:dsh plugin --profile web add [email protected]。
pi-ai 版本按内核线区分,不能混:0.2.1-rc.1 / rc.2 内核线(分别对应插件 0.7.7 / 0.7.8)已升级到 @earendil-works/pi-ai 1.3.0(由插件自带),profile 级历史遗留的 overrides: {'@earendil-works/pi-ai': '0.87.1'} 必须移除,否则插件会因加载到旧一代 pi-ai 而启动失败;0.2.0-rc.2 内核线(插件 0.7.6)仍要求 ^0.87.1,在这条线上不要把 profile 级的 pi-ai 升到 1.x,第三方插件管理器的「可更新」提示不校验 peer 约束、不能照做(#86)。
dsh-workbuddy-connect 的部分实现,为 HanaAgent 接入 WorkBuddy / WorkBuddy AI 模型。以上项目均由第三方独立维护。其中,hana-workbuddy-connect 的兼容性、安全性及使用支持由其维护者负责。收录不代表官方背书,也不意味着本插件对内部接口提供稳定性或兼容性承诺。