SuperAPI AI 工具集

sentry-sdk-upgrade

编程与开发

查看项目

更新于 10-15 21:51

技能介绍

用途:在主要版本之间升级 Sentry JavaScript SDK,适合被要求升级 Sentry、迁移到新版本、修复废弃 API,或版本升级后出现报错时使用。

主要能力:分四个阶段工作。检测阶段读取 package.json 中的 @sentry/* 包与版本,依据依赖判断框架(Next.js、Nuxt、SvelteKit、Remix、React、Angular、Vue、Express、NestJS、SolidStart、Astro、Bun、Cloudflare、Node.js),查找 Sentry 配置文件,并扫描 v7、v8 的废弃写法。推荐阶段计算迁移路径(单跳或多跳),加载对应参考文件(references/v7-to-v8.md、v8-to-v9.md、v9-to-v10.md),按可自动修复、需 AI 辅助、需人工复核三类给出变更摘要,并确认范围。引导阶段逐文件处理:先更新包导入,再做 API 重命名、配置项替换、复杂模式迁移,然后统一更新 package.json 版本并安装依赖,最后用 npx tsc --noEmit 与 npm run build 验证。收尾阶段核对所有 @sentry/* 版本一致、无导入错误、编译与构建通过,并提示目标版本新特性。

使用方式:以技能形式调用,按提示确认迁移路径与变更范围。资料提到 npx @sentry/wizard -i upgrade 可作为 v8→v9 的 CLI 替代方案,但可能无法覆盖所有模式。

适用场景:JavaScript 项目跨主要版本升级 Sentry SDK、修复升级后的类型或构建错误、了解迁移指南与变更日志。

限制:仅覆盖 JavaScript SDK,不涉及 Python、Ruby、Go 等其他 SDK;部分变更(被移除且无等价替代的 API、采样与 source map 默认值等行为变化、自定义 transport 修改)需人工复核;具体版本支持范围与最新版本信息以官方资料为准,本资料未提供完整细节。