dsh-connect-workbuddy 快速上手教程:3 步把 WorkBuddy 模型接入 DeepSeek Harness

原创2026-10-30 11:05:493,872 阅读

dsh-connect-workbuddy 快速上手教程:3 步把 WorkBuddy 模型接入 DeepSeek Harness

dsh-connect-workbuddy 是一个 DeepSeek Harness(DSH)插件:它把本机已登录的 WorkBuddy 桌面版账号(国内版与国际版)接入 DSH 的模型选择器,并提供只读的积分概览、逐模型积分倍率、每日签到和多账号池自动换号。你不需要任何 API Key,只要本机登录过 WorkBuddy 桌面 App,3 步就能在 DSH 里用上 WorkBuddy 的模型,并在输入框旁实时看到剩余积分。

一、准备工作:先装好两样东西

🧰 第 0 步(装插件之前):

  1. 安装并登录 WorkBuddy 桌面 App(国内版或国际版均可)。插件复用的正是这份登录态,凭据文件只读、永不被改写(凭据探测逻辑见 src/auth.ts)。
  2. 确认 DSH 版本 ≥ 0.1.7-rc.1(0.2.x 正式版同样支持)。版本不满足时插件会被宿主静默跳过,表现为「provider 不注册、卡片不出现」,所以建议先升级到正式版的 0.2.x。

⚠️ 风险提示:插件走的是 WorkBuddy 客户端自身的接口(非官方开放 API),上游收紧限制时可能失效。每次调用消耗的都是你自己账号的额度,使用前请自行评估账号风险(详见 README.md 的「免责声明」)。

dsh-connect-workbuddy 设置卡片:模型目录、积分倍率与逐模型开关

二、第 1 步:安装 dsh-connect-workbuddy 插件

推荐使用 DSH 自带的插件命令安装 npm 已发布版本:

dsh plugin --profile desktop add dsh-connect-workbuddy

按你使用的界面选 profile(Web / Desktop / TUI 均支持):

dsh plugin --profile web add dsh-connect-workbuddy     # Web
dsh plugin --profile dsh-tui add dsh-connect-workbuddy # TUI

安装、更新或卸载后重启 DSH 进程即可生效。两个新手常踩的坑:

  • 想立刻用刚发布的版本,请写精确版本号(如 dsh-connect-workbuddy@5.12.4),浮动范围在 pnpm 的 24 小时新版本等待期内会被静默压回旧版。
  • Windows / macOS / Linux 三平台一等支持,平台差异(凭据路径、加密凭据等)见 docs/WINDOWS.md。

三、第 2 步:确认登录状态,刷新模型目录

装好后先跑一条诊断命令,确认插件真的读到了 WorkBuddy 登录态:

dsh plugin --profile desktop exec dsh-connect-workbuddy status  # 登录状态与剩余积分
dsh plugin --profile desktop exec dsh-connect-workbuddy doctor  # 凭据路径与宿主诊断

status 与 doctor 都支持 --json 输出。status 正常显示积分,说明凭据探测成功;报未登录时,卡片上会逐条列出「探测过哪些路径、各自为什么没成」,按提示处理即可。

然后打开 DSH 设置里的 dsh-connect-workbuddy 设置卡片(顶部有「国内版 / 国际版」两个 tab,各有一套独立的账号池与模型管理):

  1. 进入「模型」栏,点「从 WorkBuddy 刷新」,拉取上游完整模型目录;
  2. 模型名后的 x0.79 这类数字是上游给出的积分倍率,x0.00 代表免费,活动时段(如夜间折扣)会自动显示折后价;
  3. 勾选你常用、且厂商文档确认支持图片输入的模型(未核实的一律不猜);
  4. 点「保存」落盘——刷新是草稿操作,点保存才真正生效。

此时回到 DSH 的模型选择器,GLM-5.3 · x0.79 这类 WorkBuddy 模型就会出现在列表里,国内版、国际版两组模型可同时在线、不同会话各选一边,互不干扰(provider 注册与路由见 src/adapter.ts)。

四、第 3 步:选择模型开始对话,顺手管理积分

选一个 WorkBuddy 模型发一条消息,插件就接好了。接下来这些「只读但省心」的能力会自动工作:

  • 输入框积分胶囊:会话模型是 WorkBuddy 时,输入框工具栏常驻 WB CN · 1,072 这类只读读数,按当前模型自动切换国内/国际版余额,每 5 分钟刷新,点开可按账号切号;
  • 模型行测试按钮:对限量模型发一次真实体积探测,直接告诉你「能否使用、何时恢复」,不用再靠试错猜冷却时间(注意:测试是真实请求,请逐个点);
  • 排队提示:模型繁忙时插件会报出你的排队位次,并明确不自动重发——重发换不来位次,只浪费额度。

进阶:多账号自动换号(账号池)

一台机器上登录过多个 WorkBuddy 账号?把要用的账号勾进账号池,再打开「启用账号池」:

dsh-connect-workbuddy 账号池:成员排序、积分余额与签到状态

  • 每次请求由排序规则自动选号(可用优先 → 快过期积分先花 → 积分高 → 凭据新);
  • 某账号撞上 429 限流 / 402 无积分 / 401 凭据失效时,自动换下一个可用账号重试;
  • 「签到勾选的账号」「测试勾选的账号」两个批量按钮随时可用——注意签到会真实领取当日奖励,测试默认指向该区域倍率为 0 的免费模型;
  • 关闭账号池后,你手动选的账号立刻恢复完全生效,池子从不写回你的选择。

额度报错怎么看

对话里出现「当前请求的额度已用尽」类提示时,先分清三种情况(额度提示的展示形态见下图):

DSH 额度提示:额度已用尽的对话内提示样式

现象 真实原因 怎么办
14003 模型繁忙 模型级暂时限流,与积分无关 换一个模型即可
429 + 国际版两个同名 Deepseek 模型 选到了付费孪生(x0.03)而非免费款(x0.00) 选中带 x0.00 后缀的那个
6004 每日额度 每日额度耗尽,与积分余额无关 等上游给出的恢复时间

账号池开启时,前两种都会自动换号,不用手动处理。

参考资源

  • README.md —— 完整功能、工作原理与已知限制
  • CHANGELOG.md —— 版本更新日志
  • docs/WINDOWS.md —— Windows 平台差异与已知限制
  • tests/ —— 各功能的验收测试
  • 设置入口:DSH 设置页中的 dsh-connect-workbuddy 卡片(国内版 / 国际版双 tab)

常见问题速答

  • 报「provider 不注册、卡片没出现」? 99% 是 DSH 版本不匹配,插件被宿主门禁静默跳过,升级到 0.1.7-rc.1 ~ 0.2.x 正式版后重装。
  • 升级命令跑完了版本却没变? pnpm 新版本等待期,改成精确版本号再装一次。
  • 服务器上没有 WorkBuddy App? 未加密凭据可以从已登录机器整体拷贝凭据目录;加密凭据(5.6.0 起)必须 App 在场,跑 doctor 看 Encrypted-credential support 一行即可判断。
  • 想彻底撤销? 卸载插件并重启 DSH;logout 命令可清理插件持有的凭据副本,但不会改动桌面 App 的登录。

按这三步走完,你的 DSH 模型选择器里应该已经能选到 WorkBuddy 的模型,输入框旁也能看到实时积分了。后续想关思考、限上下文预算、开生图工具,都直接去设置卡片的对应 tab 里勾选保存即可。

登录后查看全文
dsh-connect-workbuddy