前言¶
在 DSH 中运行 agent 时,一个现实问题是:不同请求对模型能力的需求差别较大。简单问答、小范围代码修改、复杂多步任务如果都绑定同一个模型,容易在成本和效果之间失去平衡。
dsh-auto-model-router 是为 DeepSeek Harness(DSH)编写的第三方模型路由插件。它把请求路由到 L0–L3 四个能力层级,并提供 heuristic lock、固定层级和 fully-auto 三种用户模式,同时支持成本控制、失败回退链和可选 LLM 分类器。
下面介绍它的能力、安装方式和典型用法。DSH 的扩展通过插件完成;本文提到的社区目录页是独立站点,不是 DeepSeek 或幻方官方应用商店。
这是什么¶
dsh-auto-model-router 由 ADVeRTs13 维护,许可证为 MIT。npm 包名为 @adverts13/dsh-auto-model-router,包版本为 0.1.1。
它会在 DSH 模型选择器中注册虚拟 auto provider 和 Auto Router 组,让使用者可以直接选择 Auto;如果显式选择真实模型,插件会把请求原样通过,不干预路由。
核心功能¶
- 四级能力路由:
L0–L3 - 三种用户模式:
heuristic lock、固定层级、fully-auto - 基于文本宽度阈值的零延迟启发式锁定
fully-auto模式下的关键词评分,权重和区间可配置- 评分为 0 时可选用 LLM 分类器
- 失败回退链
- 预算控制,支持
cost-first、quality-first、balanced - 浏览器设置页展示当前路由策略
- 可通过 AI 修改
cordis.patch.yml调整配置 - 显式选择真实模型时,请求按原选择通过
安装与启用¶
该插件的 Node 引擎要求为:
^22.19.0 || >=24
对依赖项的要求包括:
@deepseek-ai/dsh-llm 0.1.0-rc.6
@deepseek-ai/dsh-tools 0.1.0-rc.6
使用 npm 包安装:
dsh plugin --profile web add @adverts13/dsh-auto-model-router
也可以先安装再添加:
npm install @adverts13/dsh-auto-model-router
dsh plugin --profile web add @adverts13/dsh-auto-model-router
如果使用本地目录:
dsh plugin --profile web add ./dsh-auto-model-router
启用方式是在 DSH 模型选择器中选择 Auto Router 下的 Auto。选择 Auto 会立即生效,没有确认弹窗;选择真实模型则不会经过该路由。
典型用法¶
下面是文档给出的使用方式:
- 选择
Auto,让会话经由L0–L3层级路由。 - 选择任意真实模型,让请求原样通过。
- 在聊天中让 AI 修改配置,例如:
-change L2 to deepseek-v4-flash with max reasoning
-switch cost mode to cost-first
AI 会编辑 cordis.patch.yml;修改后需要重启 DSH 才能生效。
4. 也可以直接往 profile 的 cordis.patch.yml 中追加配置,相关配置项包括 levels、rules、heuristic、scoring、costControl。
几个配置行为需要留意:
rules默认为空,且只在fully-auto模式下参与路由。- 每个已配置层级需要
reasoningEffort,省略时默认为off。 - 未配置的层级可以留空;路由器会按成本模式落到最近的已配置层级。
适用场景与注意¶
这个插件适合希望按任务复杂度切换模型能力、希望在成本优先、质量优先和平衡之间切换策略、并且希望在 DSH 模型选择器中直接选择 Auto 的使用者。
安装前建议先检查源码和许可证。该插件会以当前 dsh 进程权限运行,修改模型路由、预算策略和 fallback 行为时,应确认自己理解这些配置项的含义。通过 AI 修改 cordis.patch.yml 后,需要重启 DSH 才能应用。
另外,client.js 是一个自包含的 ModuleLoader bundle;维护者可以用 pnpm run build:client 从 client/ 重新生成它。
链接¶
- 插件目录页:https://www.skillhub.cn/plugins/ADVeRTs13/dsh-auto-model-router
- GitHub:https://github.com/ADVeRTs13/dsh-auto-model-router