| name | release |
| description | 执行 LiveAutoRecord 完整发布流程：验证 changeset、检查 Electron 版本 bump 策略、 提交推送、等待 CI 创建 Version Packages PR、验证并 rebase merge PR、 等待 npm 发布和 Electron 构建上传 GitHub Releases。 适用场景：当用户要求发布新版本、执行 release、合并 Version PR、 或 .changeset/ 下已有待发布的 changeset 文件时使用。
|
发布新版本
执行 LiveAutoRecord 的完整发布流程。
前置条件检查
- 确认当前在
master 分支且工作区干净（除了 .changeset/*.md）
- 确认存在未提交或已暂存的 changeset 文件（
.changeset/*.md，排除 config.json 和 README.md）
- 如果没有 changeset，提示用户先运行
pnpm changeset 创建
步骤 1：验证 changeset 内容
读取 .changeset/ 下的 changeset 文件，检查：
- 包名是否正确（必须是
@autorecord/* 下的有效包名）
- 版本类型是否合理（patch/minor/major）
Electron 版本特别检查
重要：updateInternalDependencies: "patch" 配置意味着 electron 只会自动 patch bump。如果需要 minor 或 major 版本变更（如新功能发布），必须在 changeset 中显式声明 '@autorecord/electron': minor（或 major）。
检查逻辑：
- 如果任何 recorder 或 manager 包有 minor/major 变更，提醒用户是否需要 electron 也做 minor/major bump
- 显示当前 electron 版本（从
apps/electron/package.json 读取）和预期新版本
运行 pnpm changeset status 确认变更列表正确。
步骤 2：提交 changeset
git add .changeset/*.md
git commit -m "chore: add changeset for <version> release"
其中 <version> 是预期的 electron 版本号（如 v4.10.0）。
步骤 3：推送到 master
git push origin master
推送后等待 CI（changesets.yml）自动创建 "Version Packages" PR。
步骤 4：等待并验证 Version Packages PR
gh pr list --search "Version Packages" --state open
PR 创建后，验证内容：
gh pr view <number> — 确认版本号正确gh pr diff <number> — 确认变更内容：
- changeset 文件被删除
- 对应包的
package.json 版本号正确更新
CHANGELOG.md 正确生成- 没有意外的文件变更
将验证结果展示给用户，等待用户确认后再合并。
步骤 5：Rebase Merge PR
用户确认后执行：
gh pr merge <number> --rebase
步骤 6：等待 CI 发布
合并后 changesets.yml 再次触发，执行：
pnpm release → 发布 npm 包- 创建 Electron release tag（如
v4.10.0）
gh run list --workflow=changesets.yml --limit 1
gh run watch <run-id>
等待完成后确认：
- npm 包发布成功（检查 workflow 日志）
- tag 已创建：
gh api repos/{owner}/{repo}/tags --jq '.[0].name'
步骤 7：确认 Electron 构建
tag push 应自动触发 release.yml（changesets.yml checkout 使用 PAT 认证）。确认：
gh run list --workflow=release.yml --limit 3
如果未自动触发，手动兜底：
gh workflow run release.yml --ref v<version>
等待构建完成：
gh run list --workflow=release.yml --limit 1
gh run watch <run-id>
步骤 8：同步本地仓库
git pull --rebase origin master
完成
输出发布摘要：
- npm 包版本和名称
- Electron 版本
- GitHub Release 链接：
https://github.com/WhiteMinds/LiveAutoRecord/releases/tag/v<version>
- Release workflow 状态
