用途:针对项目规范检查并配置 Sentry 错误追踪集成,适用于新项目接入 Sentry、修正硬编码 DSN、添加 source map 上传与发布跟踪,并验证前端、Next.js、Node.js、Python 项目的 SDK 安装与配置合规性。调试具体告警、查询事件性能数据、管理仪表盘设置或接入其他错误追踪工具时不适用。
主要能力:自动检测项目类型(nextjs/frontend/node/python);检查对应 SDK(如 @sentry/nextjs、@sentry/vue、@sentry/react、@sentry/node、sentry-sdk)及 Vite 插件是否安装;分析初始化配置,校验 DSN 是否来自环境变量、采样率、source maps、初始化位置、框架集成等;Next.js 额外检查 instrumentation 文件、withSentryConfig 包装、tunnelRoute、隐藏与删除 source maps、错误边界、结构化日志、敏感请求头过滤等;执行安全检查(无硬编码 DSN、无前端鉴权令牌、生产采样率合理);生成 PASS/WARN/FAIL 报告;在 --fix 或确认后应用修复;检查 CI/CD 中 SENTRY_AUTH_TOKEN、source map 上传与发布创建。
使用方式:支持参数 --check-only(仅报告)、--fix(自动修复)、--type <frontend|nextjs|python|node>(覆盖类型检测)。相关命令示例:/configure:sentry --check-only、/configure:sentry --fix、/configure:sentry --type nextjs。涉及环境变量:SENTRY_DSN(必需)、NEXT_PUBLIC_SENTRY_DSN(Next.js)、SENTRY_ENVIRONMENT、SENTRY_ORG、SENTRY_PROJECT、SENTRY_AUTH_TOKEN、NEXT_PUBLIC_SENTRY_SKIP_BUILD。配置前建议核对各 SDK 最新版本。
限制:资料称需参考 REFERENCE.md 获取详细检查表、初始化模板与 CI/CD 工作流示例,但未提供其内容;除文中提及能力外,具体配置细节、价格与效果暂未提供。