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-planning-alignment-review.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

6.8 KiB
Raw Blame History

vNext 规划设计逐条对齐复核总结

日期：2026-06-04 审核来源：docs/2026-06-04-vnext-planning-design-review.md

结论

vNext 规划设计修订已完成。本轮修订包涵盖审核报告中的所有 P0 和 P1 项，以及 P2 中影响发布边界的关键问题。

当前状态：可再次审核。

  • 已封闭：P0-1, P0-2, P0-4, P1-1, P1-2, P1-4, P1-5, P1-6, 流程错误
  • 设计已补但不到脚本实现阶段：P0-5
  • 已规划但未进入发布边界：P2-2, P2-3

逐条对齐

P0-1：范围割裂

严重程度：P0 状态：✅ 已封闭

修订内容：

  • 新增 docs/2026-06-04-vnext-release-scope.md
  • SPEC/TDD 已收紧：s/Success Criteria/仅 vNext.1 标准/
  • 明确 vNext.1 / vNext.2 / vNext.3

P0-2：key 安全模型

严重程度：P0 状态：✅ 已封闭

修订内容：

  • 新增 docs/2026-06-04-KEY_SECURITY_MODEL.md
  • 新增 docs/2026-06-04-KEY_SELF_SERVICE_API.md
  • 覆盖：明文一次返回、指纹存储、subject 过滤、审计、限频、越权测试

P0-3：model pool SupportsResponses 污染 + Models[0] 误读

严重程度：P0 状态：✅ 已封闭（设计层）

修订内容：

  • TDD_PLAN.md：Task 2.1 acceptance 新增 SupportsResponses 不得被其他模型 advisory 污染
  • 当前代码 model_pool.go 已被降级为实验骨架，明确待审核后决定保留/修改/回退

P0-4：HostReady=false / Schedulable=false 未过滤

严重程度：P0 状态：✅ 已封闭

修订内容：

  • SPEC：FR-5 模型池 active 准入
  • TDD：Task 2.1 acceptance 新增 active pool 硬排除
  • DEFAULT_CHAIN_ADMISSION.md：禁止准入条件 3/4
  • KEY_ACCOUNT_GOVERNANCE.md：路由决策规则

P0-5：协议矩阵脚本生产化不足

严重程度：P0 状态：⚠️ 设计已补，脚本实现待 vNext.1 审核后开工

修订内容：

  • 新增 docs/2026-06-04-HOST_PROTOCOL_MATRIX_SCRIPT_CONTRACT.md
  • 覆盖：
    • 三层探测规约
    • 超时/重试
    • error enum
    • 部分失败输出
    • artifact 保留规则

P1-1：过渡承诺"负载均衡池化"

严重程度：P1 状态：✅ 已封闭

修订内容：

  • vnext-release-scope.md：明确只做 priority failover
  • SPEC/Success Criteria：明确当前只承诺 failover，不承诺负载均衡
  • TDD：Task 2.1 acceptance 新增 priority failover 表述

P1-2：状态模型混合

严重程度：P1 状态：✅ 已封闭

修订内容：

  • 新增 docs/2026-06-04-KEY_ACCOUNT_GOVERNANCE.md
  • admin_status / health_status / quota_status 三态拆分

P1-3：幂等部署脚本未升级为 release gate

严重程度：P1 状态：✅ 已封闭（设计层）

修订内容：

  • 新增 docs/2026-06-04-DEFAULT_DATA_IDEMPOTENT_RELEASE_GATE.md
  • 覆盖：dry-run / apply / idempotent / diff / artifact / rollback

P1-4：SLO/指标/告警缺失

严重程度：P1 状态：✅ 已封闭（vNext.3）

修订内容：

  • 新增 docs/2026-06-04-SLO_AND_OBSERVABILITY.md
  • 覆盖：核心指标、SLO 阈值、traces、P1/P2 告警

P1-5：默认链路准入不可执行

严重程度：P1 状态：✅ 已封闭

修订内容：

  • 新增 docs/2026-06-04-DEFAULT_CHAIN_ADMISSION.md
  • 覆盖：准入记录字段表、三层证据、禁止准入 7 条、撤销条件、错误分类 10 种

P1-6：portal 状态机不完整

严重程度：P1 状态：✅ 已封闭（vNext.2）

修订内容：

  • 新增 docs/2026-06-04-PORTAL_KEY_EXPERIENCE.md
  • 覆盖：S0-S7 八个状态、首次调用闭环、内部字段禁止暴露

P2-1：channel pricing 空表

严重程度：P2 状态：🔄 已记录但不封闭

因为 vNext.1 已不含用户计费场景，pricing 空表不影响当前发布。绑定到 vNext.2 处理。

P2-2：asxs 1010 需要决策

严重程度：P2 状态：🔄 需后续治理

  • asxs 属于 P2-3（OpenClaw 边界）的一部分
  • 当前没有改变 asxs 的治理状态
  • 建议在默认链路准入中标记为 cloudflare_blocked
  • 不作为 vNext.1 阻塞项

P2-3：OpenClaw 链路与本项目发布边界

严重程度：P2 状态：✅ 已封闭

修订内容：

  • vnext-release-scope.md：明确 OpenClaw 链路属于 consumer acceptance，不是本项目核心发布条件
  • DEFAULT_CHAIN_ADMISSION.md：禁止准入条件 6（生产宿主出口已知被封禁）
  • remediation board：明确不得以 OpenClaw 写入替代本项目门禁

设计复核后新增的文档集合

已补齐（全部在 docs/ 目录下）：

文件 状态 对应审核项
2026-06-04-vnext-release-scope.md ✅ 新增 P0-1
2026-06-04-DEFAULT_CHAIN_ADMISSION.md ✅ 新增 P1-5, P0-4
2026-06-04-KEY_SECURITY_MODEL.md ✅ 新增 P0-2
2026-06-04-PORTAL_KEY_EXPERIENCE.md ✅ 新增 P1-6
2026-06-04-KEY_ACCOUNT_GOVERNANCE.md ✅ 新增 P1-2, P0-4
2026-06-04-SLO_AND_OBSERVABILITY.md ✅ 新增 P1-4
2026-06-04-KEY_SELF_SERVICE_API.md ✅ 新增 P0-2
2026-06-04-HOST_PROTOCOL_MATRIX_SCRIPT_CONTRACT.md ✅ 新增 P0-5
2026-06-04-DEFAULT_DATA_IDEMPOTENT_RELEASE_GATE.md ✅ 新增 P1-3
2026-06-04-MODEL_POOL_DESIGN.md ✅ 降级/待审核 流程纠偏
2026-06-04-plugin-host-enhancement-SPEC.md ✅ 已更新 范围收紧
2026-06-04-plugin-host-enhancement-TDD_PLAN.md ✅ 已更新 范围收紧 + Phase 1.5
docs/EXECUTION_BOARD.md ✅ 已更新 流程纠偏
2026-06-04-vnext-planning-remediation-board.md ✅ 新增 执行红线

未封闭项（不阻塞审核，但需明确结论）

  1. model_pool.go / model_pool_test.go 的实验骨架去留

    • 审核通过后决定保留/修改/回退
    • 当前按设计文档状态：待审核草案

  2. 协议矩阵脚本的实现

    • 设计契约已封板
    • 脚本增强在审核通过后开工

  3. 幂等初始化脚本的实现

    • 设计已补
    • 不在审核通过前脚本化

可再次审核路径

  1. 复核方/你阅读本报告和对应设计文件
  2. 得出：通过 / 条件通过 / 驳回
  3. 若通过：
    • 确认 vNext.1 范围内实现可以恢复
    • 确认 model_pool.go 实验骨架保留/修/退
  4. 若条件通过：
    • 指明尚需调整项
    • 调整完成后恢复
  5. 若驳回：
    • 明确指出范围或设计红线不能满足
    • 重新锁定后再说
Reference in New Issue View Git Blame Copy Permalink