REA 十分钟安装全指南：rea 逆向分析命令与 AI 智能体接入如何一次配好

REA 十分钟安装全指南：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）是一个本地逆向分析工具：装好后你的终端会多出一条rea命令，能拆解 JavaScript 与 Electron 应用行为、深挖原生二进制，并把整套分析能力通过 MCP 接给 AI 编码智能体。本文带你把选路、安装、接入智能体、验证体检和排障全部走一遍。

🧭 选装路先看这张表：按环境对号入座

结论先行：三条路线——macOS / 64 位 Linux 选手，Windows 用户只有一条，一次性任务可以不装。

✅ 动手前备齐两样：Node 版本区间与 Linux 的 ps 依赖

结论先行：只查 Node.js 版本这一项硬门槛；Linux 用户另需确认 procps 就位。

动手前跑一条命令确认版本：

node -v

受支持的区间是 22.x（≥22.23.4）、24.x（≥24.22.1）和 26.12.1 及以上；23、25 大版本以及任何预发布版都不在列，两条安装路线遇到不支持的版本都会直接报版本错误，安装器不会顺手替你升级 Node.js 或 npm。

大白话注解：这像游戏机和卡带——REA 只认 22、24、26 三个"卡带版本"。版本不在名单里，它开机就拒绝启动并告诉你该换哪张卡，而不是装上玩一半才罢工。

另外两项前置：

• 系统需为 macOS，或带 apt / dnf / pacman 软件包家族的 64 位 Linux 发行版；
• ⚠️ Linux 上会拉起子进程的工作流（Ghidra、JADX、固件工具、静态 JavaScript / Electron 分析）要求 PATH 上有 procps 兼容的ps，先装发行版的procps或procps-ng包，否则这些工作流会在启动前被拒绝。

🛠 安装怎么做：三条路线任选其一

路线 A：npm 全局安装，Windows 用户的唯一通道

结论先行：Windows 上只有这一条路；其他平台习惯 npm 工作流的也可以用它。

npm install --global rea-agents

装完在任意目录敲rea都能用。⚠️ 高频坑：漏掉--global时，可执行文件只会进当前项目的node_modules/.bin，shell 的 PATH 里看不到rea——表象是"没装成功"，其实是装错了地方。带--global重装即可。

路线 B：macOS 与 64 位 Linux 的一键脚本

结论先行：脚本不省步骤，只是把"查版本 → 打印计划 → 全局 npm 安装"自动化。

先浅克隆仓库，再运行仓库根目录的install.sh：

git clone --depth 1 https://gitcode.com/GitHub_Trending/rea2/rea bash rea/install.sh

脚本会先打印安装计划（版本号、Node 运行时、npm 命令、二进制落点、是否启动 setup），确认无误才执行安装；装完终端可用时自动进入 setup 引导，不可用时留下一句提示让你稍后手动执行。常用参数：

⚠️ 落点提醒：Linux 上rea固定在~/.local/bin/rea（prefix 为~/.local）；macOS 跟随 npm 全局前缀。装完找不到命令，去下文排障区第 1 条。

路线 C：npx 按需拉起，先不装

结论先行：一次性命令和 CI 用这条，不占全局环境，直接执行最新版。

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

⚠️ 授权误区：npm 弹窗问"是否下载并运行"时，你的确认只覆盖下载这个包。后面rea setup要改智能体配置、要装 Hopper 时，会另起一份计划、另行请求批准——两次授权互不代替。

🤖 让智能体用上 REA：rea setup 的四步引导

结论先行：装完你手里只有 CLI；要让智能体真正调到 REA，必须再跑一遍 setup。

npx rea-agents setup

整个过程四步：

1. 多选智能体：Claude Code、Codex、Cursor、Gemini CLI 等十余种可选；已有 REA 注册默认选中，新检测到的客户端保持未选中状态——检测只是提供上下文，不构成自动添加的授权；
2. 审阅变更计划：每个配置路径、涉及的外部软件与网络来源逐条列出，你批准后才写文件，旧配置自动备份；
3. Hopper 独立选项：它不会默认搭车，setup 里单独点头才安装；已有 Ghidra 的话也可以只记录验证过的安装路径。Hopper 是独立商业软件、有独立许可证，免费演示版带厂商限定的限制，付费许可证可选；
4. 重启你配置过的那些智能体：完成后消息里点名的智能体都要重启才生效。

大白话注解：计划审阅像装修开工前的送货单——改哪些文件、装哪些软件、走哪些网络来源全列出来，你签字前旧文件已经备份好，出问题能原样退回。

这一步实际改动的配置（全部在第 2 步预览，全部先备份）：

• 每个被选智能体的配置文件——写入一条 REA 的 MCP 注册；
• 各所选智能体对应 skill 目录——写入内置 workflow 指令文件；
• 可选：安装 Hopper，或记录你现有 Ghidra 安装的路径。

脚本化场景可以跳过交互：--client <id>可重复使用来精确指定智能体，--dry-run返回只读计划，--skill=false可跳过 workflow 文件。⚠️ 版本绑定：MCP 注册会锁定在真正执行 setup 的那个 REA 版本上，回滚版本后建议把 setup 再跑一遍。

如果只想给智能体一份"怎么用"的说明、不装分析引擎，还有条更轻的 skill-only 路线：

npx skills add morluto/rea --skill reverse-engineer-anything

它只安装智能体指令与配套参考资料，不含 MCP 注册和分析引擎。

🩺 装完怎么验收：两条体检命令确认就绪

结论先行：看到版本号即安装成功；rea doctor --json严格只读，适合把 CLI、智能体注册、分析引擎一次查完。

先确认 CLI 本体：

rea --version

再做全面体检。rea doctor --json不碰任何文件，无参数时审计所有检测到的注册、已装 skill 和可选分析引擎：

rea doctor --json

只想查一块时用范围参数，报告里的scope_checks决定健康结论：

某项检查失败时，按报告给出的修复建议处理，修完重跑同一条范围命令即可。

⚠️ 出问题了？对着这份症状清单排查

统一按"症状 → 原因 → 解决"排列：

1. 症状：提示rea: command not found。原因：Linux 落点~/.local/bin不在 PATH。解决：在~/.bashrc或~/.zshrc追加export PATH="$HOME/.local/bin:$PATH"，重开终端。
2. 症状：安装时报 "Node.js … is unsupported"。原因：版本不在支持区间。解决：node -v对号，切到 22.x（≥22.23.4）、24.x（≥24.22.1）或 26.12.1+ 再装。
3. 症状：跑过npm install rea-agents，却找不到rea。原因：漏了--global，可执行文件只进了项目的node_modules/.bin。解决：带--global重装。
4. 症状：批过 npm 的确认，setup 还在继续请求批准。原因：npm 的下载授权与 REA setup 的计划授权是两码事。解决：每份计划逐条审阅、逐条批准；任何一步按 Ctrl-C 取消都不会产生改动。
5. 症状：npx 方式运行报ERR_MODULE_NOT_FOUND。原因：对应 npx 缓存条目缺文件。解决：用npm cache npx rm REA_CACHE_KEY删掉那一个条目（key 取自报错里的_npx路径），再重跑指定版本的命令即可，不必清空全部 npm 缓存。

🔁 日常维护：升级、回滚与干净卸载

• 升级：rea update只更新拥有当前 CLI 的 npm 全局安装位置，装完会校验新版本号才报成功，也不会重开引导；源码检出和 npx 副本各自归其机制管，直接用npx -y rea-agents@latest拉起新版。
• 锁版本 / 回滚：npm 用rea-agents@<版本号>，脚本路线用--version <版本号>；当前发布版可用npm view rea-agents dist-tags.latest查证。回滚后把 setup 再跑一遍。
• 卸载：rea uninstall只移除 REA 自己的智能体注册与 skill 文件，保留 Hopper、Node.js、Evidence 文件、抓包产物和其他 MCP 服务器；加--purge-data连 REA 的缓存与状态一起清掉。

rea update rea uninstall --purge-data

📌 速查卡：全文要点带走

• Windows →npm install --global rea-agents（唯一通道）；macOS / 64 位 Linux → 浅克隆后bash install.sh；
• 一次命令或 CI →npx -y rea-agents@latest，无头环境配--no-prompt；
• 动手前 →node -v落在 22.x（≥22.23.4）/ 24.x（≥24.22.1）/ 26.12.1+，Linux 再确认 procps；
• 装完 →rea --version验本体，rea doctor --json查环境；
• 想让智能体用 →npx rea-agents setup，审阅计划、批准、重启智能体；
• 不对劲 → 先查 PATH（Linux 落点~/.local/bin），再查 Node 版本；
• 深入 → 安装全貌 docs/installation.md、命令手册 docs/cli.md、核心源码 src/、CLI 入口 scripts/rea.mjs。

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