智能体逆向工程 morluto/rea

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Türkçe · Русский · Tiếng Việt · ไทย · Deutsch · Español · Français · Українська · Polski · Português (Brasil) · العربية · فارسی · Bahasa Indonesia · Italiano
· Ελληνικά · മലയാളം · Roman Urdu · Română

REA: Reverse Engineer Anything

一个 MCP，搞定二进制、应用与运行时行为的逆向工程。

看到喜欢的功能，就把它弄明白，一路挖到二进制层。

skills.sh

官网 · 指南 · 案例展示

快速开始 · REA 怎么工作 · 能分析什么 · 案例展示 · 构建 RL 环境 · 常见问题 · 文档

npx rea-agents setup

[!IMPORTANT]
请从 morluto/rea、 rea.tools 或 rea-agents npm 包 获取 REA。
安装与发布链接只认这几个官方来源。仓库名相似、README 被照抄，都不能说明下载来源是官方的。

加入逆向工程社区

Discord · 问答 · 作品展示

在某个应用里看到想要的功能，想搬进自己的产品？让智能体用 REA 去调查它。没有源码也能检查应用，讲清功能怎么运作，给出证据，再为你的项目做一个版本。

REA 把智能体接到一组工具上，用来检查原生二进制文件、JavaScript 与 Electron 应用、.NET 程序集和网站。这些工具在终端里同样能用。分析在本地运行，每条结论都附带证据和局限说明。

安装会把 REA 注册到你的智能体，并装上配套的工作流说明。原生分析可以复用已有的 Hopper、Ghidra、IDA 或 Kuna 安装；安装过程经你批准后，也可以选择装上 Hopper。静态 JavaScript 分析不需要原生分析引擎。

访问 REA 网站，查看安装说明、图文指南和真实案例。

快速开始

在 Linux 上，Ghidra、JADX、固件工具启动以及静态 JavaScript/Electron 分析，都要求 REA 的 PATH 里有一个兼容 procps 的 ps，用于进程归属检查。恢复步骤见 docs/installation.md 的「Linux owned-process prerequisite」一节。

配置你的智能体

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

npx rea-agents setup

选择你的智能体，检查将要做的改动，然后批准。安装会添加 REA 的 MCP 服务器和配套的工作流说明，并备份现有配置。完成后重启智能体。安装会直接记录选定的运行时和 REA 入口脚本。如果通过包运行器获取，请保留它的缓存条目。请在目标项目之外的受信任目录里执行包获取。安装与恢复细节见下方安装指南。

安装支持 Claude Code、Codex、Cursor、Gemini CLI、Grok Build 和其他智能体。服务商配置、手动注册 MCP，以及 Claude Code/Codex 插件安装，见安装与配置。

MCP 默认使用紧凑的输入 schema，以减少上下文开销。需要完整的字段说明和嵌套校验细节时，在 MCP 注册里设置 REA_MCP_INPUT_SCHEMA_PROFILE=full。两种配置档都保留完整工具集和服务端标准校验。详见 MCP 契约指南的「Compact input schema profile」一节。

默认会公布完整的输出 schema。如果你的客户端限制了完整的 tools/list 帧，把 REA_MCP_OUTPUT_SCHEMA_PROFILE=compact 设上，就能限制每个对外声明的输出 schema；设成 off 则完全省略输出 schema。两种设置都保留服务端规范校验和完整结构化结果。参见 MCP 契约指南中的「Output schemas」。

让你的智能体来做

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 迭代很快，新版本里常有 bug 修复。请保持安装为最新。

用 npm install --global 或 bun add --global 安装的命令行：

rea update

rea --update 是这个已验证工作流的别名，接受相同的全局输出参数。要和其他命令控制项组合使用时，请用 rea update。

更新器命令的 stdout 和 stderr 合计最多保留 4 MiB。元数据回复超出上限时，会在命令退出后拒绝；冗长的安装过程则带着有界诊断继续。人类可读的进度输出会遵循终端背压，等提交的写入完成。

Bun 全局更新需要 Bun 1.2.17 或更高版本。Bun 版本更旧时，先手动升级 Bun，再运行 rea update。

要刷新智能体注册和技能，运行更新时打印的 setup 命令。

如果你用 npx，这样更新智能体配置：

npx rea-agents@latest setup

检查 setup 的改动，然后重启智能体。临时跑命令行命令时，用 npx rea-agents@latest 后接命令。用 Bun 的话，把 npx rea-agents@latest 换成 bunx rea-agents@latest。

REA 如何工作

你的智能体通过 MCP 调用 REA，检查目标并追踪相关代码。REA 返回发现及其证据。智能体据此追问、解释行为，或者编写并测试实现。命令行命令走的是同一套工作流。

REA 调查流程：你的智能体询问本地目标，REA 用分析工具检查并追踪，智能体再用返回的代码、引用和未知项去解释、实现和测试。

打开原尺寸图。

你能分析什么

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

| 目标 | REA 返回的内容 | 要求与指南 |
| 桌面安装 | 运行时候选、支持文件、组件标记和下一步探测 | 内置有界目录/头检查；桌面应用 |
| 原生二进制 | 伪代码、汇编、字符串、符号、调用和引用 | Hopper、Ghidra、IDA 或 Kuna；原生分析 |
| 离线 ELF 布局 | 节、段、原始符号/重定位和静态缓解候选 | 调用方在 Linux x64 上提供 pwntools；二进制诊断 |
| Go 二进制 | 内嵌编译器版本、模块、替换和构建设置 | 内置静态 ELF/PE/thin Mach-O 检查；无需安装 Go |
| GPU 代码对象 | CUDA/HIP 目标、选定的内核参数和资源、保留的 PTX 文本 | 内置静态 ELF/PE/fatbin/CUBIN/PTX 检查；GPU 代码对象 |
| 模型产物 | GGUF / safetensors 元数据、张量声明和派生总计 | 内置头检查；可选全文件哈希；模型文件 |
| IL2CPP 元数据 | Unity global-metadata.dat 程序集映像、类型和方法名称及索引范围 | 内置静态解码版本 24、27、29、31 和 39；无需 Unity |
| Godot PCK | 归档清单和提取、原始头/目录事实及选定内容标识 | 内置静态格式 2、3 和 4；无需 Godot |
| Rust 二进制文件 | 内嵌 cargo-auditable 的 crate 名称、版本、来源和依赖关系 | 内置静态 ELF/PE/thin Mach-O 检查；Rust 二进制文件 |
| PE 证书 | Authenticode WIN_CERTIFICATE 条目和 PKCS#7 签名者/X.509 身份字段 | 内置静态 PE 检查；PE 证书 |
| PE 导入 | 导入和延迟加载的 DLL 名称、序号、IAT RVA 和 pefile 导入哈希 | 内置静态 PE 检查；PE 导入 |
| ELF 注释 | PT_NOTE/SHT_NOTE 所有者、类型、GNU build-id 和 ABI-tag 字段 | 内置静态 ELF 检查；ELF 注释 |
| Apple IPS 崩溃 | .ips 元数据、线程、镜像、寄存器和已记录的崩溃类别 | 内置静态 JSON 检查；Apple IPS |
| Linux 内核模块 | .modinfo 键、__versions CRC、this_module 是否存在，以及签名尾部 | 内置静态 ELF 检查；内核模块 |
| Erlang BEAM | IFF 块、原子、导出、导入、lambda 和 Code 头 | 内置静态 BEAM 检查；Erlang BEAM |
| WASM 产物 | 校验、节、精确的导入/导出 WAT 形式和已解码的 WAT | 调用方提供 WABT 1.0.42；inspect_wasm_artifact |
| EVM 字节码 | 分发选择器、字节偏移、推断的参数和可变性 | Linux x64 上的本地原始/十六进制载体；离线 EVM 指南 |
| SQLite 数据库 | 表、列、索引、视图、触发器和选定的普通表行 | 本地数据库/WAL 快照；Node.js 24.x >=24.15 或 26+，带原生 SQLite 限制 |
| 已记录的 Linux 崩溃 | 原始注释、每个已记录线程的寄存器/信号和可选的映射候选 | 调用方在 Linux x64 上提供 pwntools；可选 GDB/pwndbg；已记录的崩溃 |
| JavaScript / Electron | 模块、导入、source map、路由、IPC 与原生插件的关系 | Node.js 和 npm；Linux 上需要兼容 procps 的 ps；应用分析 |
| 网站 | 页面结构、脚本、网络观测结果与请求的截图 | Chrome 系浏览器；浏览器分析 |
| 已保存的网络抓包 | 请求、响应、暴露的载荷与源码位置 | HAR 或 Fiddler Everywhere SAZ；Linux 上用 mitmdump 处理原生 mitmproxy；抓包指南 |
| .NET 程序集 | 元数据、CIL 指令、声明的原生依赖与构建对比 | 无（仅静态分析）；托管代码指南 |
| Android APK | Manifest 声明、类、反编译方法与方法引用 | 无头 JADX，以及 Linux/macOS/Windows x64 上的完整 JDK；Android 指南 |
| APK 签名 | v1/v2/v3/v3.1 签名者、证书指纹、密钥轮换与摘要自洽性 | 无（仅静态分析）；inspect_apk_signature |
| Android 设备 | 设备、包、进程、日志、转储、截屏，以及 APK/文件传输 | 由调用方提供 adb（模拟器或真机）；ADB 指南 |
| JEB 项目 | 引擎支撑的项目单元、产物摘要与类型/方法伪代码 | 由调用方启动的 JEB 客户端，提供 MCP 服务，用 REA_JEB_MCP_URL 选择；JEB 指南 |
| Android 资源 | 解码后的 manifest、字符串表、语言区域与版本信息 | 由调用方提供 Apktool 启动器；资源指南 |
| Flutter 应用 | Dart 快照哈希、各 ABI 的库摘要与引擎构建来源 | 无（静态解析 APK）；Flutter 指南 |
| 固件 | 区域、提取结果与原生分析交接 | Linux 上的 Binwalk / Unblob；固件指南 |
| 录制的数据包 | 选定字段、重复值、过滤器和按规则解码 | Linux：TShark 4.x + prlimit；抓包指南 |
| 数据包摘要 | 端点、DNS、TLS SNI、协议分布和 HTTP 请求 | 调用方提供的 tshark 和 capinfos（已在 Linux 验证）；pcap 指南 |
| 录制的逻辑信号 | 解码器标注、采样范围和诊断信息 | Linux：sigrok-cli 0.7.2 + prlimit；信号录制 |
| 软件包与资源 | 文件清单、摘要、plist、Apple 应用包结构和提取的资源 | 制品与 JavaScript 指南、Apple 应用 |
| 进程行为 | 终端输出、交互、退出与文件系统观察，以及运行对比 | Linux/macOS，需原生 PTY；进程捕获 |
| PyInstaller 可执行文件 | CArchive 成员、Python 版本、入口脚本和提取的字节码 | 无（仅静态）；Python 打包应用 |

静态 JavaScript 与 .NET 检查只读取提供的文件，不运行应用。运行时捕获会以你的用户权限运行或交互选定的目标；每份运行时指南都会说明其影响。

离线原生二进制检查方面，REA 还支持调用方提供的 GNU objdump 和 Rizin。服务商配置、命令行命令和 Evidence 限制见逆向工程工具指南。REA 不安装也不更新这两个服务商。

原生格式和主机支持因服务商而异。参见 Hopper 与 Ghidra 配置、 IDA 指南（含可选的 native MCP bridge）、 Kuna 反编译器指南，以及 实验性 Windows Ghidra 支持。
Ghidra 还支持 16 位 DOS 分析。
处理大型二进制文件时，用 REA_GHIDRA_STARTUP_TIMEOUT_MS 或 REA_HOPPER_STARTUP_TIMEOUT_MS 调高服务商的启动超时。
选择服务商见命令行指南。
查看版本可用性，了解最新 npm 版本之后新增的功能。

展示

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

顺着一次声音调用找到它的位置转声像辅助函数，查看指令，把不完整的伪代码改写成 C。还原结果通过 3,205 个原始 x86 用例，并完整复现全部 63 字节编译后函数。

阅读案例 ·还原仓库

Notion：追踪 Electron 剪贴板桥接

找到渲染进程的剪贴板 API，沿 preload 和 IPC 一路追到主进程，查看富剪贴板格式。

阅读案例

TH04：还原一段 DOS 弹幕环计算

查看原版 PC-98 游戏的 16 位指令，还原固定角度与瞄准角度的计算，把还原出的 C++ 与历史编译器输出做对比。

阅读案例 ·还原仓库

用 REA 构建 RL 环境

录制一次 Web 应用会话，把它的 API 变成工具，导出一个 AI 智能体能用的环境。用 AgentEnv 运行它，再为 RL 训练或评估添加任务和奖励检查。

阅读指南 ·观看视频

如果你用 REA 做过有意思的事，我们很想看看。在 issue 或 pull request 里分享你的案例，写清目标、你的问题、REA 帮上了什么忙，以及你发现了什么。

构建 RL 环境

给 AI 智能体一个本地环境，让它练习找 issue、建文件夹这类任务，不必运行原应用。可用于强化学习（RL），也可用来测试智能体完成任务的效果。

REA 把录制下来的 API 请求和响应变成智能体能调用的工具。环境使用录制数据，只有录制能确认效果时才允许改动。

在智能体里配置好 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.

改用命令行

如果你已经有文件，里面存着应用录制下来的浏览器请求和响应，就用这些命令。运行结果还需要 AgentEnv 和 Docker。

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

REA 会导出一个可运行环境，并附带一个基础测试，用来检查它能启动并响应。把它接入你的强化学习框架，用来定义任务目标、添加奖励检查，然后跑训练。

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

常见问题

哪些智能体可以用 REA？

任何支持本地 MCP 服务器的智能体都行。安装程序会配置受支持的智能体；其他客户端可以走手动注册 MCP。

我需要原生分析引擎吗？

深度原生分析要用 Hopper、Ghidra、IDA 或 Kuna，具体取决于目标和操作。
静态 JavaScript 和 .NET 检查不需要原生分析引擎。安装程序经你批准后可以装 Hopper； Ghidra、IDA 和 Kuna 使用你已有的安装。各选项及其支持的目标见服务商配置。

我需要先启动 Hopper 吗？

操作需要时，REA 会自己启动 Hopper。在 macOS 上，首次运行可能弹出对话框，让你选择演示模式或激活许可证。请在第一次命令行/MCP 操作或无人值守任务之前，在同一个用户会话里完成这个提示。需要的话，手动打开 Hopper。见 Hopper 启动与故障排查。

从 skills.sh 安装技能会做什么？

技能为你的智能体提供调查指令。用 npx rea-agents setup 注册 REA 的 MCP 服务器并安装对应的指令，然后重启智能体。见仅安装技能。

REA 返回什么代码？

原生分析返回伪代码和汇编。JavaScript/Electron 分析会还原模块及其关系。
你的智能体用这些发现来编写并测试实现；示例展示给出了完整案例。

REA 会上传我的应用吗？

REA 在本地分析目标。你的智能体会收到工具结果，而它所用的模型服务商有自己的数据政策。

遇到 bug 该怎么办？

先更新；最近的版本可能已经修好了。

对于用 npm install --global 或 bun add --global 安装的命令行：

rea update

对于通过 npx 完成的智能体安装：

npx rea-agents@latest setup

如果你在用智能体，先完成安装刷新并重启 it。重试同一任务。如果问题仍然存在，请提交 issue，附上你的 REA 版本、目标类型、复现步骤和错误输出。

文档

先从网站的实战指南入手。
需要确切的选项、前置条件和结果约定时，看这些：

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

漏洞请通过 SECURITY.md 上报。

Star 历史

🎉 400,000 GitHub stars —— 谢谢大家！

感谢每一位使用 REA、报告 bug、提功能需求、测试构建、贡献修复的人。

免责声明

负责任使用的指引见 DISCLAIMER.md。

项目对非法或未经授权使用的立场，覆盖所有 REA 版本、分发渠道和平台；每一份副本都保留其适用的许可。

REA 用于合法研究、教育、互操作性、软件保存，以及分析你拥有或获授权检查的软件。

参与贡献

我们很欢迎你为 REA 出力！提交 issue报告 bug 或提功能建议，或者发 pull request改进代码和文档。

开发环境搭建和检查见 CONTRIBUTING.md，验证通道见测试，部分分层和依赖路径见架构图。

许可

MIT

REA 编写的代码以 MIT 许可。第三方材料保留各自的许可和版权声明；依赖清单、保留的许可文本和外部工具条款见第三方声明。

你必须合法获取并获得授权才能使用商业工具，包括 IDA Pro / Hex-Rays 反编译器、Hopper 和 JEB，均须遵守各自适用的许可协议。REA 不授予任何工具许可、密钥或激活权限。试用版和演示版仍受厂商条款约束，包括对用户、功能、自动化和输出分享的限制。破解副本、盗用密钥、未经授权分享密钥，以及绕过许可限制，均未获授权。本指引不修改 MIT 许可或第三方许可。