前言¶

DeepSeek Harness（DSH）遵循“一切皆插件”的理念。在開發智能體時，管理多個 API Provider 和模型是一項重複性工作。通常需要手工編輯 settings.yaml，不僅繁瑣且容易出錯。爲了解決這個痛點，社區開發者 jianjianzhu 開發了 dsh-model-switcher。

這是什麼¶

這是一個面向 DeepSeek Harness Web profile 的可視化自定義模型管理插件。它在 插件 → 模型切換器 中提供 Provider 預設、API Key 安全寫入、模型發現和默認模型切換，無需手工編輯 settings.yaml。作者爲 jianjianzhu，開源協議爲 MIT。

核心功能¶

該插件提供了以下能力：

• Provider 預設：支持 NyroAPI/SAPI、標準 OpenAI 兼容、OpenRouter 和自定義預設。
• 內置預設：包含 DeepSeek、SiliconFlow、Gemini、Anthropic、Ollama、LM Studio、vLLM 和 LiteLLM。
• 配置管理：支持編輯 Provider ID、名稱、基礎地址和 API 協議。
• 安全存儲：API Key 通過 Harness credentials Remote 寫入憑據存儲，不寫入普通 settings.yaml、日誌或導出配置。
• 模型發現：調用 Harness 模型發現接口測試連接，通過搜索和勾選導入模型。保留服務商返回的模型名稱、上下文長度、最大輸出和輸入類型。
• 已有 Provider 管理：讀取並編輯已有 Provider，支持重命名和刪除。保留已有 Provider 的憑據引用，並允許目錄型 Provider 繼承內置 API 地址。
• 路徑清理：自動清理誤填的 /models、/chat/completions、/responses、/messages 路徑。
• 錯誤診斷：針對認證、權限、地址、超時、TLS 和網絡錯誤提供中文診斷。
• 請求頭安全：支持安全的自定義請求頭；敏感鑑權頭不會在界面顯示。
• 高級字段調整：可視化調整 Developer Role、finish_reason、流式 usage 和 Token 上限字段。
• 模板導入導出：導入和導出不含 API Key、Authorization、Cookie 等敏感信息的 Provider 模板。
• 默認模型：保存多個模型，並可將第一個模型設爲默認模型。
• NyroAPI 特性：預設自動設置 supportsFinishReason: false、supportsDeveloperRole: false 和 maxTokensField: max_tokens。

安裝與啓用¶

在插件目錄中運行以下命令：

node tests/smoke.mjs
dsh plugin --profile web add .

安裝完成後，打開 Harness 的 插件 頁面，選擇 模型切換器。

典型用法¶

操作流程非常簡單：選擇服務商、填寫密鑰、獲取模型、選擇默認模型並保存即可。協議、地址和兼容參數默認收納在高級設置中。

適用場景與注意¶

• 版本限制：當前版本僅面向 Web profile。
• 連接測試：連接測試使用服務商的模型發現端點；不提供模型列表的網關仍可手動填寫模型 ID。
• 特殊服務商：Azure 等需要專用協議或非標準模型發現地址的服務仍需後續適配。
• 安全性：API Key 通過 Harness credentials Remote 寫入憑據存儲。插件不會把明文密鑰寫入 settings.yaml、日誌或導出配置。

結語¶

該插件通過可視化的方式降低了管理多個 Provider 的門檻，同時保證了密鑰安全。更多細節和源碼，請參考目錄頁或 GitHub 倉庫。