dsh-model-groups：DeepSeek Harness 平台与厂商分组模型选择器

前言¶

DeepSeek Harness 的插件化架构支持通过扩展逻辑来增强模型选择体验。在多厂商、多模型的场景下，直接选择容易产生混淆。dsh-model-groups 插件通过引入平台与厂商的分组视图，优化了这一流程。

插件定位¶

这是一个独立开发的客户端插件，由用户 roclee2692 维护，遵循 MIT 许可证。它不隶属于 DeepSeek 官方，仅作为对 DeepSeek Harness 0.1.1-rc.2 版本的客户端扩展。安装后不会替换社区现有的皮肤或市场。

核心功能¶

该插件主要在模型选择环节提供以下能力：

1. 复用现有服务：直接使用 DeepSeek Harness 现有的 modelDirectories 服务获取模型目录。
2. 覆盖选择槽位：仅覆盖 conversation.input.model 槽位，不干扰其他核心功能。
3. 分组展示：以厂商为分组单位展示模型，保持原始的 Provider ID 不变。
4. 未知模型路由：无法识别的模型 ID 会被自动路由至 Other/platform。
5. 思考控制：思考相关的控制项由所选模型的宿主元数据提供，而非插件硬编码。
6. 原生弹窗：对话框使用浏览器原生的顶层展示，避免被主题容器裁剪。
7. 无凭证处理：插件本身不处理任何认证凭证相关的逻辑。

安装与启用¶

安装必须通过 DSH 的 Profile 机制进行，不要手动拼接命令。

有两种配置方式，请二选一，不要同时使用：

1. 通过 Bundle 配置：
   在对应的 DSH Profile 配置中，将 dsh-model-groups 添加到 dsh.profile.bundles 数组中。

2. 通过 Patch 配置：
   将 cordis.patch.yml 中的条目插入到该 Profile 的 Patch 配置中。

重要提示：内置的模型选择插件必须保持启用状态，因为它提供了共享的目录服务和 /model 命令支持。

验证与用法¶

在正式部署前，建议在隔离的 Profile 中验证兼容性。

1. 锁定版本：在配置文件中锁定一个兼容的 Release 版本。
2. 运行测试：执行 npm test 进行本地验证。
3. 集成检查：可以通过从 macOS EAC Profile 加载该插件，并在 Chromium 中通过 Live Server 检查运行状态。

注意事项与限制¶

• 非官方插件：这不是 DeepSeek 官方的 DSH 插件。
• 皮肤替换警告：它不会替换社区的皮肤或市场。
• 兼容性风险：对于任意未来的 DeepSeek Harness 版本，没有兼容性保证。
• Webview 限制：Native WKWebView 特定的回归问题未经过认证。

总结¶

dsh-model-groups 插件通过复用底层服务和覆盖特定槽位，实现了更清晰的模型分组展示。它适合需要精细化管理多平台模型列表的用户。源码与详细文档可参考 GitHub。