用途:为 claude-mem 项目执行语义化版本发布的全流程自动化,涵盖版本号递增、构建同步、提交打标签、生成发布说明、发布至 npm 及发布后校验。
主要能力:根据改动性质判断 PATCH(缺陷修复)、MINOR(新功能)或 MAJOR(破坏性变更);同步版本号到 package.json、plugin/package.json、各 .claude-plugin/.codex-plugin/.qoder-plugin 清单、openclaw 与 grok 清单、cursor 插件清单、dsh/package.json,以及 README.md 的 version-X.Y.Z-green 徽章;用 git grep 校验新旧版本覆盖;运行 npm run build-and-sync 重新生成产物、同步本地 marketplace 副本并重启 worker;提交、打标签、推送、创建 GitHub Release;用 npm run changelog:generate 重新生成 CHANGELOG.md。
使用方式:先写发布说明并判断版本级别,从 git remote -v 确认仓库,逐处更新版本号并校验,然后执行 git add -A && git commit -m "chore: bump version to X.Y.Z"、git tag -a vX.Y.Z -m "Version X.Y.Z"、git push origin main && git push origin vX.Y.Z,再用 gh release create vX.Y.Z --title "vX.Y.Z" --notes "RELEASE_NOTES" 创建发布。npm 发布推荐在标签的干净工作树中进行:git worktree add --detach .scratch/release-X.Y.Z vX.Y.Z,cd .scratch/release-X.Y.Z && npm install --ignore-scripts,npm whoami(须输出 thedotmack),npm publish --access public。发布后用 npm view claude-mem@X.Y.Z version 与 npm view claude-mem version 校验,并在 npm 校验通过后于 ~/Scripts/claude-mem/ 运行 npm run discord:notify vX.Y.Z。
适用场景:claude-mem 维护者的常规版本发布与发布流程规范化。
限制与注意:不要改动 CHANGELOG.md(由脚本重新生成);发布校验不要用 npm run build,因为可能使本地 marketplace 与 worker 不同步;npm token 为维护者 Mac ~/.npmrc 中约 30 天有效期的细粒度令牌,过期需重新获取,不应在对话中索取;GitHub Actions 的 npm-publish.yml 自 v13.26.1 起发布失败,不要依赖它;发布前需确认所有清单版本一致、工作树干净且全部已推送。