在 DeepSeek Harness (DSH) 的 Web 界面中,當模型列表較長時,手動定位目標模型需要逐行查找,操作效率較低。這個插件通過替換原生 ModelSelect 組件,在模型選擇器中引入了實時搜索字段,同時保留了 Effort(推理強度)選擇器。
插件由 honoriomelo 維護,旨在增強 DSH Web GUI 的可用性,同時保持與原生功能的兼容性。
核心功能¶
-
實時搜索過濾
插件在 Model 面板頂部添加了一個<input type="text">輸入框。打開菜單後,輸入框會自動聚焦。列表會根據輸入內容實時過濾,匹配規則包括模型 ID、模型名稱、提供商名稱,且不區分大小寫。 -
保留 Effort 選擇器
插件保留了原生 ModelSelect 的兩層子菜單結構(Model / Effort)。當選擇支持 Effort 的模型後,依然可以進入二級菜單調整推理強度。選擇 Effort 後,觸發標籤會更新以顯示當前設置的強度。 -
狀態一致性
插件讀取並寫入原生 ModelSelect 共享的 per-sessionModelDirectory。這意味着在 Composer 插件中選擇模型,/model命令的彈窗會顯示相同的模型;在插件中切換 Effort,也會同步反映在/model命令中。 -
交互細節
- 自動聚焦:搜索框在 Model 面板打開時自動獲得焦點,用戶可以直接開始輸入。
- 導航控制:支持“返回”按鈕回到根菜單,支持點擊外部關閉菜單,支持 ESC 鍵和展開箭頭切換菜單狀態。
安裝與啓用¶
使用官方 CLI 安裝插件:
dsh plugin --profile web add link:/path/to/dsh-model-picker-search
安裝完成後,重啓 dsh web 服務或刷新瀏覽器頁面,新組件即可生效。
典型用法¶
- 在 Composer 中點擊 Model 按鈕。
- 菜單打開後,直接在頂部輸入框輸入關鍵詞(例如模型名稱的一部分或提供商名稱)。
- 列表會根據輸入實時更新,定位目標模型。
- 點擊模型後,如果需要調整推理強度,點擊模型名稱旁的箭頭進入二級菜單進行選擇。
注意事項¶
- 版本要求:該插件需要 DSH 0.1.0-rc.8 或更新版本才能運行。
- 無源碼修改:插件不修改 DSH 源代碼,而是通過注入組件來復用 DSH 的
ModelDirectory機制和主題令牌。 - 兼容性:所有顏色和間距均來自 DSH 主題令牌,因此能自動適配 Light/Dark 主題以及品牌覆蓋。
該插件通過在插件層面對話輸入槽位注入新組件,在不破壞現有架構的前提下,解決了長列表模型查找的問題。更多細節可查閱其 GitHub 倉庫或社區目錄。