前言¶
在使用 DeepSeek Harness（DSH）WebUI 進行開發或推理時，當本地與遠程的模型數量增加，默認的模型選擇器下拉列表會變得難以導航。goodandready/dsh-model-search 旨在解決這一問題，它向 DSH 的模型選擇器注入了一個實時的搜索入口，支持多詞檢索、縮寫匹配以及鍵盤快捷操作，無需切換上下文即可快速定位模型。
插件簡介¶
goodandready/dsh-model-search 是一個 DSH Web 插件，由開發者 GooDAnDReaREADY 維護。它通過非侵入式的 DOM 操作集成到 WebUI 中，提供模型過濾、鍵盤導航和一鍵更新功能，兼容 Dark/Light 主題。
安裝與啓用¶
在終端中執行以下命令，將其添加到 Web 配置文件中：
dsh plugin --profile web add @goodandready/dsh-model-search
執行完成後，重啓 DSH 或刷新瀏覽器界面，搜索框即可在模型選擇器中生效。
核心功能¶
多詞與分隔符感知搜索¶
插件支持通過空格、逗號、斜槓或分號分隔多個搜索詞，系統會對模型名稱、技術標識符或提供者組進行組合匹配。
縮寫與子序列匹配¶
支持對模型名稱的非連續子序列進行匹配。例如，輸入 dsr 可直接匹配 deepseek-reasoner，輸入 gpt4o 可匹配 openai/gpt-4o-mini。
@provider 語法¶
支持使用 @ 前綴限定提供者。輸入 @ollama 僅顯示 Ollama 註冊的模型；輸入 @ollama qwen 則進一步篩選該提供者下的 Qwen 模型。
鍵盤導航矩陣¶
插件提供完整的鍵盤操作支持，使用戶能夠脫離鼠標進行操作：
| 按鍵 | 操作 |
|---|---|
ArrowDown |
將焦點移動到下一個可見的匹配模型 |
ArrowUp |
將焦點移動到上一個可見模型；若在頂部則返回搜索框 |
Enter |
立即選中當前高亮或首個可見模型 |
Escape |
清空搜索框；若框爲空則關閉下拉菜單 |
核心集成與兼容性¶
- 非侵入式 DOM 操作：僅切換元素的可見性（
display: none），不破壞 React 虛擬 DOM 結構。 - 抗上游變更：獨立於 DSH 核心模塊的 CSS 哈希變更。
- 主題原生樣式：完全使用官方 DSH 設計令牌，自動適配深色與淺色模式。
- 多語言支持：內置英語與中文，當激活
@goodandready/dsh-russian-lang時動態加載俄語。
一鍵更新與設置¶
插件集成了原生的設置卡片，位於 DSH 設置 -> 插件 -> 插件設置（dsh-model-search 命名空間下）。
- 應用內更新：自動檢測 npm 倉庫的新版本，支持一鍵更新（含預發佈版本檢查）。
- 安全機制：採用循環回退安全策略與單次點擊保護。
典型用法示例¶
openrouter/claude-3-5reasoner; 32b@ollama llama3dsrgpt4o@openai@ollama qwen
注意事項與依賴¶
- Node 版本：插件要求運行環境爲 Node.js 20 及以上。
- 性能：搜索過程具備零 CPU 開銷，不會影響聊天流式輸出的性能。
- 版權：MIT 許可證，允許自由使用與修改。
