name: release description: > 执行 LiveAutoRecord 完整发布流程：验证 changeset、检查 Electron 版本 bump 策略、 提交推送、等待 CI 创建 Version Packages PR、验证并 rebase merge PR、 等待 npm 发布和 Electron 构建上传 GitHub Releases。 适用场景：当用户要求发布新版本、执行 release、合并 Version PR、 或 .changeset/ 下已有待发布的 changeset 文件时使用。

发布新版本

执行 LiveAutoRecord 的完整发布流程。

前置条件检查

1. 确认当前在 master 分支且工作区干净（除了 .changeset/*.md）
2. 确认存在未提交或已暂存的 changeset 文件（.changeset/*.md，排除 config.json 和 README.md）
3. 如果没有 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

# 轮询等待 PR 创建（最多等待 2 分钟）
gh pr list --search "Version Packages" --state open

PR 创建后，验证内容：

1. gh pr view <number> — 确认版本号正确
2. gh pr diff <number> — 确认变更内容：
   • changeset 文件被删除
   • 对应包的 package.json 版本号正确更新
   • CHANGELOG.md 正确生成
   • 没有意外的文件变更

将验证结果展示给用户，等待用户确认后再合并。

步骤 5：Rebase Merge PR

用户确认后执行：

gh pr merge <number> --rebase

步骤 6：等待 CI 发布

合并后 changesets.yml 再次触发，执行：

1. pnpm release → 发布 npm 包
2. 创建 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 状态