前言¶
DeepSeek Harness（DSH）Web 界面中，输入框右侧的模型座位打开后会显示按 provider 分组的模型列表。对智能体开发者来说，当可选模型较多时，需要在多个 provider 分组里滚动查找，操作并不直接。dsh-model-search 是用于 DSH Web 的插件，它在模型切换组件的顶部增加一个搜索框，按模型名 / 模型 id / provider 名过滤列表，同时保留官方选择行为与推理等级选择。
这是什么¶
- 插件名称：
dsh-model-search - 仓库：
HeathHe/dsh-model-search - 维护者：HeathHe
- 许可证：MIT
- 作用：为 DSH Web GUI 的模型切换组件增加搜索框，过滤 provider 分组模型列表，不改变官方选择交互。
GitHub 地址：
https://github.com/HeathHe/dsh-model-search
核心功能¶
- 打开模型面板后，顶部出现搜索框。
- 搜索按空格分词，大小写不敏感。
- 同时匹配模型名、模型 id、provider 名。
- 没有命中的 provider 分组自动隐藏。
- 无匹配时显示「没有匹配的模型」。
- 真正无模型时显示「没有可用的模型」。
- 搜索框内按
↑/↓直接跳到过滤结果首/末项。 - 选择模型后自动清空搜索词。
- 保留官方推理等级选择、当前项勾选、加载/错误状态、toast 交互。
安装与启用¶
先安装插件：
dsh plugin --profile web add dsh-model-search
安装完成后重启 dsh web，让插件生效：
dsh web
经过上面的步骤，打开输入框右侧的模型座位，顶部即出现搜索框。
如果需要安装 @latest 版本：
dsh plugin --profile web add dsh-model-search@latest
如果要更新到某个新版本，将 <新版本> 替换为实际版本号，然后重启 dsh web：
dsh plugin --profile web add dsh-model-search@<新版本>
如果要用本地源码调试，使用 link: 指向本地仓库路径：
dsh plugin --profile web add link:/绝对路径/到/dsh-model-search
典型用法¶
- 打开输入框右侧的模型座位。
- 在顶部搜索框中输入模型名、模型 id 或 provider 名。
- 输入内容按空格分词，大小写不敏感。
- 查看过滤后的 provider 分组；没有命中的 provider 分组会隐藏。
- 如果没有匹配模型，界面会显示「没有匹配的模型」。
- 在搜索框内使用
↑/↓跳到过滤结果首项或末项。 - 选择目标模型后，搜索词会自动清空。
本地重新构建¶
如果上游组件变化，需要重新构建插件客户端文件时，执行：
npm run build
该命令实际执行：
node lib/build.mjs
构建会基于官方模型选择组件 @deepseek-ai/dsh-client-ui-model-selection 生成 lib/client.js。上游升级后，如果补丁锚点漂移，构建或适配过程可能需要人工调整。
适用场景与注意¶
适合：
- 在 DSH Web 模型座位中快速定位某个模型。
- 按 provider 名缩小候选范围。
- 在 provider 分组较多时减少手动滚动浏览。
需要注意：
- 本插件通过
cordis.patch.yml替换官方模型选择组件@deepseek-ai/dsh-client-ui-model-selection，不是在其上叠加增强。 - DeepSeek Harness 升级后，如果官方组件发生变化，可能导致插件失效；届时需要重新构建并更新插件。
lib/client.js从@deepseek-ai/dsh-client-ui-model-selection的特定版本打补丁生成；上游升级后锚点可能漂移，需要人工适配。- 搜索框内的
↑/↓会跳到过滤结果首/末项，可能覆盖官方原有的某些键盘行为。 - 模型名或 provider 名含空格时，以空格分词搜索可能产生意外匹配。
- 许可证为 MIT；
lib/client.js衍生自@deepseek-ai/dsh-client-ui-model-selection，详见NOTICE/LICENSE。 - 插件会以当前 dsh 进程权限运行。安装前建议检查源码、依赖与许可证，确认其符合你的使用要求。
小结¶
dsh-model-search 解决的是 DSH Web 模型切换列表中的搜索问题：打开模型座位后，用顶部搜索框按模型名 / 模型 id / provider 名过滤，并保持官方选择交互不变。
GitHub：
https://github.com/HeathHe/dsh-model-search
目录页地址未在已核实资料中给出。安装前可先核对仓库源码、许可证和上面的 dsh plugin --profile web add dsh-model-search 命令。
