REA 逆向分析工具安装指南：终端一条命令装好，AI 智能体直接接入

REA 逆向分析工具安装指南：终端一条命令装好，AI 智能体直接接入

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea

REA（Reverse engineer anything）是一个终端逆向分析工具：没有源码时，它能在命令行里检查 App 行为、JavaScript/Electron 应用和原生二进制，还能以 MCP 服务器形式接入 Claude Code、Codex、Cursor 等 AI 智能体（MCP 即 Model Context Protocol，一种让 AI 客户端调用外部工具的开放协议）。装完 npm 包rea-agents后，你手里多出一个rea命令：对着任意目标直接产出带证据字段的结构化分析结果。

跳读引导：只想跑一条命令看看效果 → 直接去免安装试用：npx 跑单条分析；要装好日常使用 → 从安装主路线开始按顺序执行，全程不超过 3 分钟。

按场景选择安装路线

环境预检：Node.js 版本与 npm 前缀检查

一条命令自检：

node -v && npm -v && npm config get prefix

预期输出：前两行是版本号（形如v24.22.1、11.16.0），第三行是 npm 全局前缀路径（如/usr/local或~/.npm-global）。

不达标先切版本再谈安装：

nvm install 24 && nvm use 24

预期输出：Now using node v24.x.x，node -v复测通过后再继续。

安装主路线：npm 全局安装 rea-agents

先全局安装 npm 包，把rea可执行文件放进 npm 全局目录：

npm install --global rea-agents

预期输出：结尾一行added N packages in Xs，整段日志没有ERR字样。判断成功的标志：随后执行rea --version能返回版本号。注意安装位置：Linux 固定装到~/.local/bin/rea，macOS 和 Windows 落在上一步查出的 npm 前缀的bin子目录下。

仅当你希望 AI 智能体接入 REA 时才需要下一步；只打算在终端手动用，跳过它也能跑所有rea命令，唯一区别是智能体拿不到 REA 工具：

rea setup

预期输出：先弹出一份客户端多选列表（检测到已有 REA 注册的默认选中），确认后展示精确的配置修改计划，你批准后才写文件，原有配置自动备份为.rea.backup，结尾提示哪些智能体需要重启生效。Hopper（一个图形化逆向分析引擎）是独立选项，明确批准才会安装，默认不动你已装的分析引擎。

最小闭环：2 分钟内跑通第一条分析命令

连续跑三条命令，总预算不超过 2 分钟：

rea --version

预期输出：一个形如6.8.0的版本号。

rea analyze-javascript-application /path/to/your-app --json

把路径换成手边任意一个解包后的 Electron 应用目录或 ASAR 文件。预期输出：一份 JSON 记录，含模块清单、导入关系、Electron 边界及各自的 evidence 字段；验收标准是退出码为 0。

rea doctor --json

预期输出：JSON 健康报告，含identity、工具目录和各分析引擎的 readiness 状态。这三条命令只读：分析命令只读目标文件，doctor 严格只读、不修改任何系统状态，你的机器不会被改动。

进阶路线

免安装试用：npx 跑单条分析

适用条件：只想看看效果，不想碰全局环境。-y只授权下载包本身，跑完不碰你的任何配置：

npx -y rea-agents@latest analyze-javascript-application /path/to/app --json

预期输出：与最小闭环相同的 JSON 分析记录。适合试水，日常使用还是装一次省事。

CI 锁定版本的写法

适用条件：不能飘在最新版，要可重复构建。npm 路线把版本号直接写进包名：

npm install --global rea-agents@6.4.0

预期输出：added N packages in Xs，随后rea --version返回6.4.0。拿不准锁哪个号，先查当前最新：

npm view rea-agents dist-tags.latest

预期输出：一个纯版本号，如6.8.0。

install.sh 脚本安装

适用条件：macOS 或 64 位 Linux，想用仓库自带脚本，支持精确锁版加跳过交互，是 CI 友好形态。先--dry-run只读预演：

git clone https://gitcode.com/GitHub_Trending/rea2/rea cd rea bash install.sh --version 6.4.0 --no-prompt --dry-run

预期输出：一段REA install plan，依次打印版本、运行时、npm 命令、目标二进制路径，结尾Dry run complete; no changes made.，且未做任何改动。确认后去掉--dry-run再跑一遍即可，装完结尾提示Run rea setup。脚本在检测到可用终端时会直接接上rea setup交互流程。

⚠️ 该脚本只覆盖 macOS 和 64 位 Linux，Windows 用户请走 npm 主路线。

排障速查

报错原文：rea: command not found原因：npm 全局前缀的bin子目录不在 PATH 里。 修复：先npm config get prefix查前缀，确认其bin子目录在 PATH 中；Linux 上装到~/.local/bin时执行：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

报错原文：Node.js 版本不支持（Node.js x.x.x is unsupported）原因：当前 Node 是 23、25、预发布版或版本过旧，不在支持列表内。 修复：

nvm install 24 && nvm use 24 && npm install --global rea-agents

报错原文：分析命令被拒，提示ps缺失原因：Linux 上 REA 启动的受管进程（Ghidra、静态 JS 分析等）依赖 procps 提供的ps做进程归属检查。 修复：

sudo apt install procps

想回滚到旧版本原因：新版有 bug 或团队要求钉死版本。 修复：

npm install --global rea-agents@6.4.0

💡 MCP 注册钉在执行 setup 时的版本上，回滚后建议再跑一次rea setup对齐注册。

收尾

从自检到第一条分析结果，全程不超过 5 分钟；参数细节和客户端差异见 安装文档 与 CLI 指南。

rea --version # 查已装版本 rea doctor --json # 只读体检，不改任何配置 rea analyze-javascript-application /path/to/app --json # 最小真实分析用例 rea setup # 重连或修复智能体注册 rea update # 升级当前全局安装 rea uninstall # 只移除 REA 自有注册，自动备份 rea uninstall --purge-data # 额外清理 REA 缓存与状态目录 npm view rea-agents dist-tags.latest # 查最新可锁版本号

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea