SuperAPI AI 工具集

lokalise-upgrade-migration

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:该技能用于升级 @lokalise/node-api SDK 主版本,重点处理 v8(CommonJS)到 v9+(仅 ESM)的迁移,涵盖破坏性变更检测、代码转换与验证。

主要能力:先评估当前版本与目标版本,列出各主版本差异(9.x 要求 Node.js 18+ 且仅 ESM,8.x 为最后支持 require() 的版本,7.x 引入游标分页,6.x 为 TypeScript 重写并改为 Promise)。随后可指导修改导入方式、package.json 的 "type": "module" 与 tsconfig 的 module/moduleResolution/target 设置,更新分页为游标模式,处理 ApiError,并通过类型检查、测试与冒烟测试验证;还提供回滚流程与 CLI 升级方法。

必要用法:安装目标版本可用 npm install @lokalise/node-api@latest;检查弃用模式可用 grep -rn 搜索 require、.page: 和 token: 等旧用法。CLI 在 macOS 可用 brew upgrade lokalise2 升级,验证用 lokalise2 --version。

适用场景:适用于已有使用 @lokalise/node-api 的项目做版本升级与迁移。限制:需要 Node.js 18+(v9)、干净的 Git 工作树与覆盖 Lokalise API 调用的测试套件;技能不保证升级后所有接口自动兼容,具体变更需参考 SDK 变更日志,未提供的细节暂未提供。