DeepSeek Harness 採用插件化架構。當通過 OpenRouter 等多模型提供商接入大量模型時,原生菜單的瀏覽效率會下降。dsh-model-picker-search 用於替換原生菜單,增加了搜索與篩選能力。
插件定位¶
這是一個爲 DeepSeek Harness 和 DSH Desktop 提供的改進模型選擇器插件,由維護者 imdeniil 開發。它通過客戶端技術擴展了模型選擇界面的功能,解決了在擁有數百個模型時難以快速定位目標的問題。
核心功能¶
插件完全客戶端化,不依賴後端服務。其核心能力如下:
-
搜索功能
替換原生模型菜單。支持按模型名稱、ID、描述和提供商進行搜索,搜索不區分大小寫。搜索框在菜單打開時自動獲取焦點。 -
提供商過濾
提供一組可點擊的提供商過濾芯片(Chip),顯示“所有”以及具體的提供商列表。點擊芯片可切換過濾狀態,再次點擊可取消過濾。 -
結果計數與自適應高度
顯示篩選結果的數量(例如“M: 21 из 278”)。菜單高度自適應,不會超出屏幕邊界,超出部分會自動滾動。 -
多語言支持
內置本地化字典,支持俄語、英語和中文。
安裝與啓用¶
安裝時需要指定 profile。如果同時使用 Web 端和 Desktop 端,需分別執行對應的命令。
# 安裝到 Web Profile
dsh plugin --profile web add github:imdeniil/dsh-model-picker-search
# 安裝到 Desktop Profile
dsh plugin --profile desktop add github:imdeniil/dsh-model-picker-search
安裝完成後,重啓應用程序或執行 dsh web 命令即可生效。
典型用法¶
- 打開模型選擇菜單。
- 在搜索框中輸入字母或關鍵詞,列表會根據名稱、ID 或描述實時過濾。
- 點擊頂部的提供商芯片,僅查看特定廠商的模型。
- 按
Esc鍵清除搜索查詢和過濾條件。 - 在菜單底部查看當前篩選後的模型總數。
技術實現與注意¶
- 註冊機制:插件在
conversation.input.model槽位註冊,優先級爲-1。根據 DSH 的插槽規則,優先級數值越小,渲染優先級越高,因此該插件會覆蓋原生菜單。 - 容錯機制:如果插件在渲染過程中出現錯誤,系統會自動回退到默認的模型菜單,不會導致界面崩潰。
- 運行環境:插件完全客戶端化,直接在瀏覽器或桌面端運行。
總結¶
該插件通過增強模型選擇器的交互體驗,提升了在多模型場景下的操作效率。對於需要頻繁切換或篩選大量模型的用戶,這是一個實用的工具。