dsh-tier-router — Tiered model routing for DeepSeek Harness

按任务难度分层路由模型：强档（默认 deepseek-v4-pro）负责规划 / 架构 / 评审， 弱档（默认 deepseek-v4-flash）负责日常编码实现。灵感来自 Claude Code 的 /advisor（困难决策时咨询更强模型）与 opusplan（计划模式用强模型、执行切便宜模型）， 在 DeepSeek Harness 里用官方机制实现，并扩展了难度升级门、失败自动升级与 subagent 分层。

工作原理

flowchart LR
    subgraph main["主会话（header 驱动）"]
      U["用户消息"] --> IN["agent/inbox/inserted"]
      IN -->|"auto 模式"| HW["写入 session request/header"]
      PM["plan/mode 翻转"] --> HW
      HW --> API["api-proxy 选择层"]
      API --> STEP["每步模型 = header 档位"]
    end
    subgraph child["子代理（agent/request 直改）"]
      W["tier_worker 派发"] -->|"agentOptions 注入"| C["子代理"]
      C --> AR["agent/request 瀑布"]
      AR -->|"按档位替换 provider/model"| STEP2["子代理步骤"]
    end
    G["tools/pre-execute 守卫"] -.->|"弱档 + 高危模式"| DENY["deny + 升级提示"]
    E["agent/error 连续失败"] -.->|"阈值内"| ESC["临时强档（TTL）"]

sequenceDiagram
    participant U as 用户
    participant S as 会话（主代理）
    participant A as 强档 v4-pro
    participant C as 弱档 v4-flash
    U->>S: /tier plan（进入计划模式）
    S->>S: 写 header → strong
    S->>A: 规划 / 架构 / 设计方案
    U->>S: 批准计划，退出计划模式
    S->>S: 写 header → cheap
    S->>C: 日常编码实现
    S->>A: tier_advisor（困难决策）/ tier_review（收尾评审）
    Note over S,C: 高危操作（rm -rf / 凭据文件）被守卫拦截，要求先切强档

功能

• 自动分层路由（auto 模式，opusplan 式）：进入计划模式时步骤跑强档，执行步骤跑弱档。 主会话通过写入会话 request/header 生效（api-proxy 选择层的官方缝隙，参考社区 dsh-model-router 的做法）；子代理通过 agent/request 每步切换。
• 按会话隔离（per-session）：/tier strong|cheap|auto|off 只影响当前会话， 进程内其他会话保持自己的档位（全局默认 auto）。"别的会话被切换"不会再发生—— 不想被管理的会话发一次 /tier off 即可退出。
• 按需咨询（advisor 式）：/advisor 命令 + tier_advisor 工具，把一个问题 加已有证据交给强档模型，返回建议 / 证据 / 风险 / 验收条件；实现仍由当前档执行。
• 评审阶段：tier_review 工具 + /tier review ，强档模型对变更与验证结果 给出 APPROVE / NEEDS-CHANGES / BLOCKED 及分级问题清单。