niuniu/sub2api-cn-relay-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
13b88ba2e7ede1e6ff2acb65b2966ea6d7dae40c
sub2api-cn-relay-manager/docs/2026-06-04-vnext-release-scope.md
phamnazage-jpg 492f33a129
Some checks failed
CI / Build & Test (push) Has been cancelled
Details
CI / Lint (push) Has been cancelled
Details
CI / Security Scan (push) Has been cancelled
Details
CI / Docker Build (push) Has been cancelled
Details
CI / Release (push) Has been cancelled
Details
feat(vnext): complete vNext.1 release gate — default chain admission, idempotent init, user key skeleton 
- 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
2026-06-05 11:07:50 +08:00

3.0 KiB
Raw Blame History

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 实现。
Reference in New Issue View Git Blame Copy Permalink