用途:在准备或执行 Pake 发布时使用。共享事实(四个版本文件与标签格式、CI 任务、Trusted Publishing、界面分离、contributors bot、修复后关闭 issue)见 AGENTS.md,此处不重复。
发布前:先用 git status --short --branch -uall、git diff、git diff --cached 冻结基线;若存在无关改动,在隔离 worktree 中准备。确认新版本(jq .version package.json)且 npm view pake-cli@X.Y.Z version 返回 404。更新四个版本文件,执行 pnpm run format、pnpm test(若在 /tmp 中因镜像安装 pake-cli@latest 失败可重跑一次,连续两次失败为真实失败),再执行 pnpm run cli:build 与 pnpm run release:check。复查 git 状态,仅还原基线中干净且本次生成的构建产物。提交 chore: bump version to VX.Y.Z,并用 git add -f dist/cli.js 暂存。
打标签与验证:git tag -a VX.Y.Z -m "Release VX.Y.Z" 后 git push origin VX.Y.Z;若被拒,按 AGENTS.md 变基到 contributors bot 提交,禁止 force-push。用 gh run list/view 轮询 release.yml,填写 GitHub Release 标题与正文(CI 只留占位符),检查 npm-publish.yml 与 npm view 结果,记录 quality-and-test.yml,并通过 gh api 为 release 添加六种正向 reaction。
仅 npm 热修复(不打标签):适用于 CLI 或 Rust 模板修复,版本号仍被消耗。更新四个版本文件、构建、release:check、提交并推送 main,记录 publish-sha,等待 Quality 成功,再 gh workflow run npm-publish.yml --ref main -f expected_sha=... -f quality_run_id=...,校验 headSha 与 npm gitHead 一致。热修复跳过标签、Release、reaction 与 Docker。发布成功但验证超时不代表可重发,npm 扫描新包需 5 至 15 分钟以上。
限制:资料未提供价格、平台支持范围等额外信息。