REA 逆向分析工具快速上手:1 条命令装好 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)是一个开源 MCP 项目:它把你的 AI 智能体接上本地分析引擎,用自然语言就能逆向 App 行为、JavaScript/Electron 应用和原生二进制,结论自带证据与局限说明。装好它只需一个rea命令。
场景对号:你先判断 REA 能替你干什么
- 📱 手上有个没有源码的 App,想搞懂某个功能怎么实现的 → 智能体直接给出代码级证据,不用猜;
- 🧩 目标是 JavaScript 或 Electron 应用 → 静态分析就能恢复模块、导入和路由关系,不需要任何原生分析引擎;
- 🔍 目标是原生二进制 → 接上你已有的 Hopper、Ghidra、IDA 或 Kuna,拿到伪代码、汇编和引用;
- 💻 想在终端里直接跑分析 → 同一个
rea命令既当 CLI 用,也能当 MCP Server 挂到 Claude Code、Codex、Cursor 等 25 种客户端上。
动手前自查:先核对 Node.js 版本
| 前提 | 要求 | 说明 |
|---|---|---|
| ⚙️ Node.js | 22.x(≥22.23.4)、24.x(≥24.22.1)或 26.12.1+ | Node 23、25、更早的 26.x 及预发布版不受支持 |
| 📦 npm | 随 Node.js 自带 | 安装器不会替你升级 Node 或 npm |
| 🖥️ 操作系统 | curl 脚本仅支持 macOS / 64 位 Linux;npm 方式支持任意 Node 平台(含 Windows) | curl 脚本会自行校验平台 |
| 🐧 Linux 附加项 | procps 家族的ps命令在 PATH 上 | Ghidra、JADX 固件工具及静态 JavaScript/Electron 分析依赖它做进程归属检查 |
自检一条:
node -v执行后终端会打印当前 Node.js 版本。版本落在受支持区间外时,安装器会直接报 "unsupported" 并告诉你用 nvm 或 fnm 怎么切,不用自己猜。
方式怎么选:先定路线再动手
| 方式 | 平台 | 耗时 | 版本控制 |
|---|---|---|---|
| 🐚 curl 安装脚本 | macOS / 64 位 Linux | 一条命令 | --version <semver>锁精确版本 |
| 📦 npm 全局安装 | 全部 Node 平台(含 Windows) | 两条命令 | npm install --global rea-agents@x.y.z |
| 🏃 npx 免安装 | 全部 Node 平台 | 单条命令临时跑 | rea-agents@latest或固定版本号 |
直接给结论:
- 🍎 macOS / Linux 想最快跑起来 → curl 脚本;
- 🪟 Windows 用户,或已有 npm 工作流 → npm 全局;
- 🚀 只想跑一条分析命令、不想动系统 → npx 免安装;
- 🏭 CI / 无交互环境 → curl 加
--no-setup,或干脆 npx。
主路径执行:npm 全局装出可用的 rea 命令
跨平台最稳的路径是 npm 全局安装,分两步:
npm install --global rea-agents执行后 npm 把rea-agents装进全局前缀,rea命令进入 shell 的 PATH。
rea --help执行后打印完整的命令清单,能跑通就说明版本已落地。
⚠️ 高频坑:
npm install rea-agents不带--global时,可执行文件只落在当前项目的node_modules/.bin里,你的 shell 根本找不到rea。
轻量替代:不装全局也能跑单条分析
比如只想看一个 JS 应用的静态分析结果:
npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json执行后 npx 临时拉取rea-agents最新版,直接把模块、导入和 Electron 边界的完整 Evidence 记录以 JSON 打到终端。命令结束即退出,不改动你的系统;静态 JavaScript 分析不依赖任何原生分析引擎。
分支路径要点:curl 一行流(macOS / Linux)
项目自带 install.sh 安装脚本,本质是帮你把全局 npm 包装好再引导配置:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash执行后它会先打印一份安装计划——版本号、Node 运行时、实际执行的 npm 命令、rea的落地路径、装完是否自动进 setup——确认后才动手;当前有可用终端时会自动进入rea setup引导,否则提示你稍后手动跑。
常用参数(用bash -s --追加):
- 🔒
--version <semver>:锁定精确版本,适合回滚或团队版本对齐; - 👀
--dry-run:只打印计划、零修改,装前先摸底; - ⏭️
--no-setup/--no-prompt:装完不进 setup、跳过交互,CI 无头环境用; - 📜
--verbose:打印详细执行日志,排安装故障用。
落点有平台差异:Linux 固定~/.local/bin/rea,macOS 跟随 npm 全局前缀。
💡 前置校验:
--no-prompt和非交互模式都不会授权安装任何外部依赖,Hopper 这类可选组件仍需在 setup 里显式批准。
接入与验证:setup 让智能体用上 rea
装好 CLI 只是第一步,接入智能体需要一次引导式配置:
npx rea-agents setup- 多选智能体:勾选要接入的客户端(Claude Code、Codex、Cursor、Gemini CLI 等 25 种),已注册的默认选中,新检测到的保持未选;
- 审阅精确计划:改哪些配置路径、装哪些外部软件、走哪些网络来源,全部列出来;你批准后才写文件,原配置自动备份,Hopper 是独立可选项,需单独明确批准;
- 重启智能体:按完成提示重启被改动的客户端即可开工。
怎么判断已经生效
- 🩺 先跑
rea doctor --json:严格只读体检,逐项列出智能体注册、skill 和分析引擎的健康状态; - 🎯 再到智能体会话里下任务,例如"分析某个 App 某功能的实现,给我证据"——它能调用 REA 工具并返回带证据的结论,说明链路已通。
💡 注册会固定在实际执行 setup 的那个 REA 版本,回滚版本后建议重跑一次 setup 对齐注册。升级用
rea update;卸载用rea uninstall,加--purge-data会把~/.rea下的缓存状态一起清掉。
排障速查:4 个高频症状对症处理
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 🚫 安装时报 Node.js 版本不支持 | 当前 Node 是 23 / 25 / 过低的 22.x 等 | node -v确认,用 nvm / fnm 切到 22.23.4 / 24.22.1 / 26.12.1 的最低版本以上重跑 |
🔍 curl 装完提示rea: command not found | Linux 的~/.local/bin不在 PATH | 把该目录加进 shell 启动配置,重开终端 |
| 🤖 智能体里看不到 REA 工具 | 客户端没重启,或注册缺失 | 先rea doctor --json体检,按失败项建议修复,再重启或重连客户端 |
| 📉 回滚版本后行为不一致 | MCP 注册仍指向旧版本 | 重跑一次 setup 对齐注册,再重启智能体 |
接下来做什么
- 装好
rea命令,并用rea --help或rea doctor --json确认它能跑; - 跑一次 setup,审阅并批准计划,重启你的智能体;
- 在会话里下第一个逆向分析任务,核对结论里的证据与局限说明。
更多细节见 安装与 setup 文档 和 CLI 与 Evidence 参考。
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考