前言¶
DeepSeek Harness (DSH) 的生态设计强调一切皆插件。在模型推理场景中,往往需要根据请求类型(代码、视觉、长文本)动态切换模型,或在不同成本/性能的模型间平衡。dsh-auto-router 插件提供了一个合成 Provider,将请求委托给现有 Provider 路由下的具体模型。
插件简介¶
- 名称:
chaoyuzhang001/dsh-auto-router(包名:@chaoyuzhang/dsh-auto-router) - 维护者: ChaoYuZhang001
- 核心功能: 注册一个合成 Provider,通过本地文本分析将请求委托给目标路由上的具体模型。
功能说明¶
插件在模型选择器中注册了一个 “Auto Router” 提供商,包含六个选项:
* Auto · 智能路由: 使用默认分类器进行智能路由。
* Auto · 快速: 强制使用 light 层级。
* Auto · 均衡: 强制使用 medium 层级。
* Auto · 深度: 强制使用 heavy 层级。
* Auto · 代码: 强制使用 code 层级。
* Auto · 视觉: 强制使用 vision 层级。
默认分类器的逻辑如下:
* 图像请求 -> vision
* 代码类请求 -> code
* 较长或较深的任务 -> heavy 或 medium
* 短请求 -> light
通过配置 sticky: true,一个会话在任务过程中只会升级其层级,避免在不同模型间频繁震荡。
安装与配置¶
插件通过 DSH Community Market 或受控插件命令安装。安装后,需要在配置文件中覆盖插入的 auto-router 行。
前提条件:
* 目标 Provider 必须已存在。
* Node.js 版本 >= 22.13.0。
* DSH 版本需为 rc.7 兼容。
配置示例:
- id: auto-router
config:
providerId: auto
displayName: My Auto Router
targetProvider: my-openai-gateway
tiers:
light: fast-model
medium: balanced-model
heavy: reasoning-model
code: coding-model
vision: vision-model
sticky: true
mediumThreshold: 300
heavyThreshold: 1200
contextWindow: 262144
defaultMaxTokens: 32768
默认配置期望存在名为 ciyuan2api 的路由,包含以下模型 ID:
gpt-5.6-luna, gpt-5.6-terra, gpt-5.6-sol, kimi-k2.7-code, gemini-3.5-flash。
适用场景与注意¶
- 权限与安全: 该插件在本地检查最近的用户文本以选择目标模型,不存储、读取或传输 API 密钥。密钥属于目标 Provider 的正常 DSH 设置。无遥测、生命周期脚本或外部端点。
- 依赖: 需要
@deepseek-ai/cordis^4.0.1,@deepseek-ai/dsh-llm^0.1.0-rc.7,@deepseek-ai/schemastery^3.18.1。 - 许可证: MIT。
结语¶
dsh-auto-router 为 DSH 提供了一套标准化的模型路由方案,通过合成 Provider 和本地分类逻辑,简化了多模型编排的配置过程。更多细节可查阅 GitHub 仓库。