用途:将当前发布分支转换为带版本号的 GitHub 正式发布,完成“打标签→推送→发布说明”的流程。
适用时机:用户说“do a vX.Y.Z release”“release this”“릴리스 해줘”“cut a release”等;在变更已合并到发布分支、需要生成带标签并对外发布的版本时使用。不适用于:推送普通提交(直接 git push 即可),或不应打标签的预发布半成品。
主要步骤:
- 确认版本与工作区干净:运行 git status 确认无未提交变更;读取最新的 log/changelog-*.md 获取发布说明内容。
- 打标签:git tag vX.Y.Z(若仓库使用附注标签则用附注形式)。
- 推送标签:git push origin vX.Y.Z。
- 发布:gh release create vX.Y.Z --title "vX.Y.Z" --notes-file <notes>(或 --notes "<summary>")。
- 验证:gh release view vX.Y.Z 查看发布结果,并报告发布 URL。
限制与注意事项:若 git status 显示工作区不干净,或版本已存在(用 git tag -l vX.Y.Z 检查),应先停下来询问,再决定是否打标签。资料未提供对收费、价格、平台支持范围及自动化程度等更多说明。