kmsg版本管理

kmsg使用包含日期的版本格式。

复制MAJOR.YYMMDD.PATCH_COUNT

示例:

复制1.260727.0

唯一来源

仓库根目录的VERSION是唯一版本来源，文件内容不包含开头的v。

构建时，SwiftPM插件会验证格式并生成BuildVersion。kmsg --version、kmsg status与发布产物均使用同一数值。

字段含义

• MAJOR: 在破坏性变更或重大里程碑时递增
• YYMMDD: 发布日期
• PATCH_COUNT: 当天首个版本为0，追加发布时依次递增

Git标签使用v前缀。

复制v1.260727.0

操作规则

• 创建发布标签前更新VERSION
• 新日期的首次发布使用PATCH_COUNT=0
• 同日追加发布只增加patch count
• 日期变化时把patch count重置为0
• 二进制报告的版本与标签不一致时，发布流程必须失败

提升版本

不要手工编辑VERSION，请使用项目提供的命令。

复制make release-patch
make release-major

修改前可先执行dry run。

复制scripts/headatever.sh patch --dry-run

自动化会依次完成下一版本验证、VERSION更新、chore(release): v<version>提交以及带注释的标签创建。

完整流程请参阅英文版本管理文档。