[English](README.md) · **简体中文** · [日本語](README_ja.md) · [한국어](README_ko.md) · [العربية](README_ar.md) # REA：逆向工程一切 ### 使用智能体逆向工程任何程序，从应用行为到原生二进制文件。 **看到喜欢的功能。理解它的原理。按照你的方式实现。** [![npm version](https://img.shields.io/npm/v/rea-agents?style=flat-square&color=cb3837)](https://www.npmjs.com/package/rea-agents) [![CI](https://img.shields.io/github/actions/workflow/status/morluto/rea/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/morluto/rea/actions/workflows/ci.yml) [![MCP tool catalog](https://img.shields.io/badge/MCP-tool_catalog-5c4ee5?style=flat-square)](#调查工具目录) [![Node.js 22+](https://img.shields.io/badge/Node.js-22.19%2B-339933?style=flat-square&logo=nodedotjs&logoColor=white)](https://nodejs.org/) [![MIT license](https://img.shields.io/badge/license-MIT-f4c430?style=flat-square)](LICENSE) [![Discord](https://img.shields.io/discord/1556595354999332884?logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/GkcryMnJDM) morluto%2Frea | Trendshift [快速开始](#快速开始) · [当前状态](#当前状态) · [从二进制到行为](#从二进制到行为) · [调查工具目录](#调查工具目录) · [路线图](#路线图) · [工作原理](#工作原理)
Discord
加入逆向工程社区
Discord · 问答 · 成果分享

npx rea-agents setup
REA 在 Hopper 中启动分析桥并检查原生二进制文件
--- 看到某个应用中想加入自己产品的功能？让智能体用 REA 调查它。即使没有源代码，智能体也可以检查应用、解释功能的工作方式、展示证据，并为你的项目实现类似功能。 REA 提供原生二进制、JavaScript 与 Electron 应用、.NET 程序集和网站的分析工具。你可以从智能体或终端使用它们。分析在本机运行，结果会说明证据和限制。 Setup 可以配置智能体、连接已安装的 Hopper 或 Ghidra，也可以在你批准后安装 Hopper。 ## 直接询问智能体 完成[设置](#快速开始)后，重启智能体并提出问题： ```text 解释“备忘录”应用的搜索功能，展示证据，然后为我的项目实现类似功能。 ``` 把“备忘录”替换成你想了解的应用，也可以先请求概览。 ## 从二进制到行为 | 反编译 | 理解 | 重建 | | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | 打开原生应用或可执行文件，恢复过程、伪代码、汇编、字符串、符号、段和元数据。 | 沿调用者、被调用者、交叉引用和调用图追踪，直到智能体能够解释功能或算法的实际工作方式。 | 将智能体学到的内容变成适合你的技术栈、界面和需求的产品功能。 | REA 让调查始终以二进制证据为依据。它不会声称能恢复原始源代码，也不会自动克隆整个应用。 ## 为什么选择 REA | | | | ---------------- | -------------------------------------------------------------------- | | **为智能体设计** | 直接询问应用的行为，让智能体去检查，而不是猜测。 | | **CLI 与 MCP** | 在终端或智能体中使用同一套逆向工程能力。 | | **引导式设置** | 配置智能体、连接已有分析工具，或在你批准后安装 Hopper。 | | **从洞察到代码** | 理解功能后，在同一次编程会话中构建属于你自己的版本。 | | **本地运行** | 分析在受支持的本机系统上运行；REA 不会把二进制上传到托管式分析服务。 | | **保留上下文** | 连续调查多个应用，无需为每个问题重新开始整个分析过程。 | ## 快速开始 ### 运行设置（推荐） 配置 REA 与智能体的连接： ```bash npx rea-agents setup ``` Setup 首先让你多选要连接的智能体。已有 REA 注册默认选中；仅被检测到的客户端不会自动选中，也可以手动选择尚未配置的客户端。查看具体路径和变更后再批准。所选智能体默认安装 REA 工作流；Hopper 是单独的可选操作，需要单独批准。Setup 也可以记录现有 Ghidra 的路径。 Setup 会先展示变更并备份已有配置。要求与更多选项见[安装与设置](docs/installation.md)。 ### 使用智能体 设置完成后，重启智能体并描述你想了解的应用或功能。REA 支持 Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Windsurf、Devin、OpenCode、Antigravity、GitHub Copilot CLI、Command Code 和 VS Code。已有 REA 注册默认选中；其他检测到的客户端需手动选择。其他智能体可以使用下方的 MCP 配置。 Hopper 支持演示模式。如果首次启动时出现提示，选择演示模式或输入已有许可证。 ### AI 编程助手技能（可选） 为你的 AI 编程助手添加 skill，以获得更丰富的上下文： ```bash npx skills add morluto/rea --skill reverse-engineer-anything ``` 该 skill 提供 REA 的调查工作流。先运行上文的 setup，把 REA 连接到你的智能体并配置分析工具。Setup 默认会安装版本匹配的 skill；这条命令安装的是仓库版本。 对于已解包的 JavaScript/Electron 应用目录或 ASAR，无需 MCP 配置，也无需原生引擎： ```bash npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json ``` 把路径换成你的目标（例如 Windows 上的 `"D:/apps/example"`）。这条静态流程支持此类路径。原生分析仍需要先配置对应的分析引擎。 ### 安装 rea 命令 安装命令行工具： ```bash curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash ``` 需要预先安装 Node.js 和 npm。在终端中运行时，安装程序会安装 `rea` 并启动设置。 也可以用 npm 安装，再运行设置： ```bash npm install --global rea-agents rea setup ``` ### 系统要求 - macOS 12 或更高版本 - Ubuntu 24.04+、Fedora 41+ 或 64 位 Arch Linux - Node.js 22.x (>=22.19)、24.x (>=24.11) 或 26+，以及 npm 原生二进制分析需要 Hopper 或 Ghidra。Hopper 是独立软件；演示模式有厂商规定的限制，不要求购买许可证。 Ghidra 支持 Linux x64 和 macOS x64/arm64。单独安装 Ghidra 12.1.4 和完整的 64 位 JDK 21，然后配置 REA 使用它们。macOS 还需要对应架构的原生反编译器。 Setup 可以验证安装并保存路径，不会安装或升级 Ghidra、Java、Node.js、npm 或 Homebrew。 仓库 main 分支与 npm 4.1.0 已包含实验性的 Windows x64 Ghidra P0 支持，适用于本地 NTFS 上的原生 x86-64 PE 应用（非托管、非 DLL），并附带 Job Object、私有 DACL 与路径准入控制。请先确认[发布边界](docs/installation.md#released-package-and-main)，再假定旧版 npm 包具备该能力。详见 [Windows Ghidra P0](docs/windows-ghidra-p0.md) 的前置条件与已验证范围。 ### 故障排除 运行 `npx -y rea-agents@latest doctor`，检查主机、依赖、分析工具和智能体配置。该命令不会修改文件。添加 `--json` 可获取结构化诊断。 Linux 上的默认 Hopper 启动器为 `/opt/hopper/bin/Hopper`。其他路径可通过 `HOPPER_LAUNCHER_PATH` 指定。如果文件存在但仍报告缺少分析引擎，运行 `ldd /opt/hopper/bin/Hopper | grep 'not found'` 检查缺少的系统库。安装详情见 [Hopper 指南](docs/installation.md#hopper)。 ### 更新与卸载 - `rea update` 更新当前 REA 安装。 - `rea uninstall` 移除 REA 管理的智能体配置项和工作流文件，保留 Hopper。 - `rea uninstall --purge-data` 还会删除 REA 的缓存和状态。仅在需要移除这些数据时使用。 ## 当前状态 仓库当前能力与平台要求见[英文支持指南](README.md#current-status)。main 分支可能领先于 [npm 发布版](docs/installation.md#released-package-and-main)。 - Ghidra 在 Linux x64、macOS x64/arm64 以及实验性的 Windows x64 P0 边界上提供 25 个只读操作。Linux/macOS 额外支持原子化的会话级函数注释。Windows P0 为只读；Ghidra 不提供 GUI 控制。 - 静态 Android 检查需要自备 JADX/Java，前置条件独立；真机验证覆盖 Linux。详见 [Android 分析](docs/android-analysis.md)。 - 浏览器、Electron 与进程请求需直接声明目标、动作与生命周期，并依赖宿主的实际访问权限，无需 REA 另行授权。Setup 的配置写入与 Hopper 安装仍需逐项批准确切计划。 - `rea capabilities` 描述的是二进制会话操作，而非全部应用/运行时工具。请以已连接 MCP 工具列表与相关指南为准。 ## 一个提示词，完成一次完整调查 ```text 逆向工程“备忘录”应用，找到离线搜索功能的工作方式，解释其控制流， 并使用 TypeScript 和 SQLite 为我的项目构建一个版本。 ``` | 步骤 | 智能体的操作 | REA 工具 | | ---: | ---------------------- | ---------------------------------------------------------------- | | 1 | 打开并识别二进制文件 | `open_binary`, `binary_overview` | | 2 | 搜索可能的离线搜索线索 | `search_strings`, `search_procedures`, `list_names` | | 3 | 将线索连接到可执行代码 | `find_xrefs_to_name`, `xrefs`, `procedure_callers` | | 4 | 重建相关控制流 | `get_call_graph`, `procedure_callees`, `procedure_info` | | 5 | 反编译相关程序 | `procedure_pseudo_code`, `procedure_assembly`, `batch_decompile` | | 6 | 在你的项目中构建该功能 | 适合你的技术栈、产品和需求的代码 | REA 负责第 1–5 步中的二进制分析。第 6 步由智能体使用其常规文件编辑与测试工具完成。 ## 智能体可以完成什么 - 在没有源代码时解释某项功能的实现方式。 - 重建应用的身份验证、存储、更新或网络流程。 - 恢复足够的结构，以记录未公开的格式或接口。 - 从字符串或符号追踪到实现可疑行为的代码。 - 在一个会话中切换两个应用版本并比较实现路径。 - 调查你喜欢的功能，并为自己的产品构建量身定制的版本。 - 将恢复的行为转换为产品功能、测试、迁移说明、移植代码或互操作替代品。 - 分析 Swift 和 Objective-C 元数据。 - 在 Hopper 中留下名称、注释与书签，使人与智能体的分析互相增强。 ## 调查工具目录 | 工具类别 | 数量 | 用途 | | ----------------- | ---: | ------------------------------------------------------------------------------------------------------ | | 原生检查 | 41 | 函数、伪代码、汇编、字符串、符号、调用、引用、注释、字节读取与文件偏移 | | 调查工作流 | 14 | 应用概览、函数档案、原生 API 与分发、批量反编译、功能追踪、调用路径与调用图、Swift 与 Objective-C 发现 | | macOS 原生工具 | 7 | Mach-O 元数据、代码签名、plist、架构与 Swift 符号还原，无需启动 Hopper | | 产物图 | 5 | 目录与软件包清单、编译后的 Interface Builder 文件、Apple 资源目录与提取 | | 托管 PE/CLI | 7 | .NET 程序集身份、元数据、CIL 指令、原生依赖声明、重建导入与构建比较 | | 固件 | 2 | Linux 固件区域检查与显式提取 | | Android APK | 5 | 包与 manifest 声明、类搜索、成员清单、方法反编译与静态引用 | | 浏览器观察 | 9 | 页面结构、网络元数据、脚本、来源映射、WebMCP 发现、截图与捕获比较 | | Electron 分析 | 5 | 渲染进程观察、静态应用映射、静态/运行时结果关联 | | JavaScript 运行时 | 2 | Node/Electron Inspector 目标发现、脚本位置与执行上下文事件 | | 应用工作流 | 8 | 捕获的网站脚本导出、跨层功能追踪、构建比较、历史源码映射、静态返回结构比较与重建验证 | | 工作区与观察 | 21 | 会话、证据包、导航上下文、进程/产物/函数比较与待解决问题跟踪 | ## 路线图 接下来的工作包括更多原生目标验证、JavaScript 与 .NET 跨版本比较，以及运行时观察和重建验证。当前设置已支持选择智能体集成和 Hopper 安装；安装其他分析工具仍是后续工作。详见[安装路线图](docs/roadmap.md)和[分析工具评估](docs/provider-evaluation.md)。 ## 与其他编程智能体一起使用 Setup 支持 Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Windsurf、Devin、OpenCode、Antigravity、GitHub Copilot CLI、Command Code 和 VS Code。已有 REA 注册默认选中；其他检测到的客户端需手动选择。任何支持本地 MCP 服务器的智能体都可以使用以下配置连接 REA。 ```json { "mcpServers": { "rea": { "command": "npx", "args": ["-y", "rea-agents@4.1.0", "mcp"] } } } ``` ## 工作原理 ```mermaid flowchart LR Agent["编程智能体"] --> REA["REA
CLI + MCP"] Terminal["终端"] --> REA REA --> Hopper["Hopper 分析操作"] Hopper --> App["你的应用"] REA --> Ghidra["Ghidra 只读分析
清单 + 函数分析"] Ghidra --> App ``` CLI 与 MCP 服务器使用相同的分析流程。终端命令完成后释放自己创建的桥接会话；智能体会话可以在调查期间保持连接。关闭 REA 会话不会退出用户正在使用的 Hopper 应用。 ## CLI 上面的智能体工作流是使用 REA 最简单的方式。如果只想在终端中快速了解一个应用： ```bash npx -y rea-agents@latest analyze /Applications/Notes.app ``` 运行 `npx -y rea-agents@latest --help` 查看直接反编译和其他选项。 也可以全局安装 `rea` 命令： ```bash npm install --global rea-agents rea --help rea mcp ``` REA 可以直接打开 Mac 的 `.app` 文件夹。如果智能体找不到应用，请告诉它应用安装在哪里。 ## Hopper 应用行为 REA 会在需要时启动 Hopper，无需预先运行。Hopper 启动器内部会激活应用，因此打开目标时 Hopper 可能出现在其他窗口前。REA 会请求 macOS 在后台启动 Hopper，但无法保证窗口始终位于后台。 REA 会推导明确的格式和架构参数，以避免常见的 FAT 与 ARM 选择对话框。其他 Hopper 或 macOS 对话框仍可能需要人工响应。关闭 REA 会话会终止桥并删除私有套接字目录，但不会退出用户正在使用的 Hopper 应用。 ## 安全模型 每个桥会话都使用随机能力令牌和仅限当前用户的 Unix 套接字。诊断保留本机路径、摘要和错误位置等排查信息，同时移除凭据和认证令牌。Ghidra 会话还使用隔离的临时项目，不会打开或修改用户自己的 Ghidra 项目。 这不是沙箱，也无法防御以同一操作系统用户身份运行的恶意进程。打开不可信二进制文件会让所选本地提供商以当前用户权限进行解析和分析。请按照 [SECURITY.md](SECURITY.md) 中的私密流程报告漏洞。 ## 常见问题
Hopper 是否需要提前运行？ 不需要。REA 会在操作需要时启动 Hopper。Hopper 已经运行时也可以使用，但 REA 会打开新的分析文档，不会连接并复用现有 GUI 文档。
REA 是否包含 Hopper？ 不包含。Setup 可以为你安装 Hopper，但 Hopper 仍是需要单独授权的软件。REA 提供 CLI、MCP 服务器和面向智能体的工作流。
REA 会上传我的二进制文件吗？ REA 不提供托管分析服务，而是通过本地 Unix 套接字把操作交给 Hopper。你的智能体或模型服务商可能有自己的数据政策，请单独核查。
REA 能恢复原始源代码吗？ 不能保证。REA 提供伪代码、汇编、符号、字符串、元数据和关系，智能体可据此解释或兼容地重建观察到的行为。
## 开发 开发环境、架构、测试和发布说明请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。 ## 许可证 [MIT](LICENSE)