用途:诊断 React Native 报错,通过匹配已知错误模式、检索官方文档并检查项目配置来定位问题根因。适用于构建失败、红屏、Metro 与环境问题、配置或依赖问题等场景。
主要能力:内置错误模式库(references/error-patterns.md,含 24 个覆盖 Metro、构建、运行时和依赖错误的模式);可使用共享脚本 metro.sh 做 Metro 健康检查、包体校验和堆栈符号化;可检索 refs/react-native-docs 官方文档;可读取项目配置(package.json、ios/Podfile、android/gradle.properties、android/app/build.gradle、metro.config.js、babel.config.js);可选通过 ios-sim 的 capture.sh 抓取模拟器红屏截图。
使用方式:按错误来源走不同路径。用户粘贴错误文本时直接解析并匹配模式再查文档;错误显示在模拟器上时先截图再匹配;构建日志失败时解析日志(过大时交给子代理);配置或依赖问题用 config-check;Metro 或环境问题先做 Step 0 健康检查。Step 0 依次运行:metro.sh env 获取环境 JSON(metro、expo、newArch、entry、platform);metro.sh status 检查 Metro 是否运行;metro.sh bundle-check --platform ios 检查 JS 包是否可编译。有原始堆栈时可用 echo '<stack-trace-json>' | metro.sh symbolicate 符号化。
限制与注意:没有项目或环境上下文时诊断能力有限;大日志和截图建议交由子代理处理以保护主上下文;具体修复命令需依据实际报错,资料中未提供通用修复步骤。收费、价格等信息暂未提供。