REA 安装与上手指南：1 条命令，从零到一给你的 AI 助手装好逆向工程工作流

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

手里只有一个没有源码的成品——某个 App 的 .asar 包、一个原生可执行文件、一份 APK——想弄清里面某个功能到底怎么实现的？REA（Reverse Engineer Anything）把 Claude Code、Codex、Cursor 这类 AI 编码助手接到一套完整的逆向工程工具链上：反编译、追踪交叉引用、给出带证据的行为结论，全程由助手自己选工具往下追。本文带你走完从第一条命令到装完验证的完整流程。

能力定位与边界：REA 能分析什么

一句话：REA 解决"目标是发布产物、一行源码都拿不到"的分析问题。装上之后，助手相当于随身带了一本逆向调查手册，按目标类型自己路由：

• 原生二进制（可执行文件、动态库、固件镜像）：经open_binary打开目标，连接 Hopper、Ghidra、IDA 等分析引擎反编译、追调用；
• ASAR 包 / Electron / JavaScript 应用：走analyze_javascript_application，直接产出模块图、Electron 边界与行为证据，不需要任何原生分析引擎；
• Android APK：走inspect_android_package检查包结构，再下钻到 smali 与资源；
• .NET 程序集、网站等：同样在覆盖范围内，详见 CLI 与 Evidence 指南。

适用边界要先说清：如果你的目标是完整源码仓库，用普通仓库工具就够，不要启动逆向流程。REA 面向的是"只有发布产物"的场景，不是帮你读现成代码库。

按现状选命令：一张表决定你先跑哪条

动手前只有一个前置检查：node -v确认 Node.js 在 22.x（≥22.23.4）、24.x（≥24.22.1）或 26.12.1+ 之内，23、25 版本和预发布版不在支持范围。REA 只使用你已有的运行时，不会顺手升级 Node.js、npm 或 Homebrew。

rea命令来自全局安装（npm install --global rea-agents）；如果只跑过 npx，把表中命令换成npx rea-agents前缀即可。

REA 完整安装：npx rea-agents setup 的 4 个关键节点

npx rea-agents setup

这条命令是引导式的，全程可审、可取消，按 4 个节点走：

1. 选择要接入的客户端。列表里勾选你的助手，如 Claude Code（claude_code）、Codex、Cursor、Gemini CLI、Windsurf、OpenCode、VS Code 等，完整 client ID 对照见安装文档。它只改你勾选客户端的配置，未勾选的保持原样。
2. 审阅变更计划。REA 会逐项列出要改的配置路径、备份位置、技能落盘目录，以及是否提议安装 Hopper。你批准后才真正写文件：写入走备份加原子发布，保留原有配置里的无关条目和注释；任何一步拒绝或按 Ctrl-C，都不产生变更。
3. 可选组件：分析引擎。要分析原生二进制才需要 Hopper、Ghidra 或 IDA。setup 可以代装 Hopper，但必须经过它单独一步的明确批准；已有 Ghidra 也可以只登记已验证的路径。不需要就跳过，不会装任何额外软件。
4. 重启客户端生效。完成后你会看到"哪些客户端、哪些分析工具、哪些工作流文件通过了最终检查"的汇总。按提示重启对应助手，注册即刻生效。

装完后的第一步验证：确认工具真的进入了会话

doctor 通过、客户端重启之后，先做最轻验证：直接在会话里对助手说"你有哪些 REA 工具"。能看到open_binary、analyze_javascript_application这类工具名，才说明当前会话确实接上了——doctor 检查的是文件和前置条件，证明不了会话连接，这一步省不掉。

然后抛出第一个真实问题，例如：

解释目标 App 的搜索功能是怎么实现的，展示证据，然后在我的项目里实现类似功能。

助手会按路由规则自己选工具往下追，你不需要记任何命令。

如果 MCP 没连上，或客户端暂不支持，还有一条不依赖任何分析引擎的 CLI 回退：

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

它在终端直接输出静态 JavaScript 分析的 Evidence 记录、模块图和局限说明。这只是回退通道，不代表 MCP 已经配好，跑通它之后仍要回头完成主流程验证。

REA 日常维护：更新、卸载与排障顺序

维护只有两条命令：

rea update rea uninstall

• rea update：只更新当前 CLI 所属的那个安装（npm 或 Bun 全局），建议隔三差五跑一次；
• rea uninstall：只移除 REA 自己写入的注册项和技能文件，不碰你本地的 Hopper、Node.js、npm 与其他 MCP 服务器；加--purge-data会连 REA 的缓存与状态路径一起清掉。

真卡住时，先别想着重装，按这个顺序找答案：

1. 再跑一次rea doctor --json（全量）或rea doctor --client <id> --json（单客户端），从结构化报告里定位断在哪一环——是缺引擎、注册过期，还是会话没重连；
2. 只查某个引擎时用rea doctor --provider ghidra --json，参数可换成hopper、ida、kuna；
3. 需要修配置时，先跑只读计划rea setup --client codex --dry-run --json，看清它提议改哪些路径再批准；
4. 更细的手动注册与故障排查见安装文档，MCP 契约与工具行为见 MCP contracts，中文语境可对照中文 README。

装完这一套，你的 AI 编码助手就多了一项硬能力：沿着证据链读懂二进制、追调用、重建行为，从搞懂一个功能到把它搬进自己的项目，全程在本地完成。各客户端的具体注册方式与差异，随时可以回查安装文档。

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