DeepSeek Harness (DSH) 的理念是「一切皆插件」。在使用 Web 界面的 Composer 進行開發或交互時,如果模型列表較長或提供方衆多,原生的模型選擇器在可讀性和操作效率上會顯得喫力。針對這一場景,下面介紹 dsh-client-ui-model-search 插件。
插件定位¶
這是一個針對 DeepSeek Harness 的輕量級客戶端 UI 插件,作者爲 AndyZHENG0715,採用 MIT 許可證。它的核心作用是解決 Web Composer 中模型選擇器在大規模模型列表下的可用性問題,通過搜索和分組摺疊提升操作效率。
核心功能¶
- 頂部搜索框:在模型列表頂部提供搜索框,輸入即進行過濾。
- 分詞 AND 匹配:支持邏輯組合搜索,例如輸入
opencode-go deepseek可同時匹配特定提供方的模型(連字符和下劃線視作空格)。匹配範圍覆蓋模型名稱、ID、描述、提供方名稱及 ID。 - 分組摺疊:提供方分組支持摺疊與展開,點擊分組標題欄可操作,並在標題旁顯示該組包含的模型數量。
- 主題適配:使用 DSH 設計令牌(
--dsw-*),界面顏色會跟隨當前主題(亮色/暗色)自動調整。 - 雙語支持:通過官方
locale服務支持中文(zh-CN)和英文。 - 非破壞性註冊:使用
priority: -1註冊,不會移除原生選擇器。插件僅在運行時接管顯示,卸載或停止後,原生選擇器作爲後備機制自動恢復。
安裝與啓用¶
確保已配置包含 Web UI 的 DSH Profile。
1. 安裝插件
dsh plugin --profile <name> add dsh-client-ui-model-search
2. 本地檢出(可選)
dsh plugin --profile <name> add ./dsh-client-ui-model-search
3. 重啓 Profile
dsh --profile <name> web
使用方法¶
安裝並重啓 Profile 後,打開 Composer 右下角的模型選擇器。此時模型列表頂部會出現搜索框,點擊提供方分組標題可摺疊或展開列表。
注意事項¶
- DSH 預發佈狀態:DeepSeek Harness 目前仍處於預發佈階段,該插件基於此環境開發。
- 依賴要求:插件需要安裝以下 peer dependencies:
@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-model-selection、@deepseek-ai/dsh-client-ui-conversation。 - 非官方產品:這不是 DeepSeek 官方發佈的產品,不涉及任何背書或官方商店上架。
- 兼容性:插件基於 Community Draft v0.15 manifest 構建,兼容 DSH 官方 bundle 格式(
dsh.bundle.patch,cordis.patch.yml)。
結語¶
該插件通過搜索和分組功能優化了模型選擇體驗,且採用非破壞性設計,適合需要在 DSH Web 界面快速定位模型的場景。項目源碼位於 GitHub。