前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構。在 Web 端使用過程中，模型選擇器是高頻交互區域，但原生列表往往缺乏視覺區分，且在主力模型超時時缺乏自動容錯機制。dsh-msi-icons 插件旨在解決這兩個問題：通過廠商官方圖標和四區佈局提升視覺效率，通過置頂模型超時自動路由提升穩定性。
插件概覽¶
這是一個由 hun1315 維護的模型選擇器美化插件，核心功能包括廠商官方圖標識別、四區平鋪佈局以及置頂主力超時自動路由。
安裝¶
安裝插件需要使用官方 CLI。
dsh plugin --profile web add github:hun1315/dsh-msi-icons
安裝後重啓 DSH 使 Host 生效，刷新頁面即可看到四區佈局與圖標。
核心功能¶
廠商官方圖標與佈局¶
插件爲模型列表增加了廠商官方圖標，並採用平鋪四區佈局，不渲染組標題，僅按圖標和彩色後綴區分。四區順序爲：置頂區、原生區、插件區、視覺區。
- 同名去重：置頂模型不與原生區去重，保證置頂項可見。
- 置頂機制：點擊愛心圖標置頂，數據持久化在 localStorage 並同步 Host（用於超時路由）。
置頂主力超時路由¶
當置頂模型在首 token 產生內容超時（默認 45 秒）或報錯時，插件會自動切換下一個置頂模型重試。
- 降級鏈持久化在 pins.json，重啓不丟失。
- 若全部置頂模型均不可用，則拋錯停止；用戶主動中止不觸發路由。
配置新廠商¶
接入全新廠商無需修改代碼，僅需配置文件和 SVG。
1. 將廠商官方 SVG 放入 ~/.dsh/msi-icons/icons/ 目錄。
2. 在 ~/.dsh/msi-icons/vendors.json 的 vendors 數組中添加配置：
{ "match": "關鍵詞", "rank": 數字, "icon": "文件名.svg" }
- 刷新頁面即可生效。
接口與維護¶
插件提供 HTTP 接口供外部控制。
| 路由 | 方法 | 說明 |
|---|---|---|
/msi-icons/pins |
POST | 同步置頂降級鏈 |
/msi-icons/state |
GET | 檢查當前置頂與超時閾值 |
/msi-icons/icon?file=x.svg |
GET | 獲取圖標服務 |
注意事項¶
- 無硬依賴：不依賴 modlens 或 vision-router，缺誰少顯示對應分區。
- 兼容性：插件通過 DSH 構建產物的 CSS-module 類名定位 DOM，DSH 大版本升級可能導致類名哈希變化，需更新類名映射。
- 安全性：不修改任何 DSH 官方文件，卸載即恢復原樣。
總結¶
該插件通過視覺整理和自動容錯機制，優化了模型選擇的體驗。安裝與配置過程直接，適合追求交互效率的開發者。
