dsh-workbuddy-connect README

The project's README from github.com/corrinehu/dsh-workbuddy-connect. As one markdown file: README.md.

DSH WorkBuddy Connect

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 / TUI)
# 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 版)的 desktop profile 由 App 管理,官方版会直接拒绝独立 CLI 的 --profile desktop;其他发行版规则未必相同,请先检查你所用的发行版,不要盲用独立 CLI 的 --profile desktop。可以让 Agent 探查是否有合规的非市场安装路径,但不保证可行;切勿盲改 App 管理的目录或绕过其校验。

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

功能

WorkBuddy 模型出现在 DSH 模型选择器中

WorkBuddy AI 模型出现在 DSH 模型选择器中

上下文窗口列表里的模型显隐(DSH 0.1.6+ 插件配置页)

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

DSH 0.1.5 设置卡片中的模型显隐

设置卡片显示插件

卡片展开后分「状态 / 上下文 / 明细」三个标签:状态页展示账号、令牌有效期、合计积分、模型列表来源与推理档位检测;上下文页列出各模型上下文窗口,国际版可在这里关闭「使用上游声明的最大上下文窗口」(默认开启,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 的凭据文件仍在时依然生效)。

已知限制

版本兼容与历史版本

插件版本必须与 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):

固定版本安装示例: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)。

免责声明

相关项目 / 社区生态

以上项目均由第三方独立维护。其中,hana-workbuddy-connect 的兼容性、安全性及使用支持由其维护者负责。收录不代表官方背书,也不意味着本插件对内部接口提供稳定性或兼容性承诺。

致谢

许可证

MIT

dsh-workbuddy-connect (corrinehu/dsh-workbuddy-connect)

Searching Database…

What is this?DSH WorkBuddy Connect is a plugin for DeepSeek Harness (DSH) that pulls the models already available in your logged-in WorkBuddy or WorkBuddy AI desktop app straight into DSH, with zero extra configuration.
Is this a standalone app or a plugin for something else?It is a DSH provider plugin, not a standalone app: it piggybacks on the login session of an already-installed WorkBuddy desktop app, so account switching in the App is followed automatically.
How do I install it in DSH?Easiest is to hand the install to any agent with terminal access (DSH Agent, Codex, Claude Code, Cursor); manually it's installed via the DSH plugin CLI with a version pinned to your DSH kernel, e.g. 'dsh plugin --profile web add [email protected]'.
Do I need anything installed before adding this plugin?You need the WorkBuddy (China) or WorkBuddy AI (international) desktop app already installed and logged in locally — the plugin reuses that app's own login session instead of asking for separate credentials.
What's the biggest pitfall when installing this?The plugin version must exactly match your DSH kernel version (there's a compatibility table in the README); a mismatched combo makes DSH fail to start, and desktop builds auto-pick the plugin version from their bundled kernel.
Does it work the same on macOS, Windows, and Linux?It's fully verified on macOS across DSH Web/Desktop/TUI; Windows and WSL are supported by probing AppData/registry paths, and Linux works but needs you to manually point it at the credential file location since there's no auto-discovery there.
What's the difference between the WorkBuddy and WorkBuddy AI groups this plugin adds?WorkBuddy is the domestic China version and WorkBuddy AI is the international version; each shows up as its own model group in DSH with separate accounts, logins and credit balances that never mix.
Can I send images to the models through this plugin?Yes, most models including GLM-5.3-Flash and the DeepSeek-V4 series accept pasted or dragged images in chat; a few text-only models like GLM-5.1 and GLM-5.2 explicitly say they don't support it.
What happens if WorkBuddy changes its internal API?Since the plugin relies on WorkBuddy's private client interface rather than an official API, an upstream change can break the international model catalog; it then falls back from live data to the last saved list to a built-in list and marks which source is active.
Is this an official WorkBuddy or DeepSeek product?No. The README states it has no affiliation with Tencent, WorkBuddy, or DeepSeek and is not authorized or endorsed by them; it's intended for personal study and research use only.
Creator
corrinehu
Size
3.6 MB
Stars
1.3K
Age
2mo
Commits · 90 Days