前言¶
在 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
