DeepSeek Harness (DSH) 採用插件化架構,客戶端通過插件擴展功能。在處理大量模型時,直接在配置文件中管理每個模型的狀態和名稱較爲繁瑣。dsh-ofm-model-manager 插件在 DSH 的設置界面中增加了一個模型管理面板,允許用戶直接在圖形界面中對每個提供商的模型進行啓用/禁用操作和自定義重命名。
核心功能¶
插件在 Settings → Models 頁面底部新增了一個面板,主要提供以下能力:
- 模型開關與重命名:每個模型旁邊都有開關,可以獨立啓用或禁用。勾選“自定義名稱”後,可以輸入顯示名稱,該名稱會替換內置名稱顯示在模型選擇器中,但不會修改模型 ID。
- 多維度搜索:支持在名稱、自定義名稱、模型 ID、描述和提供商名稱中進行精確匹配搜索。
- 狀態與篩選:提供狀態芯片(All / Enabled / Region-restricted / Disabled)顯示數量,並支持通過下拉菜單按提供商篩選。
- 批量操作:針對當前篩選視圖,提供批量啓用和批量禁用按鈕。
- 即時生效:偏好設置保存在配置文件中,修改後立即應用,無需刷新頁面或重啓 DSH。
安裝¶
使用 DSH 官方插件安裝命令添加該插件。命令中的 desktop 爲配置文件名,如使用其他配置文件請替換。
dsh plugin --profile desktop add github:DeepseekDays/dsh-ofm-model-manager
安裝完成後,需要完全退出 DSH(包括系統托盤中的進程)並重新啓動,以確保新插件被正確加載。
典型用法¶
- 禁用模型:在模型面板中關閉某個模型的開關,該模型將不會出現在聊天窗口的模型選擇器和
/model對話框中。如果某個提供商下的所有模型都被禁用,該提供商也會從選擇器中消失。 - 重命名模型:在模型面板中勾選“自定義名稱”並輸入新名稱。在模型選擇器中,將顯示你輸入的名稱,而非原始的內置名稱。
技術實現與注意事項¶
- 運行機制:插件不修改 DSH 內核文件,而是通過運行時攔截
ctx.llm.listModels()來包裝模型列表,實現顯示和過濾邏輯。 - 共存性:該插件與
dsh-provider-toggle插件可以共存。它不依賴於其他運行時庫。 - 路由影響:禁用模型僅影響模型目錄(Catalog),不會改變現有的會話路由。已開啓的對話繼續使用原模型,新會話將無法選擇被禁用的模型。
- 配置格式:配置使用
provider|modelId的格式保存。如果不帶分隔符的modelId(如deepseek-v4.1-flash)在配置中,會被視爲通配符,匹配所有提供商的同名模型。新版本插件優先處理精確匹配,確保特定配置優先於通配符配置。
該插件由 DeepseekDays 維護,遵循 MIT 許可證。