4 步装好 rea-agents:终端逆向分析工具,从试跑到接入 AI 智能体
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
本文把 rea 安装的完整路径拆成四步:零安装试跑、分平台安装、接入 AI 智能体、排障收口。rea(npm 包名 rea-agents)是一款逆向分析命令行工具,把 App 运行时行为、JavaScript/Electron 应用、原生二进制这三类目标统一放进终端里分析。你可以自己敲命令,也可以以 MCP(Model Context Protocol,一种让 AI 智能体调用外部工具的标准协议)服务器形式把它接给智能体使用。
先试再装:用 npx 完成 60 秒零安装静态分析
还没准备好环境时,可以先验证工具效果再决定要不要长期用。npx 会临时拉取包并直接执行,不会把工具留在本机:
npx -y rea-agents@latest \ analyze-javascript-application /path/to/app --json把/path/to/app换成实际的应用目录路径。这里逐字解释一下参数:-y只授权自动下载包,不会改动本机任何配置;--json让分析结果以 JSON 格式输出,方便管道处理或肉眼核对。
执行后应看到:终端打印一份 JSON 分析文档。路径不存在或目录不是 JS 应用时,会收到报错提示且没有 JSON 产出。确认效果符合预期后,再进入正式安装。
分平台安装命令:macOS、Linux、Windows 各一条
三条路线都只有一个前置动作:先确认 Node 版本。
node -v受支持的范围是 22.x(≥22.19)、24.x(≥24.11)和 26+;23、25 以及任何预发布版都不在支持之列。这个约束与项目package.json的engines字段保持一致,装前核对一遍能省掉大部分环境问题。
macOS 与 64 位 Linux:一条 curl 命令走安装脚本
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash为什么推荐脚本而不是裸跑 npm:执行前它会先打印一份安装计划,包含版本号、当前 Node 运行时、实际执行的 npm 命令,以及rea二进制最终落盘的路径。在 Linux 上这个路径是~/.local/bin/rea。确认计划无误后才会真正写入。
如果只想看计划、不落盘,追加--dry-run做一次只读预演:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -s -- --dry-run执行后应看到:同样的计划输出,末尾跟一句 "Dry run complete; no changes made.",然后退出,本机无任何改动。
正式安装跑完 npm 步骤后,脚本会自动进入rea setup流程(下一节展开)。各平台的 PATH 细节和差异,可对照 安装文档。
Windows:npm 全局安装两条命令
上面的 curl 脚本只支持 macOS 与 64 位 Linux,Windows 上请直接走标准 npm 路线:
npm install --global rea-agents rea --help执行后应看到:npm 的安装完成信息,随后是rea的帮助说明。
这里区分一下--global的作用:它把rea放进全局命令目录,之后在任意路径都能调用。如果不带--global做本地安装,可执行文件只会出现在项目的node_modules/.bin里,shell 里是敲不出rea的。
接入 AI 智能体:rea setup 配置 Claude Code、Codex、Cursor
CLI 装好只是第一步,rea setup负责把智能体打通:
rea setup执行后应看到:终端列出十余种客户端(Claude Code、Codex、Cursor、Gemini CLI 等)供你勾选。接着它展示一份精确的修改计划,你批准后才会写入配置,并自动备份原文件。Hopper 是独立选项,需要单独明确批准才会安装。全部完成后按提示重启对应智能体即可生效。
如果安装阶段因为环境不支持交互而跳过了 setup,随时手动补跑这条命令。
进阶:CI 锁版本与三条日常维护命令
CI 场景需要可复现的版本,脚本和 npm 各有锁版本的写法。脚本路线推荐组合--version与--no-prompt,全程无交互:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash -s -- --version 6.4.0 --no-promptnpm 路线则把版本直接写进包名:npm install --global rea-agents@6.4.0。想先查一下当前最新发布版:
npm view rea-agents dist-tags.latest执行后应看到:一个纯版本号,例如6.7.0,以发布时的实际值为准。
日常维护只有三条命令,各司其职:
rea doctor --json rea update rea uninstallrea doctor --json:严格只读体检,输出 JSON,可直接接入脚本做判断;rea update:升级当前安装;rea uninstall:只移除 REA 自有的注册项,不碰你自己的配置。
参数全貌见 CLI 文档。
自检与排障:四种常见报错的对应处理 🩹
遇到报错时按症状对号入座,比从头重查快得多:
| 报错症状 | 可能原因 | 处理方法 |
|---|---|---|
| 安装时报 Node.js 版本不支持 | 当前 Node 不在支持范围(22.x ≥22.19、24.x ≥24.11、26+;23、25 及预发布版不支持) | 用node -v查看版本;装过 nvm 的话执行nvm use切到受支持版本后重跑安装 |
装完提示rea: command not found | Linux 上~/.local/bin不在 PATH;macOS 上 npm 全局 bin 目录不在 PATH | Linux:把~/.local/bin加进 shell 启动配置后重开终端;macOS:检查 npm 全局前缀是否在 PATH 内 |
| 需要回滚旧版本 | 当前版本出现问题需要退回 | 用npm install --global rea-agents@旧版本号重装。注意 MCP 注册固定在当初执行 setup 的版本上,回滚后建议再跑一次rea setup对齐注册 |
| curl 脚本在 Windows 上报错 | 脚本只支持 macOS 与 64 位 Linux | 直接改用上面的 npm 路线,不要用 curl 脚本 |
装完或排障后,跑一次rea doctor --json做严格只读体检,确认状态干净,整个 rea 安装流程就算收尾了。
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考