@peterwangze/claude-trigger-router 1.2.0 → 1.3.0

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

@@ -7,16 +7,19 @@
 - `ctr eval --tasks`：导出固定任务、prompt、期望输出、rubric、质量维度和 result template，方便维护者建立稳定的多模型 A/B 输入。
 - `ctr eval --input results.json`：对已有多模型输出做 deterministic rubric 评分，输出 pass rate、quality、speed、latency、best run、维度均分和失败 findings。
 - `ctr eval --run --models "sonnet;haiku"`：通过 CTR `/v1/messages` 自动执行固定任务集，支持 `--base-url`、`--api-key`、`--timeout-ms`、`--concurrency`、`--max-tokens` 和 JSON 输出。
+- `ctr eval --run --models "sonnet;haiku" --judge-model sonnet`：自动执行后继续调用一个 LLM 裁判模型，回填 `judgeScore`、`judgeFindings` 和 `calibrationNotes`；`ctr eval --input results.json --judge-model sonnet` 也可对已有结果补裁判分。
 - 严格质量维度评分：固定任务与自定义任务都可以用 `qualityDimensions` 解释语义覆盖、完整性、交付格式、安全卫生等差异；任一必需维度低于阈值会让该结果失败。
+- 人工/裁判校准入口：`ctr eval` 输入可以附带 `humanScore`、`judgeScore`、`calibrationNotes` 和 `judgeFindings`，也可以用 `--judge-model` 自动生成裁判分；报告会输出 calibration summary 和高分歧样本，裁判失败会以 `judge_error` 进入 findings 但不会误计入 calibration score。
 - 治理收益观测增强：routing outcome、task comparison、quality evidence、context window guard、switch/alignment/cascade 等指标可通过 metrics、health、CSV 和 UI 进入维护者调优路径。
+- UI benchmark summary：维护者工作台会把 task comparison、quality evidence 和 `ctr eval --run` 下一步动作合并成 benchmark 摘要。
 - 发布链路继续使用 `release:verify` / `release:stage` / GitHub trusted publishing，并要求 tag 与 `package.json.version` 一致。
 
 ## 发布边界
 
-本版本不把 CTR 宣称为完整云端平台或完整自动裁判系统。以下能力已经进入实施计划，但不作为 `v1.2.0` 的发布承诺：
+本版本不把 CTR 宣称为完整云端平台或完整自动裁判系统。`--judge-model` 已提供可重复的裁判执行入口，但它仍应和人工复核一起作为校准信号使用。以下能力已经进入实施计划，但不作为 `v1.2.0` 的发布承诺：
 
-- LLM 裁判与人工校准入口
-- UI/治理面的 benchmark 摘要看板
+- 人工校准 UI 表单
+- 更完整的 benchmark 历史看板
 - 公网 server/cloud 一键部署默认推荐
 - 托管场景密钥轮换操作手册
 - 服务发现、节点/集群编排

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

@@ -0,0 +1,39 @@
+# v1.3.0 Release Notes
+
+`v1.3.0` 定位为“基础路由常用体验版”。这个版本把 CTR 的最高频用户路径从“已经能配置多模型”推进到“新用户能配置、能诊断、能在 UI 看懂、也有 packaged smoke 防回退”。
+
+## 本次发布主线
+
+- 基础路由五槽位说明：README 围绕 `Router.default`、`Router.think`、`Router.longContext`、`Router.background`、`Router.webSearch` 补齐触发条件、推荐模型类型和常见误区。
+- 可复制基础路由模板：新增 `config/trigger.routing.yaml`，用于快速建立 default / thinking / long context / background / web search 的分流配置。
+- `ctr doctor` 路由槽位体检：检查默认模型是否存在、各槽位是否能解析到 `Models[].id`、thinking 能力是否匹配，以及上下文窗口元数据是否缺失。
+- `/ui` 使用者工作台路由解释：展示当前五槽位引用、上游 provider/model、能力提示和潜在 warning，帮助用户确认当前配置是否按预期生效。
+- Context window guide：在 `/ui` 中展示 default 与 longContext 容量、最大上下文候选、缺失元数据计数，并支持把推荐模型设为 `Router.longContext`。
+- packaged basic routing smoke：打包后 acceptance 覆盖 fresh setup、`ctr status`、`ctr code` 环境、五槽位解析，以及真实 `/v1/messages` 请求触发 longContext fallback。
+
+## 发布边界
+
+本版本不把 CTR 宣称为完整 SmartRouter 产品化版本，也不承诺完整云端托管平台。以下事项已经进入后续计划，但不作为 `v1.3.0` 的发布承诺：
+
+- SmartRouter 规则模板、候选模型配置向导、路由决策解释和慢路由/错路由调优建议。
+- benchmark 历史看板和人工校准 UI 表单。
+- 公网 server/cloud 一键部署默认推荐、托管级密钥轮换手册和集群编排。
+- 模型池主动健康探测、成本/速率元数据和更多调度策略。
+
+对用户的建议口径是：`v1.3.0` 已经适合把本地 Claude Code 的基础分流路径作为日常主路径使用；如果要启用 SmartRouter 候选模型或远程服务端，应继续按照 README 的边界说明使用，并等待后续版本把模板、解释和运维入口进一步收口。
+
+## 发布前必跑
+
+```bash
+npm run release:verify
+npm run release:stage
+```
+
+正式发布前确认：
+
+- `package.json` 与 `package-lock.json` 版本均为 `1.3.0`
+- `ctr version` 输出 `Version: 1.3.0`
+- `v1.3.0` tag 与包版本一致
+- npm registry 中不存在 `@peterwangze/claude-trigger-router@1.3.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.2.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
-   - 本次 `v1.2.0` 的发布边界以 `docs/release-notes-v1.2.0.md` 为准：主打智能路由评测与治理增强，不宣称完整云端平台或完整自动裁判系统。
+   - `v1.3.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
+   - 本次 `v1.3.0` 的发布边界以 `docs/release-notes-v1.3.0.md` 为准：主打基础路由常用体验，不宣称完整 SmartRouter 产品化版本或完整云端平台。
 2. 本地先执行发布包验证：
 
 ```bash

package/package.json

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