前言¶
在 DeepSeek Harness (DSH) 的插件生态中，不同类型的任务往往需要不同级别的模型推理能力。手动切换模型既繁琐又容易出错。dsh-model-controller 插件通过关键词和语义分类，在每次用户交互中自动选择合适的模型与推理强度，解决了这一需求。
插件简介¶
该插件由用户 jadehare 维护，属于模型推理分类。它为 DSH 提供了基于关键词和语义分类的动态模型路由，支持按任务自动选择模型与推理强度。
核心功能¶
- 基于关键词和语义分类的动态模型路由。
- 自动选择模型与推理强度。
- 支持混合/仅语义/仅正则匹配模式。
- Plan Mode 专用模型路由。
- 路由元数据显示。
安装与启用¶
在安装前，请确保当前环境满足以下条件：
* Node.js 版本：^22.19.0 || >=24.0.0
* DeepSeek Harness 版本：0.1.1-rc.2 或兼容版本
执行以下命令安装插件：
dsh plugin --profile web add dsh-model-controller@next
安装完成后，进入 设置 → 插件 → 插件配置，保存配置。从下一个用户 turn 起生效。
配置与默认规则¶
在设置界面中，可以调整以下配置项：
* 全局匹配模式：支持混合模式（先正则，再语义）、仅 Semantic、仅 Regex。
* Route 规则：增删改排序路由，可恢复内置默认表。
* Semantic 分类器：仅在混合/仅 Semantic 模式下使用。
* Plan Mode：处于 Plan Mode 时强制使用专用 Pro/max 模型。
* 路由元数据：在 reasoning 开头显示 provider、模型、推理强度和 Route id。
插件的默认路由规则如下：
| 场景 | 模型 | Reasoning |
|---|---|---|
复杂结构（v4pm、重构、设计） |
deepseek-v4-pro |
max |
Review（review） |
deepseek-v4-pro |
high |
小脚本（v4fm） |
deepseek-v4-flash |
max |
小方法（v4fh） |
deepseek-v4-flash |
high |
| 处于 Plan Mode | deepseek-v4-pro |
max |
| 语义分类器（未命中时） | deepseek-v4-flash |
off |
典型用法¶
根据任务类型，插件会自动路由到对应的模型：
* 复杂结构场景（如重构、设计）：使用 deepseek-v4-pro(max)。
* 小脚本或小方法：使用 deepseek-v4-flash(max) 或 high。
适用场景与注意¶
- 该插件以 DSH 进程权限运行，安装前请检查源码与许可证。
- 插件版本为
0.1.0-rc.1，可能与 Harness 版本要求存在差异，请确认兼容性。 - 未命中关键词匹配时，保留 Agent 的原始模型。
总结¶
安装并启用 dsh-model-controller 后，插件会自动在每个用户 turn 中根据配置规则选择模型。这能显著降低模型选择的维护成本，提升任务处理的适配度。
