rea

环境要求

• 已安装 Node.js 与 npm
• 准备一个支持 MCP 的智能体客户端（setup 中可选择）
• 可选：Hopper 反汇编器或已有的 Ghidra 安装
• Linux 演示会话需要 Xvfb、Python 3、X11 与 XTEST

安装与启动步骤

1. 1运行 REA 安装向导

   推荐方式。向导会让你选择启用 REA 的智能体，并在应用前展示具体改动与路径供确认。

   npx rea-agents setup

   复制

2. 2安装 rea 命令行

   脚本安装会把 rea 命令加入系统，在终端运行时自动进入 setup；需已装 Node.js 和 npm。

   curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash

   复制

3. 3改用 npm 全局安装

   curl 安装的替代方案：先用 npm 全局安装 rea-agents，再单独运行 setup。

   npm install --global rea-agents
   rea setup

   复制

4. 4手动配置 MCP

   不通过向导时，可在智能体的 MCP 配置中加入 rea 服务；持久注册应固定一个精确包版本。

   {
     "mcpServers": {
       "rea": {
         "command": "npx",
         "args": ["-y", "rea-agents@4.0.1", "mcp"]
       }
     }
   }

   复制

5. 5检查分析引擎

   用 doctor 检查环境是否就绪，尤其是分析引擎能否被正确识别。

   rea doctor --json

   复制

6. 6更新 REA

   两种安装方式都用同一条命令更新，它会安装精确版本并校验新的可执行文件。

   rea update

   复制

关键配置

如何确认成功

运行 rea doctor --json 不报缺少分析引擎，且所选智能体中出现名为 rea 的 MCP 服务。

常见问题

注意事项

• setup 会在应用改动前展示变更并备份现有配置，需逐项确认后再批准。
• Hopper 是独立可选的授权项，不会随智能体选择自动启用；已有 Ghidra 安装也可被记录。
• MCP 持久注册应固定一个精确包版本，rea setup 会维护该版本固定并同步更新内置技能。
• Linux 上 Hopper 默认启动器为 /opt/hopper/bin/Hopper，演示会话使用私有虚拟显示，不影响桌面。