DeepSeek Harness 采用插件化架构。当通过 OpenRouter 等多模型提供商接入大量模型时,原生菜单的浏览效率会下降。dsh-model-picker-search 用于替换原生菜单,增加了搜索与筛选能力。
插件定位¶
这是一个为 DeepSeek Harness 和 DSH Desktop 提供的改进模型选择器插件,由维护者 imdeniil 开发。它通过客户端技术扩展了模型选择界面的功能,解决了在拥有数百个模型时难以快速定位目标的问题。
核心功能¶
插件完全客户端化,不依赖后端服务。其核心能力如下:
-
搜索功能
替换原生模型菜单。支持按模型名称、ID、描述和提供商进行搜索,搜索不区分大小写。搜索框在菜单打开时自动获取焦点。 -
提供商过滤
提供一组可点击的提供商过滤芯片(Chip),显示“所有”以及具体的提供商列表。点击芯片可切换过滤状态,再次点击可取消过滤。 -
结果计数与自适应高度
显示筛选结果的数量(例如“M: 21 из 278”)。菜单高度自适应,不会超出屏幕边界,超出部分会自动滚动。 -
多语言支持
内置本地化字典,支持俄语、英语和中文。
安装与启用¶
安装时需要指定 profile。如果同时使用 Web 端和 Desktop 端,需分别执行对应的命令。
# 安装到 Web Profile
dsh plugin --profile web add github:imdeniil/dsh-model-picker-search
# 安装到 Desktop Profile
dsh plugin --profile desktop add github:imdeniil/dsh-model-picker-search
安装完成后,重启应用程序或执行 dsh web 命令即可生效。
典型用法¶
- 打开模型选择菜单。
- 在搜索框中输入字母或关键词,列表会根据名称、ID 或描述实时过滤。
- 点击顶部的提供商芯片,仅查看特定厂商的模型。
- 按
Esc键清除搜索查询和过滤条件。 - 在菜单底部查看当前筛选后的模型总数。
技术实现与注意¶
- 注册机制:插件在
conversation.input.model槽位注册,优先级为-1。根据 DSH 的插槽规则,优先级数值越小,渲染优先级越高,因此该插件会覆盖原生菜单。 - 容错机制:如果插件在渲染过程中出现错误,系统会自动回退到默认的模型菜单,不会导致界面崩溃。
- 运行环境:插件完全客户端化,直接在浏览器或桌面端运行。
总结¶
该插件通过增强模型选择器的交互体验,提升了在多模型场景下的操作效率。对于需要频繁切换或筛选大量模型的用户,这是一个实用的工具。