用途:发布 Feishu 插件新版本,把 @m1heng-clawd/feishu 发布到 npm 并创建 GitHub release。
前置条件:工作区干净(所有改动已提交到 main);npm 登录会话有效且对 @m1heng-clawd scope 有发布权限;gh CLI 已认证。
主要步骤:
- 确定版本递增类型。用 gh release list --limit 1 查最近 tag,用 git log ..HEAD --oneline 和 git diff ..HEAD --stat 查看提交与差异,选择 patch(缺陷修复)、minor(新功能)或 major(破坏性变更)。
- 类型检查:npx tsc --noEmit,失败则不要继续。
- 撰写发布说明:git diff <last-tag>..HEAD,先创建草稿:gh release create v<new-version> --draft --title "v<new-version>" --target main --notes "<release notes markdown>"。
- 修改 package.json 中的 version 字段。
- 提交、打标签并推送:git add package.json;git commit -m "chore: bump version to <new-version>";git tag v<new-version>;git push && git push --tags。
- 发布到 npm:npm publish。若认证失败,先让用户运行 npm login 后重试。
- 正式发布 GitHub release:gh release edit v<new-version> --draft=false。
发布说明格式(Features / Bug Fixes / Internal 三节,条目含标题、描述与 PR 编号)。
排错:npm publish 404 或认证错误时,用 npm login 重新认证、npm whoami 确认、再 npm publish。标签已存在时,可 git tag -d v<version>、git push origin :refs/tags/v<version>,修复后重新打标签并推送。
限制:未提供其他平台支持、权限细节或自动化脚本信息;依赖本地 git、npm、gh 环境与账号权限。