15 KiB
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Türkçe · Русский · Tiếng Việt · ไทย · Deutsch · Español · Français · Українська · Polski · Português (Brasil) · العربية · فارسی · Bahasa Indonesia · Italiano · Ελληνικά · മലയാളം · Roman Urdu · Română · Български
REA:逆向一切
通過一個 MCP 服務,逆向分析二進位檔案、應用程式和執行階段行為。
看到喜歡的功能,弄清它的工作原理,深入到二進位層面。
快速開始 · 案例 · REA 的工作原理 · 可以分析什麼 · 建立 RL 環境 · 常見問題 · 文件
npx rea-agents setup
Important
REA 官方來源: morluto/rea, rea.tools, rea-agents (npm). 請透過這些官方來源提供的安裝與發布連結取得 REA。相似的儲存庫名稱或複製的 README 不能證明下載內容來自官方。
在應用中看到一個想加入自己產品的功能?讓 AI 代理用 REA 調查它。即使沒有原始碼,AI 代理也可以檢查應用、解釋功能的工作方式、展示證據,並為你的專案實現類似功能。
REA 將 AI 代理連接到分析工具,用於檢查原生二進位檔案、JavaScript 和 Electron 應用、.NET 程式集以及網站。你也可以在終端中使用同樣的工具。分析在本機執行,結果包含支撐各項結論的證據和相關限制。
設定流程會向 AI 代理註冊 REA,並安裝對應的工作流程指引。原生分析可以使用已有的 Hopper、Ghidra、IDA 或 Kuna;設定流程也可以在你核准後安裝 Hopper。靜態 JavaScript 分析不需要原生分析引擎。
快速開始
設定 AI 代理 (MCP)
安裝 Node.js 和 npm 後,在目標專案以外可信任的目錄中執行下列指令。
npx rea-agents setup
選擇 AI 代理,檢查計劃中的變更並核准。設定流程會添加 REA 的 MCP 服務和對應的工作流程指引,並備份已有組態。完成後重新啟動 AI 代理。
詢問 AI 代理:
弄清 Notes 應用的搜尋功能如何工作,展示證據,並為我的專案實現類似功能。
把 Notes 替換為目標應用,並描述你想瞭解的功能。
使用終端 (CLI)
檢查已解包的 JavaScript/Electron 應用目錄或 ASAR 檔案:
npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json
結果包含模組、匯入、Electron 邊界及相關證據。將路徑替換為你的目標路徑,例如 Windows 上的 "D:/apps/example"。
如果需要經常使用,可以安裝 rea 命令:
npm install --global rea-agents
rea --help
原生分析需要先設定分析提供者。原生命令、提供者選擇、快照和腳本用法見 CLI 與 Evidence 指南。
更新 REA
通過 npm install --global 或 bun add --global 安裝的 CLI 使用:
rea update
如果使用 npx,通過以下命令更新 AI 代理設定:
npx rea-agents@latest setup
案例
DX-Ball:重建聲像計算沿聲音呼叫追蹤到根據位置計算聲像的輔助函數,檢查指令,將不完整的偽程式碼轉為 C。重建結果通過了 3,205 個原始 x86 測試用例,並復現了編譯後函數的全部 63 個位元組。 |
Notion:追蹤 Electron 剪貼簿橋找到渲染處理程序的剪貼簿 API,沿 preload 和 IPC 追蹤到主處理程序,並檢查富格式剪貼簿資料。 |
TH04:恢復 DOS 環形子彈的計算檢查原始 PC-98 遊戲的 16 位指令,恢復固定角度和瞄準角度的計算,並將重建的 C++ 與當年的編譯器輸出進行對比。 |
如果你用 REA 分析了有趣的目標,我們很想瞭解。歡迎通過 issue 或 pull request 分享案例,說明目標、你的問題、REA 如何提供幫助,以及你的發現。
REA 的工作原理
AI 代理通過 MCP 呼叫 REA,檢查目標並追蹤相關程式碼。REA 返回發現及對應證據。AI 代理據此提出後續問題、解釋行為,或編寫並測試實現。CLI 命令使用同樣的工作流程。
可以分析什麼
原生二進位檔案 · JavaScript / Electron · 網站 · .NET 程式集 · Android APK · 韌體 · 處理程序行為
建立 RL 環境
從錄製的網頁工作階段或 Linux 桌面應用程式建立本機環境,讓代理練習任務並檢查結果。
常見問題
哪些 AI 代理可以使用 REA?
任何支援本地 MCP 服務的 AI 代理都可以使用。設定流程會設定受支援的 AI 代理;其他客戶端可通過手動註冊 MCP 使用。
需要 Hopper、Ghidra、IDA 或 Kuna 嗎?
深入的原生分析需要其中一個引擎。靜態 JavaScript 和 .NET 檢查不需要原生分析引擎。設定流程可以在你核准後安裝 Hopper;Ghidra、IDA 和 Kuna 則使用已有安裝。見提供者設定。
需要先啟動 Hopper 嗎?
REA 會在操作需要時啟動 Hopper。在 macOS 上,首次執行時可能會出現對話框,讓你選擇演示模式或啟用授權。見 Hopper 啟動與故障排查。
從 skills.sh 安裝 skill 有什麼作用?
skill 為 AI 代理提供調查指引。使用 npx rea-agents setup 註冊 REA 的 MCP 服務並安裝對應的指引,然後重新啟動 AI 代理。見僅安裝 skill。
REA 返回什麼程式碼?
原生分析返回偽程式碼和組合語言。JavaScript/Electron 分析恢復模組及其關係。AI 代理利用這些發現編寫並測試實現;案例提供了完整示例。
REA 會上傳我的應用嗎?
REA 在本機分析目標。AI 代理會接收工具結果,其模型提供商有自己的資料政策。
遇到錯誤時該怎麼辦?
先更新;最近的版本可能已經修復了問題。
通過 npm 安裝的 CLI 使用:
rea update
通過 npx 設定 AI 代理時使用:
npx rea-agents@latest setup
如果正在使用 AI 代理,請完成設定更新並重新啟動 AI 代理。重試同一任務。如果問題仍然存在,請提交 issue,附上 REA 版本、目標類型、復現步驟和錯誤輸出。
文件
可以先閱讀網站上的實操指南。具體選項、前提條件和結果契約見:
- 安裝與設定:AI 代理註冊、提供者組態、更新和卸載。
- 就緒檢查與故障排查:診斷特定 AI 代理或分析引擎。
- CLI 與 Evidence:命令、提供者選擇、快照、匯入/匯出和退出狀態。
- MCP 契約和AI 代理提示詞:工具結果、會話和引導式調查。
- 工具目錄:建置時生成的工具、提供者和 CLI 命令清單。
請按照 SECURITY.md 報告漏洞。
社群與支援
- Discord — 歡迎提問、分享你的研究,加入由五萬多名逆向工程愛好者與開發者組成的社群!
- Twitter / X — 追蹤 @reatools 掌握更新與公告。
- 意見與建議 — 想要新功能或支援某種檔案格式?歡迎在 GitHub 或 Discord 告訴我們。
Star 歷史
🎉 GitHub Star 達到 400,000 個,感謝大家!
感謝每一位使用 REA、報告錯誤、提出功能需求、測試建置和貢獻修復的朋友。
參與貢獻
歡迎幫助改進 REA!你可以提交 issue 報告錯誤或建議功能,也可以提交 pull request 改進程式碼或文件。
開發設定和檢查見 CONTRIBUTING.md,驗證流程見測試指南。
免責聲明
負責任使用的相關指引請見 DISCLAIMER.md。
REA 用於合法的研究、教育、互通性、軟體保存,以及分析你擁有或獲准檢查的軟體。
本專案對非法或未經授權使用的立場涵蓋所有 REA 版本、分發管道和執行平台; 每份副本仍適用其隨附的授權。
授權條款
REA 自行編寫的程式碼採用 MIT 授權;第三方內容保留各自的授權和著作權聲明。 依賴清單、授權原文及外部工具條款見第三方聲明。
使用者須自行合法取得商用工具及所需使用權,包括 IDA Pro / Hex-Rays 反編譯器、 Hopper 和 JEB,並遵守各自授權。REA 不提供工具授權、金鑰或啟用權利;試用版和 展示版也須遵守廠商對使用者、功能、自動化及輸出分享的限制。不得使用破解副本、 竊取或違規共用金鑰,也不得繞過授權限制。本指引不變更 MIT 或第三方授權。
