快捷模型选择器 SnailMann/dsh-quick-model-selector

DSH 快捷模型选择器

English · 中文

使用 SnailMann DSH 插件统一的橙蓝蜗牛图标，通过 ./icon 导出并随安装包分发。

模型越来越多，切换不该越来越麻烦。

接入了好几个 provider，模型列表越拉越长；明明只想换回刚才那个，却又得从头翻一遍。

快捷模型选择器让 DSH 里的模型更好找：刚用过的就在最上面，常用的收藏紧随其后，想找哪个就输入几个字。少翻列表，把注意力留给眼前的对话。

模型面板

用起来有什么不同？

- 想找哪个，直接打字：打开就能搜，输入模型名或 provider 名即可缩小范围，不必挨个展开分组。
- 常用的，不用反复找：最近使用和收藏都置顶，刚用过的排在最前，换回上一个模型只需点一下。
- 模型再多，也有条理：超过 6 个模型的 provider 默认收起，当前模型和收藏所在的组保持展开；你手动调整的折叠状态也会记住。
- 倍率不用藏在长名字里：x0.28 这类倍率单独显示为彩色角标，扫一眼就能分辨。
- 换模型、调推理，各管各的：推理强度有独立按钮，不必在模型列表里来回找；不支持时自动隐藏。
- 手不离键盘，也能切换：方向键选、Enter 确认，⌘1–⌘9 快选、⌘D 收藏（也支持 Ctrl）。
- 窗口变窄，按钮也不乱跑：窄框下模型按钮固定为 150px，长名称用省略号收尾，悬停查看全名；实际空间不足时进一步收窄，推理强度移入模型菜单，给麦克风和发送按钮留出位置。窗口放宽后恢复独立的强度按钮。

搜索

推理强度

窗口变窄时保留模型名，推理强度收进菜单：

窄窗口

窄窗口菜单

深色主题同一套排版：

深色

安装

插件页（推荐）：设置 → 插件 → 添加插件 → 「包名或地址」填

https://github.com/SnailMann/dsh-quick-model-selector

装完按提示重启一次 DSH Desktop。重启后在「已安装插件」里能看到 dsh-quick-model-selector，可随时开关或卸载。

命令行（等价，web 是 Desktop 用的 profile 名）：

dsh plugin --profile web add github:SnailMann/dsh-quick-model-selector

dist/ 已随仓库提交，安装不需要编译，也不会触发 pnpm 的构建脚本审批。

从源码（想改代码时）：

git clone https://github.com/SnailMann/dsh-quick-model-selector.git
cd dsh-quick-model-selector
dsh plugin --profile web add .

改完 src/ 要 npm run build 再重启 DSH。

已在 DSH Desktop 0.12.1 / Harness 0.2.1-rc.2 验证：插件列表可见可开关，启用装配 1 条插件行、停用 0 条。

使用

点输入框右下角的模型按钮，剩下的都在表里：

| 键 | 行为 |
| 直接打字 | 过滤列表 |
| ↑ / ↓ | 移动高亮（焦点留在搜索框） |
| Enter | 选中当前高亮 |
| Esc | 先清空搜索词，再按一次关闭；在强度弹层里直接关闭 |
| Tab | 无搜索词时折叠 / 展开当前分组；连续按可恢复刚折叠的组（Shift+Tab 返回前一个控件） |
| ⌘1 – ⌘9（或 Ctrl+1–9） | 直选第 N 个可见项 |
| ⌘D（或 Ctrl+D） | 收藏 / 取消收藏当前高亮 |

鼠标同样可用：点行选中、点星标收藏、点分组头折叠。

偏好存在 localStorage 的 dsh-quick-model-selector:prefs:v1，全局共享、不区分会话；从旧包名 dsh-model-palette 升级时旧键会自动迁移，收藏与折叠状态不丢。

卸载

dsh plugin --profile web remove dsh-quick-model-selector

只移除自身登记，会话、模型配置和偏好都保留；重启后恢复官方模型选择器。

开发

改 src/ 后 npm run build 再 npm test；node scripts/preview.mjs <dir> 可把真实组件渲染成静态页看排版。

浏览器交互测试使用本机 DSH profile 的 React 和 Playwright，覆盖键盘操作、320–800px 工具栏宽度、模型名省略、其他控件文字变化和弹层边界。通过 NODE_PATH 提供 Playwright 后运行 npm test；使用系统 Chrome 时加上 QMS_BROWSER_CHANNEL=chrome。缺少依赖时会明确跳过浏览器测试，不能替代真实 DSH 验证。静态预览不执行布局观察器，响应式行为以浏览器测试和真实宿主为准。

License

MIT