前言¶
DeepSeek Harness（DSH）里，规划、架构和评审需要更强模型，日常实现可以用更便宜的模型。dsh-tier-router 为 DSH 提供分层模型路由：强档处理规划、架构和评审，廉价档处理日常实现，并支持回退链、失败自动升级、顾问/评审、高影响门控和子代理分层。
插件定位¶
仓库标识为 BruceLanLan/dsh-tier-router，许可证为 MIT。它把模型选择分成 strong / cheap 两档：strong 档用于规划、架构和评审，cheap 档用于日常实现。
路由保持 agent-plane：工具、斜杠命令、提示词片段和路由监听器只在会话使用 tiered 时挂载。
核心能力¶
自动分层路由¶
auto 模式下，plan 模式使用强档，执行阶段使用廉价档。
全局默认路由模式是 auto。
会话作用域¶
下面这个命令只影响当前会话：
/tier strong|cheap|auto|delegated|off
其他会话保持自己的 tier。off 模式不会自动升级。
顾问与评审¶
按需顾问可以用：
/advisor <question>
对应工具是 tier_advisor，它把问题交给强档并返回建议、证据、风险和验收标准。
评审可以用：
/tier review <focus>
对应工具是 tier_review，它由强档返回 APPROVE / NEEDS-CHANGES / BLOCKED 结论。
失败自动升级¶
窗口内重复步骤错误时，会话会临时升级到强档。默认是 2 错误 / 60s，TTL 默认 180s。
off 模式不会升级。
回退链¶
每个 tier 支持有序 fallback chain。路由按请求错误边界切换，并在 TTL 后回到主模型。
fallback 状态按 agent 和 tier 维护，默认 TTL 5 分钟；plan 切换期间不会从 cheap 链切到 strong 链。
推理强度¶
cheap tier 默认 medium，可因重试错误、高影响 guard 拒绝或 tier_escalate_effort 提升到 high/max。
也可以手动设置：
/tier effort <medium|high|max>
高影响门控¶
cheap tier 执行时，tools/pre-execute 会拒绝 rm -rf、sudo、敏感路径等高影响操作。
高影响 guard 规则是纯逻辑并经过单元测试。
子代理分层¶
tier_worker 按选定 tier 派发子代理任务，支持 outputSchema、toolFilter、maxDepth、persona 和 background。
也可以用下面命令选择子代理路由：
/tier subagent <inherit|cheap|strong>
提示词升级规则¶
当出现歧义未解、架构/安全/数据完整性、两次失败或高风险完成时，系统提示会引导调用 tier_advisor / tier_review。
安装与启用¶
先确认 Node 引擎要求：
node: ^22.19 || >=24
然后安装到 web profile：
dsh plugin --profile web add dsh-tier-router
经过上面的步骤后，profile bundle 会在 DSH 启动时将 packaged tiered preset 同步到 DSH discovery root。
典型用法¶
下面这组命令覆盖常用切换和配置路径：
/tier strong|cheap|auto|delegated|off
/advisor <question>
/tier review <focus>
/tier set <strong|cheap> <provider> <model> [effort]
/tier effort <medium|high|max>
/tier subagent <inherit|cheap|strong>
工具接口包括：
tier_advisor
tier_review
tier_configure
tier_worker
tier_escalate_effort
README 的序列图示例是：
1、/tier plan 进入 plan mode。
2、approve plan 后切到 cheap。
3、硬决策使用 tier_advisor。
4、最终评审使用 tier_review。
配置与运行边界¶
持久配置可以用：
/tier set <strong|cheap> <provider> <model> [effort]
也可以用 tier_configure 工具。配置默认持久保存，并保存在 tier-router 命名空间。如果只想做临时修改，可使用 sessionOnly: true。
WebUI 设置页可配置 providers、models、reasoning effort、follow-session、fallback chains、routing mode 和 subagent policy。
适用场景与注意¶
适合需要把规划、架构、评审和日常执行分开处理的 DSH 会话：
- 规划、架构、评审交给 strong tier。
- 日常实现交给 cheap tier。
- 需要失败自动升级、回退链、子代理分层或高影响操作门控。
注意：
- 插件以当前
dsh进程权限运行；安装前应检查源码与许可证。 - 路由挂载依赖会话是否使用
tiered；未使用该模式的会话不会看到对应工具、命令和监听器。 /tier切换只影响当前会话；全局默认是auto。off模式不会自动升级。
结尾¶
整体看，dsh-tier-router 的价值在于把 DSH 的模型选择变成按任务分层的路由策略：strong tier 负责规划、架构和评审，cheap tier 负责日常实现，异常和高风险操作有明确的升级、回退和门控路径。
