DeepSeek Harness (DSH) 的模型管理頁面,官方適配器存在功能缺失。插件 dsh-llm-hub 旨在補全這些缺失的能力:網關可達性探測、模型目錄拉取並勾選寫回、餘額/配額常駐顯示,以及協議與接入地址的可見性。該插件由 webkubor 維護,遵循 MIT 協議。
核心功能¶
插件爲模型頁提供了以下能力:
- 餘額與配額常駐:卡片下方常駐顯示餘額信息,支持閾值預警。
- 模型目錄拉取:支持一鍵拉取網關在售列表,實測可拉取 71 個模型(針對 modelgo)。
- 網關探測與狀態:顯示實測延遲、健康狀態與在售數量;若未配置 baseURL,會明確提示。
- 用量統計:統計本月用量,展示前 5 個最常用模型,支持 CSV 導出。
- 可用性過濾:靜默從下拉列表中移除確鑿不可用的 provider,並在卡片上標紅提示原因。
- 子代理工具:安裝後自動註冊 codex、claude、agy 等外部 agent 工具。
安裝與啓用¶
該插件零運行時依賴,不改動 DSH 安裝。
- 執行安裝命令:
npx @deepseek-ai/dsh plugin --profile web add @dsh-plugins/dsh-llm-hub
-
將
@dsh-plugins/dsh-llm-hub加進~/.dsh/profiles/web/package.json的dsh.profile.bundles數組。 -
重啓 DSH(boot graph 變了必須重啓,熱載不生效)。
典型用法¶
- 模型發現:進入「設置 → 模型」,選擇 DeepSeek(官方直連)卡片,點擊「獲取可用模型」。
- 旁路卡詳情:在任意 pi-ai provider(如 modelgo、minimax、zai-coding-cn)卡片下方,可查看探測結果、拉取目錄及餘額信息。
- 家族面板:在設置 → 模型底部,可查看「Webkubor DSH 擴展家族」狀態。
行爲與注意¶
- 密鑰解析:與官方適配器一致,支持
request.baseURL、request.apiKey、環境變量$DEEPSEEK_BASE_URL等順序。 - 安全:餘額接口僅允許同源讀取,拒絕跨站讀取。
- 不可用過濾:隱藏 provider 的判定只認確鑿證據(fail-open 策略),拿不準一律保留,以避免誤藏可用模型。
- 無破壞性變更:舊版配置在升級後仍兼容。