@peterwangze/claude-trigger-router 1.3.0 → 1.4.0

package/docs/configuration-guide.md

@@ -213,6 +213,8 @@ SmartRouter:
       description: "复杂推理"
 ```
 
+如果想直接从常用规则起步，可以复制 `config/trigger.smart-router.yaml`。模板已经覆盖 `coding`、`review`、`architecture`、`long_context`、`fast_reply` 五类高频任务，并把每条规则引用的模型都写在 `Models[]` 中，便于 `ctr doctor` 和 `/ui` 做一致校验。
+
 默认情况下，`SmartRouter` 会启用语义增强和 sticky 稳定性修正，但不会自动启用 `sticky.alignment` 上下文摘要注入。Claude Code 会在每次请求里携带已有会话上下文；只有在你明确需要跨模型切换交接摘要，并接受额外一次 summarizer 调用带来的首包等待时，才建议显式开启：
 
 ```yaml
@@ -410,6 +412,8 @@ Models:
 
 - 主入口：`README.md`
 - 最小示例：`config/trigger.example.yaml`
+- 基础路由五槽位示例：`config/trigger.routing.yaml`
+- SmartRouter 常用规则示例：`config/trigger.smart-router.yaml`
 - 完整高级示例：`config/trigger.advanced.yaml`
 - 旧配置迁移：`docs/models-migration-guide.md`
 - 发布验证：`docs/releasing.md`

package/docs/release-notes-v1.4.0.md

@@ -0,0 +1,40 @@
+# v1.4.0 Release Notes
+
+`v1.4.0` 定位为“SmartRouter 常用体验版”。这个版本把 CTR 的智能路由从“有能力但需要理解内部机制”推进到“能复制模板、能配置候选、能看懂为什么选模、能发现切换割裂，并能按配置路径调优”。
+
+## 本次发布主线
+
+- SmartRouter 规则模板：新增 `config/trigger.smart-router.yaml`，覆盖 coding、review、architecture、long_context、fast_reply 等高频任务。
+- SmartRouter 配置解释：`/api/models/compiled` 和草稿 preview 返回归一化 explanation，`/ui` 展示规则顺序、候选模型、router_model、semantic/sticky 开关和 fallback。
+- 候选模型向导：`/ui` Candidate guide 检查 fast / balanced / deep / long-context 候选覆盖，并支持把建议模型加入 `SmartRouter.candidates` 草稿。
+- 路由决策可解释性：governance trace 记录 route source、rule、confidence、选中模型和 fallback reason，`/ui` 展示最近请求的可读 route decision。
+- 切换体感治理：switch continuity summary 把 initial/final model、sticky、alignment、cascade 和 route source 合成为 stable / aligned / watch / critical 状态。
+- 配置路径级调优建议：health routing tuning 将 context window、switch without alignment、switch cascade risk 和 slow route group 转成 `configSuggestions`，指向 `Router.longContext`、`SmartRouter.sticky.alignment`、`SmartRouter.rules`、`SmartRouter.candidates` 等可操作建议。
+
+## 发布边界
+
+本版本聚焦本地 SmartRouter 常用体验，不把 CTR 宣称为完整 benchmark 运营平台或完整 server/cloud 托管平台。以下事项进入后续版本，但不作为 `v1.4.0` 发布承诺：
+
+- benchmark 历史看板。
+- 人工校准 UI 表单。
+- 固定任务集按核心路由场景重排。
+- `ctr eval` 与真实 trace 的统一收益解释口径。
+- 服务端安全默认策略、密钥轮换手册、主动 pool health、成本/速率元数据和更多调度策略。
+
+对用户的建议口径是：`v1.4.0` 已经适合把 SmartRouter 用作日常多模型组合入口；如果要证明长期质量/速度收益，仍应结合 `ctr eval`、真实 trace 和后续 v1.5.0 的运营化能力。
+
+## 发布前必跑
+
+```bash
+npm run release:verify
+npm run release:stage
+```
+
+正式发布前确认：
+
+- `package.json` 与 `package-lock.json` 版本均为 `1.4.0`
+- `ctr version` 输出 `Version: 1.4.0`
+- `v1.4.0` tag 与包版本一致
+- npm registry 中不存在 `@peterwangze/claude-trigger-router@1.4.0`
+- npm trusted publisher 指向 `peterwangze/claude-trigger-router` 的 `publish.yml`
+- GitHub publish workflow 使用 Node 24 / npm 11.5.1+

package/docs/releasing.md

@@ -23,8 +23,8 @@
 推荐主流程：
 
 1. 更新版本号
-   - `v1.3.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
-   - 本次 `v1.3.0` 的发布边界以 `docs/release-notes-v1.3.0.md` 为准：主打基础路由常用体验，不宣称完整 SmartRouter 产品化版本或完整云端平台。
+   - `vX.Y.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
+   - 本次 `v1.4.0` 的发布边界以 `docs/release-notes-v1.4.0.md` 为准：主打 SmartRouter 常用体验，不宣称完整 benchmark 运营平台或完整云端平台。
 2. 本地先执行发布包验证：
 
 ```bash
@@ -63,6 +63,7 @@ npm run release:verify
 - 目标端口被非本服务占用时的安全提示与“无额外文件修改”边界
 - 残留 / 失效 PID 文件的安全清理
 - `release:stage` 生成的 `.release-stage\ctr-release-home.cmd` wrapper 是否真的指向隔离 `.release-home`
+- SmartRouter v1.4.0 发布承诺的模板、配置解释、候选向导、路由决策摘要、切换体感摘要和配置路径级调优建议
 
 只有这一步通过后，才继续正式发布，避免“发布后才发现包内容、CLI 启动或 setup 主流程有问题”。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peterwangze/claude-trigger-router",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Intelligent trigger-based router for Claude Code with automatic task type detection and model routing",
   "bin": {
     "ctr": "dist/cli.js"