在 DeepSeek Harness (DSH) 的 Web 界面中,当模型列表较长时,手动定位目标模型需要逐行查找,操作效率较低。这个插件通过替换原生 ModelSelect 组件,在模型选择器中引入了实时搜索字段,同时保留了 Effort(推理强度)选择器。
插件由 honoriomelo 维护,旨在增强 DSH Web GUI 的可用性,同时保持与原生功能的兼容性。
核心功能¶
-
实时搜索过滤
插件在 Model 面板顶部添加了一个<input type="text">输入框。打开菜单后,输入框会自动聚焦。列表会根据输入内容实时过滤,匹配规则包括模型 ID、模型名称、提供商名称,且不区分大小写。 -
保留 Effort 选择器
插件保留了原生 ModelSelect 的两层子菜单结构(Model / Effort)。当选择支持 Effort 的模型后,依然可以进入二级菜单调整推理强度。选择 Effort 后,触发标签会更新以显示当前设置的强度。 -
状态一致性
插件读取并写入原生 ModelSelect 共享的 per-sessionModelDirectory。这意味着在 Composer 插件中选择模型,/model命令的弹窗会显示相同的模型;在插件中切换 Effort,也会同步反映在/model命令中。 -
交互细节
- 自动聚焦:搜索框在 Model 面板打开时自动获得焦点,用户可以直接开始输入。
- 导航控制:支持“返回”按钮回到根菜单,支持点击外部关闭菜单,支持 ESC 键和展开箭头切换菜单状态。
安装与启用¶
使用官方 CLI 安装插件:
dsh plugin --profile web add link:/path/to/dsh-model-picker-search
安装完成后,重启 dsh web 服务或刷新浏览器页面,新组件即可生效。
典型用法¶
- 在 Composer 中点击 Model 按钮。
- 菜单打开后,直接在顶部输入框输入关键词(例如模型名称的一部分或提供商名称)。
- 列表会根据输入实时更新,定位目标模型。
- 点击模型后,如果需要调整推理强度,点击模型名称旁的箭头进入二级菜单进行选择。
注意事项¶
- 版本要求:该插件需要 DSH 0.1.0-rc.8 或更新版本才能运行。
- 无源码修改:插件不修改 DSH 源代码,而是通过注入组件来复用 DSH 的
ModelDirectory机制和主题令牌。 - 兼容性:所有颜色和间距均来自 DSH 主题令牌,因此能自动适配 Light/Dark 主题以及品牌覆盖。
该插件通过在插件层面对话输入槽位注入新组件,在不破坏现有架构的前提下,解决了长列表模型查找的问题。更多细节可查阅其 GitHub 仓库或社区目录。