dsh-model-visibility：DeepSeek Harness 模型選擇器過濾插件

前言¶

DeepSeek Harness (DSH) 允許開發者配置多個 Provider 和模型。當配置的模型數量較多時，對話界面的模型選擇菜單會變得冗長，影響選擇效率。本插件通過管理模型可見性，控制哪些模型出現在選擇器中。

插件介紹¶

dsh-model-visibility 是一個 DeepSeek Harness 插件，由開發者 Lzh3070 維護。其核心價值在於在保持原有 Provider 配置不變的前提下，提供細粒度的模型顯示控制。

核心功能¶

1. 實時過濾：支持按模型名、模型 ID 或渠道名進行實時搜索過濾。
2. 逐模型開關：可以爲單個模型設置可見或隱藏狀態，開關立即生效。
3. 渠道級批量：支持按 Provider（渠道）批量隱藏或顯示其下的全部模型。
4. 一鍵恢復：提供清空隱藏列表的功能，快速恢復所有模型顯示。
5. 零侵入：插件不寫入 Provider 配置文件，只維護自身的隱藏列表。
6. 會話兼容：隱藏正在使用的模型不會中斷當前會話的調度。

安裝與啓用¶

使用官方安裝命令添加插件，並在重啓服務後生效。

dsh plugin --profile web add dsh-model-visibility

安裝完成後，重啓 dsh web 進程。

工作原理¶

插件利用 DSH 的配置系統實現功能。

• 宿主端：通過 .volatile() 聲明 hidden 字段，在設置表單寫入時原地更新，並包裝 ctx.llm.listModels 方法。目錄成員資格是“建議性”的，因此隱藏操作不會影響正在運行的會話。
• 瀏覽器端：向設置頁面註冊獨立的“模型可見性”分區頁。利用 ctx.configForms 共享表單讀寫，通過 ctx.remote.session.modelCatalog() 讀取目錄，並跟隨 llm/adapters-updated 事件刷新頁面狀態。

卸載與恢復¶

卸載插件會自動清除隱藏設置，恢復原始狀態。

dsh plugin --profile web remove dsh-model-visibility

由於插件不寫入 Provider 配置，卸載後隱藏列表隨包刪除自動失效，無需手動清理配置。

適用場景與注意¶

• 版本要求：本插件需要 DeepSeek Harness 版本 ≥ 0.2.0-rc.1。
• 新模型處理：插件只記錄“要隱藏什麼”，Provider 新增的模型默認爲可見狀態。
• 資料來源：更多信息請查閱 GitHub 或 社區目錄。