REA 的安装只有一行命令,但失败的人不少,绝大多数卡在同一个地方。

第一步:把 Node 调到合规的版本

官方要求写在 README 里,很具体:Node 22.x 需要 22.23.4 或更高,24.x 需要 24.22.1 或更高,26.12.1 及以上也可以。23 和 25 两个奇数版本明确不支持。

这一条比看上去严格。如果你机器上是 22.11 或者 24.5,命令会失败,而报错信息不会直说版本不够。稳妥的做法是装一个 24 的 LTS,用 nvm 或 fnm 切过去,再确认 node -v 和 npm -v 都能跑。

第二步:装到 Agent 里

在终端执行 npx rea-agents setup。它会做什么,值得提前知道:扫描你装了哪些 Agent,把 REA 的 MCP 服务器注册进去,同时写入配套的工作流指令,改动之前会先备份原有配置。

执行完必须重启 Agent。MCP 配置在启动时读取,不重启等于没装。

有一个容易被忽略的要求:这一步要在目标项目之外的目录里跑。README 明确写了,包获取要在可信目录里进行,别在你要分析的那个仓库里敲命令。

如果只想装命令行工具,不走 Agent,用 npm install --global rea-agents,装完 rea --help 看子命令。

第三步:决定用哪个逆向引擎

这一步决定了你能分析什么。

只做 JavaScript、Electron、.NET 或者常见的二进制格式解析,不需要装任何引擎,REA 内置了静态分析。

要分析原生二进制,就得有本机的引擎。四个选择:Ghidra 免费开源,但要 JDK 21 以上;Hopper 是 macOS 和 Linux 上的付费工具,大文件明显更快;IDA Pro 最贵,功能最全;Kuna 是另一个解编译器选项。REA 自己不做反编译,它只是把请求路由到这些引擎。

setup 过程可以帮你装 Hopper,但要你确认。Ghidra、IDA、Kuna 都用你已有的安装。

Linux 上还有一个前置条件:Ghidra、JADX、固件工具和静态 JS 分析的进程归属检查需要一个 procps 兼容的 ps 在 PATH 里。缺了它,命令会以一个看不出因果的错误结束。

第四步:跑第一次分析

最快的一次成功,是不依赖任何引擎的那种。拿一个解包好的 JavaScript 或 Electron 应用目录:

npx -y rea-agents@latest analyze-javascript-application /绝对路径/到/应用 --json

Windows 上路径写成 D:/apps/example 这种形式。结果会列出模块、导入关系、Electron 的进程边界,以及每一条对应的证据。

想直接看效果,可以用官网的引导样例:下载那个 Notes 小应用,让它追 CSV 导出功能,然后改一个输入看结果怎么变。

第五步:知道怎么更新

REA 发版极快,6.1 到 6.9 全在十月中旬到十一月中旬这一个月里。全局装的话,rea update 一条命令搞定,rea --update 是它的别名。用 npx 的话,重跑一次 npx rea-agents@latest setup,然后重启 Agent。

四种最常见的失败

一是 Node 版本。上面说过了,占大头。

二是没重启 Agent。配置写进去了,进程还是旧的。

三是客户端截断了工具列表。REA 暴露 207 个工具,某些客户端处理不了整帧 tools/list。官方给了开关:设 REA_MCP_OUTPUT_SCHEMA_PROFILE=compact 限制输出模式,或者 off 干脆不带。反过来,如果你需要完整的字段说明和嵌套校验,设 REA_MCP_INPUT_SCHEMA_PROFILE=full,代价是上下文开销变大。

四是下错了包。市面上有同名仓库和复制 README 的站点。官方只说三个来源:GitHub 的 morluto/rea、rea.tools、npm 的 rea-agents。别的都别装。

装完先别急着上大目标,拿一个自己写过的小程序试一遍,看它给出的证据是不是你能验证的。这一步能省掉后面很多误判。