用途:在 monorepo 中统一管理版本号。仓库根目录的 VERSION 文件是唯一版本来源,格式为 MAJOR.MINOR.PATCH[-PRERELEASE](SemVer 2.0),不带 v 前缀,例如 1.0.0-beta.1、1.1.0。
主要能力:通过编辑 VERSION 文件并运行同步脚本,将版本同步到 backend/pyproject.toml、frontend/ai.client/package.json、infrastructure/package.json,以及 README.md 的版本徽章和“Current release”文本。
使用方式:1) 用新版本号编辑 VERSION 文件;2) 运行 bash scripts/common/sync-version.sh;3) 提交 VERSION 文件与更新后的各清单文件。
PR 门禁:向 main 提交的 PR 在以下情况会导致 CI 失败:VERSION 文件与 main 相比未变化;包清单未同步(运行同步脚本可修复)。
CI 自动处理:Docker 镜像标签、AWS 资源标签、健康端点版本、前端版本显示和 git 标签均由 CI 自动处理,只需提升 VERSION 并同步。
限制:资料未提供脚本内部实现细节、支持的环境依赖或错误处理方式。