492f33a129
- DEFAULT_CHAIN_ADMISSION.md: reviewed and approved, real artifact refs added - DEFAULT_DATA_IDEMPOTENT_RELEASE_GATE.md: reviewed and approved - scripts/setup_default_data.sh: idempotent init with --dry-run/--apply/artifact - scripts/test/test_default_data.sh: 4 test cases all pass - scripts/acceptance/verify_user_key_self_service.sh: Phase 0 skeleton - .gitignore: add generated artifact directories
102 lines
3.0 KiB
Markdown
102 lines
3.0 KiB
Markdown
# vNext Release Scope
|
||
|
||
日期：2026-06-04
|
||
状态：待审核
|
||
优先级：高于继续实现
|
||
|
||
## 目的
|
||
|
||
统一 `docs/plans/2026-06-04-next-version-plan.md` 与 `docs/2026-06-04-plugin-host-enhancement-SPEC.md` 的范围边界，避免把供应链收口、模型池、用户 key 自助、治理、SLO 同时推进，导致版本失控。
|
||
|
||
本文件是 vNext 的发布范围真相源。后续 TDD、执行板、实现任务都必须服从本文件，而不是各自扩张。
|
||
|
||
## 发布拆分
|
||
|
||
### vNext.1：能力真相与模型池基础
|
||
|
||
本版本发布项：
|
||
|
||
1. 宿主协议能力矩阵
|
||
2. 模型池抽象
|
||
3. pool 到现有 priority failover 运行面的映射规则
|
||
4. 默认链路准入规则
|
||
5. 幂等默认数据/初始化脚本进入发布前置
|
||
|
||
本版本明确不发布：
|
||
|
||
1. 用户 key 自助申请
|
||
2. portal 首次调用闭环
|
||
3. key/account 治理动作页
|
||
4. quota/limit 产品化
|
||
5. SLO/告警完整体系
|
||
|
||
本版本验收命令：
|
||
|
||
- `go test ./internal/host/sub2api -run Capability -count=1`
|
||
- `go test ./internal/provision -run ModelPool -count=1`
|
||
- `bash ./scripts/test/test_host_protocol_matrix_script.sh`
|
||
- 至少一组真实 artifact：upstream probe + host probe + user-key probe
|
||
|
||
本版本必须产出：
|
||
|
||
- `docs/2026-06-04-vnext-release-scope.md`
|
||
- `docs/2026-06-xx-HOST_PROTOCOL_MATRIX.md`
|
||
- `docs/2026-06-04-MODEL_POOL_DESIGN.md`（审核后版本）
|
||
- `docs/2026-06-xx-DEFAULT_CHAIN_ADMISSION.md`
|
||
- 幂等初始化/默认数据 runbook 或脚本说明
|
||
|
||
### vNext.2：用户 key 自助
|
||
|
||
本版本发布项：
|
||
|
||
1. KEY_SECURITY_MODEL
|
||
2. key self-service API 设计
|
||
3. portal key 状态机
|
||
4. 明文只显示一次
|
||
5. 用户首次调用 200 闭环
|
||
|
||
本版本必须产出：
|
||
|
||
- `docs/2026-06-xx-KEY_SECURITY_MODEL.md`
|
||
- `docs/2026-06-xx-PORTAL_KEY_EXPERIENCE.md`
|
||
- `docs/2026-06-xx-KEY_SELF_SERVICE_API.md`
|
||
|
||
### vNext.3：治理与 SLO
|
||
|
||
本版本发布项：
|
||
|
||
1. `admin_status / health_status / quota_status` 三态拆分
|
||
2. key/account 暂停恢复
|
||
3. quota 或 request limit 最小事实源
|
||
4. route resolve 与治理状态联动
|
||
5. SLO / 指标 / 告警 / 发布门禁
|
||
|
||
本版本必须产出：
|
||
|
||
- `docs/2026-06-xx-KEY_ACCOUNT_GOVERNANCE.md`
|
||
- `docs/2026-06-xx-SLO_AND_OBSERVABILITY.md`
|
||
|
||
## 明确非目标
|
||
|
||
以下内容不应作为当前 vNext.1 的完成条件：
|
||
|
||
1. OpenClaw 默认链路写入
|
||
2. 消费方配置联动
|
||
3. 完整负载均衡池化
|
||
4. 宿主后端改造
|
||
5. 常态化直写宿主数据库
|
||
|
||
## 设计红线
|
||
|
||
1. 未经审核通过，不得继续实现新版本主链能力。
|
||
2. 已写但未审批的代码只能标记为“实验骨架”，不能在执行板中表述为既定方案。
|
||
3. `priority failover` 不得表述为“完整负载均衡池化”。
|
||
4. 任何“支持”结论必须区分：upstream / host / user-key 三层证据。
|
||
5. `/v1/models=200` 不能替代真实 `chat/completions=200`。
|
||
|
||
## 当前结论
|
||
|
||
- 现有 `internal/provision/model_pool.go` 仅可视为实验性骨架。
|
||
- 是否保留该骨架作为 vNext.1 起点，必须以后续设计审核结论为准。
|
||
- 在本文件审核通过前，不继续 Phase 2/3/4 实现。
|