用途:在主要版本之间升级 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 的废弃模式。推荐阶段计算单跳或多跳迁移路径,加载对应参考文件(v7-to-v8.md、v8-to-v9.md、v9-to-v10.md),按可自动修复、需 AI 辅助、需人工复核三类列出破坏性变更。引导阶段逐文件处理:先更新包导入,再做 API 改名,然后调整 Sentry.init() 与构建配置,接着处理 Hub 变量存储、事务性能代码等复杂模式,最后统一升级 package.json 版本并验证构建。交叉链接阶段检查所有包版本一致、无导入错误、TypeScript 编译与构建通过、测试通过,并提示新版本特性。
使用方式:通过技能调用触发,按阶段执行。检测命令如 cat package.json | grep -E '"@sentry/' | head -20;验证命令如 npx tsc --noEmit 与 npm run build。存在 CLI 替代方案 npx @sentry/wizard -i upgrade,但可能无法覆盖所有模式。
限制:仅覆盖 JavaScript SDK,不处理 Python、Ruby、Go 等其他 SDK;部分变更需人工确认;多跳迁移需按顺序增量应用代码改动,但包版本一次性更新到最终目标;具体收费、价格与效果资料未提供。