用途:自动化完整发布周期——版本提升 → 测试 → 构建 → 提交 → 推送分支 → 创建 PR → 合并 → 打标签 → GitHub Release。主分支受分支规则集保护,禁止直接推送,所有发布均通过 PR 完成。
主要能力:默认走 GitHub Actions 流程(Prepare Release 工作流生成发布 PR,检查通过后自动合并,Tag Release 工作流对合并提交打标签,Release 工作流发布产物);也提供手动回退路径。可从 conventional commits 自动判定 major/minor/patch 提升类型,并处理预发布版本(alpha、rc、stable)。
使用方式:前置条件为工作树干净、位于 main 分支、gh CLI 已认证、npm test 与 npm run build 通过。手动流程依次执行预检、确定版本提升、展示计划并确认、创建 chore/release-v{NEW} 分支、用 npm run bump:*(或 node scripts/bump-version.js <kind>)同步更新各版本文件、运行 npm test、运行 npm run build、提交 chore(release): v{NEW}、推送并创建 PR,最后用 scripts/ci-wait-merge.sh <PR_NUMBER> --tag "v${NEW}" 等待 CI、合并、打标签并创建 Release。
适用场景:需要按规范化流程发布版本并生成 GitHub Release 的仓库维护。
限制与安全规则:绝不跳过测试或构建、绝不 force push、绝不直接推送 main、发布 PR 禁用 squash 合并、未经确认不创建 Release、未经明确要求不删除已有标签或 Release;支持 --dry-run 仅执行预检与分析。版本字段一律通过 npm run bump:<kind> 更新,不得手工编辑。原资料未提供具体价格、平台支持范围或效果数据。