版本号升级技能

指令

当用户输入包含以下关键词时，自动触发版本升级流程：

中文触发条件

• •"升级版本"、"版本号"、"发布版本"、"更新版本"、"更新版本并提交"、"提交 git" → 执行版本升级
• •"bump"、"release" → 执行版本升级

参数说明

• •无参数或 patch: patch 版本 +1
• •minor: minor 版本 +1, patch 归零
• •major: major 版本 +1, minor 和 patch 归零
• •具体版本号 (如 2.1.0): 直接使用该版本号

发布选项

⚠️ 重要: 默认情况下，版本升级后必须创建 tag 并推送！只有推送 tag 才能触发 GitHub Actions 自动编译发布。除非用户明确说"不要 tag"或"--no-tag"，否则始终创建并推送 tag。

• •--no-tag 或 "不要 tag": 不创建 git tag（仅提交版本变更）
• •--push 或 "并推送"、"push": 推送 commit 到远程仓库（默认行为）

项目版本文件

• •位置: VERSION (项目根目录)
• •格式: v{major}.{minor}.{patch}
• •示例: v2.0.15

执行步骤

1. 读取当前版本号

cat VERSION

2. 解析并计算新版本号

根据用户指定的升级类型计算：

3. 更新版本文件

echo "v{新版本号}" > VERSION

4. 更新 CHANGELOG.md

将 [Unreleased] 替换为新版本号和当前日期：

# 替换前

## [Unreleased]

# 替换后

## [v{新版本号}] - YYYY-MM-DD

5. 验证更新

cat VERSION
cat CHANGELOG.md | head -20

6. 查看 git 状态

git status
git diff --stat

7. 提交变更

询问用户确认提交信息后执行：

git add -A
git commit -m "chore: bump version to v{新版本号}"

8. 创建 Tag（默认必须执行）

⚠️ 除非用户明确说"不要 tag"，否则必须创建 tag！

git tag v{新版本号}

9. 推送到远程（默认必须执行）

# 推送 commit
git push origin main

# 推送 tag（触发 GitHub Actions 自动编译发布）
git push origin v{新版本号}

示例场景

场景 1：默认升级 patch 版本

用户输入: "升级版本号并提交" 或 "更新版本并推送"

自动执行流程:

1. •读取 VERSION: v2.0.14
2. •计算新版本: v2.0.15
3. •更新 VERSION 文件
4. •执行 git commit
5. •创建 git tag: v2.0.15
6. •推送 commit 和 tag 到远程

场景 2：升级 minor 版本

用户输入: "升级 minor 版本"

自动执行流程:

1. •读取 VERSION: v2.0.14
2. •计算新版本: v2.1.0
3. •更新 VERSION 文件
4. •执行 git commit

场景 3：指定具体版本

用户输入: "版本号改为 3.0.0"

自动执行流程:

1. •读取 VERSION: v2.0.14
2. •使用指定版本: v3.0.0
3. •更新 VERSION 文件
4. •执行 git commit

场景 4：发布新版本（完整流程）

用户输入: "发布新版本并打 tag 推送"

自动执行流程:

1. •读取 VERSION: v2.0.29
2. •计算新版本: v2.0.30
3. •更新 VERSION 文件
4. •执行 git commit
5. •创建 git tag: v2.0.30
6. •推送 commit 和 tag 到远程
7. •GitHub Actions 自动触发，编译 6 平台版本并发布到 Releases

场景 5：仅打 tag（不升级版本）

用户输入: "给当前版本打 tag 并推送"

自动执行流程:

1. •读取当前 VERSION: v2.0.29
2. •创建 git tag: v2.0.29
3. •推送 tag 到远程

输出格式

基础版本升级

版本升级完成:
- 原版本: v2.0.14
- 新版本: v2.0.15
- 升级类型: patch

是否提交 git? (Y/n)

完整发布流程

版本升级完成:
- 原版本: v2.0.29
- 新版本: v2.0.30
- 升级类型: patch

✅ Git commit 已创建
✅ Git tag v2.0.30 已创建

是否推送到远程仓库? (Y/n)
  - 推送后将自动触发 GitHub Actions
  - 自动编译 Linux/Windows/macOS 版本
  - 自动发布到 GitHub Releases

GitHub Actions 集成

当推送 v* 格式的 tag 时，会自动触发以下 workflow：

Concurrency 配置

每个 release workflow 使用独立的 concurrency group，确保三个平台并行编译：

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: false

• •${{ github.workflow }} 使用 workflow 名称作为前缀，避免不同平台的构建相互阻塞
• •cancel-in-progress: false 确保发布构建不会被取消

发布内容

• •6 个平台的可执行文件（三平台并行构建）
• •自动生成的 Release Notes
• •Docker 镜像（推送到阿里云容器镜像服务）
• •发布为 draft 模式，需手动确认发布

注意事项

• •版本号格式为 v{x}.{y}.{z}（无后缀）
• •提交前会显示所有待提交的变更供用户确认
• •如果有其他未提交的变更，会一并提交
• •遵循 Conventional Commits 规范，使用 chore: bump version 格式
• •推送 tag 后，GitHub Actions 需要几分钟完成编译和发布
• •可以在 GitHub Actions 页面查看构建进度