version-bump

版本号升级技能

指令

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

中文触发条件

• "升级版本"、"版本号"、"发布版本"、"更新版本"、"更新版本并提交"、"提交 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. 解析并计算新版本号

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

当前版本	升级类型	新版本
v2.0.14	patch (默认)	v2.0.15
v2.0.14	minor	v2.1.0
v2.0.14	major	v3.0.0
v2.0.14	2.1.5	v2.1.5

3. 更新版本文件

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

4. 更新 CHANGELOG.md

前置检查（必须）：

1. 读取 CHANGELOG.md，查找 ## [Unreleased] 区块（若不存在则创建）
2. 获取上一个版本 tag 到 HEAD 的全部提交记录，用于后续校验补全：

   git log v{上一个版本}..HEAD --pretty=format:"%h %s"
   

3. 如果没有提交记录，❌ 中止流程，提示用户没有新的变更

git log 校验与补全（始终执行）：

无论 [Unreleased] 是否已有内容，都必须用 git log 逐条校验，确保每个提交都已在 CHANGELOG 中有对应条目：

1. 解析 [Unreleased] 区块中已有的条目（按标题摘要匹配）
2. 将 git log 中的每个 commit subject 与已有条目逐一比对
3. 找出所有尚未记录的提交，分为两类：
   • 根本不存在：CHANGELOG 中完全没有该提交的条目 → 直接生成新条目追加到 [Unreleased]
   • 错位到前一个版本下：在 ## [v{上一个版本}] 区块中找到了该提交的条目 → 必须将条目从旧版本区块中剪切，移动到 [Unreleased] 区块（保留分类分组，删除原位置）
4. 追加/移动完毕后，若全部已有记录则无需改动

⚠️ 错位处理必须优先于补全：先扫描 [v{上一个版本}] 区块是否有属于本次 v{新版本} 的提交，有则剪切移动，再对剩余遗漏的提交生成新条目。避免同一个提交在 CHANGELOG 中出现两次。

覆盖率校验（必须通过）：

校验补全完成后，必须执行以下命令确认无遗漏：

# 获取本版本区间所有有效 commit 数量（排除 Merge 和 bump version）
TOTAL=$(git log v{上一个版本}..HEAD --pretty=%s | grep -cvE "^(Merge |chore: bump version)")
# 统计 CHANGELOG 中本版本的条目数量（按 "- **" 开头的行计数）
RECORDED=$(sed -n '/^## \[v{新版本号}\]/,/^## \[/p' CHANGELOG.md | grep -c "^- \*\*")
echo "有效提交: ${TOTAL} 条, 已记录: ${RECORDED} 条"