SuperAPI AI 工具集

release

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:为 argue 包准备并发布新版本,涵盖版本号更新、变更日志生成、打标签、推送以及触发 CI 发布到 npm。

前置条件:工作区干净(git status 无未提交改动)、位于 master 分支、本地 CI 检查通过(npm run ci && npm run format:check)。任一条件不满足需先修复,不可跳过检查。

主要流程:

  1. 收集上下文:读取根 package.json 的统一版本、最近发布标签、自上次标签以来的提交。
  2. 决定版本升级:仅 fix/perf/refactor 为 patch,出现 feat 为 minor,出现 BREAKING CHANGE 或类型带 ! 为 major;所有工作区包共用同一版本号,取最高级别,并向用户确认。
  3. 更新版本:运行 node scripts/bump-version.mjs X.Y.Z 与 npm install,更新根及各 packages/*/package.json,并重写内部依赖。
  4. 生成变更日志:在 CHANGELOG.md 顶部新增 ## [X.Y.Z] - YYYY-MM-DD 段落,按 Features/Fixes/Other 分类,写人类可读描述并附短哈希,跳过合并提交,省略空段落。
  5. 校验:运行 npm run release:check(类型检查、测试、构建、smoke pack)。
  6. 提交、打标签、推送:git add -A、git commit -m "release: vX.Y.Z"、git tag vX.Y.Z、git push && git push --tags。推送后 GitHub Actions 检测标签并发布 @onevcat/argue 与 @onevcat/argue-cli 到 npm;argue-viewer 为 private: true,仅保留本地。
  7. 创建 GitHub Release:运行 node scripts/publish-github-release.mjs,脚本读取根版本、提取 CHANGELOG 顶部段落并执行 gh release create。该步骤独立于 npm 发布,可在推送标签后立即执行。

限制与排错:标签已存在时需本地与远程删除后重打;若第二个包发布失败,可升级到下一个 patch 重新发布,库发布步骤幂等。GitHub Release 已存在时脚本会报错,需先删除或手动更新说明。