@peterwangze/claude-trigger-router 1.0.5 → 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：候选模型智能兜底
 
-- 默认请求走 `Router.default`
-- 命中 TriggerRouter 规则的请求，优先切到规则指定模型
-
-## SmartRouter：候选模型自动选择
-
-`SmartRouter` 是当前产品的另一个核心功能。
+统一 `Router` 的第二层能力，是在显式规则未命中时，用候选模型做智能兜底。
 
 它适合“规则难以穷举，但模型选择仍然很重要”的任务：
 
@@ -140,7 +150,10 @@ TriggerRouter:
 - 日常修复 vs 架构设计
 - 常规回答 vs 长上下文分析
 
-你提供一个路由模型和一组候选模型，`SmartRouter` 会在规则未命中时，从候选模型里自动挑一个更合适的目标。
+你提供一个路由模型和一组候选模型，路由器会在规则未命中时，从候选模型里自动挑一个更合适的目标。
+
+- 规则负责稳定命中
+- 智能兜底负责补上规则没覆盖到的模糊任务
 
 示例：
 
@@ -175,13 +188,14 @@ SmartRouter:
 
 可以简单理解成：
 
-- TriggerRouter 解决“能明确命中的规则任务”
-- SmartRouter 解决“规则没命中时的动态选模”
+- `Router.default` 负责默认去向
+- 显式规则负责“能明确命中的任务”
+- 智能兜底负责“规则没命中时的动态选模”
 
-两者可以同时启用：
+这两层能力可以同时启用：
 
-- 先让 `TriggerRouter` 处理高确定性任务
-- 再让 `SmartRouter` 处理剩余的模糊任务
+- 先让显式规则处理高确定性任务
+- 再让智能兜底处理剩余的模糊任务
 
 ## `interface` 怎么选
 
@@ -243,9 +257,11 @@ ctr doctor
 - 诊断当前配置文件是否存在格式问题
 - 自动修复低风险、可确定补全的结构问题
 - 确认修复后的配置是否还能通过本地校验并让服务启动
+- 用可理解的说明展示当前模型的兼容策略与请求编译方式
+- 预览 capability 配置可能触发的运行时降级，例如 thinking 忽略、工具降级为文本、图片降级为文本
 - 在征得你同意后，对配置中的模型发送最小探测请求，确认模型是否真实可用
 
-其中模型探测会消耗少量额度，所以 doctor 会先征求你的确认。
+其中模型探测会消耗少量额度，所以 doctor 会先征求你的确认。探测失败时，doctor 会优先给出面向用户的失败说明和处理建议，再保留原始远端报错供继续排查。
 
 ## 推荐使用顺序
 
@@ -328,33 +344,3 @@ http://127.0.0.1:5678/ui
 - `docs/configuration-guide.md`
 - `docs/models-migration-guide.md`
 - `docs/releasing.md`
-
-## 发布前验证
-
-如果你是维护者，发布前建议执行：
-
-```bash
-npm run release:verify
-```
-
-这一步现在会包含：
-
-- 常规测试
-- tarball 安装校验
-- 安装后 CLI 冒烟校验
-
-这样可以尽量避免“发出去再发现 CLI 不可用”。
-
-如果你想把“当前仓库里尚未发布的最新版本”直接安装到真实全局环境，可执行：
-
-```bash
-npm run install:local-release
-```
-
-它会自动执行：
-
-- `npm run build`
-- `npm pack`
-- `npm install -g <本地 tarball>`
-
-这样安装的是“待发布包的真实内容”，比直接 `npm install -g .` 更适合发包前手动验收。

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"