先找到卡住的那一步。
从最小检查开始。搜索在本地进行,无需上传日志。
macOS:SwiftBridging 模块重复定义
这是本站案例遇到并解决的具体故障。失败发生在 macOS 进程检查组件的编译阶段,尚未解析目标脚本;最小 Swift 程序也报同样错误。
macOS process ownership helper compilation failed
redefinition of module 'SwiftBridging'核对根因
该环境的 Swift include 目录里,旧 module.modulemap 和 bridging.modulemap 重复声明了相同模块。案例脚本会严格核对内容,不匹配时停止。
使用项目局部修复
下载案例包,在解压目录运行以下步骤(需要 Python 3)。脚本创建局部 VFS 映射与编译器包装器,不修改系统文件,也不关闭 REA 的进程检查。
python3 prepare-swift-workaround.py
source .rea-local/env.sh
npx -y rea-agents@6.5.0 analyze-javascript-application ./case-source --json > result.json修复记录环境为 macOS arm64、Swift 6.1、SDK 15.4。打开新终端可停止使用这组临时变量;工具链更新后应先在无映射的新终端验证。
查看脚本 ↗ · 下载案例包 ↓Node 版本不兼容
运行 node --version 和 npm --version。REA 6.5.0 声明支持 Node 22.19+(22.x)、24.11+(24.x)或 26+。Node 23、25 不在声明范围。切换后重开终端,确认 PATH 中的 Node 已改变。
配置完成,但代理看不到 REA MCP
确认 setup 选中的是正在使用的客户端,并已批准配置计划。完全退出并重启代理,再运行对应的 doctor --client 命令。只有 skill 不等于 MCP 已注册;doctor 注册通过也不等于分析引擎已准备好。
找不到 Ghidra / Hopper / IDA
先确认需要原生二进制分析。静态 JavaScript 案例无需这些引擎。需要引擎时,先验证它能独立启动,再按官方文档配置路径;Windows Ghidra 路径需核对实验性支持说明。
目标目录或文件无法读取
检查目标是否存在、当前用户是否可读。含空格的路径用双引号包围。JavaScript 分析使用解包目录或受支持的 ASAR,不把安装包直接当源码目录。先用本站冻结案例缩小问题范围。
Linux 的 ps / 进程检查失败
检查 command -v ps。相关 Linux 分析路径要求 procps 兼容的 ps;按发行版安装相应软件包并确认它位于当前 PATH。
网页分析连不上浏览器
网页地址不是浏览器调试端点。按官方指南建立专用 Chromium 调试会话,确认代理使用该会话的端点,并检查目标页面是否已打开。
没有匹配项。试试 Node、Swift、Ghidra 或 MCP。
按你的下一个问题继续阅读
- REA MCP:客户端、服务与分析引擎的关系
理解 REA MCP 的工作关系,区分代理注册、工具发现与引擎准备,按 JavaScript、浏览器和原生目标选择验证步骤。
- REA 接入 Claude Code:配置与首次检查
用可预览的配置流程将 REA 接入 Claude Code,检查 MCP 注册,区分 Claude Code 与 Claude Desktop,并设计首次分析问题。