前言¶
在 DeepSeek Harness（DSH）里做 Agent 开发时，模型来源往往和日常用的客户端是两套：一边要配 API Key 或自建网关，一边在 WorkBuddy / WorkBuddy AI 桌面 App 里已经登录、有积分和模型目录。官方插件 dsh-workbuddy-connect 可以把桌面 App 的模型挂进 DSH，但上游 v0.7.9 已停止维护；在较新的 DSH 0.2.x 内核上还可能被兼容性检查拦下，发消息时也可能遇到 WorkBuddy 网关返回 HTTP 400（code 11128「请求被拦截」）。下面介绍维护者 LJY-YL 发布的社区修复版（0.7.9-p1），以及如何在核对源码与许可证的前提下安装使用。
这是什么¶
DSH WorkBuddy Connect（npm 包名 dsh-workbuddy-connect）是 DSH 的客户端类插件：读取本机已登录的 WorkBuddy（国内版）或 WorkBuddy AI（国际版）桌面 App 的凭据与模型信息，在 DSH 模型选择器里出现对应分组，请求仍走 WorkBuddy 侧计费与账号体系，无需在插件里再配一套 Key。
- 维护者：LJY-YL（仓库 LJY-YL/dsh-workbuddy-connect）
- 分类：客户端
- 版本：社区修复版
0.7.9-p1，基于已停更的 corrinehu/dsh-workbuddy-connect v0.7.9 - 许可：MIT
SkillHub 目录页：https://www.skillhub.cn/plugins/LJY-YL/dsh-workbuddy-connect（社区插件目录，与 DeepSeek / 幻方无官方从属关系）。
社区修复版相对官方 0.7.9 的两处改动¶
详细说明见仓库内 README-PATCH.md。
-
兼容 DSH 0.2.x 内核
在package.json中声明engines.dsh: ">=0.2.0-rc.1 <0.3.0"。存在该字段时 DSH 以它为准，不再被官方包钉死在0.2.1-rc.2的 peer 依赖卡住；文档记载 rc.2 / rc.3 / rc.5 实测可用，一般无需手动加版本豁免。 -
修复渠道拦截（code 11128）
WorkBuddy 网关会按客户端指纹拦截 DSH 系统提示里同时出现的特定短语（含产品名the harness，以及the user mentioned与relative paths resolve against the workspace root的组合）。修复版在CHANNEL_PHRASE_REWRITES中补齐改写规则，并对聊天正文应用sanitizeChannelText/sanitizeChannelPhrases，缓解workbuddy upstream client (http 400)/ 「请求被拦截，请重新发送」。
边界说明：若 DSH 再次调整系统提示词，可能出现新的指纹句，需要继续补规则；DSH 升到 0.3 后需重新评估 engines.dsh 范围。
核心功能¶
行为与上游 0.7.9 一致，安装启用后无需额外配置即可使用（仍依赖本机 App 已登录）。
- 模型分组：国内版显示「WorkBuddy」，国际版显示「WorkBuddy AI」；两版账号、积分、模型列表互不混用，只跟随对应 App 的登录状态。
- 图片输入：多数模型支持粘贴或拖入图片；部分纯文字模型会提示不支持。
- 推理档位：上游已声明的档位直接展示；未声明的模型在 Web / Desktop 可在插件卡片里手动检测（会发少量请求，可能消耗积分）。TUI 不提供手动检测。
- 余额与设置：选中模型时输入框旁可显示剩余积分，可手动刷新；设置 → 插件（或左侧栏「插件」面板，视 DSH 版本而定）可查看账号、令牌有效期、模型列表来源、显隐模型、企业额度（国内版企业账号）等。
- 命令行（Web / TUI profile；Desktop 一般由 App 管理，CLI 往往不可用）：
dsh plugin --profile web exec dsh-workbuddy-connect status
dsh plugin --profile web exec dsh-workbuddy-connect doctor
dsh plugin --profile web exec dsh-workbuddy-connect status --provider workbuddy-ai
--json 可输出机器可读格式；logout 仅清理插件自留的凭据副本，不保证卸载 App 侧登录。
安装与启用¶
前置：本机已安装并登录 WorkBuddy 或 WorkBuddy AI 桌面 App；目标机器需已安装 Git（DSH 通过 git 拉取 GitHub 仓库，未安装时会报 git ls-remote failed）。
社区修复版不以 npm 上的官方 dsh-workbuddy-connect@0.7.9 为主路径（上游已停更）；按 README-PATCH.md，仓库为私人仓库，安装地址需带访问令牌。
- 在 DSH 设置 → 插件 → 添加插件 中粘贴（将
<TOKEN>换成有读权限的 GitHub 令牌）：
https://<TOKEN>@github.com/LJY-YL/dsh-workbuddy-connect
- 或在 Web profile 下用命令行安装：
dsh plugin --profile web add "https://<TOKEN>@github.com/LJY-YL/dsh-workbuddy-connect"
安装过程中若出现构建脚本确认（如 @google/genai、protobufjs），在插件管理器中允许即可（与安装官方版时类似）。DSH 从 GitHub 源码安装时会执行 pnpm install --omit=dev 拉取运行依赖 @earendil-works/pi-ai@1.3.0。
验证：重启对应界面后，模型选择器出现 WorkBuddy / WorkBuddy AI 分组（只装一版则只验一组），从分组选模型完成一次简短对话且能正常回复，即安装成功。
若你仍使用未修复的官方 npm 包，需按 DSH 内核与插件版本一一对应（例如内核 0.2.1-rc.2 对应插件 0.7.9），完整表见上游 README「版本兼容与历史版本」；社区修复版则优先用上述 GitHub 地址，并享受放宽后的 engines.dsh 与渠道改写。
典型用法¶
日常使用与上游文档一致：在 DSH Web / Desktop 中选 WorkBuddy 分组下的模型对话；需要查积分或排错时用 CLI。
# 国内版状态与积分
dsh plugin --profile web exec dsh-workbuddy-connect status
# 国际版诊断
dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-ai
Linux 无法自动定位 WorkBuddy 解密程序时，可设置 WORKBUDDY_ELECTRON_BIN / WORKBUDDY_AI_ELECTRON_BIN；WSL 或 Windows 凭据路径异常时，可用 WORKBUDDY_AUTH_FILE / WORKBUDDY_AI_AUTH_FILE 指向实际文件（详见上游 README「已知限制」）。
适用场景与注意¶
适合：已在 WorkBuddy 生态里付费或攒积分，希望在 DSH 里用同一账号跑 Agent、工具调用和多模态对话，且不想重复维护一套模型网关的用户。
务必注意：
- 插件以当前 DSH 进程的权限运行，会读取桌面 App 凭据相关路径；安装前应阅读仓库源码与 MIT 许可证，私人仓库安装令牌勿泄露或提交到版本库。
- 依赖 WorkBuddy 非官方开放的客户端接口，App 或网关策略变更可能导致模型目录、国际版 UA 分流等行为失效，插件会按文档描述降级并标注列表来源。
- 渠道改写是与网关指纹识别的对抗，不能保证永久有效；DSH 0.3 起需等待维护者更新
engines.dsh或重打补丁（修改lib/host-heartbeat-SJaZ33tR.js中的CHANNEL_PHRASE_REWRITES）。 - Desktop 的
desktopprofile 常由发行版 App 自行管理，勿盲目用独立 CLI 改 App 目录或绕过校验。
结尾¶
DSH WorkBuddy Connect 社区修复版在停更的 0.7.9 之上，把「全 0.2.x 内核可用」和「渠道 11128 拦截」两件阻塞性问题补上，仍保持零配置接入 WorkBuddy 模型分组与积分的定位。需要安装说明与补丁细节时，以仓库 README-PATCH.md 为准；功能与限制的全文仍以 README 为主。
- 目录页：https://www.skillhub.cn/plugins/LJY-YL/dsh-workbuddy-connect
- GitHub：https://github.com/LJY-YL/dsh-workbuddy-connect
