cjinhuo 版本发布助手
处理 blazwitcher 扩展的完整发布流程：版本升级 → GitHub Release → Chrome Web Store。
完整发布流程
# 1. 版本升级 + 推送 GitHub Release + 拉取 releases 数据
pnpm bump_and_push_and_fetch
# 2. 构建生产包（产物：packages/blazwitcher-extension/build/chrome-mv3-prod.zip）
pnpm package
# 3. 上传并发布到 Chrome Web Store
pnpm exec dotenv -e .env -- chrome-webstore-upload upload --source packages/blazwitcher-extension/build/chrome-mv3-prod.zip
pnpm exec dotenv -e .env -- chrome-webstore-upload publish
上传后需 Google 审核（通常 1-3 天）。发布前确认
package.json版本号已通过 changeset 升级，且高于线上版本。
命令速查
| 命令 | 说明 |
|---|---|
pnpm bump_version |
用 changeset 升级版本号并推送 |
pnpm push_release |
推送 release 到 GitHub |
pnpm fetch_releases |
拉取扩展的 releases 数据 |
pnpm bump_and_push |
bump + push |
pnpm bump_and_push_and_fetch |
bump + push + fetch（推荐） |
pnpm package |
构建生产包 |
pnpm exec dotenv -e .env -- chrome-webstore-upload upload --source <zip> |
上传到 Chrome Web Store |
pnpm exec dotenv -e .env -- chrome-webstore-upload publish |
提交审核发布 |
前置条件
- Git 工作区干净，改动已提交并测试通过
- Changeset 已正确配置
.env包含所需环境变量：- GitHub Release：
CHANGESET_READ_REPO_TOKEN - Chrome Web Store：
EXTENSION_ID、CLIENT_ID、CLIENT_SECRET、REFRESH_TOKEN、PUBLISHER_ID
- GitHub Release：
故障排除
| 现象 | 排查方向 |
|---|---|
bump_version 失败 |
检查 .env 是否存在及变量正确 |
push_release 失败 |
验证 GitHub 凭证和权限 |
fetch_releases 失败 |
检查网络连接和 GitHub API 访问 |
chrome-webstore-upload 报 401 |
REFRESH_TOKEN 已过期，需重新获取 |
| 上传报版本冲突 | 确认版本号已通过 changeset 正确 bump |
command not found: dotenv |
命令需加 pnpm exec 前缀（dotenv-cli 是本地依赖） |
首次配置或凭证过期 → 阅读 chrome-webstore-setup.md 完成 CLI 安装与 OAuth 凭证获取。