前言¶
DeepSeek Harness (DSH) 的插件生態允許將本地資源接入模型選擇器。dsh-connect-workbuddy 是一個獨立插件，用於將本機已登錄的 WorkBuddy 賬號接入 DSH。它提供只讀的積分概覽與模型管理功能，支持國內版與國際版雙供應商並行接入。
核心功能¶
該插件主要包含以下能力：
- 雙供應商並行接入：同時支持國內版（
workbuddy）與國際版（workbuddy-global）供應商。 - 插件卡片 tab 切換：設置卡片頂部提供「國內版 / 國際版」兩個 tab，管理互不干擾。
- 可單獨關閉供應商：取消勾選即可從模型選擇器中徹底移除對應供應商。
- 模型管理：支持從上游刷新模型目錄，並逐項勾選啓用或禁用。
- 本機賬號切換：自動發現本機 WorkBuddy 桌面端留下的多個登錄憑據。
- 憑據失效處理：上游拒絕 token 時，會探測其他可用賬號並提供一鍵切換建議。
- 只讀積分概覽：按套餐聚合展示剩餘積分，查詢不消耗積分。
- 憑據路徑探測：支持多候選路徑探測，並詳細列出失敗原因。
- 安全 loopback shim：通過隨機端口和進程內 secret 與上游通信，不直接暴露 token。
- 命令行診斷：提供
status、doctor、logout命令進行診斷。
安裝與使用¶
前置條件¶
- 需要安裝並登錄 WorkBuddy 桌面 App。
- 需要安裝 DSH 0.1.7-rc.1 及以上版本。
安裝命令¶
推薦使用 DSH 插件命令安裝：
dsh plugin --profile desktop add dsh-connect-workbuddy
根據你使用的 DSH 界面環境，選擇對應的 profile 參數：
dsh plugin --profile web add dsh-connect-workbuddy # Web 環境
dsh plugin --profile dsh-tui add dsh-connect-workbuddy # TUI 環境
安裝或更新 bundle 後，需要重啓對應的 DSH 進程。
命令行診斷¶
安裝完成後，可以使用以下命令行工具檢查登錄狀態和積分：
status # 報告登錄狀態與積分
doctor # 運行診斷
logout # 登出當前區域賬號
平臺支持與差異¶
該插件支持 Windows、macOS 和 Linux 三種平臺。不同平臺在實現細節上存在差異。
| 方面 | Windows | macOS | Linux |
|---|---|---|---|
| 憑據目錄 | %LOCALAPPDATA% / %APPDATA% 優先，回落到 <home>\AppData |
~/Library/Application Support/CodeBuddyExtension/Data/Public/auth |
$XDG_CONFIG_HOME 優先，回落到 ~/.config |
| App 可執行文件定位 | 搜索 %LOCALAPPDATA%\Programs\WorkBuddy 等 |
讀取 bundle 的 Info.plist，獲取 CFBundleExecutable（真實值 Electron） |
不適用（加密憑據場景下 Linux 無對應 App） |
| 子進程窗口 | 必須使用 windowsHide（宿主爲 GUI 進程） |
不適用 | 不適用 |
| 設置寫入 | 可能被殺毒軟件或 OneDrive 鎖定 | 通常無鎖定問題 | 無鎖定問題 |
注意事項¶
- 插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證（MIT）。
- 國內版與國際版是兩個並行的供應商，設置與賬號互不干擾。
- 憑據文件爲只讀，插件不會向 WorkBuddy 桌面 App 寫入任何數據。
生態背景¶
DSH 理念是「一切皆插件」。該插件維護在 GitHub，也可在 SkillHub 生態目錄中查看。
- GitHub: https://github.com/dingminhua/dsh-connect-workbuddy
- Catalog: https://www.skillhub.cn/plugins/dingminhua/dsh-connect-workbuddy
