DeepSeek Harness (DSH) 的理念是「一切皆插件」。在使用 Web 界面的 Composer 进行开发或交互时，如果模型列表较长或提供方众多，原生的模型选择器在可读性和操作效率上会显得吃力。针对这一场景，下面介绍 dsh-client-ui-model-search 插件。
插件定位¶
这是一个针对 DeepSeek Harness 的轻量级客户端 UI 插件，作者为 AndyZHENG0715，采用 MIT 许可证。它的核心作用是解决 Web Composer 中模型选择器在大规模模型列表下的可用性问题，通过搜索和分组折叠提升操作效率。
核心功能¶
- 顶部搜索框：在模型列表顶部提供搜索框，输入即进行过滤。
- 分词 AND 匹配：支持逻辑组合搜索，例如输入
opencode-go deepseek可同时匹配特定提供方的模型（连字符和下划线视作空格）。匹配范围覆盖模型名称、ID、描述、提供方名称及 ID。 - 分组折叠：提供方分组支持折叠与展开，点击分组标题栏可操作，并在标题旁显示该组包含的模型数量。
- 主题适配：使用 DSH 设计令牌（
--dsw-*），界面颜色会跟随当前主题（亮色/暗色）自动调整。 - 双语支持：通过官方
locale服务支持中文（zh-CN）和英文。 - 非破坏性注册：使用
priority: -1注册，不会移除原生选择器。插件仅在运行时接管显示，卸载或停止后，原生选择器作为后备机制自动恢复。
安装与启用¶
确保已配置包含 Web UI 的 DSH Profile。
1. 安装插件
dsh plugin --profile <name> add dsh-client-ui-model-search
2. 本地检出（可选）
dsh plugin --profile <name> add ./dsh-client-ui-model-search
3. 重启 Profile
dsh --profile <name> web
使用方法¶
安装并重启 Profile 后，打开 Composer 右下角的模型选择器。此时模型列表顶部会出现搜索框，点击提供方分组标题可折叠或展开列表。
注意事项¶
- DSH 预发布状态：DeepSeek Harness 目前仍处于预发布阶段，该插件基于此环境开发。
- 依赖要求：插件需要安装以下 peer dependencies：
@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-model-selection、@deepseek-ai/dsh-client-ui-conversation。 - 非官方产品：这不是 DeepSeek 官方发布的产品，不涉及任何背书或官方商店上架。
- 兼容性：插件基于 Community Draft v0.15 manifest 构建，兼容 DSH 官方 bundle 格式（
dsh.bundle.patch,cordis.patch.yml）。
结语¶
该插件通过搜索和分组功能优化了模型选择体验，且采用非破坏性设计，适合需要在 DSH Web 界面快速定位模型的场景。项目源码位于 GitHub。
