@peterwangze/claude-trigger-router 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,36 @@
1
+ # v1.6.0 Release Notes
2
+
3
+ `v1.6.0` 定位为“多模型收益运营化版”。这个版本不继续扩展服务化或模型池策略,而是先把维护者判断“多模型组合是否真的带来质量/速度收益”的证据链做完整。
4
+
5
+ ## 本次发布主线
6
+
7
+ - Benchmark history:`ctr eval --input/--run` 支持 `--save-history`,把评测摘要写入 `~/.claude-trigger-router/benchmark-history.json`;`ctr eval --history` 可查看最近分数、趋势和 Top models。
8
+ - History API/UI:新增 `/api/benchmark/history`,`/ui` 维护者工作台展示 benchmark history、最近趋势、Top models,并同屏显示真实 trace 的 task comparison / quality evidence 对齐摘要。
9
+ - 人工校准 UI:新增 `/api/benchmark/calibration` 与 `/ui` Human calibration 表单,维护者可把人工评分样本追加进 benchmark history;历史文件只保存摘要,不持久化原始模型输出。
10
+ - 核心路由场景任务集:固定任务新增 `routeScenario`,覆盖 default、think、long_context、background、rule_hit、candidate_selection,并保留 server_ops / pool_health 作为后续服务化证据。
11
+ - 评测与真实 trace 对齐:离线评测报告新增 `byRouteScenario`,UI benchmark history 同时展示离线 history、真实 task comparison 和 quality evidence,避免把 rubric 分数孤立看待。
12
+
13
+ ## 发布边界
14
+
15
+ 本版本聚焦收益运营化,不把 CTR 宣称为完整 server/cloud 托管平台、完整模型池运营平台或 agent 平台。以下事项进入后续版本,但不作为 `v1.6.0` 发布承诺:
16
+
17
+ - 服务端部署默认安全策略、密钥轮换手册和托管维护 checklist。
18
+ - 模型池主动健康探测、成本/速率元数据和更多调度策略。
19
+ - handoff summary、tool capability guardrail、输入/输出 guardrail 和 trace span 化。
20
+ - 更完整的可视化趋势图表或外部报表系统。
21
+
22
+ ## 发布前必跑
23
+
24
+ ```bash
25
+ npm run release:verify
26
+ npm run release:stage
27
+ ```
28
+
29
+ 正式发布前确认:
30
+
31
+ - `package.json` 与 `package-lock.json` 版本均为 `1.6.0`
32
+ - `ctr version` 输出 `Version: 1.6.0`
33
+ - `v1.6.0` tag 与包版本一致
34
+ - npm registry 中不存在 `@peterwangze/claude-trigger-router@1.6.0`
35
+ - npm trusted publisher 指向 `peterwangze/claude-trigger-router` 的 `publish.yml`
36
+ - GitHub publish workflow 使用 Node 24 / npm 11.5.1+
package/docs/releasing.md CHANGED
@@ -7,7 +7,7 @@
7
7
  - `Release Check`:在 PR、`master` push 和手动触发时执行发布前检查
8
8
  - `Publish Package`:在版本 tag、GitHub Release 或手动触发时执行正式发布
9
9
 
10
- 本次 `v1.5.0` minor release 的优先级是入口基础功能稳定与易用性巩固。继续扩展 benchmark、服务化、模型池或 agent/tool 前,发布检查需要先保护 `setup / start / status / code / doctor / ui`、配置保存/修复/迁移、打包后真实用户流和 UI 基础交互看护。
10
+ 本次 `v1.6.0` minor release 的优先级是多模型收益运营化。发布检查需要同时保护既有 `setup / start / status / code / doctor / ui` 入口主路径,以及 `ctr eval`、benchmark history、人工校准 UI、真实 trace outcome / task comparison 的收益证据链。
11
11
 
12
12
  ## 一次性准备
13
13
 
@@ -26,14 +26,14 @@
26
26
 
27
27
  1. 更新版本号
28
28
  - `vX.Y.0` 这类 minor release 还需要同步更新版本依赖用例、README 发布定位和对应 release notes。
29
- - 本次 `v1.5.0` 的发布边界以 `docs/release-notes-v1.5.0.md` 为准:主打入口基础功能稳定与易用性巩固,不宣称完整 benchmark 运营平台或完整云端平台。
29
+ - 本次 `v1.6.0` 的发布边界以 `docs/release-notes-v1.6.0.md` 为准:主打多模型收益运营化,不宣称完整云端平台、完整模型池运营平台或 agent 平台。
30
30
  2. 本地先执行发布包验证:
31
31
 
32
32
  ```bash
33
33
  npm run release:verify
34
34
  ```
35
35
 
36
- v1.5.0 期间建议在正式 `release:verify` 前额外跑一次入口稳定专项:
36
+ v1.6.0 期间建议在正式 `release:verify` 前额外跑一次收益运营专项:
37
37
 
38
38
  ```bash
39
39
  npm test -- --run --coverage
@@ -43,7 +43,7 @@ npm run test:e2e:cli
43
43
  npm run test:e2e:acceptance
44
44
  ```
45
45
 
46
- 其中 coverage 口径已经从早期 `src/trigger/**/*.ts` 扩展到 setup、config、models、protocols、governance、server、auth、doctor、cli 主链;`test:ui` 是源码侧 `/ui` DOM smoke,用于保护配置载入、compiled preview、保存失败提示和 Health action 这类基础交互;`test:e2e:cli:entry` 是较短的打包后入口 smoke,用于先保护 init、doctor、start/status/stop、setup fresh、setup remote client、setup server deployment、code 和 ui;后续新增入口功能时,先补对应看护再扩展低频能力。
46
+ 其中 coverage 口径已经从早期 `src/trigger/**/*.ts` 扩展到 setup、config、models、protocols、governance、server、auth、doctor、cli 主链;`test:ui` 是源码侧 `/ui` DOM smoke,用于保护配置载入、compiled preview、保存失败提示、Health action、benchmark history 和人工校准表单这类基础交互;`test:e2e:cli:entry` 是较短的打包后入口 smoke,用于先保护 init、doctor、start/status/stop、setup fresh、setup remote client、setup server deployment、code 和 ui;后续新增入口功能时,先补对应看护再扩展低频能力。
47
47
 
48
48
  这一步会依次执行:
49
49
 
@@ -80,7 +80,7 @@ npm run test:e2e:acceptance
80
80
  - 目标端口被非本服务占用时的安全提示与“无额外文件修改”边界
81
81
  - 残留 / 失效 PID 文件的安全清理
82
82
  - `release:stage` 生成的 `.release-stage\ctr-release-home.cmd` wrapper 是否真的指向隔离 `.release-home`
83
- - v1.5.0 入口稳定发布承诺的 packaged entry smoke、UI DOM smoke、配置保存安全线、remote client setup 和 server deployment setup
83
+ - v1.6.0 收益运营发布承诺的 benchmark history CLI/API/UI、人工校准 UI、核心路由场景任务集和评测/真实 trace 对齐
84
84
 
85
85
  只有这一步通过后,才继续正式发布,避免“发布后才发现包内容、CLI 启动或 setup 主流程有问题”。
86
86
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@peterwangze/claude-trigger-router",
3
- "version": "1.5.0",
3
+ "version": "1.6.0",
4
4
  "description": "Intelligent trigger-based router for Claude Code with automatic task type detection and model routing",
5
5
  "bin": {
6
6
  "ctr": "dist/cli.js"