用途:在用户要求升级 Sentry、迁移到新主版本、修复废弃的 Sentry API,或版本提升后出现破坏性变更时报错时,AI 引导完成 Sentry JavaScript SDK 的跨主版本迁移。
主要能力分四个阶段。检测阶段读取 package.json 中的 @sentry/* 依赖与版本,依据依赖判断框架(Next.js、Nuxt、SvelteKit、Remix、React、Angular、Vue、Express、NestJS、SolidStart、Astro、Bun、Cloudflare、Node.js 等)及对应 Sentry 包,检索 Sentry 配置与 instrumentation 文件,并扫描 v7、v8 的废弃模式(如 @sentry/hub、@sentry/tracing、startTransaction、getCurrentHub、enableTracing 等)。推荐阶段计算单跳或多跳迁移路径,加载 references/v7-to-v8.md、v8-to-v9.md、v9-to-v10.md 等参考,按可自动修复、需 AI 辅助、需人工复核三类列出变更并确认范围。引导阶段逐文件处理:先改包导入,再改 API 名称,再改 Sentry.init() 配置与构建配置,然后处理 Hub 变量、性能事务、自定义集成等复杂模式,最后统一更新 package.json 版本并验证构建。核查阶段确认所有 @sentry/* 同一主版本、无删除包的导入错误、TypeScript 编译通过、构建与测试通过。
使用方式:以技能形式调用后按提示确认迁移路径与范围。自动修复包括包导入重命名、方法重命名、简单配置项替换;复杂变更会解释并提出具体编辑;不确定处请用户确认。可用 npx @sentry/wizard -i upgrade 作为 v8→v9 的 CLI 替代,但可能无法覆盖全部模式。
限制:仅覆盖 JavaScript SDK,不含 Python、Ruby、Go 等其他 SDK;无等价替代的已删除 API、采样与 source maps 默认值等行为变更、自定义 transport 需人工复核;资料未提供具体价格与收费信息。