前言¶
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 官方文件，卸载即恢复原样。
总结¶
该插件通过视觉整理和自动容错机制，优化了模型选择的体验。安装与配置过程直接，适合追求交互效率的开发者。
