前言¶
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 負責日常實現，異常和高風險操作有明確的升級、回退和門控路徑。
