版本发布

受众：开发者 摘要：版本发布索引。版本目标 / 能力边界 / 发布前检查清单。

本文档记录框架各阶段版本的发布目标、能力边界、验收方式和后续计划。

版本发布说明用于回答“当前版本交付什么、哪些能力不阻塞发布、发布前要检查什么”。功能使用方法仍然放在各模块文档中。

升级操作请看 升级指南，版本变化摘要请看 变更日志，API 兼容边界请看 API 兼容策略。

版本列表

版本	状态	说明
V0.1 基础版	已发布	框架基础能力、启动体验、核心测试和文档入口
V0.2 异步运行时	已发布	Queue、Scheduler、Event、Storage、Logging 收口
V0.3 业务基础设施	已发布	Mail、SMS、Notification、WebSocket、Rate Limit 收口
V0.4 生态能力	已发布	Payment、Web3、Open Platform、OAuth、Observability 收口
V0.5 AI Native	已发布	Knowledge Base、RAG、AI Task、开放平台计量和 Agent 友好接口
V0.6 上线收口	已发布	检查并完善现有模块、文档、用户体系和管理后台
V0.7 前端视图	已发布	Admin 后台、App 移动端、PC 电脑端、Install 安装端、Docs 文档站和可预览闭环
V0.8 全栈联调	已发布	前后端联调、真实环境 smoke、生产化复验和可选增强能力
V0.9 会员与内容运营	发布前复验中	会员、余额、账单和内容运营基础已提前落地，当前聚焦本地门禁复验、真实外部 Provider 验收和稳定版准备前置

版本说明原则

• 版本号采用语义化三段式 x.y.z：x 表示重大架构调整或兼容性边界变化，通常可能包含破坏性变更；y 表示向后兼容的功能新增、模块增强或能力扩展；z 表示向后兼容的缺陷修复、文档修正、依赖安全补丁或小范围维护。
• 只记录版本目标、验收标准和发布边界。
• 不堆积开发过程、聊天记录或任务执行日志。
• 具体功能使用方式链接到对应模块文档。
• 开发期版本可以按“验收通过即发布”推进，不长期悬挂在已完成状态。
• 正式稳定版发布必须人工确认后再执行，例如 V1.0、对外承诺兼容性的版本或需要远程 tag / GitHub Release 的版本。
• 发布版本和全局版本号必须对齐：发布 vX.Y.Z 前，Maven 全局 revision、版本说明、Git tag、GitHub Release 标题和 Release 内容都应是同一个正式版本；发布完成后再单独切入下一个 SNAPSHOT 开发周期。
• 发版前可用 ./scripts/release checklist --version X.Y.Z 生成本地检查清单，用 ./scripts/release dry-run --version X.Y.Z --since vA.B.C 生成只读发布说明草稿，用 ./scripts/release api-compat --previous-version A.B.C 生成公共 starter / core jar 兼容检查命令，用 ./scripts/release migration-freeze 生成 V1.0 前 Liquibase freeze 快照报告，用 ./scripts/release install-smoke 生成企业安装向导复验报告，用 ./scripts/release provider-smoke-acceptance --domain <payment-platform|live|wechat|rtc|storage> --provider <provider> 生成通用真实 Provider smoke 验收 runbook，并用 ./scripts/release provider-smoke-gate --record <file> 校验记录里的真实环境、凭据来源、外部对象 / 交易、失败路径和回滚证据完整性；用 ./scripts/release web3-provider-acceptance --chain <chain> --rpc-provider <provider> 生成 Web3 真实链 / RPC / 签名 / 小额交易验收 runbook，并用 ./scripts/release web3-provider-gate --record <file> 校验真实链、签名、充值 / 提现 / Bridge、nonce / replay 和扫描 checkpoint 证据完整性；用 ./scripts/release reading-source-acceptance --source-code <code> 生成 Reading 授权书源真实验收 runbook，并用 ./scripts/release reading-source-gate --record <file> 校验授权、投诉入口、导入批次和生产检查证据；用 ./scripts/release advertising-settlement-acceptance --provider <provider> 生成 Advertising 广告主结算 / 打款联动验收 runbook，并用 ./scripts/release advertising-settlement-gate --record <file> 校验报表、预算、账本、结算引用、外部打款和对账证据；用 ./scripts/release video-provider-acceptance --recommendation-provider <provider> --payout-provider <provider> 生成 Video 推荐 Provider / 创作者打款验收 runbook，并用 ./scripts/release video-provider-gate --record <file> 校验推荐、过滤、创作者收益和外部打款证据；用 ./scripts/release ai-b2b2c-acceptance --payout-provider <provider> 生成 AI B2B2C 真实打款、资金四方对账和 Release Gate 终审 runbook，并用 ./scripts/release ai-b2b2c-gate --record <file> 校验归档前证据完整性；AI B2B2C Release Gate 需要 11 项逐项通过，不接受单个总结果替代逐项证据。gate 通过后可用 ./scripts/release ai-b2b2c-archive --record <file> 生成本地归档包，归档包仍需人工审查外部证据真实性。真实外部厂商和真实链路按 外部 Provider 验收清单 记录。本地脚本不会创建 tag、推送分支或发布 Release。
• 后续 V1.0 和更多版本都在这里新增入口。

Maven Central 发布准备

Maven Central 发布能力默认不参与普通开发构建，只在维护者显式启用 central-release profile 时生效。该 profile 会附加 sources jar、javadoc jar、GPG 签名和 Central Portal 发布插件。

本地预检：

./mvnw -pl spring-open-starters/spring-open-starter-common -am install -DskipTests
./mvnw -pl spring-open-starters/spring-open-starter-common -am help:effective-pom -Pcentral-release -DskipTests -Dgpg.skip=true -Dcentral.publishing.skipPublishing=true

真实发布必须由维护者确认后执行，并提前在 Maven settings.xml 配置 central server token，同时准备 GPG key。central-release 默认 central.publishing.skipPublishing=true，如确需上传到 Central Portal，应显式传入 -Dcentral.publishing.skipPublishing=false；autoPublish 默认关闭，发布后仍由维护者在 Portal 做最终确认。