SuperAPI AI 工具集

verify-before-npm-publish

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:在发布 pangu 到 npm 前做一次发布前验证。examples 应用是真实消费者,其 package.json 固定的是已发布版本,依赖通过 node_modules 和 exports 映射解析,而这正是 pangu 自身构建不会走的路径,因此相对导入缺少扩展名或 files 列表漏掉文件等问题可能蒙混过关。本技能把该消费者临时指向新打出的 tarball,运行全部示例检查后再恢复固定版本;tarball 是唯一可靠产物,且因新版本尚未上架,只有用它顶替固定版本才能提前检查。

主要能力:校验工作树干净、在 master、本地标签不存在、npm 上无该版本;运行测试、lint、typecheck;构建并打包;检查 dist 下无游离文件;核对 tarball 中 package.json 与 pangu.version;比对浏览器扩展 manifest 版本与商店版本;检查 examples 固定版本、CHANGELOG 顶部条目;对比已发布版本确认没有文件被移除。

使用方式:整段命令一次运行,不要拆分,以保证失败或中断时 trap 仍能恢复 examples/package.json。脚本显式捕获退出码而非依赖 set -e,最后输出 VERIFY OK 或 VERIFY FAILED,应报告该行而非工具自身退出状态。关键命令包括 npm test、npm run lint、npm run typecheck、npm run build、npm pack --pack-destination、npm pack "pangu@$PUBLISHED" --min-release-age=0、npm install --prefix examples 与 npm run verify --prefix examples。

限制与说明:VERIFY FAILED 时不要发布,已自动恢复固定版本并清理临时安装;需确认 git diff --quiet examples/package.json 返回 0,若被中断可用 git checkout -- examples/package.json 恢复。失败含义参见技能内表格,例如 dist 中 TS2834 表示相对导入缺少 .js 扩展名。资料未提供官方收费、平台支持范围或其他版本信息。