前言¶
DeepSeek Harness 的核心设计理念是插件化。在使用该工具时,如果需要在 Standard、PTC、Minimal 或 Cordis 等预设之间切换,通常需要手动干预。dsh-auto-preset-router 插件通过引入一个“Auto” Agent Preset,解决了这一痛点。它会利用分类器自动识别用户的第一个意图,并据此路由到最合适的预设。
插件定位¶
这是一个由 yhfgyyf 维护的 DeepSeek Harness 插件。它通过 DeepSeek V4 Flash 模型对用户的第一个提示进行分类,随后根据分类结果自动加载对应的预设。安装后,它不会修改 settings.yaml,而是通过插件自身的配置覆盖默认行为。
核心能力¶
- 自动分类:插件会将用户的第一个提示文本及附件元数据发送给
deepseek-v4-flash模型进行意图识别。 - 智能路由:根据分类结果,自动切换到 Standard、PTC、Minimal 或 Cordis 预设。
- 工具与技能选择:在路由完成后,插件会通过一次独立的 V4 Flash 调用,从有限制的目录中选择可能需要的工具和技能名称,并追加到会话中。它不会加载 Skill 的具体内容,也不会修改目标预设的工具前缀。
路由策略¶
分类器使用固定参数(无工具、推理努力关闭、温度 0、输出限制 16 token)进行判断。其路由逻辑如下:
| 目标预设 | 适用场景 |
|---|---|
standard |
Web/当前信息查询、混合非编程工作、一般协助、完整工具生态,或分类结果模糊的情况。 |
code |
任何代码仓库分析、编程任务,以及广泛的批量/并行工具编排。 |
minimal |
高要求的自包含推理、数学或算法分析,且不涉及仓库或编程工作。 |
cordis |
非编程的 DSH 预设、Cordis 概念或运行时工作。 |
注意:在某些版本中,code 预设可能被称为 ptc,此时分类器的 code 结果会自动挂载 ptc 预设。
安装与启用¶
此插件需要 DeepSeek Harness 0.1.1-rc.1 或兼容版本。安装前请确认已安装 @deepseek-ai/dsh-agent-presets 和 @deepseek-ai/dsh-skill-filesystem(作为可选依赖)。
Web 端安装:
dsh plugin --profile web add github:yhfgyyf/dsh-auto-preset-router
dsh web
TUI 端安装:
dsh plugin --profile tui add github:yhfgyyf/dsh-auto-preset-router
dsh --profile tui
安装后,默认预设会被设置为 auto。若需手动覆盖,可在 settings.yaml 中显式指定:
agent-presets:
default: auto
注意事项¶
- 隐私与数据:分类器仅接收提示文本和附件的元数据(名称、尺寸、媒体类型),绝不会发送图片字节数据。
- 长文本处理:如果提示超过 24,000 个字符,系统只会截取开头和结尾部分进行分类。
- 容错机制:如果分类失败或结果模糊,系统会自动回退到
standard预设。 - 会话锁定:分类过程会产生诊断日志,但不会修改
settings.yaml。已存在的会话会记录路由结果,并在首次真实轮次前锁定到选定的预设。
总结¶
dsh-auto-preset-router 通过自动化分类流程,减少了用户在 DSH 日常使用中的配置开销。它不改变 DeepSeek Harness 的底层逻辑,仅作为路由层存在。