SuperAPI AI 工具集

ln-821-npm-upgrader

编程与开发

查看项目

更新于 10-16 06:23

技能介绍

用途:升级 Node.js 项目依赖,支持 npm、yarn(classic 与 berry)、pnpm,并在升级过程中处理破坏性变更与迁移。输入为项目路径、包管理器类型和升级策略,输出更新后的依赖清单及机器可读的升级摘要。

主要能力:按优先级分类依赖(peer、framework、build、ui、state、utils、dev);执行安全审计(npm audit --audit-level=high、yarn audit --level high、pnpm audit --audit-level high);检查过期包(npm outdated --json 等);对比主版本识别破坏性变更,并借助 Context7、Ref 或 WebSearch 查询迁移指南;按顺序应用升级;验证构建、类型检查与测试;失败时可回滚单个包。

使用方式:工作流分为预检、分析、安全审计、检查过期、识别破坏性变更、应用升级、应用迁移、验证构建、报告等阶段。预检要求存在 package.json 和可用包管理器,锁文件缺失会警告并在最终验证前重新生成。升级命令如 npm install <package>@latest --save、yarn add <package>@latest、pnpm add <package>@latest。遇到 ERESOLVE 可尝试 npm install --legacy-peer-deps,仍失败才考虑 --force。配置项包括 upgradeType、allowBreaking、autoMigrate、queryMigrationGuides、auditLevel、minimumReleaseAge、legacyPeerDeps、force、runBuild、runTests、runTypeCheck、rollbackOnFailure。

适用场景:需要批量更新 JavaScript/TypeScript 依赖并处理主版本升级的项目。限制:资料未提供具体收费、平台支持范围或效果保证;破坏性变更处理依赖外部文档查询,无法保证所有迁移自动完成;部分步骤需人工跟进。