1. Przygotuj komputer
Użyj komputera, na którym znajdują się badane pliki. Lokalny agent programistyczny może je czytać i uruchamiać narzędzia za Ciebie.
Jak otworzyć terminal?
- Windows : otwórz menu Start, wpisz PowerShell i naciśnij Enter.
- macOS : prasa ⌘ Space, Typ Terminal i naciśnij Enter.
- Linux : prasa Ctrl Alt T na większości komputerów stacjonarnych.
Wklej polecenie za pomocą Ctrl V (macOS : ⌘ V; Terminale Linux: Ctrl Shift V), a następnie naciśnij Enter.
Komendy wpisuj w terminalu. Polecenia oznaczone „Twój agent programistyczny” wklejaj do czatu agenta.
Będziesz potrzebować Node.js 22 (22.19+), 24 (24.11+) lub 26+. npm pochodzi z Node.js.
Nie masz Node.js, czy nie jesteś pewien?
Otwórz terminal i sprawdź:
node -v
npm -v
Jeśli node -v drukuje v22.19+, v24.11+ lub v26+, jesteś gotowy. Jeśli wydrukuje starszą wersję lub "nie rozpoznano" / "nie znaleziono polecenia", zainstaluj Node.js 24 LTS:
Windows (PowerShell)
winget install --exact --id OpenJS.NodeJS.LTS
Wpisz Y, jeśli zostaniesz poproszony o zaakceptowanie warunków. Zamknij PowerShell, otwórz go ponownie, a następnie uruchom node -v.
Jeśli winget jest niedostępny, pobierz instalator Node.js.
Jeśli później podczas uruchamiania npx PowerShell wyświetli "running scripts is disabled on this system", użyj zamiast tego npx.cmd. W przypadku npm użyj npm.cmd:
npx.cmd rea-agents@latest setup
macOS
Przy pierwszej instalacji pobierz instalator Node.js 24 LTS dla macOS (.pkg), otwórz go i postępuj zgodnie z instrukcjami. Następnie ponownie otwórz Terminal.
Korzystasz już z Homebrew?
brew install node
Linux
Jeśli brakuje curl lub unzip, najpierw je zainstaluj. W Debian lub Ubuntu wykonaj sudo apt install curl unzip; w innych dystrybucjach użyj swojego menedżera pakietów.
curl -fsSL https://fnm.vercel.app/install | bash
Zamknij terminal, otwórz go ponownie, a następnie wykonaj:
fnm install 24
fnm use 24
fnm default 24
Twoja dystrybucja własna nodejs Pakiet jest często starszy niż 22.19, więc sprawdź node -v jeśli zamiast tego go użyjesz.
Wolisz zwykłego instalatora? Pobierz wersję LTS z nodejs.org.
Utwórz folder roboczy dla agenta
W terminalu utwórz folder na ćwiczenie, a następnie przejdź do niego:
mkdir rea-work
cd rea-work
Zostaw ten terminal otwarty do następnego kroku. Jeśli masz już folder roboczy, otwórz go zamiast nowego.
2. Wybierz agenta programistycznego
Agent to AI, z którą rozmawiasz. REA dostarcza jej narzędzia do badania programów. Wybierz jedną aplikację kliencką poniżej; jeśli jeszcze jej nie znasz, otwórz instrukcje.
Codex · użyj swojego konta ChatGPT
Zainstaluj Codex za pomocą komendy dla swojego systemu operacyjnego:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Po instalacji ponownie otwórz terminal i wróć do folderu roboczego. Następnie uruchom Codex:
codex
Wybierz „Sign in with ChatGPT”, zaloguj się w przeglądarce i wróć do terminala. Gdy pojawi się pole wiadomości, przejdź do kroku 3.
Cursor, Windsurf lub VS Code · użyj edytora
- Zainstaluj edytor dla swojego systemu operacyjnego i zaloguj się.
- Otwórz folder rea-work utworzony w kroku 1.
- Otwórz czat AI w edytorze i wybierz tryb Agent. W Windsurf lub Devin Desktop otwórz czat agenta; w VS Code najpierw skonfiguruj GitHub Copilot.
Konfiguracja Cursor · Konfiguracja Windsurf / Devin Desktop · Konfiguracja VS Code i Copilot
Claude Code · użyj swojego konta Claude
Zainstaluj za pomocą komendy dla swojego systemu operacyjnego:
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.sh | bash
Otwórz ponownie terminal, wróć do folderu roboczego i uruchom claude. Postępuj zgodnie z instrukcjami logowania. Dostęp wymaga odpowiedniej subskrypcji Claude lub skonfigurowanego konta API.
Claude Desktop · użyj czatu w aplikacji desktopowej
Zainstaluj Claude Desktop w Windows lub macOS i zaloguj się. Całkowicie zamknij aplikację, a następnie wykonaj tę komendę w terminalu otwartym poza Claude:
npx rea-agents@latest setup --client claude_desktop
Przejrzyj i zatwierdź plan, ponownie otwórz Claude, a następnie sprawdź połączenie w kroku 3.
Pobierz Claude Desktop · Szczegóły połączenia z Claude Desktop
OpenCode · wybierz model AI
npm install --global opencode-ai
Uruchom opencode w folderze roboczym. W jego czacie użyj /connect, aby połączyć konto dostępu do modeli, a następnie wybierz model.
Wszystkie obsługiwane klienty i identyfikatory konfiguracji
Wydanie 6.4.0 w npm obsługuje klienty wymienione poniżej. Aby wskazać konkretny klient, użyj jego identyfikatora z --client.
| Klient | Identyfikator konfiguracji |
|---|---|
| Claude Code | claude_code |
| Claude Desktop | claude_desktop |
| Codex | codex |
| Cursor | cursor |
| Gemini CLI | gemini_cli |
| Windsurf | windsurf |
| Devin | devin |
| OpenCode | opencode |
| Antigravity | antigravity |
| GitHub Copilot CLI | copilot_cli |
| Command Code | commandcode |
| Qwen Code | qwen_code |
| VS Code | vscode |
| Grok Build | grok_build |
| OMP | omp |
| Pi | pi |
| Hermes | hermes |
Qoder (qoder), Factory Droid (droid), Trae (trae), ZCode (zcode) i DeepSeek Harness (dsh) są dostępne w gałęzi main repozytorium; użyj kompilacji ze źródeł lub wydania zawierającego te integracje.
Konfiguracja klientów i rozwiązywanie problemów · Dostępność w wydaniach
Grok Bot · połącz na komputerze, na którym działa
W czacie Grok Bot poproś o dodanie własnego serwera MCP o nazwie rea, używając tej komendy na komputerze bota:
npx -y rea-agents@6.4.0 mcp
3. Połącz REA
Wklej to polecenie do swojego agenta programistycznego:
Zainstaluj REA i połącz je z tym agentem programistycznym za pomocą npx rea-agents@latest setup. Najpierw pokaż plan zmian i poczekaj na moją zgodę. Potem sprawdź instalację.
Lub uruchom samodzielnie konfigurację
npx rea-agents@latest setup
Dla konkretnego klienta dodaj jego identyfikator konfiguracji:
npx rea-agents@latest setup --client codex
Jeśli npm poprosi o zgodę na pobranie pakietu, wpisz y i naciśnij Enter. Na liście klientów REA poruszaj się strzałkami, zaznacz swój klient klawiszem Space i naciśnij Enter, aby kontynuować.
Wybierz swojego klienta i przejrzyj plan konfiguracji. REA dodaje swoje połączenie MCP i umiejętność badania dopasowania, zachowując kopię zapasową istniejącej konfiguracji. Pyta przed zastosowaniem zmian.
MCP to połączenie, przez które agent wywołuje REA. Umiejętność daje mu sposób postępowania przy badaniu programów.
W pierwszym ćwiczeniu możesz pominąć opcjonalną instalację Hopper. Po zakończeniu konfiguracji uruchom ponownie klienta.
Jak zrestartować klienta?
Aplikacje komputerowe (Claude Desktop, Cursor, Windsurf, VS Code): całkowicie zamknij aplikację, a następnie otwórz ją ponownie. Zamknięcie okna nie wystarczy. Na prasie macOS ⌘ Q; na Windows Zamknij również ikonę w zasobniku, jeśli taka istnieje.
Agenci terminalowi (Claude Code , Codex , Gemini CLI ): Zamknij sesję i uruchom ją ponownie.
npx -y rea-agents@latest doctor --client codex --json
Zastąp codex identyfikatorem konfiguracji swojego klienta. Poprawna kontrola zwraca "healthy": true. Następnie poproś agenta:
Sprawdź, czy REA jest połączone, i pokaż, z jakich narzędzi REA możesz korzystać.
4. Spróbuj pierwszego badania
Przykładem jest sześcioplikowa aplikacja Electron z Eksportuj notatki przycisk. Twój agent może sprawdzić swój kod bez instalowania lub uruchamiania Electron .
Pobierz https://rea.tools/examples/notes-example.zip do nowego przykładowego folderu i rozpakuj go. Użyj REA, aby dowiedzieć się, co się stanie, gdy kliknę Eksportuj notatki. Pokaż gdzie notes.csv jest napisane, które pola zawiera, oraz odpowiednie pliki i wiersze.
Poszukaj krótkiego wyjaśnienia z odniesieniami do plików i linii:
Przycisk wysyła
notes:exportwiadomość. Główny proces formatuje notatki jako CSV i zapisujenotes.csvw folderze Pobrane użytkownika. Kolumny sąidoraztitle.
Sprawdź przewidywanie w ćwiczeniu krok po kroku →
Pobierz przykład samodzielnie lub użyj własnej aplikacji
Jeśli twój agent nie może pobrać plików, rozpakuj to archiwum samodzielnie. Daj mu drogę do notes-example folder i to samo pytanie o eksport.
Użyj REA do zbadania aplikacji pod ścieżką
/absolute/path/to/app. Znajdź, jak eksportuje dane, i pokaż odpowiednie pliki oraz linie.
Jak uzyskać pełną ścieżkę folderu?
- Windows : w Eksploratorze plików kliknij folder prawym przyciskiem myszy i wybierz Kopiuj jako ścieżkę. Na Windows 10 przytrzymaj klawisz Shift, klikając prawym przyciskiem myszy.
- macOS : w Finderze kliknij prawym przyciskiem myszy folder, przytrzymaj opcję i wybierz Skopiuj " ... " jako ścieżkę.
- Dowolny system: przeciągnij folder do okna terminala, a pojawi się jego ścieżka.
W terminalu umieść cudzysłowy wokół ścieżki zawierającej spacje.
Zbadaj inny rodzaj oprogramowania
Wybierz sekcję dla swojego celu. Dostawca analizy to lokalne narzędzie, którego REA używa do badania tego rodzaju oprogramowania.
Pliki wykonywalne i biblioteki kodu maszynowego · Hopper, Ghidra lub IDA
Zainstaluj jedno narzędzie analizy na komputerze, na którym działa REA. Host to Twój system operacyjny, a cel to program, który chcesz zbadać.
| Dostawca analizy | Windows | macOS | Linux |
|---|---|---|---|
| Hopper | Niedostępne | 12+ | Obsługiwane dystrybucje |
| Ghidra | x64 · eksperymentalnie | x64 / arm64 | x64 / arm64 |
| IDA | Zweryfikowane profile | Zweryfikowany profil bez interfejsu graficznego | Zobacz przewodnik dostawcy |
Hopper · pozwól konfiguratorowi go zainstalować lub połączyć
Podłącz Hopper na macOS lub Linux . Uruchom powyższe polecenie konfiguracji; wykrywa istniejącą instalację lub oferuje plan instalacji do zatwierdzenia.
Wybierz Hopper podczas konfiguracji i przejrzyj jego oddzielny plan instalacji. W macOS przy pierwszym uruchomieniu Hopper wybierz tryb demonstracyjny lub aktywuj licencję. W Linux konfigurator przygotowuje obsługiwaną wersję demonstracyjną i osobny ekran dla niej.
Hosty Linux: Ubuntu 24.04+, Fedora 41+, Nobara 44+, Arch Linux, CachyOS lub Omarchy. Hopper to oprogramowanie komercyjne; ograniczenia wersji demonstracyjnej określa producent.
npx -y rea-agents@latest doctor --provider hopper --json
Jeśli macOS poprosi o uprawnienie do automatyzacji, zezwól aplikacji uruchamiającej REA w Ustawienia systemowe → Prywatność i ochrona → Automatyzacja, a następnie spróbuj ponownie.
Ghidra · zainstaluj bezpłatne narzędzie analizy i Javę
- Zainstaluj 64-bitowy JDK 21 lub nowszy, zawierający kompilator Java. Wybierz pakiet pasujący do architektury Twojego komputera.
-
Pobierz Ghidra 12.1.4 z listy Assets wydania i rozpakuj archiwum
ghidra_…_PUBLIC_….zip. Wybierz archiwum wydania, a nie „Source code”. -
Znajdź rozpakowany folder zawierający
ghidraRunlubghidraRun.bat. Użyj go jakoGHIDRA_INSTALL_DIR.
Pobierz JDK · Pobierz Ghidra 12.1.4
Sprawdź Javę. Pierwsza komenda wyświetla java.home; użyj tego folderu jako JAVA_HOME. Druga potwierdza, że kompilator jest zainstalowany:
java -XshowSettings:properties -version
javac -version
Połącz Ghidra na Windows
Windows x64 ma eksperymentalną obsługę tylko do odczytu dla natywnych aplikacji x86 i x64 PE oraz bibliotek DLL na stałych lokalnych dyskach NTFS. Użyj istniejącego Ghidra 12.1.instalacja x i 64-bitowy JDK 21 lub nowszy:
$env:GHIDRA_INSTALL_DIR = "C:/tools/ghidra_12.1.4_PUBLIC"
$env:JAVA_HOME = "C:/tools/jdk-21"
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup
Zastąp dwie ścieżki instalacjami, a następnie przejrzyj plan konfiguracji.
Podłącz instalację Ghidra
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"
Zastąp obie ścieżki ścieżkami do swoich istniejących instalacji. Przy nowej instalacji w macOS lub Linux arm64 przed kontynuowaniem skompiluj natywny dekompilator dla swojego komputera.
Skompiluj natywny dekompilator Ghidra
W macOS kompilacja wymaga Xcode Command Line Tools, make i bison. Użyj przewodnika dla swojego komputera:
Następnie sprawdź Ghidra i zapisz jego ścieżki dla swojego klienta:
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup
Wykonuj te komendy w tej samej sesji terminala. Po ustawieniu ścieżek ponownie uruchom konfigurację, zatwierdź zaktualizowaną konfigurację klienta i uruchom ponownie agenta.
Konfiguracja Ghidra i wymagania architektury · Przewodnik po Ghidra w Windows
IDA · połącz istniejącą instalację
Przygotuj rejestrację serwera MCP po stronie IDA zgodnie z przewodnikiem dostawcy IDA. Wybierz połączenie z interfejsem graficznym, w którym otwarty jest oryginalny plik binarny, lub z nadzorcą bez interfejsu graficznego, który otwiera osobną bazę danych.
Zweryfikowane profile obejmują starsze połączenie GUI i nadzorcę bez interfejsu graficznego w Windows oraz nadzorcę bez interfejsu graficznego w macOS arm64 z IDA Professional 9.1. Opcjonalny natywny most do GUI ma własne wymagania dotyczące wersji i platformy.
Profil bez interfejsu na macOS i natywny most GUI wymagają REA zbudowanego ze źródeł lub wydania zawierającego te zmiany. npm 6.4.0 ich nie zawiera.
W katalogu zbudowanego kodu źródłowego uruchom node scripts/rea.mjs doctor --provider ida --json i node scripts/rea.mjs setup zamiast poniższych poleceń npx.
Przygotuj plik rejestracji IDA
Zainstaluj i skonfiguruj serwer po stronie IDA zgodnie z przewodnikiem poniżej. Następnie zapisz jego działającą rejestrację jako ida-mcp.json w edytorze tekstu. W Windows podczas zapisywania w Notatniku wybierz „Wszystkie pliki”, aby nie dodał .txt.
Dla nadzorcy bez interfejsu graficznego udostępniającego idb_open, idb_list i idb_close plik może wyglądać tak:
{
"command": "idalib-mcp",
"args": ["--stdio", "--max-workers", "1"],
"mode": "headless"
}
Dla podłączonego starszego serwera GUI 1.4.0 skopiuj do pliku jego działające wartości command, args i opcjonalnie env. Otwórz oryginalny plik binarny w IDA i uruchom wtyczkę po stronie IDA, zanim poprosisz REA o jego zbadanie.
$env:REA_IDA_MCP_CONFIG = "C:/analysis/ida-mcp.json"
$env:REA_ANALYSIS_PROVIDER = "ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup
export REA_IDA_MCP_CONFIG="/absolute/path/to/ida-mcp.json"
export REA_ANALYSIS_PROVIDER="ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup
Użyj pliku rejestracji JSON przygotowanego według przewodnika dostawcy, a następnie ponownie uruchom konfigurację i agenta.
Profile IDA, przykłady rejestracji i zweryfikowane platformy
Po połączeniu podaj agentowi pełną ścieżkę do oryginalnego pliku wykonywalnego i nazwę dostawcy analizy:
Użyj REA z dostawcą, którego skonfigurowałem, aby zbadać
/absolute/path/to/program. Wymień funkcje i ciągi znaków, a następnie wyjaśnij część obsługującą dane użytkownika, podając odwołania do kodu.
Witryny, Android, .NET, firmware i inne cele
Otwórz przewodnik dla swojego celu. Każdy podaje dodatkowe narzędzia, obsługiwane hosty i pierwszą komendę.
| Cel | Narzędzia do przygotowania | Przewodnik |
|---|---|---|
| JavaScript / Electron | Node.js + npm | Otwórz przewodnik |
| Witryna | Chrome / Chromium / Edge | Otwórz przewodnik |
| .NET / Flutter / pakiety | Node.js + npm | Otwórz przewodnik |
| Android APK | JADX + JDK 17+ | Otwórz przewodnik |
| Urządzenie Android | adb | Otwórz przewodnik |
| Zasoby Android | Apktool + Java | Otwórz przewodnik |
| Projekt JEB | JEB + MCP | Otwórz przewodnik |
| Firmware | Binwalk / Unblob · Linux | Otwórz przewodnik |
| WASM | WABT | Otwórz przewodnik |
| Baza danych SQLite | Node.js 24.15+ / 26+ | Otwórz przewodnik |
| Bajtkod EVM | Node.js · Linux x64 | Otwórz przewodnik |
| ELF / awaria Linux | pwntools / GDB / pwndbg | Otwórz przewodnik |
| HAR / SAZ / mitmproxy | Node.js / mitmdump | Otwórz przewodnik |
| PCAP / PCAPNG | TShark / capinfos · Linux | Otwórz przewodnik |
| Sygnały logiczne | sigrok-cli · Linux | Otwórz przewodnik |
| Zachowanie procesu | PTY · Linux / macOS | Otwórz przewodnik |
Przewodnik po Flutter · Pakiety i zasoby · Bajtkod EVM · Wszystkie przewodniki badania
Używaj REA z terminala
Komendy CLI, instalacja globalna i curl
Analizuj folder aplikacji JavaScript lub Electron lub archiwum ASAR bez uruchamiania aplikacji:
npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json
Zastąp ścieżkę wyodrębnionym katalogiem aplikacji lub .asar akta. Na Windows ścieżka taka jak "D:/apps/example" działa tutaj.
Gdzie znajdę aplikację .plik asar?
Aplikacje Electron zwykle przechowują go w resources folder:
-
Windows :
C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar -
macOS :
/Applications/<App>.app/Contents/Resources/app.asar(kliknij aplikację prawym przyciskiem myszy i wybierz Pokaż Zawartość Opakowania) -
Linux : często
/opt/<App>/resources/app.asar
Niektóre aplikacje instalują się gdzie indziej. Wyszukaj w folderze aplikacji app.asar.
Wynik identyfikuje aplikację, pokazuje połączenia między modułami i podaje ich lokalizacje źródłowe. Połączenia REA nie można rozwiązać są oznaczone w wyniku.
Jeśli chcesz mieć stałe rea polecenie w Twojej powłoce:
npm install --global rea-agents
Kontynuuj korzystanie z Przewodnika po aplikacjach JavaScript
npx -y rea-agents@latest function "/absolute/path/to/program" main --provider ghidra --json
Zastąp main nazwą lub adresem funkcji z listy funkcji celu. Najpierw trzeba skonfigurować Ghidra.
W macOS lub Linux po przygotowaniu Node.js możesz również użyć instalatora przez curl:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
Postępuj zgodnie ze wskazówkami konfiguracji, aby połączyć agenta. Jeśli się nie pojawią, uruchom rea setup.
Jeśli powłoka nie znajduje rea, użyj ścieżki pliku wykonywalnego wyświetlonej przez instalator. W systemie Linux domyślne polecenie konfiguracji to "$HOME/.local/bin/rea" setup.
Uzyskiwanie pomocy
Jeśli twój agent nie widzi REA
Uruchom ponownie lub podłącz ponownie Klienta po konfiguracji. Sprawdź połączenie REA z doctor; dla Codex :
Wykonaj kontrolę klienta z kroku 3, podając swój identyfikator konfiguracji. W edytorach włącz REA w ustawieniach MCP i zezwól na jego narzędzia w czacie agenta.
Jeśli dostawca wymaga uwagi
Sprawdź dostawcę, którego używasz. Dla Ghidra :
npx -y rea-agents@latest doctor --provider ghidra --json
Raport zawiera nieudaną kontrolę i sugerowany następny krok.
Windows, WSL i ścieżki ze spacjami
Dla klientów i narzędzi analizy Windows używaj Windows PowerShell. Jeśli agent działa w WSL, zainstaluj Node.js i REA w tym środowisku Linux i używaj w nim ścieżek Linux. Dostawcy bez interfejsu graficznego działają na tym samym hoście co REA.
W terminalu umieść cudzysłowy wokół ścieżki zawierającej spacje.
Komenda konfiguracji dla Windows:
npx.cmd rea-agents@latest setup
Zaktualizuj lub usuń REA
Aby odświeżyć połączenie agenta, ponownie wykonaj najnowszą komendę konfiguracji, przejrzyj jej plan i uruchom ponownie klienta.
npx rea-agents@latest setup
Jeśli CLI jest zainstalowane globalnie, zaktualizuj je za pomocą rea update. Użyj npx rea-agents@latest uninstall, aby usunąć konfigurację klienta REA i umiejętność.
- REA FAQSzybkie odpowiedzi na aktualizacje, agentów i analizy.
- Wybierz przewodnik po dochodzeniuPracował przykłady binarny, aplikacja Electron i przeglądarki.
- Problemy z GitHubZgłoś problem z poleceniem i diagnostyką.
- Społeczność REAPytania, dochodzenia i prace w toku.
