REA：让 Agent 逆向一切

这个 Agent 能做什么，适合哪些场景？

REA 是一个面向编码 Agent 的逆向工程工具包，以 npm 包 rea-agents 发布，同时提供 rea 命令行和 MCP 服务器，两条路径共用同一套证据契约与调查流程。它把 Hopper（macOS/Linux，支持演示模式）或自备 Ghidra 12.1.4（Linux、macOS，以及实验性 Windows x64 P0）封装为受管的深度分析提供方，Agent 通过 open_binary、binary_overview、search_strings、find_xrefs_to_name、get_call_graph、procedure_pseudo_code、batch_decompile 等工具完成从识别二进制到反编译目标函数的完整链路。除原生分析外，它还覆盖 CDP 被动网页观察、Electron/Node V8 Inspector 附加观察、JavaScript 与 source-map 重建、ASAR/包结构静态映射、托管 PE/CLI 分诊、受控进程捕获与对比，并把每次成功调用记录为可导入导出的 Evidence 记录。分析全部在本地完成，REA 不提供托管分析服务，也不会上传目标应用。它明确不承诺还原原始源码，只给出伪代码、汇编、符号、字符串和关系，供 Agent 解释或兼容重建行为。

安装后 REA 探测本机 Agent（Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Windsurf、Devin），以追加且先备份的方式写入 MCP 注册并安装配套路由技能。分析时，rea analyze / rea decompile / rea function / rea xrefs / rea trace 等命令会先解析深度分析提供方（请求级 --provider 优先于 REA_ANALYSIS_PROVIDER，auto 只在唯一可用候选时绑定，多候选报 ambiguous，绝不静默回退），再启动提供方运行时，完成后把结果写成带 artifact 与 provider 身份、置信度、局限和位置的 Evidence。MCP 会话可长期保留目标与证据账本，并通过 snapshot_path 在 open_binary/close_binary 时原子导入导出分析快照。额外的只读能力包括 inspect-managed-artifact 系列的 PE/CLI 元数据与 CIL 指纹检查、list-browser-targets / inspect-web-page 的被动 CDP 抓取、list-javascript-runtime-targets / observe-javascript-runtime 的 V8 Inspector 生命周期观察，以及 capture-process / capture-browser-scenario 这类默认关闭、需按调用单独授权的受控行为捕获。

1. 产品团队在某个 App 里看到想复刻的搜索或离线缓存功能，手上没有源码，希望 Agent 先解释实现再给出适配自家技术栈的版本。
2. 安全或逆向工程师需要把一个可疑字符串、符号或 IPC 通道一路追到实现它的函数，并保留可复核的证据链。
3. 开发者拿到一个 Electron 应用，想在不运行引导代码的前提下用 rea analyze 直接还原 ASAR 内的模块、入口、preload 与 IPC 结构。
4. 需要跨版本对比同一应用的行为差异，用 rea compare 或 compare-process-captures 找出第一处终端、文件系统或协议分歧。
5. 维护遗留 .NET/CLI 程序集，希望在不加载程序集、不解析 CLR 依赖的情况下先做只读的元数据与 P/Invoke 边界分诊。
6. 分析流程要求可复现：把成功调用固化为快照或 Evidence 包，在之后不重启分析引擎的情况下重放同一查询。

如何安装或部署这个 Agent？

推荐先跑一次 setup 向导，它会先打印完整计划、路径与外部影响，最终确认默认是 No：

npx --yes rea-agents@latest setup

如果希望把 rea 命令装进 shell PATH：

npm install --global rea-agents
rea setup
rea doctor

设置向导检测到 Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Windsurf 时会配置前六个；Devon 只报告不修改。深度原生分析还需要一个提供方，Hopper 由 setup 负责安装（macOS 从官方 DMG 装到 ~/Applications，Linux 下载固定的 6.4.2 包并校验），Ghidra 必须自备：

export GHIDRA_INSTALL_DIR=/absolute/path/to/ghidra_12.1.4_PUBLIC
export JAVA_HOME=/absolute/path/to/jdk-21 # 可选，java 与 javac 已在 PATH 时可省略
rea doctor --json
rea providers --json

环境要求：macOS 12+、Ubuntu 24.04+/Fedora 41+/64 位 Arch Linux，Windows x64 仅用于实验性 Ghidra P0；Node.js 22.19+ 或 24.11+。

如何使用这个 Agent？

配置好 Agent 集成后，重启被改动的客户端，再用自然语言下单：

Reverse engineer the Notes app. Find how offline search works, explain it,
and build a version for my project using TypeScript and SQLite.

只想在终端里做一次快速概览时：

npx -y rea-agents@latest analyze /Applications/Notes.app
npx -y rea-agents@latest search /Applications/Notes.app "offline"
npx -y rea-agents@latest trace /Applications/Notes.app "offline"

手动接入任意支持本地 MCP 的客户端：

{
  "mcpServers": {
    "rea": {
      "command": "npx",
      "args": ["-y", "[email protected]", "mcp"]
    }
  }
}

需要复用已批准的分析结果时，把同一份快照交给后续调用：

rea analyze /absolute/path/to/app --snapshot /absolute/path/to/analysis/app.json

浏览器与运行时观察默认关闭，必须显式开权限并指定 loopback 端点与原点：

export REA_BROWSER_OBSERVE_ENABLED=true
export REA_BROWSER_CDP_ENDPOINTS_JSON='["http://127.0.0.1:9222"]'
export REA_BROWSER_ALLOWED_ORIGINS_JSON='["http://127.0.0.1:3000"]'
rea list-browser-targets http://127.0.0.1:9222 --approved --json

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题