前言¶
DeepSeek Harness（DSH）Web 界面中，輸入框右側的模型座位打開後會顯示按 provider 分組的模型列表。對智能體開發者來說，當可選模型較多時，需要在多個 provider 分組裏滾動查找，操作並不直接。dsh-model-search 是用於 DSH Web 的插件，它在模型切換組件的頂部增加一個搜索框，按模型名 / 模型 id / provider 名過濾列表，同時保留官方選擇行爲與推理等級選擇。
這是什麼¶
- 插件名稱：
dsh-model-search - 倉庫：
HeathHe/dsh-model-search - 維護者：HeathHe
- 許可證：MIT
- 作用：爲 DSH Web GUI 的模型切換組件增加搜索框，過濾 provider 分組模型列表，不改變官方選擇交互。
GitHub 地址：
https://github.com/HeathHe/dsh-model-search
核心功能¶
- 打開模型面板後，頂部出現搜索框。
- 搜索按空格分詞，大小寫不敏感。
- 同時匹配模型名、模型 id、provider 名。
- 沒有命中的 provider 分組自動隱藏。
- 無匹配時顯示「沒有匹配的模型」。
- 真正無模型時顯示「沒有可用的模型」。
- 搜索框內按
↑/↓直接跳到過濾結果首/末項。 - 選擇模型後自動清空搜索詞。
- 保留官方推理等級選擇、當前項勾選、加載/錯誤狀態、toast 交互。
安裝與啓用¶
先安裝插件：
dsh plugin --profile web add dsh-model-search
安裝完成後重啓 dsh web，讓插件生效：
dsh web
經過上面的步驟，打開輸入框右側的模型座位，頂部即出現搜索框。
如果需要安裝 @latest 版本：
dsh plugin --profile web add dsh-model-search@latest
如果要更新到某個新版本，將 <新版本> 替換爲實際版本號，然後重啓 dsh web：
dsh plugin --profile web add dsh-model-search@<新版本>
如果要用本地源碼調試，使用 link: 指向本地倉庫路徑：
dsh plugin --profile web add link:/絕對路徑/到/dsh-model-search
典型用法¶
- 打開輸入框右側的模型座位。
- 在頂部搜索框中輸入模型名、模型 id 或 provider 名。
- 輸入內容按空格分詞，大小寫不敏感。
- 查看過濾後的 provider 分組；沒有命中的 provider 分組會隱藏。
- 如果沒有匹配模型，界面會顯示「沒有匹配的模型」。
- 在搜索框內使用
↑/↓跳到過濾結果首項或末項。 - 選擇目標模型後，搜索詞會自動清空。
本地重新構建¶
如果上游組件變化，需要重新構建插件客戶端文件時，執行：
npm run build
該命令實際執行：
node lib/build.mjs
構建會基於官方模型選擇組件 @deepseek-ai/dsh-client-ui-model-selection 生成 lib/client.js。上游升級後，如果補丁錨點漂移，構建或適配過程可能需要人工調整。
適用場景與注意¶
適合：
- 在 DSH Web 模型座位中快速定位某個模型。
- 按 provider 名縮小候選範圍。
- 在 provider 分組較多時減少手動滾動瀏覽。
需要注意：
- 本插件通過
cordis.patch.yml替換官方模型選擇組件@deepseek-ai/dsh-client-ui-model-selection，不是在其上疊加增強。 - DeepSeek Harness 升級後，如果官方組件發生變化，可能導致插件失效；屆時需要重新構建並更新插件。
lib/client.js從@deepseek-ai/dsh-client-ui-model-selection的特定版本打補丁生成；上游升級後錨點可能漂移，需要人工適配。- 搜索框內的
↑/↓會跳到過濾結果首/末項，可能覆蓋官方原有的某些鍵盤行爲。 - 模型名或 provider 名含空格時，以空格分詞搜索可能產生意外匹配。
- 許可證爲 MIT；
lib/client.js衍生自@deepseek-ai/dsh-client-ui-model-selection，詳見NOTICE/LICENSE。 - 插件會以當前 dsh 進程權限運行。安裝前建議檢查源碼、依賴與許可證，確認其符合你的使用要求。
小結¶
dsh-model-search 解決的是 DSH Web 模型切換列表中的搜索問題：打開模型座位後，用頂部搜索框按模型名 / 模型 id / provider 名過濾，並保持官方選擇交互不變。
GitHub：
https://github.com/HeathHe/dsh-model-search
目錄頁地址未在已覈實資料中給出。安裝前可先覈對倉庫源碼、許可證和上面的 dsh plugin --profile web add dsh-model-search 命令。
