逆向工程助手 Prompt-Motion/ReaReverse

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

REA: Reverse Engineer Anything

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

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

skills.sh

官网 · 指南 · 案例展示

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

npx rea-agents setup

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

Join the Reverse Engineering Community

Discord · Q&A · Show and Tell

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

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

安装会把 REA 注册到你的智能体，并装上配套的工作流说明。原生分析可以复用已有的 Hopper、Ghidra 或 IDA 安装；安装过程经你同意后，也可以顺带装上 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 服务器和配套的工作流说明，并备份现有配置。之后重启你的智能体。

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

让智能体干活

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

原生分析要先配置服务商。原生命令、服务商选择、快照和脚本化用法见命令行与证据指南。

更新 REA

REA 迭代很快，新版本里常有 bug 修复。记得保持安装是最新的。
用 npm install --global 或 bun add --global 安装的命令行工具：

rea update

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.19）、24.x（>=24.11）或 26+，以及 npm。额外的工具和宿主支持取决于目标：

| 目标 | REA 返回的内容 | 要求与指南 |
| 原生二进制文件 | 伪代码、汇编、字符串、符号、调用和引用 | Hopper、Ghidra 或 IDA；原生分析 |
| 离线 ELF 布局 | 节、段、原始符号/重定位和静态缓解候选 | 调用方在 Linux x64 上提供 pwntools；二进制诊断 |
| Go 二进制文件 | 内嵌的编译器版本、模块、替换和构建设置 | 内置静态 ELF/PE/thin Mach-O 检查；无需安装 Go |
| Rust 二进制文件 | 内嵌的 cargo-auditable crate 名称、版本、来源和依赖边 | 内置静态 ELF/PE/thin Mach-O 检查；Rust 二进制文件 |
| WASM 产物 | 校验、节区、精确的导入/导出 WAT 形式与解码后的 WAT | 调用方提供 WABT 1.0.42；inspect_wasm_artifact |
| EVM 字节码 | 分发选择器、字节偏移、推断出的参数与可变性 | Linux x64 上的本地 raw/hex 载体；离线 EVM 指南 |
| SQLite 数据库 | 表、列、索引、视图、触发器与选定的普通表行 | 本地 database/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 声明、类、反编译方法与方法引用 | Linux/macOS/Windows x64 上的无头 JADX 与完整 JDK；Android 指南 |
| Android 设备 | 设备、软件包、进程、日志、转储、屏幕截图与 APK/文件传输 | 调用方提供 adb（模拟器或真机）；ADB 指南 |
| JEB 项目 | 引擎支持的项目单元、产物摘要与类型/方法伪代码 | 调用方启动的 JEB 客户端，对外提供 MCP，用 REA_JEB_MCP_URL 选择；JEB 指南 |
| Android 资源 | 解码后的 manifest、字符串表、语言区域与版本信息 | 调用方提供 Apktool 启动器；资源指南 |
| Flutter 应用 | Dart 快照哈希、按 ABI 拆分的库摘要，以及引擎构建来源信息 | 无（静态解析 APK）；Flutter 指南 |
| 固件 | 区域、提取结果，以及原生分析的交接数据 | Linux 上的 Binwalk / Unblob；固件指南 |
| 录制的数据包 | 选定字段、重复值、过滤器，以及 decode-as 规则 | Linux：TShark 4.x + prlimit；抓包指南 |
| 数据包摘要 | 端点、DNS、TLS SNI、协议分布，以及 HTTP 请求 | 调用方提供的 tshark 和 capinfos（已在 Linux 验证）；pcap 指南 |
| 录制的逻辑信号 | 解码器标注、采样范围，以及诊断信息 | Linux：sigrok-cli 0.7.2 + prlimit；信号录制 |
| 软件包与资源 | 文件清单、摘要、plist、Apple bundle 结构，以及提取出的资源 | 制品与 JavaScript 指南、Apple 应用 |
| 进程行为 | 终端输出、交互、退出与文件系统观察结果，以及运行对比 | 带原生 PTY 的 Linux/macOS；进程捕获 |

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

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

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

展示

DX-Ball 声音声像、Notion 剪贴板桥接和 TH04 弹幕环展示的插图

DX-Ball：重建声音声像计算

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

阅读案例研究 ·重建仓库

Notion：追踪 Electron 剪贴板桥接

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

阅读案例研究

TH04：还原 DOS 弹幕环计算

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

阅读案例研究 ·重建仓库

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

FAQ

哪些智能体可以用 REA？

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

我需要 Hopper、Ghidra 或 IDA 吗？

深度原生分析要用其中之一。静态 JavaScript 和 .NET 检查不需要原生分析引擎。安装程序经你同意后可以安装 Hopper；Ghidra 和 IDA 用你现有的安装。见服务商配置。

我需要先启动 Hopper 吗？

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

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

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

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

REA 会上传我的应用吗？

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

遇到 bug 该怎么办？

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

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

rea update

对于通过 npx 设置的智能体：

npx rea-agents@latest setup

如果你在用智能体，完成 setup refresh 并重启它。重试同一个任务。如果问题依旧，提交 issue，附上你的 REA 版本、目标类型、复现步骤和错误输出。

文档

先从网站的实战指南看起。
要查确切的选项、前置条件和结果契约：

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

通过 SECURITY.md 报告漏洞。

Star 历史

🎉 200,000 GitHub stars — 谢谢你们！

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

免责声明

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

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

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

贡献

欢迎你为 REA 出一份力！发现 bug 或者想提功能建议，就开一个 issue；想改进代码或文档，就发一个 pull request。

开发环境搭建和检查项见 CONTRIBUTING.md，验证流程见测试文档，项目结构见架构图。

许可证

MIT

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

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