🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
← 全部攻略

WorkBuddy 桌面版模型被接进 DSH 模型选择器的全过程

工具 / 效率类文章2026/10/4 发布12 次阅读

DeepSeek Harness(下称 DSH)的模型列表本来由引擎自己维护,而 dsh-workbuddy-connect 做了一件不太一样的事:它不去新建一套账号体系,而是把 WorkBuddy 桌面 App 里已经可用的那批模型——GLM-5.3、GLM-5.2、DeepSeek-V4-Pro、DeepSeek-V4-Flash、Kimi-K3、MiniMax-M3、Hy3 等——直接搬进 DSH 的模型选择器,装好后零配置即可切换。下面按「凭据 → 注册 → 档位 → 上下文 → 分组」的顺序,拆开看它到底是怎么接上的。

起点:模型已经躺在桌面 App 里

插件本身不提供任何模型。它的定位是 dsh 原生插件 · desktop,分类 token 是 desktop,README 里写得很直白:把 WorkBuddy 桌面 App 里包含的模型自动接入 DSH。也就是说,能用哪个模型,取决于你本机装了哪个 WorkBuddy 桌面 App、登录了哪个账号。

这个前提决定了整条链路的方向:不是「插件连到某个云 API」,而是「插件在本机读取桌面 App 的状态,再把它翻译成 DSH 能识别的 provider」。

凭据从哪来:读桌面 App 的登录,而不是让你再登一次

最容易被忽略的一环是凭据。插件复用桌面 App 的登录状态,账号切换会自动跟随,你不需要在 DSH 里再输一遍。桌面侧的凭据是加密存储的,插件需要定位并调用对应的解密程序:

  • macOS 走各产品自己的默认路径与 App 发现;
  • Windows 上,国内版先查 %LOCALAPPDATA%\Programs\WorkBuddy\WorkBuddy.exe,再查卸载注册表;国际版没有已验证的默认安装位置,只查注册表;
  • 两个产品只按各自的 App 身份(bundle id / 注册表名 / 可执行文件名)定位,不会互相误选。

如果自动定位失败,可以用环境变量兜底:国内版 WORKBUDDY_ELECTRON_BIN,国际版 WORKBUDDY_AI_ELECTRON_BIN(两个变量自 0.6.4 起分离)。注意这两个变量是在插件构造时读取的,设置后必须完全退出并重启 DSH;Windows 上还建议注销重登后再启动,因为 explorer 会缓存旧的环境块。

WSL 用户需要额外留意:插件会优先从挂载的 Windows 用户目录读登录凭据,但如果 Windows 与 Linux 用户名不同、且 Windows 环境变量没有传入 WSL,就得用 WORKBUDDY_AUTH_FILE(国际版 WORKBUDDY_AI_AUTH_FILE)显式指定凭据文件的实际位置。

provider 注册:模型怎么出现在选择器里

凭据拿到之后,插件把它们注册成 DSH 的 provider,模型就以分组的形式出现在聊天模型选择器里。/model 弹窗和输入框下拉都能看到它们,模型名后还会直接显示积分倍率,例如 GLM-5.2 · x0.79、Hy3 · x0.00——倍率只是显示,不影响实际请求。

促销徽章也跟在模型名后面(如 Hy4 preview · x0.00 · 限时免费),以 WorkBuddy 服务端数据为准,每次启动 DSH 时同步。这里有个值得记录的细节:国际版促销来自服务端的 modelPromotions(含生效时段),过期后徽章撤销;而由于服务端把折后价直接写进倍率字段,原价无法还原,此时该模型倍率会显示「价格未知 — 刷新后更新」,而不是继续显示折扣价或「免费」。

推理档位:为什么不做一次性补齐

档位是这个插件里最克制的一块。WorkBuddy 明确声明的档位会直接显示,比如 GLM-5.3 和 GLM-5.3-Flash 可选 low / high / max;对于没有声明档位的模型,Web 和 Desktop 可以在模型选择器里点「推理等级」手动检测。

为什么不干脆给所有模型补一套统一档位?README 解释了原因:档位信息分散在上游接口与客户端自身的私有 UI 逻辑中,模型目录变化很快,靠经验补齐就得持续追赶没有稳定契约的产品逻辑。而且实测发现,有些模型虽然接受 reasoning_effort 参数,却可能忽略未知值并回退到默认行为——一次请求返回成功,并不能证明某个档位真实可用。

于是它改成用户主动授权、动态获取:先确认上游会校验该参数,再逐项确认哪些规范档位被接受。代价是检测会发送少量请求,可能消耗积分;未检测或没有可用档位的模型,仍走 WorkBuddy 默认档位。TUI 界面不提供这个检测入口。

上下文窗口与显示开关:按账号分开保存

设置卡片分成「状态 / 上下文 / 明细」三个标签:状态页展示账号、令牌有效期、合计积分、模型列表来源与档位检测;上下文页列出各模型的上下文窗口;明细页展示各套餐余量与模型优惠。国际版在上游声明了更大可选窗口时,可以切换「使用上游声明的最大上下文窗口」,该开关默认开启,偏好会持久化,重启后保持。

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

双版本分组隔离:两套账号,两组模型

国内版 WorkBuddy 与国际版 WorkBuddy AI 的分组是严格隔离的:装哪个 App 就出现哪个分组,两个都装则两组并存,各自用自己的账号与积分,互不混用;退出其中一版,对应分组消失。设置里也是两张卡片,分别展示各自的账号与余额。

企业账号积分目前只覆盖国内版:国内版企业账号(enterpriseId 非空)走企业专用计费接口读取周期额度,卡片显示「企业额度」与周期重置时间;国际版企业账号的计费接口尚未验证,仍按个人版接口读取。另外,国际版的模型目录来自 App 界面接口(服务端按 User-Agent 分流下发),属私有实现,上游改动可能使其失效;国内版目录走官方 CLI 同款接口,不受此影响。

一条容易踩的边界:某版 App 从未登录、也没留下插件自留副本时,该版模型分组不再显示。此前国内版会显示一份内置兜底列表,但那些模型选了必然报错。

总结

它把「桌面 App 已有能力」翻译成「DSH 里的 provider」,靠复用登录凭据、动态探测档位和按账号隔离的显示配置完成接入;想对照同类插件的中文清单与安装形态,见 DeepSeek Harness Hub 插件清单。

适合与不适合

适合:本机已装并登录 WorkBuddy 桌面 App 的 macOS 用户;想在国内版与国际版之间切换账号、又不希望两套积分混用的人;需要在对话里直接贴图(GLM-5.3-Flash、GLM-5.2、DeepSeek-V4 系列等)的人。

不适合:主力环境是 Windows / Linux、又不愿配置环境变量的用户,自动定位支持不完整;介意「国际版模型目录依赖私有接口、不保证长期兼容」的人;以及任何打算把它用于商业用途的人,项目免责声明明确限定个人学习研究。

标签:DSH WorkBuddy Connect、DeepSeek Harness、模型接入原理、桌面端插件、provider 注册

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

回到顶部