yjh051108/dsh-routing-suite · 上手攻略
- 仓库：yjh051108/dsh-routing-suite
- 链接：https://github.com/yjh051108/dsh-routing-suite
- 分类：AI Agent · 运行时增强
- 作者：Tom
- 更新：2026-08-22
是什么
dsh-routing-suite 是一个聚合套装，由两个独立维护的组件构成，专门解决「DSH 运行时缺乏任务感知思维模式路由」的问题。它不是一个独立的 AI Agent，而是 DSH（DeepSeek Host）生态的运行时增强层。
核心组成：
| 组件 | 仓库 | 版本 | 职能 |
|---|---|---|---|
injector/ |
dsh-super-injector | v0.3.3 | 运行时注入器：dev_* 工具全家桶（注入/热重载/侧挂转正/卸载/路由自愈） |
preset/ |
dsh-router-standard | v0.3.0 | 思维模式路由预设：router-standard（分类 persona + 完整 sections）/ router-spec（深度思考优先） |
两个组件独立演进（submodule 指向各自 main），套装聚合安装链与总览文档。
解决什么问题
DSH 默认的对话模式是「统一风格应对所有任务」，这导致：
- 开放性任务（写方案、做调研）模型跑偏到执行者模式，完成率曾为 0%
- 首轮路由失灵：所有会话首轮无条件走 weak（模型自分类）路径，用户消息分类形同虚设
- 近距离引导每轮额外调用：每轮用户消息后注入引导时产生额外的 LLM API 调用，费用翻倍
- plan-mode 与 persona 冲突：开启规划模式后 persona 覆盖导致边界丢失
dsh-routing-suite 通过「注入器 + 路由预设」双层机制，在 DSH 重启后以零人工干预方式解决上述四个问题。
快速安装
方式一：一键安装（推荐 Windows/PowerShell）
git clone --recurse-submodules https://github.com/yjh051108/dsh-routing-suite.git
cd dsh-routing-suite
.\install.ps1
脚本自动完成：注入器装配 → 预设复制 → 布局自检 → 提示重启。
方式二：手动安装
# 步骤 1：装配注入器
dsh plugin --profile web add .\injector
# dsh 不在 PATH 时：
npx '@deepseek-ai/dsh' plugin --profile web add .\injector
# 步骤 2：安装 router 预设（每个预设目录平铺复制到 .agent-presets 下）
# 注意：DSH 只扫描一级子目录，不要复制 preset 整目录
$target = Join-Path $env:USERPROFILE '.dsh\.agent-presets\router-standard'
Copy-Item -Recurse .\preset\router-standard $target
$target = Join-Path $env:USERPROFILE '.dsh\.agent-presets\router-spec'
Copy-Item -Recurse .\preset\router-spec $target
# 步骤 3：重启 DSH → 新会话选择 Router Standard / Router Spec (experimental)
⚠️ 关键坑：复制时路径末尾不能多套一层
preset/目录，否则 DSH 发现不了预设。
环境要求： DSH 运行时（deepseek-ai/dsh）+ PowerShell（Windows）或 bash（Linux/macOS手动）。
核心用法
启动路由会话
DSH 重启后在新会话中选择： - Router Standard — 任务分类 persona + 完整 sections，适用于日常大多数任务 - Router Spec (experimental) — 深度思考优先，适用于复杂分析、论文、架构设计
router-standard 的三行为带 + weak 内路由
预设根据任务类型自动路由到对应 persona：
| 行为 | 场景 | 说明 |
|---|---|---|
spec |
计划-集体任务 | 规划型 persona，规划边界清晰 |
react |
执行者任务 | 快速执行，适合明确指令 |
mixed |
陷阱，回避 | 自动识别并绕开模糊/危险指令 |
weak |
模型自分类 | 首轮兜底，按消息内容自判断 |
按模型选 persona（区分度数据）
| 模型 | 推荐 persona | 实测区分度提升 |
|---|---|---|
| Pro 系列 | spec + few-shot | +5.0 |
| Flash 系列 | neutral + classify | +5.7 |
AI 自优化工具（会话内可用）
dev_router_status # 查看当前路由状态
dev_router_mode # 手动切换路由模式
dev_mode_subagent # 启动子 agent 模式
典型适用场景
1. DSH 重度用户日常提效 原本所有任务走同一风格，复杂规划任务容易被模型「跑偏」成执行模式。Router Standard 三锚（回顾 + 收敛 + 反跑题）将开放任务完成率从 0% 提升到 100%。
2. 多模型团队协作 Pro 系列和 Flash 系列对 persona 偏好不同，通过预设切换实现「同一套 DSH、不同模型最优输出」。
3. 长程规划任务保护
plan-mode 保留机制：切换 persona 时只替换 section，plan 的边界条件不丢失。适用于需要多轮迭代的方案设计。
4. 企业内部知识管理
结合 agent/inbox/claimed 首轮真实消息捕获，实现「接入真实任务流 → 首轮即分类」，无需人工前置判断。
坑与注意
⚠️ 安装路径坑：DSH 只扫描 ~/.dsh/.agent-presets/ 一级子目录。复制时必须是 ./preset/router-standard/* 里面的内容平铺到 router-standard/ 下，而不是把 router-standard 文件夹再套一层。
⚠️ 首轮路由修复前提：v0.3.0 的首轮路由真实生效依赖 agent/inbox/claimed 接口，需确认 DSH 版本支持该接口（DeepSeek 官方 DSH >= 某版本，版本号未在文档明确标注）。
⚠️ router-pro 未发布：预设中 router-pro 为规划中（planned），v0.3.0 未包含，不要尝试安装。
⚠️ 费用注意：v0.3.0 之前版本每轮引导额外产生一次 LLM API 调用，费用约 2×。升级后引导改走 agent/pre-step，同请求注入，不再额外计费。
⚠️ 组件版本独立：injector v0.3.3 和 router-standard v0.3.0 是分别维护的，升级其中一个不影响另一个，但建议保持同步更新。
与同类对比
| 方案 | 定位 | 注入方式 | 路由预设 | 适用场景 |
|---|---|---|---|---|
| dsh-routing-suite | DSH 生态运行时增强 | 注入器（免重启） | 三行为带 + weak 内路由 + 实验数据支撑 | DSH 重度用户、DSH 二次开发 |
| dsh-super-injector（单独使用） | 纯 dev_* 工具注入 | 同上 | 无 | 仅需要热重载/侧挂转正 |
| OpenAI Assistant API | 通用助手构建 | 云端托管 | 内置分类（不支持自定义行为带） | 快速接入、无需本地定制 |
| LangChain Agents | 应用层 Agent 编排 | 代码层集成 | 可编程自定义路由 | 需要深度定制的 AI 应用开发 |
| CrewAI / AutoGen | 多 Agent 协作框架 | 代码层集成 | 角色-任务绑定 | 多 Agent 协作场景 |
核心差异：dsh-routing-suite 是 DSH 生态的「软改装」，不需要 fork DSH 或写代码，通过注入器和预设文件实现运行时增强，零侵入。
一句话推荐结论
如果你已经在用 DSH 并且经常处理多类型任务，dsh-routing-suite 是目前 DSH 生态里唯一一个同时解决「首轮路由失灵 + 近距离引导费用翻倍 + plan-mode 边界丢失」三个痛点、且有 P1-P23 量化实验支撑的运行时增强方案，建议优先安装 injector 再按需加载 router 预设。
⚠️ 数字核验
- injector v0.3.3：来源 GitHub Release v0.3.3，✅ 核验
- router-standard v0.3.0：来源 GitHub Release v0.3.0，✅ 核验
- 近距离引导缓存命中率 92-94%、路由准确率 96%、收敛率 100%：来自
preset/docs/experiments.md（P1-P23 实验，原始 commit 未逐条核实） - 开放任务完成率 0% → 100%：同上，实验条件未公开具体任务集
- 模型区分度 +5.0 / +5.7：同上，实验细节需进一步核实
原始 commit / Release 链接： - 套装主仓库：https://github.com/yjh051108/dsh-routing-suite - injector v0.3.3：https://github.com/yjh051108/dsh-super-injector/releases/tag/v0.3.3 - router-standard v0.3.0：https://github.com/yjh051108/dsh-router-standard/releases/tag/v0.3.0