| name | release-publisher |
| description | Handles version bumping and release publishing for blazwitcher extension. Invoke when user wants to release, publish, or bump version. |
版本发布助手
处理 blazwitcher 扩展的完整发布流程:版本升级 → GitHub Release → Chrome Web Store。
完整发布流程
pnpm bump_and_push_and_fetch
pnpm package
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
故障排除
| 现象 | 排查方向 |
|---|
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 凭证获取。