Files
rea/README_de.md
T
Kaoru0822andClaude Opus 5.5 b6d8bb65d3 docs(readme): add responsible-use guidance and reframe the introduction
Reframe the tagline and opening paragraph around security research,
interoperability and authorized analysis. Add a "Responsible use"
section before Quick start that lists unsupported uses and the user's
legal responsibilities, replace the Notes example prompt with a
release-versus-debug crash investigation, and point the Disclaimer at
the new section while keeping the cryptocurrency statement.

Apply the same changes to all 18 translated READMEs, with anchors
matching each translated heading.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 06:03:22 +00:00

21 KiB
Raw Blame History

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Türkçe · Русский · Tiếng Việt · ไทย · Deutsch · Español · Français · Українська · Polski · Português (Brasil) · العربية · فارسی · Bahasa Indonesia · Italiano

REA: Alles reverse-engineeren

Ein MCP für das Reverse Engineering von Binärdateien, Anwendungen und Laufzeitverhalten.

Verstehe, wie Software funktioniert, bis hinunter auf die Binärebene – für Sicherheitsforschung, Interoperabilität und Software, die du analysieren darfst.

npm version MCP tool catalog Node.js requirements skills.sh MIT license Discord

morluto%2Frea | Trendshift

Website · Anleitungen · Fallstudien

Schnellstart · So funktioniert REA · Was du analysieren kannst · Fallstudien · Häufige Fragen · Dokumentation

npx rea-agents setup


REA startet seine Analysebrücke in Hopper und untersucht eine native Binärdatei



Discord
Der Reverse-Engineering-Community beitreten

Discord · Fragen und Antworten · Ergebnisse teilen


REA hilft Sicherheitsforschern, Malware-Analysten, CTF-Spielern und Entwicklern, kompilierte Software mithilfe ihrer Agenten zu verstehen. Richte deinen Agenten auf eine Binärdatei, eine Anwendung oder eine Aufzeichnung, die du analysieren darfst; REA untersucht sie ohne Quellcode, erklärt ihr Verhalten und zeigt die Belege hinter jeder Schlussfolgerung.

REA verbindet deinen Agenten mit Werkzeugen zum Untersuchen nativer Binärdateien, von JavaScript- und Electron-Apps, .NET-Assemblies und Websites. Dieselben Werkzeuge kannst du auch im Terminal nutzen. Die Analyse läuft lokal; die Ergebnisse enthalten die Belege und Einschränkungen hinter jeder Schlussfolgerung.

Die Einrichtung registriert REA bei deinem Agenten und installiert passende Workflow-Anweisungen. Für native Analysen kannst du eine vorhandene Hopper- oder Ghidra-Installation verwenden. Mit deiner Zustimmung kann die Einrichtung auch Hopper installieren. Statische JavaScript-Analysen benötigen keines der beiden Programme.

Besuche die REA-Website für Einrichtungshinweise, bebilderte Anleitungen und echte Fallstudien.

Verantwortungsvolle Nutzung

REA ist für rechtmäßige Analysen gedacht: Sicherheitsforschung, Malware- und Vorfallsanalyse, Schwachstellenforschung und koordinierte Offenlegung, CTFs und Lehre, Interoperabilität, Softwarebewahrung sowie das Debuggen oder Prüfen von Software, die dir gehört oder die du untersuchen darfst.

Das REA-Projekt unterstützt Folgendes nicht und hilft auch nicht dabei:

  • DRM, Lizenzprüfungen, Anti-Cheat-Systeme oder andere technische Schutzmaßnahmen zu umgehen;
  • Cheats für Spiele zu entwickeln oder Onlinedienste zu manipulieren;
  • Authentifizierung, Bot-Schutz oder Zugriffskontrollen auf Systemen zu umgehen, die du nicht testen darfst;
  • proprietäre Software zu kopieren oder ihren geschützten Code und ihre geschützten Assets zu reproduzieren;
  • die Nutzungsrichtlinien oder Sicherheitsmaßnahmen von KI-Modellanbietern zu unterlaufen;
  • KI-Konten oder API-Zugänge weiterzuverkaufen oder zu teilen.

Du bist dafür verantwortlich, erforderliche Genehmigungen einzuholen und geltendes Recht, Lizenzvereinbarungen und Nutzungsbedingungen einzuhalten. Reverse Engineering kann in deiner Rechtsordnung oder durch die Lizenz der analysierten Software eingeschränkt sein.

Anfragen nach Hilfe bei den oben genannten Zwecken werden in Issues und Diskussionen ohne Antwort geschlossen und können zum Ausschluss aus der REA-Community führen.

Schnellstart

Deinen Agenten einrichten

Wenn Node.js und npm installiert sind, führe diesen Befehl aus:

npx rea-agents setup

Wähle deine Agenten aus, prüfe die geplanten Änderungen und bestätige sie. Die Einrichtung fügt den MCP-Server von REA und passende Workflow-Anweisungen hinzu und sichert vorhandene Konfigurationen. Starte deinen Agenten anschließend neu.

Die Einrichtung unterstützt Claude Code, Codex, Cursor, Gemini CLI, Grok Build und weitere Agenten. Informationen zur Provider-Konfiguration und manuellen MCP-Registrierung findest du unter Installation und Einrichtung.

Deinen Agenten fragen

Der Release-Build meiner App stürzt beim Start ab, der Debug-Build aber nicht.
Untersuche ./build/MyApp, finde heraus, wo die beiden Builds voneinander abweichen, und zeige mir die Belege.

Richte deinen Agenten auf ein Ziel, das du analysieren darfst, und beschreibe, was du verstehen möchtest.

Das Terminal verwenden

Untersuche ein entpacktes JavaScript-/Electron-App-Verzeichnis oder eine ASAR-Datei:

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json

Das Ergebnis enthält Module, Imports, Electron-Grenzen und die zugehörigen Belege. Ersetze den Pfad durch dein Ziel, beispielsweise "D:/apps/example" unter Windows.

Für die regelmäßige Nutzung kannst du den Befehl rea installieren:

npm install --global rea-agents
rea --help

Konfiguriere für native Analysen zuerst einen Provider. Native Befehle, Provider-Auswahl, Snapshots und Skriptnutzung beschreibt der CLI- und Evidence-Leitfaden.

REA aktualisieren

REA entwickelt sich schnell weiter; neue Versionen enthalten häufig Fehlerbehebungen. Halte deine Installation aktuell.

Für eine über npm installierte CLI:

rea update

Um die Agentenregistrierungen und den Skill zu aktualisieren, führe den Einrichtungsbefehl aus, den das Update ausgibt.

Wenn du npx verwendest, aktualisiere die Agenteneinrichtung mit:

npx rea-agents@latest setup

Prüfe die Änderungen und starte deinen Agenten neu. Für einzelne CLI-Aufrufe verwende npx rea-agents@latest, gefolgt vom gewünschten Befehl.

So funktioniert REA

Dein Agent ruft REA über MCP auf, um das Ziel zu untersuchen und relevanten Code zu verfolgen. REA liefert Ergebnisse mit ihren Belegen zurück. Der Agent nutzt sie für weitere Fragen, Erklärungen oder zum Schreiben und Testen einer Implementierung. CLI-Befehle verwenden dieselben Workflows.

REA-Untersuchungsablauf: Dein Agent fragt nach einem lokalen Ziel, REA untersucht und verfolgt es mit Analysewerkzeugen, und der Agent nutzt den zurückgegebenen Code, Verweise und offene Fragen zum Erklären, Implementieren und Testen.

Abbildung in voller Größe öffnen.

Was du analysieren kannst

REA benötigt Node.js 22.x (>=22.19), 24.x (>=24.11) oder 26+ sowie npm. Zusätzliche Werkzeuge und unterstützte Hostsysteme hängen vom Ziel ab:

Ziel Was REA zurückgibt Voraussetzungen und Anleitung
Native Binärdateien Pseudocode, Assemblercode, Zeichenketten, Symbole, Aufrufe und Verweise Hopper, Ghidra oder IDA; native Analyse
Offline-ELF-Struktur Sektionen, Segmente, ursprüngliche Symbole/Relokationen und mögliche Schutzmaßnahmen aus statischer Analyse Vom Aufrufer bereitgestelltes pwntools unter Linux x64; Binärdiagnostik
EVM-Bytecode Dispatch-Selektoren, Byte-Offsets, abgeleitete Argumente und Veränderbarkeit des Zustands Lokale Eingabe mit Rohbytes oder Hexdarstellung unter Linux x64; Offline-EVM-Leitfaden
Aufgezeichnete Linux-Abstürze Unverarbeitete Note-Einträge, Register/Signale aller aufgezeichneten Threads und optionale Zuordnungskandidaten Vom Aufrufer bereitgestelltes pwntools unter Linux x64; optional GDB/pwndbg; aufgezeichnete Abstürze
JavaScript / Electron Module, Imports, Source Maps, Routen, IPC und Beziehungen zu nativen Add-ons Node.js und npm; Anwendungsanalyse
Websites Seitenstruktur, Skripte, Netzwerkbeobachtungen und angeforderte Screenshots Ein Browser aus der Chrome-Familie; Browseranalyse
Gespeicherte Netzwerkaufzeichnungen Anfragen, Antworten, zugängliche Nutzdaten und Quellpositionen HAR; mitmdump unter Linux für Aufzeichnungen im nativen mitmproxy-Format; Leitfaden zu Netzwerkaufzeichnungen
.NET-Assemblies Metadaten, CIL-Anweisungen, deklarierte native Abhängigkeiten und Build-Vergleiche Statische Untersuchung; Leitfaden für verwalteten Code
Android-APKs Manifest-Deklarationen, Klassen, dekompilierte Methoden und Verweise JADX ohne grafische Oberfläche und ein vollständiges JDK unter Linux/macOS/Windows x64; Android-Leitfaden
Android-Geräte Geräte, Pakete, Prozesse, Logs, Dumps, Bildschirmaufnahmen sowie APK- und Dateiübertragungen Vom Aufrufer bereitgestelltes adb (Emulator oder Gerät); ADB-Leitfaden
JEB-Projekte Engine-gestützte Projekteinheiten, Artefakt-Prüfsummen und Pseudokode von Typen/Methoden Ein vom Aufrufer gestarteter JEB-Client mit MCP, ausgewählt über REA_JEB_MCP_URL; JEB-Leitfaden
Android-Ressourcen Dekodiertes Manifest, String-Tabellen, Sprachen und Versionsfakten Vom Aufrufer bereitgestellter Apktool-Starter; Ressourcen-Leitfaden
Firmware Bereiche, Extraktionsergebnisse und Übergaben an die native Analyse Binwalk / Unblob unter Linux; Firmware-Leitfaden
Pakete und Ressourcen Dateiinventare, Hashwerte, plists, Aufbau von Apple-Bundles und extrahierte Ressourcen Artefakt- und JavaScript-Leitfaden, Apple-Anwendungen
Prozessverhalten Terminalausgabe, Interaktionen, Beobachtungen zu Prozessende und Dateisystem sowie Laufvergleiche Linux/macOS mit nativer PTY; Prozessaufzeichnung

Statische JavaScript- und .NET-Untersuchungen lesen die bereitgestellten Dateien, ohne die Anwendung auszuführen. Laufzeitaufzeichnungen führen das gewählte Ziel mit deinen Benutzerrechten aus oder interagieren damit; die jeweiligen Anleitungen beschreiben die Auswirkungen.

Native Formate und unterstützte Hostsysteme unterscheiden sich je nach Provider. Siehe Hopper- und Ghidra-Einrichtung, den IDA-Leitfaden und die experimentelle Ghidra-Unterstützung unter Windows. Ghidra unterstützt auch 16-Bit-DOS-Analyse. Die Provider-Auswahl beschreibt der CLI-Leitfaden. Prüfe die Verfügbarkeit in Releases für Funktionen, die seit der neuesten npm-Version hinzugekommen sind.

Fallstudien

Illustrationen der Fallstudien zu DX-Balls Klangbalance, Notions Zwischenablage-Brücke und TH04s Geschossring

DX-Ball: Eine Stereo-Panning-Berechnung rekonstruieren

Verfolge einen Sound-Aufruf zur Hilfsfunktion, die Positionen in Panning-Werte umrechnet, untersuche die Anweisungen und überführe unvollständigen Pseudocode in C. Die Rekonstruktion besteht 3.205 Tests mit dem ursprünglichen x86-Code und reproduziert alle 63 Bytes der kompilierten Funktion.

Fallstudie lesen · Rekonstruktionsrepository

Notion: Die Electron-Zwischenablagebrücke verfolgen

Finde die Zwischenablage-API des Renderers, verfolge sie über preload und IPC bis zum Hauptprozess und untersuche das Zwischenablageformat samt Formatierungsdaten.

Fallstudie lesen

TH04: Eine DOS-Geschossring-Berechnung wiederherstellen

Untersuche die 16-Bit-Anweisungen des ursprünglichen PC-98-Spiels, rekonstruiere die festen und zielgerichteten Winkelberechnungen und vergleiche das rekonstruierte C++ mit der Ausgabe des damaligen Compilers.

Fallstudie lesen · Rekonstruktionsrepository

Wenn du mit REA etwas Interessantes untersucht hast, würden wir es gern sehen. Teile deine Fallstudie in einem Issue oder Pull Request und beschreibe das Ziel, deine Frage, wie REA geholfen hat und was du herausgefunden hast.

Häufige Fragen

Welche Agenten können REA verwenden?

Jeder Agent, der lokale MCP-Server unterstützt. Die Einrichtung konfiguriert die unterstützten Agenten; andere Clients können die manuelle MCP-Registrierung nutzen.

Brauche ich Hopper, Ghidra oder IDA?

Für tiefgehende native Analysen wird eines dieser Programme verwendet. Statische JavaScript- und .NET-Untersuchungen funktionieren ohne native Analyse-Engine. Die Einrichtung kann Hopper nach Zustimmung installieren; Ghidra und IDA nutzen deine vorhandenen Installationen. Siehe Provider-Einrichtung.

Muss ich Hopper vorher starten?

REA startet Hopper, wenn eine Operation es benötigt. Unter macOS kann beim ersten Start ein Dialog erscheinen, in dem du den Demomodus auswählst oder deine Lizenz aktivierst. Siehe Hopper-Start und Fehlerbehebung.

Was bewirkt die Installation des Skills über skills.sh?

Der Skill stellt Untersuchungsanweisungen für deinen Agenten bereit. Verwende npx rea-agents setup, um den MCP-Server von REA zu registrieren und passende Anweisungen zu installieren. Starte deinen Agenten anschließend neu. Siehe Installation nur des Skills.

Welchen Code liefert REA zurück?

Native Analysen liefern Pseudocode und Assemblercode. JavaScript-/Electron-Analysen rekonstruieren Module und ihre Beziehungen. Dein Agent nutzt diese Ergebnisse zum Schreiben und Testen einer Implementierung; die Fallstudien zeigen konkrete Beispiele.

Lädt REA meine App hoch?

REA analysiert Ziele lokal. Dein Agent erhält die Werkzeugergebnisse; sein Modellanbieter hat eine eigene Datenrichtlinie.

Was soll ich tun, wenn ich einen Fehler finde?

Aktualisiere zuerst; eine neuere Version könnte den Fehler bereits behoben haben.

Für eine über npm installierte CLI:

rea update

Für die Agenteneinrichtung über npx:

npx rea-agents@latest setup

Wenn du einen Agenten verwendest, schließe die Aktualisierung der Einrichtung ab und starte ihn neu. Wiederhole dieselbe Aufgabe. Besteht das Problem weiterhin, öffne ein Issue mit deiner REA-Version, dem Zieltyp, den Reproduktionsschritten und der Fehlerausgabe.

Dokumentation

Beginne mit den praxisnahen Anleitungen auf der Website. Genaue Optionen, Voraussetzungen und Ergebniskontrakte findest du hier:

Melde Sicherheitslücken gemäß SECURITY.md.

Sternverlauf

🎉 110.000 GitHub-Sterne – vielen Dank!

Danke an alle, die REA nutzen, Fehler melden, Funktionswünsche äußern, Builds testen und Fehlerbehebungen beitragen.

GitHub-Sternverlauf von REA

Haftungsausschluss

Siehe Verantwortungsvolle Nutzung.

Mitwirken

Wir freuen uns über deine Hilfe bei REA! Öffne ein Issue, um einen Fehler zu melden oder eine Funktion vorzuschlagen, oder sende einen Pull Request, um Code oder Dokumentation zu verbessern.

Die Entwicklungsumgebung und Prüfungen beschreibt CONTRIBUTING.md, die Verifikationspfade der Testleitfaden und die Projektstruktur die Architekturübersicht.

Lizenz

MIT