reverse
发布时间:2026-10-12 | 浏览:1
Files Expand file tree
File metadata and controls
English · 简体中文 · 日本語 · 한국어 · العربية
一个 CLI 与 MCP 服务器,让编程智能体逆向工程任何程序
看到喜欢的功能。理解它的原理。按照你的方式实现。
快速开始 · 从二进制到行为 · 工具目录 · 工作原理 · 常见问题
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
看到某个应用中想加入自己产品的功能?即使没有源代码,也可以把应用交给编程智能体。借助 REA,智能体能够调查该功能、理解其工作原理,并按照你的技术栈、设计和需求构建适合你产品的版本。
REA 通过一个 CLI 与 MCP 服务器实现这套流程。智能体可以检查编译后的应用、追踪功能的工作方式,并把了解到的内容用于日常编码。REA 在一个接口背后处理复杂的逆向工程工具。
“备忘录”只是示例。你可以说出任何想了解的应用,也可以让智能体先从概览开始。
REA 让调查始终以二进制证据为依据。它不会声称能恢复原始源代码,也不会自动克隆整个应用。
让智能体设置 REA。它会检查你的 Mac,说明需要安装的内容,先征得同意,并引导你处理系统提示。如果智能体要求重启以加载完整工具,请在设置后重启。
Ubuntu 24.04+、Fedora 41+ 或 64 位 Arch Linux
Node.js 22.19+ 或 24.11+,以及随 Node 安装的 npm
rea setup 会先显示完整变更计划并请求确认。它不会安装或更新 Homebrew、Node.js 或 npm。缺少 Hopper 时,Setup 会提议安装官方软件包;Hopper 是需要单独许可证的独立软件。
如果你已在 64 位 Linux 上安装 Ghidra 12.1.4 PUBLIC 和完整的 64 位 JDK 21,Setup 也可以在批准后登记 GHIDRA_INSTALL_DIR 和可选的 JAVA_HOME 。REA 不会下载、安装或修改 Ghidra 或 Java。Ghidra provider 在隔离的只读 headless 会话中提供清单、反编译、汇编、调用关系、带类型的引用、xref、CFG 与函数 dossier;GUI 状态和修改操作仍不可用。
在 Ubuntu 24.04+、Fedora 41+ 和 64 位 Arch Linux 上,REA 会下载 Hopper 官方的 DEB、RPM 或 Arch 软件包,验证发布方提供的大小和校验和,然后通过 apt-get 、 dnf 或 pacman 安装依赖。非 root 运行时, pkexec 会显示系统授权提示;REA 不调用 sudo 。
默认启动器是 /opt/hopper/bin/Hopper 。自定义安装可设置 HOPPER_LAUNCHER_PATH 。如果 Doctor 报告缺少分析引擎,请运行 ldd /opt/hopper/bin/Hopper | grep 'not found' ,安装缺少的系统库后重新运行 rea setup 。REA 会在私有 Xvfb 显示器上运行受支持的 Hopper 演示版,并为每个分析会话选择 Hopper 提供的演示模式;无需桌面 DISPLAY 或付费许可证,但演示版受厂商限制。Linux 上还应确保 ~/.local/bin 位于 PATH 中。
如果 macOS 或安装程序要求确认,请完成提示,然后再次运行同一命令。
Setup 会检测 Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Windsurf 和 Devin。它会自动配置检测到的前六种客户端;由于目前没有明确的本地 MCP 配置边界,检测到 Devin 时只会报告而不会修改。重启已配置的客户端,让它加载 REA。
你可以直接说出应用名称。编程智能体会找到应用,并把 REA 所需的程序文件交给它。
REA 负责第 1–5 步中的二进制分析。第 6 步由智能体使用其常规文件编辑与测试工具完成。
在没有源代码时解释某项功能的实现方式。
重建应用的身份验证、存储、更新或网络流程。
恢复足够的结构,以记录未公开的格式或接口。
从字符串或符号追踪到实现可疑行为的代码。
在一个会话中切换两个应用版本并比较实现路径。
调查你喜欢的功能,并为自己的产品构建量身定制的版本。
将恢复的行为转换为产品功能、测试、迁移说明、移植代码或互操作替代品。
分析 Swift 和 Objective-C 元数据。
在 Hopper 中留下名称、注释与书签,使人与智能体的分析互相增强。
Setup 会检测 Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Windsurf 和 Devin,并自动配置检测到的前六种客户端;检测到 Devin 时只会报告而不会修改。任何支持本地 MCP 服务器的编程智能体都可以使用以下配置连接 REA。
CLI 与 MCP 服务器使用相同的分析引擎。终端命令完成后会关闭应用;智能体会话则会在调查期间保持应用打开。
上面的智能体工作流是使用 REA 最简单的方式。如果只想在终端中快速了解一个应用:
运行 npx -y rea-agents@latest --help 查看直接反编译和其他选项。
也可以全局安装 rea 命令:
REA 可以直接打开 Mac 的 .app 文件夹。如果智能体找不到应用,请告诉它应用安装在哪里。
REA 会在需要时启动 Hopper,无需预先运行。Hopper 启动器内部会激活应用,因此打开目标时 Hopper 可能出现在其他窗口前。REA 会请求 macOS 在后台启动 Hopper,但无法保证窗口始终位于后台。
REA 会推导明确的格式和架构参数,以避免常见的 FAT 与 ARM 选择对话框。其他 Hopper 或 macOS 对话框仍可能需要人工响应。关闭 REA 会话会终止桥并删除私有套接字目录,但不会退出用户正在使用的 Hopper 应用。
每个桥会话都使用随机能力令牌和仅限当前用户的 Unix 套接字。协议消息有大小限制,面向调用者的错误不会暴露启动器 stderr 或内部异常原因。Ghidra 会话还使用隔离的临时项目,不会打开或修改用户自己的 Ghidra 项目。
这不是沙箱,也无法防御以同一操作系统用户身份运行的恶意进程。打开不可信二进制文件会让所选本地提供商以当前用户权限进行解析和分析。请按照 SECURITY.md 中的私密流程报告漏洞。
不需要。REA 会在操作需要时启动 Hopper,也支持已经运行的 Hopper。
不包含。Setup 可以为你安装 Hopper,但 Hopper 仍是需要单独授权的软件。REA 提供 CLI、MCP 服务器和面向智能体的工作流。
REA 不提供托管分析服务,而是通过本地 Unix 套接字把操作交给 Hopper。你的智能体或模型服务商可能有自己的数据政策,请单独核查。
不能保证。REA 提供伪代码、汇编、符号、字符串、元数据和关系,智能体可据此解释或兼容地重建观察到的行为。
开发环境、架构、测试和发布说明请参阅 CONTRIBUTING.md 。