前言¶
在 DeepSeek Harness（DSH）裏做智能體或日常對話，模型來源往往分散：WorkBuddy 桌面端一套賬號與目錄，Qoder CN 又需要單獨維護 PAT 與 jobToken。若只靠各自 provider 或手工改配置，模型選擇器裏很難並列看到多平臺目錄，多賬號輪換、失敗重試和請求觀測也缺少統一入口。DSH 社區採用「一切皆插件」的擴展方式；DSH Model Hub（倉庫 lifeiyu-44/dsh-model-hub）面向「模型推理」場景，把 WorkBuddy（國際/國內）與 Qoder CN 的模型註冊到宿主模型選擇器，並在面板裏完成賬號池、憑據接管與請求記錄。
下面介紹插件定位、能力、安裝步驟與典型用法；事實以 GitHub README 爲準。
這是什麼¶
DSH Model Hub 由維護者 lifeiyu-44 發佈，MIT 許可，當前 package 版本爲 0.1.0。它通過本機迴環 shim 向上遊轉發請求，在 DSH 內提供：
- 多平臺模型並列展示（id 帶
hub-前綴，如hub-workbuddy-global/…、hub-qoder-cn/…）； - 多賬號池（手動優先、故障切換、熔斷）；
- WorkBuddy 桌面端加密登錄態的內置解密與 Qoder PAT 換 token；
- 請求記錄與診斷界面。
面板內「?」按鈕附有與 README 一致的使用說明，日常配置可不依賴倉庫文檔。
核心功能¶
多平臺接入¶
WorkBuddy 側約 25 個模型與 Qoder CN 約 10 個模型會出現在 DSH 模型選擇器裏。渠道可在面板關閉：關閉後該渠道模型從選擇器徹底消失，憑據仍保留。
賬號管理與多賬號池¶
面板支持增刪賬號、啓用/禁用、設爲當前、單賬號測試；同一賬號按 uid 去重，不會重複出現。
池策略要點（README 表格與正文）：
- 手動優先：「設爲當前」的賬號作爲池頭，請求優先使用。
- 故障切換：遇到 401/402/403/429/5xx 等失敗時自動換池中下一個賬號重試，單請求內重試上限爲
min(池大小, 3)。 - 熔斷：連續 3 次憑據類失敗後冷卻 10 分鐘，到期自動解凍；全池冷卻時仍按序兜底。
憑據自動接管¶
| 來源 | 說明 |
|---|---|
| WorkBuddy 桌面端 | 讀取 %LOCALAPPDATA%\CodeBuddyExtension\Data\Public\auth\workbuddy-desktop-ai.info 中的加密信封；插件通過 App 的 native binding 取密鑰，AES-256-GCM 解密；解密結果寫入 %USERPROFILE%\.dsh\model-hub\workbuddy-tokens\（0600） |
| Qoder CN | 面板粘貼 pt- 開頭的 PAT，插件換 jobToken 並寫入 model-hub/qoder-pats/ |
| 歷史 vault | %USERPROFILE%\.dsh\workbuddy-vault\ 只讀，可掃描導入 |
插件數據庫只存憑據引用（文件路徑），不存明文；日誌隱去 token/PAT 全文。
請求記錄與診斷¶
每次上游嘗試記一行：token 數、TTFT、tok/s、狀態碼、歸屬賬號；故障切換時失敗與成功兩次嘗試均可見。記錄彈層支持篩選與導出 CSV。診斷欄提供憑據路徑、token 有效期、shim 地址、上游錯誤原文（便於貼 issue）。
思考檔位¶
WorkBuddy 目錄未逐模型標註 reasoning，插件對 25 個模型統一聲明支持 reasoning_effort（上游不支持的會忽略）。Qoder 按目錄 is_reasoning 聲明。選中支持思考的 hub 模型後，DSH 輸入框模型選擇器會出現「思考強度」（off/minimal/low/medium/high），並按模型記憶。
安裝與啓用¶
前置條件：Node.js ^22.19.0 || >=24，以及已安裝的 DSH 本體（插件通過 peerDependencies 使用宿主 @deepseek-ai/dsh-* 包）。
構建產物 lib/、client.js 已隨倉庫提交，普通用戶無需本地構建。
從 GitHub 安裝：
dsh plugin add github:lifeiyu-44/dsh-model-hub
也可在 GUI：側邊欄 插件 → 添加插件 → 粘貼 github:lifeiyu-44/dsh-model-hub。
指定 tag 安裝：
dsh plugin add github:lifeiyu-44/dsh-model-hub#v0.1.0
npm 包名安裝（包發佈後）：
dsh plugin add dsh-model-hub
裝完重啓 DSH，打開 設置 → 插件 → DSH Model Hub 配置賬號。
插件配置項（Config，改完即生效）：
| 字段 | 默認 | 說明 |
|---|---|---|
enabled |
true | 總開關；關閉需重載插件 |
recordEnabled |
true | 是否寫入請求記錄 |
retentionDays |
90 | 明細保留天數；聚合永久保留 |
典型用法¶
WorkBuddy：換號後一鍵認證¶
- 在 WorkBuddy 桌面端登錄目標賬號。
- 打開 DSH Model Hub 面板，使用 一鍵認證：插件讀取桌面端加密登錄態、解密、驗活，按 uid 去重後新增或刷新賬號行。
- 需要優先使用的賬號點 設爲當前。
同一賬號重複認證只刷新該行，不會 duplicate。
Qoder：粘貼 PAT¶
- 在 https://qoder.com.cn/account/integrations 創建 PAT（
pt-開頭）。 - 面板 + 添加賬號 → 粘貼 PAT；備註留空則使用 userinfo 真名。
- 驗活通過後賬號進入池，渠道 runtime 啓動。
觀測與排錯¶
- 記錄 欄看今日摘要與最近明細；需要完整表時用「查看全部 →」。
- 診斷 欄覈對 shim、憑據路徑與上游錯誤原文。
- 讀
%USERPROFILE%\.dsh\model-hub\status.json中的ok、modelCount與失敗原因（部署自檢亦用此文件）。
常見寫接口錯誤：origin_not_allowed / host_not_allowed（非本機請求）、bad_request、payload_too_large（body 超過 64KB）。
適用場景與注意¶
適合誰：已在 WorkBuddy 桌面端或 Qoder CN 有可用憑據、希望在 DSH 單一界面選模型、並需要多賬號輪換與請求可觀測的開發者。
安裝前建議：插件以當前 DSH 進程權限運行，會讀取本機 WorkBuddy auth 文件、寫入 .dsh/model-hub/ 下的 token/PAT 文件，並起本機迴環 shim。安裝前應閱讀 倉庫源碼與 MIT 許可證，確認憑據邊界與安全說明符合你的環境策略。
已知限制（README）：WorkBuddy 渠道校驗可能隨上游變化；目錄拉取失敗時渠道暫無 runtime，需下次寫操作或重啓重試；5xx 觸發的請求內換號對非冪等上游存在理論上的重複副作用（重試上限 min(池, 3)）；記錄明細上限 2000 行。
社區插件目錄見 SkillHub 條目，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
經過上面的步驟，DSH Model Hub 把 WorkBuddy 與 Qoder CN 的模型目錄、賬號池與請求診斷收攏到 DSH 插件面板，減少在多套客戶端與配置文件之間切換的成本。進一步細節與開發結構見 GitHub：lifeiyu-44/dsh-model-hub。
