@peterwangze/claude-trigger-router 1.6.0 → 1.8.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 +10 -5
- package/dist/cli.js +888 -179
- package/dist/cli.js.map +4 -4
- package/docs/configuration-guide.md +11 -4
- package/docs/release-notes-v1.7.0.md +36 -0
- package/docs/release-notes-v1.8.0.md +38 -0
- package/docs/releasing.md +4 -4
- package/docs/server-maintainer-guide.md +20 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -11,11 +11,11 @@ Claude Trigger Router 是给 Claude Code 用的本地路由代理。
|
|
|
11
11
|
- 想在 Claude Code 外层增加配置校验、健康检查、治理观测和 UI 工作台
|
|
12
12
|
- 想从 `claude-code-router` 迁移到更清晰的 `Models + Router` 配置心智
|
|
13
13
|
|
|
14
|
-
## v1.
|
|
14
|
+
## v1.8.0 发布定位
|
|
15
15
|
|
|
16
|
-
`v1.
|
|
16
|
+
`v1.8.0` 是低侵入 agent/tool 增强与架构减压版。它把 agent/tool 能力压回现有路由代理和治理观测体系，先补 runtime pipeline、管理 API 权限 contract、UI fragment contract、route handoff summary、tool capability guardrail、输入/输出 guardrail 和 trace spans。
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
这个版本不把独立 agent 编排、任务队列、完整工具平台、完整 cloud 托管控制面或节点集群编排纳入发布承诺。完整发布边界见 [docs/release-notes-v1.8.0.md](docs/release-notes-v1.8.0.md)。
|
|
19
19
|
|
|
20
20
|
## 版本路线
|
|
21
21
|
|
|
@@ -25,7 +25,8 @@ Claude Trigger Router 是给 Claude Code 用的本地路由代理。
|
|
|
25
25
|
- `v1.4.0`：SmartRouter 常用体验，已收口规则模板、候选模型配置向导、路由决策解释、切换体感摘要和配置路径级调优建议。
|
|
26
26
|
- `v1.5.0`：入口基础功能稳定与易用性巩固，已补 packaged entry smoke、remote/server setup slice、UI DOM smoke 和配置保存安全线。
|
|
27
27
|
- `v1.6.0`：多模型收益运营化，已补 benchmark history、人工校准 UI、核心路由场景任务集和评测/真实 trace 统一解释。
|
|
28
|
-
- `v1.7.0
|
|
28
|
+
- `v1.7.0`：服务化与模型池安全体验，已补服务端安全默认值、密钥轮换、主动 pool health、成本/速率元数据和更多调度策略。
|
|
29
|
+
- `v1.8.0`：低侵入 agent/tool 增强与架构减压，已补 runtime pipeline、管理 API route contract、UI fragment contract、handoff summary、tool capability guardrail、输入/输出 guardrail 和 trace spans。
|
|
29
30
|
|
|
30
31
|
完整版本计划见 [docs/superpowers/plans/2026-05-07-core-routing-version-plan.md](docs/superpowers/plans/2026-05-07-core-routing-version-plan.md)。
|
|
31
32
|
|
|
@@ -71,7 +72,7 @@ npm 包也随附可复制部署模板：
|
|
|
71
72
|
- 服务提供者/维护者：[docs/server-maintainer-guide.md](docs/server-maintainer-guide.md)
|
|
72
73
|
- 远程服务使用者：[docs/remote-client-guide.md](docs/remote-client-guide.md)
|
|
73
74
|
|
|
74
|
-
这些模板仍以 `ctr deploy init --target server`
|
|
75
|
+
这些模板仍以 `ctr deploy init --target server` 生成的配置为起点。生成的 server profile 会写入 `Runtime.security` 默认策略：公网监听必须有鉴权、bootstrap key 只用于 admin、远程客户端使用 managed `client + read-only` key，公网部署前应放在 HTTPS 反向代理或内网之后。`GET /api/service-info` 会返回同一策略和部署 checklist，方便 `/ui`、`ctr status` 和维护脚本复核。
|
|
75
76
|
|
|
76
77
|
生成后确认或调整的最小结构如下：
|
|
77
78
|
|
|
@@ -110,6 +111,10 @@ ctr start --daemon
|
|
|
110
111
|
- `operator` key 用于日常运维写操作，例如重启、治理指标快照/定时快照、异常阈值和归档删除；它不能读取配置、保存配置或管理 auth key。
|
|
111
112
|
- managed key 支持过期、撤销和 `quota.request_limit` / `quota.token_limit` / `quota.window_seconds`；窗口配额会持久化到本地状态文件，超限时 429 会返回 `quota.windowResetAt` 和 `Retry-After`。
|
|
112
113
|
- `GET /api/service-info` 会返回脱敏的 `auth` / `security` 摘要和 quota 用量；`GET /api/auth/audit` 可用 admin key 查看最近鉴权允许/拒绝记录。
|
|
114
|
+
- `POST /api/auth/keys/:id/rotate` 会生成替代 managed key、只返回一次新 secret，并立即吊销旧 key；用于定期轮换、交接和疑似泄漏处置。
|
|
115
|
+
- `POST /api/models/pool-health/probe` 可由 operator/admin 触发主动 pool 探测，用轻量 `HEAD` 检查 enabled endpoint 可达性，并把成功延迟或失败写入现有 pool health。
|
|
116
|
+
- `Registration.models[].metadata` 可声明成本和速率限制：`cost_per_1m_input_tokens`、`cost_per_1m_output_tokens`、`cost_currency`、`rate_limit_rpm`、`rate_limit_tpm`，这些字段会进入 compiled model pool 和 `/api/models/pool-health`。
|
|
117
|
+
- `Registration.strategy` 支持 `priority`、`least-latency`、`round-robin`、`health-aware`、`cost-aware`，active endpoint 和 fallback candidate 使用同一排序口径。
|
|
113
118
|
- 公网入口仍建议放在 HTTPS 反向代理之后；远程浏览器访问 UI 时建议使用本地隧道、内网访问，或由反向代理处理认证。
|
|
114
119
|
|
|
115
120
|
## 安装
|