ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

reverse-engineer-anything 安装指南:3 条命令给 AI 编码助手装上逆向工程能力

reverse-engineer-anything 安装指南:3 条命令给 AI 编码助手装上逆向工程能力

reverse-engineer-anything 安装指南:3 条命令给 AI 编码助手装上逆向工程能力

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea

手里只有一个没有源码的发布产物——某个 App 的 .asar 包、一个原生可执行文件、一份 Android APK——想弄清它的某个功能到底怎么实现的?把 REA 的 reverse-engineer-anything 技能装进 Claude Code、Codex 这类 AI 编码助手,它就能按目标类型自己选工具、沿证据链一路追到结论。本文带你在 3 条命令内完成安装、验证和排障,装完马上能用。

先判断该不该用:适用场景与边界

适合用 REA 的情况:

  • 目标是没有一行源码的发布产物:原生二进制、ASAR / Electron / JavaScript 应用、.NET 程序集、Android APK、固件镜像
  • 需要反编译伪代码、追踪字符串与交叉引用,或对比两个版本的行为差异
  • 想让 AI 助手自己决定调哪个工具,并给出带 Evidence 出处的结论

别用 REA 的情况:

  • 目标是完整源码仓库——普通仓库工具就够,技能说明书明确要求这种场景跳过 REA
  • 只是读几个文本或配置文件,不涉及任何分析

动手前自检:一条命令确认 Node.js 💡

node -v

REA 要求 Node.js22.23.4+、24.22.1+ 或 26.12.1+;23、25 版本和预发布版都不支持。REA 只使用你已有的运行时,不会顺手升级 Node.js、npm 或 Homebrew。另外在 Linux 上,如果你打算走 Ghidra、JADX 或固件工具链,PATH 里要先有一个 procps 兼容的ps,否则这些受管进程的所有权检查会直接拒绝启动。

主路径:从零完成一次完整安装

主路径只有一条命令:

npx rea-agents setup

整个流程是引导式的,逐步可审、随时可取消:

  1. 勾选要接入的助手。多选择列表里挑你的客户端,如 Claude Code(claude_code)、Codex(codex)、Cursor(cursor)、Gemini CLI(gemini_cli)、OpenCode(opencode)、VS Code(vscode)等,完整 client ID 对照见安装文档。已有 REA 注册默认选中,新检测到的客户端默认不选——检测到不等于获得添加许可。
  2. 审变更计划。REA 会逐项列出要改的配置路径、备份位置、技能落盘目录,以及外部软件与网络来源;你确认通过才写文件。写入走备份 + 暂存 + 结果校验,中途按 Ctrl-C 或拒绝都不会留下半写状态。
  3. (可选)接分析引擎。要分析原生二进制才需要 Hopper 或 Ghidra。Hopper 是独立选项,必须等你明确批准才会安装;已有 Ghidra 则只保存已验证的路径。
  4. 重启客户端。按完成提示重启对应的助手,注册立即生效。跑完一切顺利时,终端会汇总"哪些客户端、哪些分析工具、哪些工作流文件通过了最终检查"。

如果你要同时接多个 agent 会话,更稳的做法是全局装一次:npm install --global rea-agents,再直接跑rea setup,这样每个客户端不必各自拉起一个 npm launcher 进程。

轻路径:不想从头装时的两条快捷命令

只刷新技能说明书:

npx skills add morluto/rea --skill reverse-engineer-anything

它只写入技能指令和 7 份按需加载的参考指南,不注册 MCP、不装引擎、也不会给运行中的会话添加工具。已注册好的工具可以立刻用。

只做只读体检:

rea doctor --client codex --json

把codex换成你的 client ID,输出结构化 JSON,逐项列出依赖与注册状态;rea doctor严格只读,不改任何配置。只关心技能文件时换成rea doctor --skill --json。两条轻路径的区别一句话:前者写指令,后者只看文件——而两者都证明不了"当前会话已连上",这一点留给下面的验证。

装完怎么验证:两步确认 + 一条回退命令 ✅

  1. 确认工具真的出现在会话里。直接对助手说"你有哪些 REA 工具",能看到open_binary、analyze_javascript_application这类工具名才算注册生效。doctor 检查的是文件和前置条件,证明不了当前会话已连上,这一步省不掉。
  2. 抛出第一个真实问题。例如"解释目标 App 的搜索功能是怎么实现的,展示证据"。助手会按路由规则自己选工具往下追,你不需要记任何命令。

如果 MCP 没连上、或客户端不受支持,还有一条不依赖任何逆向引擎的 CLI 回退,静态 JavaScript 分析直接走命令行:

npx -y rea-agents@latest analyze-javascript-application /绝对路径/应用目录 --json

跑完直接拿到完整 Evidence 记录,不需要 MCP 注册和原生引擎。注意它只是回退通道,不代表 MCP 已配好。

后续维护与排障顺序

日常两条,各一句话:

  • 更新:rea update,只更新当前 CLI 所属的那个 npm 或 Bun 全局安装;
  • 卸载:rea uninstall,只移除 REA 自己写入的注册项和技能文件,不碰 Hopper 和 Node.js;加--purge-data会连 REA 的缓存与状态路径一起清掉。

真卡住时按这个顺序来,别一上来就重装:

  1. rea doctor --json(全量)或rea doctor --client <id> --json(单客户端),从结构化报告里定位断点——缺 provider、注册过期,还是会话没重连;
  2. 只查单个引擎:rea doctor --provider ghidra --json,hopper、ida、kuna同理;
  3. 需要动配置时,先跑只读计划rea setup --client codex --dry-run --json,看清它提议改哪些路径再批准;
  4. 更细的手动注册与客户端差异见安装文档,MCP 行为契约见MCP contracts,中文语境可对照README 中文版。

装完这一套,你的 AI 编码助手就多了一项硬能力:沿证据链读懂二进制、追调用、重建行为,全程在本地完成。

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进