# 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 实现。