模型选择器 yusufameri/dsh-t3-model-picker

dsh-t3-model-picker

一个用于 DeepSeek Harness 编辑器的模型选择器，移植自 T3 Code 的模型选择器。

选择器：提供商侧栏、分组搜索、收藏和跳转快捷键

使用 Cmd/Ctrl+Shift+M 打开选择器，跨所有提供商搜索，为你常用的模型加星标，并使用 Cmd/Ctrl+1…9 快速跳转到前九行。

致谢

本插件实现的选择器是 T3 Code 的 ProviderModelPicker。提供商侧栏、无边框搜索框、带提供商页脚的行布局、收藏模型、分级搜索排名，以及 Cmd+1…9 跳转快捷键都归功于他们。T3 Code 基于 MIT 开源；本移植版保持相同的行为，并将底层数据替换为 DeepSeek Harness 的模型目录。请支持原项目。

功能

- 提供商侧栏。 一个 44px 宽的列，Favorites 位于首位，每个已公布的提供商对应一个磁贴。当前活动项带有主色调指示器。
- 搜索。 选择器打开时搜索框自动获得焦点。匹配使用分级评分，针对模型名称、其描述、提供商 id 和提供商名称，包括对三个及以上字符的查询进行子序列匹配，并对收藏项给予小幅加权。结果按提供商标题分组。
- 收藏。 每一行都有一个星标，存储在浏览器中 dsh.t3-model-picker.favorites.v1 下，格式为 [{ provider, model }]。Favorites 侧栏项按提供商分组列出它们。
- 跳转快捷键。 在 macOS 上为 Cmd+1…9，在其他平台为 Ctrl+1…9，用于选择可见列表的前九行；这些行每一行都会在一个 kbd 小标签中显示其快捷键。
该监听器仅在卡片打开时生效。
- 切换快捷键。 在 macOS 上为 Cmd+Shift+M，在其他平台为 Ctrl+Shift+M，在卡片关闭时打开它，在打开时关闭它，可从窗口中的任意位置使用，包括编辑器。触发器的工具提示会显示该快捷键。在锁定的会话中，该快捷键无效，正如触发器一样。shift 键不会影响单独的 Cmd+M 文本绑定。
- 不可用的模型。 主机未报告为可路由的提供商会在其行上、侧栏磁贴的工具提示中以及触发器上标记。
- 推理强度。 一个页脚行会打开当前模型所公布的强度级别。当模型未公开任何级别时，该行会被隐藏。

安装

从本仓库安装：

dsh plugin --profile web add github:yusufameri/dsh-t3-model-picker

或者从发布 tarball 安装，无需构建步骤：

dsh plugin --profile web add https://github.com/yusufameri/dsh-t3-model-picker/releases/latest/download/dsh-t3-model-picker.tgz

一旦该包发布到 npm，使用注册表形式的命令会少一个词：

dsh plugin --profile web add dsh-t3-model-picker
它们中的任何一个都会协调该配置文件的 bundle 列表，因此下一次启动会合并该插件的补丁并加载其客户端部分。移除该 bundle 会恢复随附的模型选择器，且不留任何残留。

截图

| 在收藏中打开的选取器 | 分组搜索结果 | 加星后的收藏 |
| 收藏面板 | 按提供商分组的搜索 | 收藏列表 |

工作原理

编辑器的 conversation.input.model 座位是一个 single 槽位。两个占用者可以以不同的优先级共存于其中，而存活的最低优先级会渲染，因此该插件注册在 -1，而随附的 ModelSelect 在其默认的 0 处停止渲染。

两者读取同一个按会话划分的模型目录（ctx.modelDirectories），这也正是 /model 命令弹出框所使用的。在此处选择的模型就是那些界面接下来会显示的，而在那里做出的选择就是此选取器所高亮的。

| 文件 | 作用 |
| package.json | Bundle 清单：dsh.bundle.patch 加上 dsh.client Web 部分 |
| cordis.patch.yml | 一行 insert 记录，用于挂载该 bundle |
| index.js | 宿主部分——为空；该功能完全在浏览器端 |
| client.js | 客户端部分：选取器、其样式、收藏和快捷键 |

与 T3 Code 的差异

四处有意的偏离，均记录在 client.js 中：

- 搜索结果按提供商标题分组。T3 渲染一个扁平的排名列表，并在每一行标注提供商名称。
- 一行页脚使推理强度选择器保持可访问。T3 将强度保留在并列的控件中，而在 DeepSeek Harness 中，此座位是编辑器唯一的强度控件。
- 正在使用的模型所在行带有一个对勾标记。此座位是单选，且触发器并不总是在视野中。
- Cmd/Ctrl+Shift+M 打开和关闭该卡片。T3 仅将打开操作留给触发器，因此绑定到触发器的组合键将意味着按住 Cmd 并伸手去拿鼠标。

已知限制

- 选取器需要一个会话作用域的模型目录。被寻址的子代理会话不暴露任何此类目录，因此该座位在那里保持缺失，组合键也没有可打开的内容。
- 跳转组合键保持仅打开，与 T3 中一样。Cmd/Ctrl+Shift+M 是唯一在卡片关闭时也能工作的组合键。
- 强度页脚只会显示其提供商声明了推理元数据的模型。

开发

无需构建步骤：client.js 是纯 JavaScript，采用客户端模块加载器所接受的格式。编辑它并重新加载页面。

scripts/verify-shortcuts.mjs 会针对真实组件检查这些组合键。它在带有 React 的 jsdom 页面中挂载 client.js，并在窗口上派发真实的按键事件，因此无需桌面应用即可验证组合键的更改。该插件没有依赖项，因此测试装置自带依赖：

npm install --no-save react react-dom jsdom
node scripts/verify-shortcuts.mjs

scripts/ 还存放用于上述资源的录制工具。它驱动通过 Chrome DevTools 协议运行 DeepSeek Harness 页面，因此无需下载浏览器：

node scripts/record.mjs # 帧 + 静帧 + 时间线
node scripts/encode-gif.mjs --fps 12 --speed 1.8 --start 1.14

record.mjs 期望页面显示一个会话，其编辑器带有选择器，并在结束时恢复浏览器的收藏夹。编码器使用 sharp 裁剪、调整大小并组装 GIF；它不需要 ffmpeg。

发布

RELEASING.md
涵盖了 npm token 设置、标签驱动的发布工作流以及手动发布回退方案。

许可证

MIT。此插件复现的界面来自 T3 Code，采用 MIT 许可证，由其作者提供。