自动模式路由yhfgyyf/dsh-auto-preset-router

DSH 自动模式路由器

English

这是一个符合当前 DeepSeek Harness profile bundle 规范的插件，为 DSH
新增“自动模式” Agent Preset。它只分析会话的第一条用户 prompt：固定使用
deepseek-official/deepseek-v4-flash 选择四个内置模式之一，随后保持用户原始
prompt 不变，由会话当前选择的模型在目标模式下执行。目标 preset 挂载后，Auto
用第二个隔离的 V4 Flash 小调用，从 JSON 边界化且有上限的已安装工具/Skill 摘要中
选择可能必要的名称；调用失败才退回确定性词法排序。主上下文只追加有界名称，
不会加载 Skill 正文，也不会改变目标 preset 的工具前缀。

路由规则

| 目标模式 | 适用任务 |
|---|---|
| standard 标准模式 | 联网或时效信息、混合型非编程任务、一般问答、需要完整工具生态、无法明确判断的任务 |
| code PTC 模式 | 所有仓库/源码分析和编程任务，以及大批量、可并行的工具调用 |
| minimal 极简模式 | 不涉及仓库、源码或编程的自包含高难度推理、数学或算法分析 |
| cordis 创造模式 | 不涉及仓库、源码或编程的 DSH preset/Cordis 概念或运行时工作 |

分类请求不携带工具，推理强度为 off，temperature 为 0，输出上限为 16
tokens。DSH rc.1 下，固定 Flash 分类器只接收首条 prompt 文本和安全的附件元
数据（文件名、尺寸、媒体类型），不会接收图片字节；原始多模态消息不会被改写。
分类调用失败、输出含糊或无法解析时，安全回退到标准模式。

Auto 等待首条 prompt 时只挂载 DSH 官方文件系统 Skill 目录提供器，使 Web 和 TUI
可以展示允许用户调用的 /skill-name。Auto 本身仍不提供任何模型工具；完成路由后，
由目标 preset 负责 Skill 加载和 prompt 注入。

安装

要求 DeepSeek Harness 0.1.1-rc.1 或兼容的后续版本。
0.2.4 已适配 DSH 0.1.3-alpha.2。
首轮判断同时兼容旧版 Session.events 和 DSH 0.1.2-rc.1 使用的
snapshotEvents() API。
如果官方只提供 ptc 而不再提供 code，分类器输出的 code 会挂载 ptc；
trace 保留 rawOutput: "code"，记录 finalPreset: "ptc"，不将更名视为 fallback。
恢复旧会话时，旧 code 选择也会解析为 ptc；如果另行安装了 code preset，
仍优先使用它，菜单不增加重复条目。

Web profile：

dsh plugin --profile web add github:yhfgyyf/dsh-auto-preset-router
dsh plugin --profile web add github:yhfgyyf/dsh-progressive-tools
dsh web

如果已经安装了使用官方 agent-presets 服务的 TUI profile，需要也把 bundle
装入该 profile：

dsh plugin --profile tui add github:yhfgyyf/dsh-auto-preset-router
dsh plugin --profile tui add github:yhfgyyf/dsh-progressive-tools
dsh --profile tui

插件保留官方 roster service，通过该 roster 注册包内只读 preset，并把工程层
默认值设为 auto。它不会改写 settings.yaml。如果用户设置中已经显式选择了
别的默认模式，该设置仍然优先；需要时改为：

agent-presets:
default: auto

第一条 prompt 完成路由后，插件会依次持久化 auto-router/classified 和
agent-preset/selected，再开始真正的第一轮模型请求。分类事件只用于
诊断，并携带 DSH 的 ignorable 信封标记，因此未安装本插件的 Harness
也可以安全跳过该事件。事件内容包括
classifierProvider、classifierModel、rawOutput、finalPreset、
fallbackUsed、errorCode、latencyMs、capabilitySelection、toolHints
和 skillHints。此后会话遵循 DSH 原生规则锁定模式，
不能中途切换。

若至少一个已安装摘要匹配，原始首条用户消息之后会追加一条 plugin-owned
，最多包含 5 个工具名和 3 个 Skill 名。配合
dsh-progressive-tools 时，agent 通过 search_tools/describe_tools 获取延迟
schema；Skill 仍通过 DSH 官方稳定的 skill(name) loader 按需加载。

卸载

dsh plugin --profile web remove dsh-auto-preset-router
dsh plugin --profile tui remove dsh-auto-preset-router

已经存在的会话仍保留历史中记录的模式。如果本机存在
$DSH_HOME/.agent-presets/auto，安装期间它会被插件自带的同名 preset 遮蔽，
但不会被读取、覆盖或删除。卸载 bundle 并重启后，包内 preset 会从 roster 消失。

隐私与失败行为

无论会话当前选择哪个模型，第一条 prompt 的文本与附件元数据都会发送给
DeepSeek V4 Flash 做分类，图片字节不会发送给分类器。路由完成后，未改写的多
模态 prompt 继续走 DSH rc.1 原生附件通道，因此会话当前模型必须真实声明图片
输入能力。官方自带的 DeepSeek Flash/Pro 路由是纯文本的；rc.1 新增官方
deepseek-v4-flash-vision-exp 图片模型。DSH 会拒绝发送并保留草稿，直到选择该
模型或其他支持图片的路由。超过 24,000 字符时只保留开头和结尾；分类失败会进入
标准模式。

开发与校验

npm test
npm run check
npm pack --dry-run

配置好 TUI profile 与 DeepSeek 凭据后，可以运行四个真实新会话案例；该命令会
留下四份简短的会话日志：

npm run test:live:tui

仓库采用当前 DSH 插件分发规范：package.json 声明
dsh.bundle.patch，由 cordis.patch.yml 通过
dsh plugin --profile … add … 组装，不使用已经移除的旧 .dsh-plugin 格式。