@peterwangze/claude-trigger-router 1.17.0 → 1.18.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.
- package/README.md +4 -4
- package/dist/cli.js +321 -4
- package/dist/cli.js.map +3 -3
- package/docs/release-notes-v1.18.0.md +49 -0
- package/docs/releasing.md +4 -4
- package/package.json +1 -1
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Release notes v1.18.0
|
|
2
|
+
|
|
3
|
+
`v1.18.0` 定位为“治理观测运营化增强版”。这个版本不改变默认路由运行时语义，而是把维护者已经能看到的 trace、metrics、pool health、key quota 和 guardrail 信号继续收敛成可排序、可行动、可在 Web UI 中快速扫描的运营闭环。
|
|
4
|
+
|
|
5
|
+
## 本次闭环
|
|
6
|
+
|
|
7
|
+
1. Routing outcome scorecard
|
|
8
|
+
- `/api/governance/metrics` 新增 `outcomeScorecard`。
|
|
9
|
+
- route reason、final model、semantic intent 三类 outcome 会按 priority score 排序。
|
|
10
|
+
- scorecard 同时结合 model switch、alignment、cascade、latency、quality evidence 和 task comparison，给出 status、evidence、action 和 configPath。
|
|
11
|
+
- CSV export 同步包含 scorecard 摘要和条目。
|
|
12
|
+
|
|
13
|
+
2. Operations risk
|
|
14
|
+
- `/api/service-info` 新增 `operations` 汇总。
|
|
15
|
+
- model pool health 与 managed key quota 不再只分散在两个表格中，而是合并为统一 status 和 actions。
|
|
16
|
+
- `/ui` 维护者工作台新增 Operations risk 面板。
|
|
17
|
+
|
|
18
|
+
3. Guardrail summary
|
|
19
|
+
- `/api/governance/metrics` 新增 `guardrails` 汇总。
|
|
20
|
+
- 输入侧 prompt injection / secret exfiltration 和输出侧 placeholder / tool error 会按 code、severity、count、rate 和 action 汇总。
|
|
21
|
+
- `/ui` 维护者工作台新增 Guardrail summary 面板。
|
|
22
|
+
|
|
23
|
+
4. Web UI 功能审视与视觉设计优化
|
|
24
|
+
- 维护者工作台顶部新增 decision rail。
|
|
25
|
+
- Operations、Guardrails 和 Outcome 三类运营信号先汇总为状态和下一步动作，再进入明细表。
|
|
26
|
+
- decision rail 在桌面保持三列，在移动端回落单列，并纳入 DOM/style/browser smoke 看护。
|
|
27
|
+
|
|
28
|
+
## 发布边界
|
|
29
|
+
|
|
30
|
+
- 不改变 SmartRouter 默认运行时语义。
|
|
31
|
+
- 不新增新的模型调度策略或远程部署形态。
|
|
32
|
+
- 不新增平行观测结构；新增汇总均复用现有 trace、metrics、service-info、pool health、auth quota 和 UI contract。
|
|
33
|
+
- 后续部署形态与远程接入收敛进入 v1.19.0。
|
|
34
|
+
|
|
35
|
+
## 发布前验证
|
|
36
|
+
|
|
37
|
+
本版本发布前至少执行：
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
npx vitest --run src/deploy-assets.test.ts
|
|
41
|
+
npm run test:ui
|
|
42
|
+
npm run test:ui:browser
|
|
43
|
+
npm run test:e2e:cli:entry
|
|
44
|
+
npm run test:route-ux
|
|
45
|
+
npm run build
|
|
46
|
+
npm run release:verify
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
其中 `release:verify` 仍是最终发布门禁。
|
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.
|
|
10
|
+
本次 `v1.18.0` minor release 的优先级是治理观测运营化增强。发布检查需要优先保护既有 `setup / start / status / code / doctor / ui` 入口主路径，以及 fresh setup、远程转发、配置保存、鉴权、route preview 可读解释、`/v1/messages` 流式即时透传、上游中途断流的可读 SSE error、远程中转客户端断开取消上游、结构化 API error 返回不回退、`/ui` 角色化入口不漂移、outcome scorecard、Operations risk、Guardrail summary、decision rail、trace evidence detail 可达和真实浏览器布局不横向溢出。
|
|
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.
|
|
29
|
+
- 本次 `v1.18.0` 的发布边界以 `docs/release-notes-v1.18.0.md` 为准：主打治理观测运营化、outcome scorecard、Operations risk、Guardrail summary、Web UI decision rail 和真实浏览器 smoke。
|
|
30
30
|
2. 本地先执行发布包验证：
|
|
31
31
|
|
|
32
32
|
```bash
|
|
33
33
|
npm run release:verify
|
|
34
34
|
```
|
|
35
35
|
|
|
36
|
-
v1.
|
|
36
|
+
v1.18.0 期间建议在正式 `release:verify` 前额外跑一次 UI 与治理观测运营化专项：
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
39
|
npx vitest --run src/deploy-assets.test.ts
|
|
@@ -43,7 +43,7 @@ npm run test:e2e:cli:entry
|
|
|
43
43
|
npm run test:route-ux
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
-
这条专项把 README/发布说明入口、`/ui` 角色化第一屏、trace evidence detail、真实浏览器桌面/移动布局、help/setup/doctor/code/ui 短入口、setup fresh、remote client、server deployment、route preview、即时流式输出、上游断流可读 error、远程中转取消和结构化 API error 串成同一个发布前门禁。它关注用户能直接感知的“能不能进入、会不会卡住、错误能不能读懂、路由选择能不能预期、页面会不会溢出”，不是只检查内部函数返回。
|
|
46
|
+
这条专项把 README/发布说明入口、`/ui` 角色化第一屏、outcome scorecard、Operations risk、Guardrail summary、decision rail、trace evidence detail、真实浏览器桌面/移动布局、help/setup/doctor/code/ui 短入口、setup fresh、remote client、server deployment、route preview、即时流式输出、上游断流可读 error、远程中转取消和结构化 API error 串成同一个发布前门禁。它关注用户能直接感知的“能不能进入、会不会卡住、错误能不能读懂、路由选择能不能预期、页面会不会溢出”，不是只检查内部函数返回。
|
|
47
47
|
|
|
48
48
|
v1.12.0 期间建议在正式 `release:verify` 前额外跑一次流式稳定专项：
|
|
49
49
|
|
package/package.json
CHANGED