dsh-model-groups：DeepSeek Harness 平臺與廠商分組模型選擇器

前言¶

DeepSeek Harness 的插件化架構支持通過擴展邏輯來增強模型選擇體驗。在多廠商、多模型的場景下，直接選擇容易產生混淆。dsh-model-groups 插件通過引入平臺與廠商的分組視圖，優化了這一流程。

插件定位¶

這是一個獨立開發的客戶端插件，由用戶 roclee2692 維護，遵循 MIT 許可證。它不隸屬於 DeepSeek 官方，僅作爲對 DeepSeek Harness 0.1.1-rc.2 版本的客戶端擴展。安裝後不會替換社區現有的皮膚或市場。

核心功能¶

該插件主要在模型選擇環節提供以下能力：

1. 複用現有服務：直接使用 DeepSeek Harness 現有的 modelDirectories 服務獲取模型目錄。
2. 覆蓋選擇槽位：僅覆蓋 conversation.input.model 槽位，不干擾其他核心功能。
3. 分組展示：以廠商爲分組單位展示模型，保持原始的 Provider ID 不變。
4. 未知模型路由：無法識別的模型 ID 會被自動路由至 Other/platform。
5. 思考控制：思考相關的控制項由所選模型的宿主元數據提供，而非插件硬編碼。
6. 原生彈窗：對話框使用瀏覽器原生的頂層展示，避免被主題容器裁剪。
7. 無憑證處理：插件本身不處理任何認證憑證相關的邏輯。

安裝與啓用¶

安裝必須通過 DSH 的 Profile 機制進行，不要手動拼接命令。

有兩種配置方式，請二選一，不要同時使用：

1. 通過 Bundle 配置：
   在對應的 DSH Profile 配置中，將 dsh-model-groups 添加到 dsh.profile.bundles 數組中。

2. 通過 Patch 配置：
   將 cordis.patch.yml 中的條目插入到該 Profile 的 Patch 配置中。

重要提示：內置的模型選擇插件必須保持啓用狀態，因爲它提供了共享的目錄服務和 /model 命令支持。

驗證與用法¶

在正式部署前，建議在隔離的 Profile 中驗證兼容性。

1. 鎖定版本：在配置文件中鎖定一個兼容的 Release 版本。
2. 運行測試：執行 npm test 進行本地驗證。
3. 集成檢查：可以通過從 macOS EAC Profile 加載該插件，並在 Chromium 中通過 Live Server 檢查運行狀態。

注意事項與限制¶

• 非官方插件：這不是 DeepSeek 官方的 DSH 插件。
• 皮膚替換警告：它不會替換社區的皮膚或市場。
• 兼容性風險：對於任意未來的 DeepSeek Harness 版本，沒有兼容性保證。
• Webview 限制：Native WKWebView 特定的迴歸問題未經過認證。

總結¶

dsh-model-groups 插件通過複用底層服務和覆蓋特定槽位，實現了更清晰的模型分組展示。它適合需要精細化管理多平臺模型列表的用戶。源碼與詳細文檔可參考 GitHub。