SuperAPI AI 工具集

updating-npm-package

编程与开发

查看项目

更新于 10-15 21:05

技能介绍

用途:当用户要求更新、升级或提升某个 npm 依赖版本时使用本技能,帮助安全地完成依赖升级。

主要能力与流程:

  1. 查看当前版本,读取 package.json 并执行 npm ls <package-name>。
  2. 查询最新版本,执行 npm view <package-name> versions --json 与 npm view <package-name> dist-tags --json,获取 latest 标签及全部已发布版本。
  3. 判断升级类型:补丁(1.2.3→1.2.4,仅修 bug)、次版本(1.2.3→1.3.0,新增功能且向后兼容)、主版本(1.2.3→2.0.0,含破坏性变更)。
  4. 补丁或次版本升级可直接执行 npm install <package-name>@latest,随后运行 npm run build && npm test,通过后提交并报告变更。
  5. 主版本升级需先调研:获取 CHANGELOG.md、MIGRATION.md 或发布说明,搜索官方迁移指南;识别被移除或重命名的 API、函数签名或返回类型变化、Node.js 版本支持变化、新的 peer 依赖要求、默认行为变化、配置文件格式变化等破坏性变更;用 grep 扫描代码库中所有导入与引用,逐一评估影响。
  6. 执行 npm install <package-name>@latest,按迁移指南逐文件修复受影响用法,再运行 npm run lint && npx tsc --noEmit && npm test && npm run build 验证,最后输出迁移报告,列出已应用的破坏性变更、修改的文件与验证结果。

注意事项:更新前检查 peer 依赖兼容性;monorepo 中需同步更新所有使用该包的工作区;若包提供 codemod 工具(如 npx @next/codemod)应优先使用;package-lock.json 的变更属预期,应随更新一并提交。

限制:资料未提供具体支持的包范围、平台限制或收费信息。