零配置接入 WorkBuddy 大模型:DSH WorkBuddy Connect 完全入门指南
零配置接入 WorkBuddy 大模型:DSH WorkBuddy Connect 完全入门指南
DSH WorkBuddy Connect 是一个零配置插件,它能把 WorkBuddy 桌面 App 中已登录的模型自动接入 DeepSeek Harness(DSH),装完就能在模型选择器里直接用 WorkBuddy 大模型,账号与积分自动跟随,无需填写任何 API Key。
它解决了什么问题
很多开发者已经在用 WorkBuddy 桌面 App 登录并充值了积分,却希望在 DSH(DeepSeek Harness)里调用同一批模型,又不想重复配置一套独立的 API 凭据。
DSH WorkBuddy Connect 正是为此而生:
- 直接复用 App 登录状态:插件读取桌面 App 已有的登录凭据,账号切换自动跟随,不额外存密码;
- 国内版与国际版并存:装 WorkBuddy 显示「WorkBuddy」分组,装 WorkBuddy AI 显示「WorkBuddy AI」分组,两者互不混用;
- 开箱即用:安装并启用后立即可用,没有配置项要填。
它的核心适配逻辑集中在 src/adapter.ts 中注册的 workbuddy provider,而两个 App 的差异(文件名、接口地址、显示名)被统一收敛到 src/variants.ts 这个描述符里,这也是它能同时兼容国内外两版的关键设计。
安装前只需准备这一步
安装插件本身很简单,但有一个前置条件必须满足:
本机已安装并登录了 WorkBuddy(国内版)或 WorkBuddy AI(国际版)桌面 App。
插件不替你登录,它只是读取你现有的登录状态。只要 App 处于登录态,DSH 侧就能自动出现对应的模型分组。
内核与插件版本对应表
插件版本必须与 DSH 内核匹配,装错会导致 DSH 启动失败。对照下表选择:
| DSH 内核 | 推荐插件版 |
|---|---|
| 0.2.0-rc.2 | 0.7.4(npm latest) |
| 0.2.0-rc.1 | 0.7.0 |
| 0.1.5 – 0.1.7 | 0.6.5 |
桌面版按其内置核心选择插件版本,npm 上的最新版不一定适合你,请以实际内核为准。完整对照见 README.md。
两种安装方式:让 Agent 代劳,或命令行手动装
方式一(推荐):把安装交给本机已有的 Agent
任何具备终端与文件操作能力的助手(DSH Agent、Codex、Claude Code、Cursor 等)都能完成安装。只需把一段固定指令原样发给它,它会先确认你使用的界面(Web / Desktop / TUI)与 DSH 内核版本,再从 npm 正式包按版本对应关系安装,最后帮你验证模型选择器里出现了 WorkBuddy 分组。
这种方式的好处是:Agent 会自动处理不同发行版的合规安装路径,避免你手改受 App 管理的目录。
方式二:命令行手动安装(Web / TUI)
如果你更喜欢自己掌控,可以按内核版本固定安装:
# Web 示例(0.2.0-rc.2 内核 → 0.7.4 插件)
dsh plugin --profile web add dsh-workbuddy-connect@0.7.4
dsh web
# TUI 示例(0.1.x 内核;该 profile 需用 pnpm 11 安装)
dsh plugin --profile dsh-tui add dsh-workbuddy-connect@0.6.5
dsh --profile dsh-tui
注意:部分 Desktop 发行版(尤其官方 Electron 版)的
desktopprofile 由 App 管理,会直接拒绝独立 CLI 的--profile desktop。请勿盲改 App 管理的目录或绕过其校验,可以让 Agent 探查合规的非市场安装路径。
如何验证安装成功
重启对应界面后,成功的标志是:
- 模型选择器中出现「WorkBuddy」或「WorkBuddy AI」分组(只装一版就只出现对应一组);
- 从分组里选一个模型,完成一次简短对话并正常回复。
安装成功后,你的模型选择器会看到类似下图的 WorkBuddy 分组,每个模型名后直接标注了积分倍率与促销徽章:
只装国际版时,分组会显示为「WorkBuddy AI」,模型列表与徽章文案均为英文风格:
核心功能一览
图片输入
大部分模型支持在对话里直接粘贴或拖入图片(如 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 默认档位。
输入框底部的「推理等级」就是这里的选择入口,点击即可切换:
为什么这样设计?因为实测发现有些模型虽接受
reasoning_effort参数,却会忽略未知值并回退默认行为——一次请求成功并不证明某个档位真实可用。所以插件采用「用户主动授权 + 动态检测」而非凭经验硬填,详细原理见 README.md。
余额速览
选中 WorkBuddy 模型时,输入框底部在模型选择器旁会显示当前账号的剩余积分(如 WB.3,401(积分))。积分不自动轮询(每次读取都是真实计费查询),挂载时读取一次后可点旁边的 ↻ 手动刷新。
模型显隐:按需精简选择器
模型太多想隐藏几个?在卡片的「上下文窗口」标签里勾选即可。隐藏配置按登录账号分别保存:切换账号自动切换各自配置,切回后恢复;新账号和新上架模型默认显示。
同一份界面在 DSH 0.1.5 的设置卡片中原样生效:
设置卡片:账号、积分、档位一站查看
进入 设置 → 插件,展开 DSH WorkBuddy Connect 卡片,会看到账号登录状态、令牌有效期、剩余积分合计,以及每个模型的推理档位检测结果。卡片分「状态 / 上下文 / 明细」三个标签,分别对应账号状态、上下文窗口与套餐余量:
DSH 0.1.6+ 的入口移到主界面左侧栏「插件」面板,两张卡片(国内版 / 国际版)分别独立展示各自账号与余额:
费率比例与促销徽章
每个模型名后直接显示积分倍率(如 GLM-5.2 · x0.79),促销徽章(限时免费、夜间折扣)直接跟在模型名后(如 Hy4 preview · x0.00 · 限时免费)。数据以 WorkBuddy 服务端为准,每次启动 DSH 时同步;国际版促销过期后徽章自动撤销。
命令行:随时查登录状态与积分
不打开界面也能查状态:
# 默认查国内版
dsh plugin --profile web exec dsh-workbuddy-connect status
# 加 --provider 查国际版
dsh plugin --profile web exec dsh-workbuddy-connect status --provider workbuddy-ai
另有 doctor 诊断、logout 清理凭据(--json 可输出机器可读格式)。logout 只删除该版插件自留的凭据副本,不动桌面 App 自己的登录。命令入口定义见 src/bin.ts。
版本兼容:避免装错插件
插件与 DSH 内核是强绑定的,不匹配的组合会导致 DSH 启动失败。请严格对照上表:
0.2.0-rc.2→0.7.4(勿停留在 0.7.2,该版有 Windows 注册表回归);0.2.0-rc.1→0.7.0(0.7.1 起不再支持 rc.1);0.1.5 – 0.1.7→0.6.5。
不要把 profile 级的
@earendil-works/pi-ai升到 1.x,本插件与 0.2.0-rc.2 内核都要求^0.87.1,第三方插件管理器的「可更新」提示不校验 peer 约束,不能照做。
已知限制
- 平台:macOS 已验证通过;Windows 会依次探测 Local 与 Roaming AppData;WSL 优先从挂载的 Windows 用户目录读取凭据,用户名不一致时可用
WORKBUDDY_AUTH_FILE显式指定。 - 国际版目录来自 App 界面接口:属私有实现,上游改动可能使其失效;届时插件按「上次成功目录 → 内置目录」降级,并在卡片标明来源。
- 企业账号积分目前仅覆盖国内版:国际版企业计费接口尚未验证。
- 依赖 WorkBuddy 客户端接口(非官方开放 API),WorkBuddy 更新后插件可能需要随之调整。
常见问题 FAQ
Q:装完没看到 WorkBuddy 分组? A:确认对应 App 处于登录态;只装一版就只验对应一组;退出一版 App 则对应分组消失。若从未登录且无凭据副本,该版分组不显示(属正常设计)。
Q:国内版和国际版能同时用吗? A:可以,两版各自独立、互不混用。装两个版本后选择器里会出现「WorkBuddy」和「WorkBuddy AI」两个分组。
Q:积分会重复扣吗? A:不会。插件只是复用 App 登录态调用,计费仍走 WorkBuddy 服务端,与你在 App 里使用一致。
Q:设置里「模型」页看不到 WorkBuddy 条目? A:属有意设计,「设置 → 模型」两代都不显示 WorkBuddy 条目,请在「设置 → 插件」查看。
结语
DSH WorkBuddy Connect 把「已有 WorkBuddy 登录态」直接变成 DSH 里可用的模型来源:零配置、双版本并存、积分自动跟随。只需确认 App 已登录、按内核选对插件版本,几分钟就能在模型选择器里看到属于自己的 WorkBuddy 大模型分组。更多源码细节可参阅 src/adapter.ts 与 src/catalog.ts。
本项目仅供个人学习和研究使用,请遵守 WorkBuddy 服务条款,勿用于商业用途。






