在 DeepSeek Harness (DSH) 的生態中，模型管理通常分散在多個設置項和組件中，缺乏統一的入口。yhyfhgs/dsh-model-hub 插件旨在將提供者登錄、模型目錄和會話路由統一到一個安全、僅本地迴環的 /model-hub RPC 通道中。它接管了生命週期管理和模型選擇，同時保留了對官方 DSH 設置的訪問權限，從而提供集中的配置和路由體驗。
核心功能¶
該插件提供以下具體能力：
- Provider Sign-in：在瀏覽器中直接完成 OAuth / 設備代碼認證流程，支持實時嘗試追蹤、提示對話框和 30 分鐘的主機超時。
- Provider Lifecycle：提供激活、停用、登出和使用記錄等管理操作，所有操作均通過影響確認對話框進行保護。
- Provider Customization：允許編輯 API 密鑰（通過
credentials.set安全存儲）、Base URL、協議、顯示名稱以及每路由的模型映射。 - Rich Model Catalog：擴展原生
llm.models架構，保留inputModalities、contextWindow和defaultMaxTokens等字段。 - Session Selection & Routing：支持內存會話模型選擇，使用
{ prepend: true }掛鉤優先級。子智能體遵循 3 層路由策略。 - Thinking Effort Control：動態滑塊，根據每個模型支持的推理級別自動校準。
- Fast Mode：基於元數據的切換功能，用於聲明加速服務層的模型。
- Built-in Providers：內置支持
qwen-code(RFC 8628) 和codex(OpenAI Codex)。 - Bilingual Interface：原生支持簡體中文和英文 UI，遵循 Harness Shell 的語言偏好。
- Loopback Security：所有
/model-hub端點嚴格綁定authority: 'loopback'，並使用 Zod 進行嚴格的負載驗證。
安裝與啓用¶
安裝前請確保 pnpm 已在 PATH 中，因爲 dsh plugin 命令在底層調用 pnpm。
- 執行安裝命令：
dsh plugin --profile web add @fhxgs/dsh-model-hub
- 安裝完成後必須重啓 profile，因爲配置文件的組合更改不支持熱重載。
典型用法¶
- 在運行 DSH 的同一臺機器上打開 DSH Web UI（所有端點均需要本地迴環訪問）。
- 進入 Settings -> Model Hub -> Providers，選擇提供者並完成登錄流程。
- 在提供者卡片上點擊 Activate 以啓用路由。
- 切換到 Catalog 選項卡，選擇希望在拾取器中顯示的模型。
- 在任意聊天會話中，從氣泡或輸入
/model命令中選擇模型和推理努力。
配置說明¶
插件在 model-hub 設置命名空間下管理配置。配置項包括：
- picker：控制模型可見性。
mode支持all（默認）或include（顯式白名單）。include列表定義了允許的模型。 - fastMode：開啓加速服務層路由的模型列表。
- preferredEffort：可選的默認推理努力級別。
- subagent：繼承或特定提供者/模型/推理努力的配置。
內置提供者配置存儲在單獨的 model-hub-providers 命名空間中，以防止目錄緩存失效。
注意事項¶
- 環境依賴：
dsh plugin命令依賴pnpm，請確保corepack enable pnpm後pnpm可用。 - 安全性：憑證直接進入安全存儲，絕不會在日誌或狀態快照中暴露。
- Loopback 限制：所有
/model-hub端點僅限本地訪問。
