REA

看到喜欢的功能？深入了解它的工作原理，直至二进制层面。

网站 · 指南 · 案例展示

快速开始 · REA 的工作原理 · 可分析内容 · 案例展示 · 构建 RL 环境 · 常见问题 · 文档

npx rea-agents setup

重要

请从 morluto/rea、 rea.tools 或 rea-agents npm 包获取 REA。 请通过这些官方来源中的链接访问安装与发布页面。仓库名称相似或 README 被复制，并不能证明下载内容是官方版本。

加入逆向工程社区 Discord · 问答 · 分享展示

在应用中看到想加入自己产品的功能？让你的 Agent 使用 REA 调查它。REA 可以在没有源代码的情况下检查应用，说明该功能的工作原理、展示证据，并为你的项目构建一个实现版本。

REA 可将你的 Agent 连接到用于检查原生二进制文件、JavaScript 和 Electron 应用、.NET 程序集以及网站的工具。你也可以在终端中使用同一组工具。分析在本地运行，结果会包含每项结论背后的证据和局限性。

安装会将 REA 注册到你的 Agent，并安装匹配的工作流说明。原生分析可使用现有的 Hopper、Ghidra 或 IDA 安装；也可以在获得许可后通过安装程序安装 Hopper。静态 JavaScript 分析无需原生分析引擎。

访问 REA 网站，获取安装说明、图解指南和真实案例研究。

快速开始

在 Linux 上，Ghidra、JADX、固件工具启动以及静态 JavaScript/Electron 分析需要 REA 的 PATH 中有兼容 procps 的 ps，用于检查进程所有权。 恢复步骤请参阅 docs/installation.md 中的 “Linux owned-process prerequisite”。

设置你的 Agent

安装 Node.js 和 npm 后，运行：

npx rea-agents setup

选择你的 Agent，查看建议的更改并批准。设置过程会添加 REA 的 MCP 服务和匹配的工作流说明，并备份现有配置。之后请重启你的 Agent。

设置支持 Claude Code、Codex、Cursor、Gemini CLI、Grok Build 和 其他 Agent。有关提供方配置、手动注册 MCP 服务以及安装 Claude Code/Codex 插件，请参阅 安装与设置。

默认情况下，MCP 使用精简的输入架构，以减少上下文开销。如果需要完整的字段说明和嵌套验证详情，请在 MCP 注册配置中设置 REA_MCP_INPUT_SCHEMA_PROFILE=full。两种配置都会保留完整的工具集和标准服务器验证。请参阅 MCP 合约指南中的“精简输入架构配置”。

默认情况下会公布完整的输出架构。如果你的客户端对完整的 tools/list 帧设置了上限，请将 REA_MCP_OUTPUT_SCHEMA_PROFILE=compact 设为每个公布的输出架构设置大小上限，或设为 off 以完全省略输出架构。这两种设置都会保留标准服务器端验证和完整的结构化结果。请参阅 MCP 合约指南中的“输出架构”。

向你的 Agent 提问

Understand how search works in the Notes app, show me the evidence, and build a
similar feature for my project.

将 Notes 替换为目标应用，以及你想了解的功能。

使用终端

检查已解压的 JavaScript/Electron 应用目录或 ASAR：

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

结果包含模块、导入、Electron 边界及其证据。 将路径替换为你的目标路径，例如 Windows 上的 "D:/apps/example"。

如需安装 rea 命令以便日常使用：

npm install --global rea-agents
rea --help

如需进行原生分析，请先配置提供方。有关原生命令、提供方选择、快照和脚本编写，请参阅 CLI 与证据指南。

更新 REA

REA 更新迅速，新版本会频繁修复错误。请保持安装版本为最新。

对于通过 npm install --global 或 bun add --global 安装的 CLI：

rea update

rea --update 是此验证更新流程的别名，并接受相同的全局输出标志。与其他命令控制选项结合使用时，请运行 rea update。

更新程序命令的标准输出和标准错误总量最多保留 4 MiB。命令退出后，如果元数据回复超出此限制，就会被拒绝；详细安装会继续进行，并提供有界诊断信息。人工可读的进度输出会遵循终端的背压机制，并等待已提交的写入完成。

Bun 全局更新要求使用 Bun 1.2.17 或更高版本。如果使用较旧的 Bun 版本，请先手动升级 Bun，再运行 rea update。

如需刷新 Agent 注册信息和技能，请运行更新时显示的设置命令。

如果你使用 npx，请通过以下命令更新 Agent 设置：

npx rea-agents@latest setup

查看设置更改并重启你的 Agent。对于一次性 CLI 命令，请先运行 npx rea-agents@latest，再运行相应命令。使用 Bun 时，请用 bunx rea-agents@latest 替代 npx rea-agents@latest。

REA 的工作原理

你的 Agent 通过 MCP 调用 REA 来检查目标并追踪相关代码。 REA 会返回带有证据的发现。Agent 会利用这些发现提出后续问题、解释行为，或编写并测试实现。 CLI 命令使用相同的工作流。

打开完整尺寸的图示。

可分析的内容

REA 要求使用 Node.js 22.x (>=22.23.4)、24.x (>=24.22.1) 或 26.12.1+，以及 npm。 其他工具和宿主支持取决于目标：

对于离线原生二进制检查，REA 也支持调用方提供的 GNU objdump 和 Rizin。有关提供程序设置、CLI 命令和 Evidence 的限制，请参阅逆向工程工具指南。REA 不会安装或更新这两个提供程序。

原生格式和主机支持因提供程序而异。请参阅 Hopper 和 Ghidra 设置、IDA 指南（包括可选的原生 MCP 桥接）、Kuna 反编译器指南，以及实验性的 Windows Ghidra 支持。 Ghidra 还支持 16 位 DOS 分析。 对于大型二进制文件，请使用 REA_GHIDRA_STARTUP_TIMEOUT_MS 或 REA_HOPPER_STARTUP_TIMEOUT_MS 延长提供程序的启动时限。 有关提供程序选择，请参阅 CLI 指南。 请查看发布版本可用性，了解自最新 npm 发布版本以来新增的功能。

展示案例

DX-Ball：还原声音声像计算

跟踪一次声音调用，找到其位置到声像的辅助函数，检查指令，并将不完整的伪代码转化为 C。还原结果通过了 3,205 个原始 x86 测试用例，并复现了全部 63 个已编译函数字节。

阅读案例研究 · 还原仓库

Notion：追踪 Electron 剪贴板桥接

找到渲染进程的剪贴板 API，沿着调用链经由 preload 和 IPC 追踪到主进程，并检查富文本剪贴板格式。

阅读案例研究

TH04：还原 DOS 子弹环计算

检查原版 PC-98 游戏的 16 位指令，还原固定角度和瞄准角度的计算，并将重建的 C++ 与历史编译器输出进行比较。

阅读案例研究 · 还原仓库

使用 REA 构建 RL 环境

录制 Web 应用会话，将其 API 转化为工具，并导出 AI Agent 可使用的环境。使用 AgentEnv 运行环境，然后添加任务和奖励检查，用于 RL 训练或评估。

阅读指南 · 观看视频

如果你用 REA 探索过有趣的项目，我们很乐意了解。请在 issue 或 pull request 中分享你的案例，并注明目标、你的问题、REA 如何提供帮助，以及你的发现。

构建 RL 环境

为 AI Agent 提供一个本地环境，让它练习查找问题或创建文件夹等任务，而无需运行原始应用。可将其用于强化学习（RL），或测试 Agent 完成任务的能力。

REA 会将录制的 API 请求和响应转换为 Agent 可调用的工具。环境使用录制的数据，只有在录制内容证实变更效果时才支持进行变更。

在 Agent 中配置好 REA 后，将下面示例中的 URL 和文件夹任务替换为你自己的任务：

Use REA to build an RL environment from my test web app at
http://127.0.0.1:3000.
Cover listing, creating, renaming, and deleting folders. You may create and
remove test folders. Leave existing data unchanged.
Save it in a folder named my-env. Check which operations work and tell me
how to run it.

rea environment-build ./session.har ./my-env --name my-env --json
agent-env run ./my-env

REA 会导出一个可运行的环境，并附带一个基本测试，用于检查环境能否启动并响应。使用你的 RL 框架定义任务目标、添加奖励检查并运行训练。

构建环境 · 环境参考 · 在 X 上观看演示

常见问题

rea update

npx rea-agents@latest setup

请先阅读网站上的实践指南。 有关具体选项、前置条件和结果约定，请参阅：

• 安装和设置：Agent 注册、提供方配置、更新和卸载。
• 就绪状态和故障排除：诊断单个 Agent 或分析引擎。
• CLI 和 Evidence：命令、提供方选择、快照、导入/导出和退出状态。
• MCP 约定和 Agent 提示词：工具结果、会话和引导式调查。
• 工具目录：自动生成的工具、提供方和 CLI 命令清单。
• 路线图：计划中的工作和能力跟踪。

请通过 SECURITY.md 报告漏洞。

星标历史

🎉 GitHub 星标数达 300,000——感谢大家！

感谢所有使用 REA、报告错误、提出功能需求、测试构建版本并贡献修复的朋友。

免责声明

请参阅 DISCLAIMER.md 了解负责任使用指南。

项目关于非法或未经授权使用的立场适用于所有 REA 版本、 分发渠道和平台；每个副本均保留其适用的许可证。

REA 适用于合法研究、教育、互操作性、软件保存，以及对您拥有或获准检查的软件进行分析。

贡献

欢迎为 REA 提供帮助！您可以提交问题， 报告错误或提出功能建议；也可以提交拉取请求 来改进代码或文档。

开发环境设置和检查请参阅 CONTRIBUTING.md，验证流程请参阅 测试文档，选定层级和依赖路径请参阅 架构图。

许可证

MIT

REA 编写的代码采用 MIT 许可证。第三方材料保留其自身的 许可证和版权声明；依赖项清单、保留的许可证文本和外部工具条款请参阅 第三方声明。

您必须依法取得商业工具并获得使用授权，包括 IDA Pro / Hex-Rays 反编译器、Hopper 和 JEB，并遵守其适用的 许可证。REA 不授予任何工具许可证、密钥或激活权益。试用版和 演示版仍受供应商条款约束，包括关于用户、功能、自动化和 输出共享的限制。未经授权的破解副本、盗用的密钥、未经授权的密钥 共享以及规避许可证限制均不被允许。本指南不修改 MIT 或第三方许可证。