前言¶

接入多个 provider 后，模型列表往往会变得很长。想在对话中换回刚才用过的模型，或者切换到常用的一个，往往要多次展开分组、滚动列表。这种重复操作会打断思路，把注意力从对话本身分散到 UI 操作上。

快捷模型选择器（dsh-quick-model-selector）为 DSH 提供了一个更直接的模型切换入口：支持搜索、收藏和最近使用置顶，并提供键盘快捷操作，让模型切换尽量少占用时间和精力。

插件定位¶

这是一个为 DeepSeek Harness（DSH）桌面端设计的模型选择器插件，由 SnailMann 维护。它解决的是在模型数量增多时，切换和查找模型变得繁琐的问题。通过搜索、置顶和快捷键，让常用的模型始终在视线范围内。

核心功能¶

• 即时搜索：打开模型面板后直接输入模型名或 provider 名，列表会即时过滤，无需先展开分组。

• 最近使用与收藏置顶：刚用过的模型排在最前，常用的模型可以通过收藏标记并跟随其后，减少翻找次数。

• 分组折叠：超过 6 个模型的 provider 默认收起，当前模型和收藏所在的组保持展开，手动调整的折叠状态也会被记住。

• 倍率角标：模型名称中包含的倍率（如 x0.28）会以彩色角标单独显示，便于快速识别。

• 推理强度独立按钮：推理强度控制有独立按钮，在支持该功能的模型上可直接调整，不支持时自动隐藏。

• 键盘快捷操作：方向键移动高亮、Enter 确认，⌘1–⌘9 或 Ctrl+1–9 快速选择第 N 个可见项，⌘D 或 Ctrl+D 收藏当前高亮项。

• 响应式布局：工具栏变窄时，模型按钮固定宽度，长名称使用省略号并在悬停时显示全名；空间进一步不足时，推理强度移入模型菜单，给麦克风和发送按钮留出位置。

• 深色主题支持：同一套排版适配深色主题，界面一致性较好。

安装与启用¶

推荐通过插件页安装：

1. 打开 DSH Desktop 的设置。
2. 进入「插件」页面。
3. 点击「添加插件」。
4. 在「包名或地址」中填入：

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

5. 安装完成后按提示重启一次 DSH Desktop。
6. 重启后在「已安装插件」列表中可以看到 dsh-quick-model-selector，可以随时开关或卸载。

命令行等价安装（web 为 Desktop 使用的 profile 名）：

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

从源码安装（需要修改代码时）：

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。

典型用法¶

安装启用后，点击输入框右下角的模型按钮即可打开模型面板。

• 搜索：在面板中直接打字，列表会根据模型名或 provider 名过滤。

• 收藏：选中某个模型后按 ⌘D（Mac）或 Ctrl+D（Windows/Linux），或在鼠标操作时点击星标图标。

• 最近使用：刚使用过的模型会自动排在列表最前面。

• 键盘切换：使用 ↑ / ↓ 移动高亮，Enter 确认选择。在无搜索词时，Tab 可以折叠/展开当前分组，连续按可恢复刚折叠的组。

• 快捷数字选择：⌘1–⌘9 或 Ctrl+1–9 可以快速选择当前可见的第 N 个模型。

• 调整推理强度：在支持该功能的模型上，点击独立的推理强度按钮即可调整。

适用场景与注意¶

• 适合接入多个 provider、模型数量较多的 DSH 用户，尤其是需要频繁切换模型和推理强度的场景。

• 插件以当前 DSH 进程的权限运行，安装前建议查看源码和许可证（MIT）。

• 卸载时只会移除插件自身的登记，会话、模型配置和偏好数据会保留，重启后恢复官方模型选择器。

结尾¶

通过快捷模型选择器，可以在模型列表变长的情况下，依然保持快速、直观的切换体验。它把注意力从 UI 操作中解放出来，让对话本身成为重点。

插件目录页与 GitHub 仓库：
- https://www.skillhub.cn/plugins/SnailMann/dsh-quick-model-selector
- https://github.com/SnailMann/dsh-quick-model-selector