@peterwangze/claude-trigger-router 1.0.6 → 1.0.7

package/README.md

@@ -33,7 +33,8 @@ ctr setup
 
 - 检查当前 `~/.claude-trigger-router` 配置是否可以直接复用
 - 检查旧的 `claude-code-router` 配置是否可以迁移
-- 如果都不适用，就引导你创建最小可用配置
+- 如果都不适用，就按“默认模型 ID -> 接入方式 -> API 信息”的顺序引导你创建最小可用配置
+- 完成最小配置后，可选继续添加一个复杂任务模型，并直接生成 SmartRouter 路由模板
 - 保存配置后启动本地服务
 
 这是当前最推荐、也是覆盖最完整的用户入口。
@@ -80,11 +81,20 @@ Router:
 
 消息格式转换由路由层统一处理，不需要你自己按不同厂商手写消息体。
 
-## TriggerRouter：规则路由
+如果你在 `ctr setup` 中选择继续添加“复杂任务专用模型”，setup 还可以直接帮你补一层 SmartRouter 模板：
 
-`TriggerRouter` 是当前产品的核心功能之一。
+- 规则模板：把架构设计、代码审查、深入分析等高确定性任务切到复杂任务模型
+- 规则 + 智能兜底：在规则之外，再让 `router_model` 在默认模型和复杂任务模型之间自动选择
 
-它适合“高确定性任务”：
+这样首次接入时就能同时得到：
+
+- 一个默认模型
+- 一个复杂任务模型
+- 一套可直接修改的 SmartRouter 起步模板
+
+## Router：显式规则优先
+
+统一 `Router` 的第一层能力，是先用显式规则处理“高确定性任务”：
 
 - 架构设计
 - 代码审查
@@ -93,6 +103,11 @@ Router:
 
 这类任务通常可以通过关键词或规则稳定识别，然后直接路由到你指定的模型。
 
+当前这层能力由 `SmartRouter.rules` 承载：
+
+- 默认请求先走 `Router.default`
+- 命中显式规则的请求，优先切到规则指定模型
+
 示例：
 
 ```yaml
@@ -112,7 +127,7 @@ Models:
 Router:
   default: "sonnet"
 
-TriggerRouter:
+SmartRouter:
   enabled: true
   analysis_scope: "last_message"
   rules:
@@ -125,14 +140,9 @@ TriggerRouter:
       model: "opus"
 ```
 
-可以简单理解成：
-
-- 默认请求走 `Router.default`
-- 命中 TriggerRouter 规则的请求，优先切到规则指定模型
+## Router：候选模型智能兜底
 
-## SmartRouter：候选模型自动选择
-
-`SmartRouter` 是当前产品的另一个核心功能。
+统一 `Router` 的第二层能力，是在显式规则未命中时，用候选模型做智能兜底。
 
 它适合“规则难以穷举，但模型选择仍然很重要”的任务：
 
@@ -140,7 +150,10 @@ TriggerRouter:
 - 日常修复 vs 架构设计
 - 常规回答 vs 长上下文分析
 
-你提供一个路由模型和一组候选模型，`SmartRouter` 会在规则未命中时，从候选模型里自动挑一个更合适的目标。
+你提供一个路由模型和一组候选模型，路由器会在规则未命中时，从候选模型里自动挑一个更合适的目标。
+
+- 规则负责稳定命中
+- 智能兜底负责补上规则没覆盖到的模糊任务
 
 示例：
 
@@ -175,13 +188,14 @@ SmartRouter:
 
 可以简单理解成：
 
-- TriggerRouter 解决“能明确命中的规则任务”
-- SmartRouter 解决“规则没命中时的动态选模”
+- `Router.default` 负责默认去向
+- 显式规则负责“能明确命中的任务”
+- 智能兜底负责“规则没命中时的动态选模”
 
-两者可以同时启用：
+这两层能力可以同时启用：
 
-- 先让 `TriggerRouter` 处理高确定性任务
-- 再让 `SmartRouter` 处理剩余的模糊任务
+- 先让显式规则处理高确定性任务
+- 再让智能兜底处理剩余的模糊任务
 
 ## `interface` 怎么选
 

package/config/trigger.advanced.yaml

@@ -55,11 +55,10 @@ Router:
   longContextThreshold: 60000
   webSearch: "sonnet"
 
-# 3) TriggerRouter：高确定性任务优先走规则路由
-TriggerRouter:
+# 3) SmartRouter：统一路由入口。先走高确定性规则，再用候选模型智能兜底
+SmartRouter:
   enabled: true
   analysis_scope: "last_message"
-  llm_intent_recognition: false
   rules:
     - name: "architecture"
       priority: 90
@@ -121,9 +120,6 @@ TriggerRouter:
             - "simple"
       model: "ollama_qwen"
 
-# 4) SmartRouter：规则没命中时，从候选模型中自动挑选
-SmartRouter:
-  enabled: true
   router_model: "sonnet"
   candidates:
     - model: "sonnet"
@@ -139,10 +135,6 @@ SmartRouter:
   max_tokens: 256
   fallback: "default"
 
-# 5) Governance：治理模块也直接引用 model id
-Governance:
-  enabled: true
-
   sticky:
     enabled: true
     session_ttl_ms: 3600000
@@ -153,6 +145,19 @@ Governance:
       summarizer_model: "sonnet"
       max_summary_tokens: 256
 
+  semantic:
+    enabled: true
+    mode: "embedding"
+    threshold: 0.2
+    prototypes:
+      architecture: "重构 系统 结构 模块 拆分 架构 设计"
+      code_review: "代码 审查 风险 评审 review"
+      complex_reasoning: "复杂 推理 分析 严谨 逻辑 reasoning"
+
+# 4) Governance：保留响应治理、级联与观测能力；semantic / sticky 已归入 SmartRouter
+Governance:
+  enabled: true
+
   cascade:
     enabled: true
     max_attempts: 2
@@ -168,15 +173,6 @@ Governance:
         to: "opus"
         reasoning: "high"
 
-  semantic:
-    enabled: true
-    mode: "embedding"
-    threshold: 0.2
-    prototypes:
-      architecture: "重构 系统 结构 模块 拆分 架构 设计"
-      code_review: "代码 审查 风险 评审 review"
-      complex_reasoning: "复杂 推理 分析 严谨 逻辑 reasoning"
-
   shadow:
     enabled: true
     mode: "async_audit"
@@ -199,7 +195,7 @@ Governance:
       spike_warn_rate: 0.5
       spike_delta_rate: 0.3
 
-# 6) Legacy 兼容：旧 `Providers` 仅作为兼容层保留，不建议新配置继续扩展
+# 5) Legacy 兼容：旧 `Providers` 仅作为兼容层保留，不建议新配置继续扩展
 # Providers:
 #   - name: openrouter
 #     api_base_url: "https://openrouter.ai/api/v1/chat/completions"