reverse-engineering-anything/docs/readme/README_el.md

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: Reverse Engineer Anything

Ένα MCP για αντίστροφη μηχανική δυαδικών αρχείων, εφαρμογών και της συμπεριφοράς τους κατά την εκτέλεση.

Βρήκες μια λειτουργία που σου αρέσει; Μάθε πώς λειτουργεί, μέχρι το επίπεδο του δυαδικού κώδικα.

Ιστότοπος · Οδηγοί · Μελέτες περίπτωσης

Γρήγορη εκκίνηση · Πώς λειτουργεί το REA · Τι μπορείς να αναλύσεις · Μελέτες περίπτωσης · Δημιουργία περιβαλλόντων RL · Συχνές ερωτήσεις · Τεκμηρίωση

npx rea-agents setup

Important

Κατέβασε το REA από το morluto/rea, το rea.tools ή το πακέτο rea-agents στο npm. Ακολούθησε τους συνδέσμους εγκατάστασης και εκδόσεων από αυτές τις επίσημες πηγές. Ένα παρόμοιο όνομα αποθετηρίου ή ένα αντιγραμμένο README δεν αποδεικνύει ότι ένα αρχείο προς λήψη προέρχεται από επίσημη πηγή.

Έλα στην κοινότητα αντίστροφης μηχανικής Discord · Ερωτήσεις και απαντήσεις · Παρουσίαση έργων

---

Είδες σε μια εφαρμογή μια λειτουργία που θα ήθελες στο δικό σου προϊόν; Ζήτησε από τον πράκτορά σου (agent) να τη διερευνήσει με το REA. Μπορεί να εξετάσει την εφαρμογή χωρίς τον πηγαίο κώδικά της, να εξηγήσει πώς λειτουργεί η συγκεκριμένη δυνατότητα, να παρουσιάσει τα τεκμήρια και να υλοποιήσει μια αντίστοιχη έκδοση για το έργο σου.

Το REA συνδέει τον πράκτορά σου με εργαλεία εξέτασης δυαδικών αρχείων με κώδικα μηχανής, εφαρμογών JavaScript και Electron, assemblies .NET και ιστοτόπων. Μπορείς να χρησιμοποιήσεις τα ίδια εργαλεία και από το τερματικό. Η ανάλυση εκτελείται τοπικά και τα αποτελέσματα περιλαμβάνουν τα τεκμήρια και τους περιορισμούς στους οποίους βασίζεται κάθε συμπέρασμα.

Η διαδικασία εγκατάστασης καταχωρίζει το REA στον agent σου και εγκαθιστά τις αντίστοιχες οδηγίες εργασίας. Για ανάλυση κώδικα μηχανής μπορείς να χρησιμοποιήσεις μια υπάρχουσα εγκατάσταση του Hopper, του Ghidra, του IDA ή του Kuna. Η διαδικασία εγκατάστασης μπορεί επίσης να εγκαταστήσει το Hopper, εφόσον το εγκρίνεις. Η στατική ανάλυση JavaScript δεν χρειάζεται μηχανή ανάλυσης κώδικα μηχανής.

Επισκέψου τον ιστότοπο του REA για οδηγίες εγκατάστασης, εικονογραφημένους οδηγούς και πραγματικές μελέτες περίπτωσης.

Γρήγορη εκκίνηση

Στο Linux, η εκκίνηση Ghidra, JADX και εργαλείων firmware και η στατική ανάλυση JavaScript/Electron απαιτούν ps συμβατό με procps στο PATH του REA για έλεγχο ιδιοκτησίας διεργασιών. Δες την προϋπόθεση Linux.

Ρύθμιση του agent σου

Αφού εγκαταστήσεις το Node.js και το npm, εκτέλεσε:

npx rea-agents setup

Επίλεξε τους agents σου, έλεγξε τις προτεινόμενες αλλαγές και ενέκρινέ τες. Η διαδικασία προσθέτει τον MCP server του REA και τις αντίστοιχες οδηγίες εργασίας, κρατώντας αντίγραφα ασφαλείας των υφιστάμενων ρυθμίσεων. Στη συνέχεια, επανεκκίνησε τον agent σου.

Υποστηρίζονται τα Claude Code, Codex, Cursor, Gemini CLI, Grok Build και άλλοι agents. Για τη ρύθμιση των παρόχων ανάλυσης και τη μη αυτόματη καταχώριση MCP, δες τον οδηγό εγκατάστασης και ρύθμισης.

Το MCP χρησιμοποιεί συμπαγή σχήματα εισόδου από προεπιλογή. Για πλήρεις οδηγίες πεδίων και ένθετης επικύρωσης, όρισε REA_MCP_INPUT_SCHEMA_PROFILE=full στην καταχώριση MCP. Και τα δύο προφίλ διατηρούν όλα τα εργαλεία και την ίδια κανονική επικύρωση διακομιστή· δες τον οδηγό συμβολαίων MCP.

Η εγκατάσταση καταχωρίζει απευθείας τον επιλεγμένο runtime και το αρχικό script του REA. Αν χρησιμοποιείς package runner, διατήρησε την καταχώριση cache και τον runtime· απόκτησε το πακέτο από έμπιστο κατάλογο έξω από το έργο-στόχο. Δες τον οδηγό εγκατάστασης.

Τα πλήρη σχήματα εξόδου ανακοινώνονται από προεπιλογή. Αν ο client περιορίζει το tools/list, όρισε REA_MCP_OUTPUT_SCHEMA_PROFILE=compact ή off στην καταχώριση MCP. Η επικύρωση του διακομιστή και τα δομημένα αποτελέσματα παραμένουν πλήρη. Δες το «Output schemas» στον οδηγό συμβάσεων MCP.

Ζήτησε από τον agent σου

Διερεύνησε πώς λειτουργεί η αναζήτηση στην εφαρμογή Notes, δείξε μου τα τεκμήρια και υλοποίησε μια παρόμοια λειτουργία για το έργο μου.

Αντικατάστησε το Notes με την εφαρμογή που θέλεις να εξετάσεις και προσδιόρισε τη λειτουργία που θέλεις να κατανοήσεις.

Χρήση από το τερματικό

Εξέτασε τον αποσυμπιεσμένο φάκελο μιας εφαρμογής JavaScript/Electron ή ένα αρχείο ASAR:

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

Το αποτέλεσμα περιλαμβάνει modules, εισαγωγές, τα όρια μεταξύ των μερών της εφαρμογής Electron και τα αντίστοιχα τεκμήρια. Αντικατάστησε τη διαδρομή με τη δική σου, για παράδειγμα "D:/apps/example" στα Windows.

Για να εγκαταστήσεις την εντολή rea για τακτική χρήση:

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

Για ανάλυση κώδικα μηχανής, ρύθμισε πρώτα έναν πάροχο ανάλυσης. Ο οδηγός CLI και Evidence περιγράφει τις σχετικές εντολές, την επιλογή παρόχου, τα στιγμιότυπα και τη χρήση σε scripts.

Ενημέρωση του REA

Το REA εξελίσσεται γρήγορα και οι νέες εκδόσεις περιλαμβάνουν συχνές διορθώσεις σφαλμάτων. Διατήρησε την εγκατάστασή σου ενημερωμένη.

Για CLI εγκατεστημένο με npm install --global ή bun add --global:

rea update

Το rea --update είναι συνώνυμο του rea update με τις ίδιες καθολικές επιλογές εξόδου. Οι εντολές ενημέρωσης διατηρούν συνολικά έως 4 MiB stdout/stderr. Υπερμεγέθη μεταδεδομένα απορρίπτονται μετά την έξοδο· οι αναλυτικές εγκαταστάσεις κρατούν περιορισμένα διαγνωστικά. Η πρόοδος σέβεται την αντίθλιψη του τερματικού και περιμένει τις υποβληθείσες εγγραφές.

Οι ενημερώσεις καθολικής εγκατάστασης με Bun απαιτούν Bun 1.2.17 ή νεότερο. Αν χρησιμοποιείς παλαιότερη έκδοση, αναβάθμισε το Bun χειροκίνητα πριν εκτελέσεις το rea update.

Για να ανανεώσεις τις καταχωρίσεις των agents και το skill, εκτέλεσε την εντολή ρύθμισης που εμφανίζει η ενημέρωση.

Αν χρησιμοποιείς npx, ενημέρωσε τη ρύθμιση του agent με:

npx rea-agents@latest setup

Έλεγξε τις αλλαγές και επανεκκίνησε τον agent σου. Για μεμονωμένες εντολές CLI, χρησιμοποίησε npx rea-agents@latest και στη συνέχεια την εντολή που θέλεις. Με Bun, χρησιμοποίησε bunx rea-agents@latest αντί για npx rea-agents@latest.

Πώς λειτουργεί το REA

Ο agent σου καλεί το REA μέσω MCP για να εξετάσει τον στόχο και να ακολουθήσει τον σχετικό κώδικα. Το REA επιστρέφει ευρήματα μαζί με τα τεκμήριά τους. Ο agent τα χρησιμοποιεί για να θέσει πρόσθετες ερωτήσεις, να εξηγήσει τη συμπεριφορά ή να γράψει και να δοκιμάσει μια υλοποίηση. Οι εντολές CLI χρησιμοποιούν τις ίδιες ροές εργασίας.

Άνοιγμα του διαγράμματος σε πλήρες μέγεθος.

Τι μπορείς να αναλύσεις

Το REA απαιτεί Node.js 22.x (>=22.23.4), 24.x (>=24.22.1) ή 26+ (>=26.12.1), καθώς και npm. Τα πρόσθετα εργαλεία και τα υποστηριζόμενα συστήματα εξαρτώνται από τον στόχο:

Στόχος	Τι επιστρέφει το REA	Απαιτήσεις και οδηγός
Δυαδικά αρχεία με κώδικα μηχανής	Ψευδοκώδικα, κώδικα assembly, συμβολοσειρές, σύμβολα, κλήσεις και αναφορές	Hopper, Ghidra, IDA ή Kuna· ανάλυση κώδικα μηχανής
Δομή ELF χωρίς εκτέλεση	Ενότητες, τμήματα, αρχικά σύμβολα/εγγραφές μετεγκατάστασης και ενδείξεις πιθανών μέτρων προστασίας από στατική ανάλυση	pwntools που παρέχει ο χρήστης σε Linux x64· διαγνωστικά δυαδικών αρχείων
Δυαδικά αρχεία Go	Ενσωματωμένη έκδοση μεταγλωττιστή, modules, αντικαταστάσεις και ρυθμίσεις μεταγλώττισης	Ενσωματωμένη στατική εξέταση ELF/PE/thin Mach-O· δεν απαιτείται εγκατάσταση του Go
Δυαδικά αρχεία Rust	Ενσωματωμένα ονόματα, εκδόσεις, πηγές και σχέσεις εξάρτησης των crates από το cargo-auditable	Ενσωματωμένη στατική εξέταση ELF/PE/thin Mach-O· δυαδικά αρχεία Rust
PE certificates	Authenticode WIN_CERTIFICATE entries and PKCS#7 signer/X.509 identity fields	Built-in static PE inspection; PE certificates
PE imports	Import and delay-load DLL names, ordinals, IAT RVAs and pefile import hash	Built-in static PE inspection; PE imports
Windows shortcuts	Shell Link target, arguments, working dir, ExtraData and Tracker droid facts	Built-in static LNK inspection; Windows shortcuts
ELF notes	PT_NOTE/SHT_NOTE owners, types, GNU build-id and ABI-tag fields	Built-in static ELF inspection; ELF notes
Binary hardening	PIE, NX, RELRO, CFG and related header flags for ELF, PE and Mach-O	Built-in static header inspection; binary hardening
Apple IPS crashes	.ips metadata, threads, images, registers and crash classes	Built-in static JSON inspection; Apple IPS
Linux kernel modules	.modinfo keys, __versions CRCs, this_module presence, and signature trailer	Built-in static ELF inspection; kernel modules
Erlang BEAM	IFF chunks, atoms, exports, and tables	Built-in static BEAM inspection; Erlang BEAM
Αρχείο WASM	Έλεγχο εγκυρότητας, ενότητες, ακριβείς μορφές εισαγωγών/εξαγωγών σε WAT και αποκωδικοποιημένο WAT	WABT 1.0.42 που παρέχει ο χρήστης· inspect_wasm_artifact
Bytecode EVM	Selectors επιλογής συνάρτησης, μετατοπίσεις σε bytes, εκτιμώμενα ορίσματα και δυνατότητα μεταβολής της κατάστασης	Τοπική είσοδος σε ακατέργαστα bytes ή δεκαεξαδική μορφή σε Linux x64· οδηγός EVM χωρίς εκτέλεση
Βάσεις δεδομένων SQLite	Πίνακες, στήλες, ευρετήρια, όψεις, triggers και επιλεγμένες γραμμές κανονικών πινάκων	Τοπικό στιγμιότυπο βάσης δεδομένων/WAL· Node.js 24.x >=24.15 ή 26+ με εγγενή όρια SQLite
Καταγεγραμμένες καταρρεύσεις στο Linux	Ακατέργαστες εγγραφές notes, καταχωρητές/σήματα κάθε καταγεγραμμένου νήματος και προαιρετικές πιθανές αντιστοιχίσεις μνήμης	pwntools που παρέχει ο χρήστης σε Linux x64· προαιρετικά GDB/pwndbg· καταγεγραμμένες καταρρεύσεις
Εγκαταστάσεις επιφάνειας εργασίας	Υποψήφια περιβάλλοντα εκτέλεσης, αρχεία τεκμηρίωσης, στοιχεία και επόμενα βήματα	Περιορισμένη επιθεώρηση καταλόγων και κεφαλίδων；Εφαρμογές επιφάνειας εργασίας
JavaScript / Electron	Modules, εισαγωγές, source maps, διαδρομές, IPC και σχέσεις με πρόσθετα κώδικα μηχανής	Node.js και npm· ανάλυση εφαρμογών; Linux: procps ps
Ιστότοποι	Δομή σελίδων, scripts, παρατηρήσεις δικτύου και ζητούμενα στιγμιότυπα οθόνης	Πρόγραμμα περιήγησης της οικογένειας Chrome· ανάλυση μέσω προγράμματος περιήγησης
Αποθηκευμένες καταγραφές δικτύου	Αιτήματα, αποκρίσεις, διαθέσιμα δεδομένα φορτίου και θέσεις στην πηγή	HAR ή SAZ του Fiddler Everywhere· mitmdump σε Linux για την εγγενή μορφή mitmproxy· οδηγός καταγραφών
Assemblies .NET	Μεταδεδομένα, εντολές CIL, δηλωμένες εξαρτήσεις από κώδικα μηχανής και συγκρίσεις builds	Καμία πρόσθετη απαίτηση (μόνο στατική ανάλυση)· οδηγός διαχειριζόμενου κώδικα
PyInstaller	CArchive, PYZ, Python bytecode	Static inspection; Python packaged applications
Deno compile binaries	Virtual files, entry point, recorded options, npm snapshot length	Static inspection; Deno compile executables
APK Android	Δηλώσεις manifest, κλάσεις, απομεταγλωττισμένες μέθοδοι και αναφορές	JADX χωρίς γραφικό περιβάλλον και πλήρες JDK σε Linux/macOS/Windows x64· οδηγός Android
Συσκευές Android	Συσκευές, πακέτα, διεργασίες, logs, dumps, στιγμιότυπα οθόνης και μεταφορές APK/αρχείων	adb που παρέχει ο χρήστης (εξομοιωτής ή φυσική συσκευή)· οδηγός ADB
Έργα JEB	Μονάδες έργου από τη μηχανή ανάλυσης, ψηφιακά αποτυπώματα αρχείων και ψευδοκώδικα τύπων/μεθόδων	Client JEB που έχει ξεκινήσει ο χρήστης και παρέχει MCP, επιλεγμένος μέσω REA_JEB_MCP_URL· οδηγός JEB
Πόροι Android	Αποκωδικοποιημένο manifest, πίνακες συμβολοσειρών, τοπικές ρυθμίσεις και στοιχεία έκδοσης	Launcher του Apktool που παρέχει ο χρήστης· οδηγός πόρων
Εφαρμογές Flutter	Hash του στιγμιότυπου Dart, ψηφιακά αποτυπώματα βιβλιοθηκών ανά ABI και στοιχεία προέλευσης του build της μηχανής	Καμία πρόσθετη απαίτηση (στατική ανάλυση APK)· οδηγός Flutter
Firmware	Περιοχές, αποτελέσματα εξαγωγής και παραπομπές για ανάλυση κώδικα μηχανής	Binwalk / Unblob σε Linux· οδηγός firmware
Καταγεγραμμένα πακέτα	Επιλεγμένα πεδία, επαναλαμβανόμενες τιμές, φίλτρα και κανόνες decode-as	Linux: TShark 4.x + prlimit· οδηγός καταγραφών
Σύνοψη πακέτων	Τερματικά σημεία, DNS, TLS SNI, κατανομή πρωτοκόλλων και αιτήματα HTTP	tshark και capinfos που παρέχει ο χρήστης (επαληθευμένα σε Linux)· οδηγός pcap
Καταγεγραμμένα λογικά σήματα	Σχολιασμούς αποκωδικοποιητή, εύρη δειγμάτων και διαγνωστικά	Linux: sigrok-cli 0.7.2 + prlimit· καταγραφές σημάτων
Πακέτα και πόροι	Καταλόγους αρχείων, ψηφιακά αποτυπώματα, plists, δομή bundles της Apple και εξαγόμενους πόρους	Οδηγός αρχείων και JavaScript, εφαρμογές Apple
Συμπεριφορά διεργασιών	Έξοδο τερματικού, αλληλεπιδράσεις, παρατηρήσεις τερματισμού και συστήματος αρχείων, καθώς και συγκρίσεις εκτελέσεων	Linux/macOS με εγγενές PTY· καταγραφή διεργασιών
Αντικείμενα κώδικα GPU	Στόχοι CUDA/HIP, παράμετροι και πόροι επιλεγμένων kernels, διατηρημένο κείμενο PTX	Ενσωματωμένη στατική επιθεώρηση ELF/PE/fatbin/CUBIN/PTX; GPU
Αρχεία μοντέλων	Μεταδεδομένα GGUF / safetensors, δηλώσεις tensors και παράγωγα σύνολα	Επιθεώρηση κεφαλίδων· προαιρετικό hash ολόκληρου αρχείου; GGUF / safetensors
Μεταδεδομένα IL2CPP	Εικόνες assemblies Unity global-metadata.dat, ονόματα τύπων/μεθόδων και εύρη δεικτών	Στατική αποκωδικοποίηση εκδόσεων 24, 27, 29, 31, 39· χωρίς Unity
Godot PCK	Απογραφή και εξαγωγή αρχείου, αρχικές κεφαλίδες/κατάλογοι και ταυτότητες επιλεγμένου περιεχομένου	Στατικές μορφές 2, 3, 4· χωρίς Godot
Υπογραφές APK	Υπογράφοντες v1/v2/v3/v3.1, αποτυπώματα πιστοποιητικών, εναλλαγή κλειδιών και εσωτερική συνέπεια digests	Ενσωματωμένη στατική επιθεώρηση; inspect_apk_signature

Για εξέταση δυαδικών αρχείων με κώδικα μηχανής χωρίς εκτέλεση, το REA υποστηρίζει επίσης GNU objdump και Rizin που παρέχει ο χρήστης. Δες τον οδηγό εργαλείων αντίστροφης μηχανικής για τη ρύθμιση των παρόχων, τις εντολές CLI και τους περιορισμούς των Evidence. Το REA δεν εγκαθιστά ούτε ενημερώνει κανέναν από τους δύο παρόχους.

Η στατική εξέταση JavaScript και .NET διαβάζει τα αρχεία που παρέχονται χωρίς να εκτελεί την εφαρμογή. Η καταγραφή κατά την εκτέλεση εκτελεί τον επιλεγμένο στόχο ή αλληλεπιδρά μαζί του με τα δικαιώματα του χρήστη σου. Κάθε σχετικός οδηγός περιγράφει τις επιπτώσεις της.

Οι μορφές κώδικα μηχανής και τα υποστηριζόμενα συστήματα διαφέρουν ανά πάροχο ανάλυσης. Δες τη ρύθμιση Hopper και Ghidra, τον οδηγό IDA (που περιλαμβάνει προαιρετική γέφυρα MCP για κώδικα μηχανής), Kuna και την πειραματική υποστήριξη Ghidra στα Windows. Το Ghidra υποστηρίζει επίσης ανάλυση DOS 16 bit. Για μεγάλα δυαδικά αρχεία, αύξησε το χρονικό όριο εκκίνησης του παρόχου με REA_GHIDRA_STARTUP_TIMEOUT_MS ή REA_HOPPER_STARTUP_TIMEOUT_MS. Για την επιλογή παρόχου, δες τον οδηγό CLI. Έλεγξε τη διαθεσιμότητα ανά έκδοση για λειτουργίες που προστέθηκαν μετά την τελευταία έκδοση στο npm.

Μελέτες περίπτωσης

DX-Ball: ανακατασκευή υπολογισμού στερεοφωνικής τοποθέτησης ήχου

Ακολούθησε μια κλήση ήχου μέχρι τη βοηθητική συνάρτηση που μετατρέπει τη θέση σε στερεοφωνική τοποθέτηση, εξέτασε τις εντολές και μετέτρεψε τον ελλιπή ψευδοκώδικα σε C. Η ανακατασκευή περνά 3.205 δοκιμές με τον αρχικό κώδικα x86 και αναπαράγει και τα 63 bytes της μεταγλωττισμένης συνάρτησης.

Διάβασε τη μελέτη περίπτωσης · Αποθετήριο ανακατασκευής

Notion: ιχνηλάτηση της γέφυρας προχείρου στο Electron

Βρες το API προχείρου του renderer, ακολούθησέ το μέσω του preload και του IPC μέχρι την κύρια διεργασία και εξέτασε τη μορφή εμπλουτισμένου περιεχομένου του προχείρου.

Διάβασε τη μελέτη περίπτωσης

TH04: ανάκτηση υπολογισμού δακτυλίου βλημάτων σε DOS

Εξέτασε τις εντολές 16 bit του αρχικού παιχνιδιού για PC-98, ανέκτησε τους υπολογισμούς σταθερών γωνιών και γωνιών στόχευσης και σύγκρινε τον ανακατασκευασμένο κώδικα C++ με την έξοδο του μεταγλωττιστή της εποχής.

Διάβασε τη μελέτη περίπτωσης · Αποθετήριο ανακατασκευής

Δημιουργία περιβαλλόντων RL με το REA

Καταγράψτε μια συνεδρία εφαρμογής ιστού, μετατρέψτε το API της σε εργαλεία και εξαγάγετε ένα περιβάλλον για πράκτορα AI. Εκτελέστε το με το AgentEnv και προσθέστε εργασίες και ελέγχους ανταμοιβής για εκπαίδευση RL ή αξιολόγηση.

Οδηγός δημιουργίας περιβάλλοντος · Δείτε το demo στο X

Αν χρησιμοποίησες το REA για κάτι ενδιαφέρον, θα θέλαμε να το δούμε. Μοιράσου τη μελέτη σου σε ένα issue ή pull request, αναφέροντας τον στόχο, το ερώτημά σου, πώς βοήθησε το REA και τι ανακάλυψες.

Δημιουργία περιβαλλόντων RL

Δημιουργήστε ένα τοπικό περιβάλλον όπου ένας πράκτορας AI εξασκείται σε εργασίες όπως η εύρεση ενός issue ή η δημιουργία φακέλου, χωρίς να εκτελείται η αρχική εφαρμογή. Χρησιμοποιήστε το για ενισχυτική μάθηση (RL) ή για να ελέγξετε πόσο καλά ολοκληρώνει εργασίες ο πράκτορας.

Το REA μετατρέπει καταγεγραμμένα αιτήματα και απαντήσεις API σε εργαλεία που μπορεί να καλεί ο πράκτορας. Το περιβάλλον χρησιμοποιεί τα καταγεγραμμένα δεδομένα και υποστηρίζει αλλαγές μόνο όταν η καταγραφή επιβεβαιώνει τα αποτελέσματά τους.

Ρυθμίστε το REA στον πράκτορά σας και προσαρμόστε το URL και τις εργασίες φακέλων του παραδείγματος:

Χρησιμοποίησε το REA για να δημιουργήσεις περιβάλλον RL από τη δοκιμαστική εφαρμογή μου:
http://127.0.0.1:3000
Κάλυψε προβολή, δημιουργία, μετονομασία και διαγραφή φακέλων. Μπορείς να δημιουργείς
και να αφαιρείς δοκιμαστικούς φακέλους, αλλά μην αλλάξεις τα υπάρχοντα δεδομένα.
Αποθήκευσέ το σε φάκελο my-env, έλεγξε τις διαθέσιμες λειτουργίες και πες μου πώς εκτελείται.

Χρήση της γραμμής εντολών

Χρησιμοποιήστε αυτές τις εντολές αν έχετε ήδη αρχείο με τα καταγεγραμμένα αιτήματα και τις απαντήσεις της εφαρμογής στο πρόγραμμα περιήγησης. Η εκτέλεση χρειάζεται επίσης AgentEnv και Docker.

rea environment-build ./session.har ./my-env --name my-env --json
agent-env run ./my-env

Το REA εξάγει ένα εκτελέσιμο περιβάλλον με μια βασική δοκιμή εκκίνησης και απόκρισης. Συνδέστε το στο πλαίσιο RL για να ορίσετε στόχους, να προσθέσετε ελέγχους ανταμοιβής και να εκτελέσετε εκπαίδευση.

Οδηγός δημιουργίας περιβάλλοντος · Αναφορά περιβαλλόντων · Δείτε το demo στο X

Περιβάλλοντα εφαρμογών επιφάνειας εργασίας

Το REA μπορεί επίσης να δημιουργήσει περιβάλλον για μια εφαρμογή επιφάνειας εργασίας Linux, την οποία ο πράκτορας χρησιμοποιεί μέσω στιγμιότυπων οθόνης, ποντικιού και πληκτρολογίου. Από ένα αίτημα μίας γραμμής, όπως «Φτιάξε μου ένα περιβάλλον Gnote όπου ο πράκτορας προσθέτει ελαιόλαδο στη σημείωση με τη λίστα αγορών», ο πράκτοράς σας εγκαθιστά την εφαρμογή σε έναν τοπικό υπολογιστή κατασκευής, γράφει την εργασία, εξάγει το περιβάλλον και ελέγχει την εργασία σε έναν νέο υπολογιστή. Ο υπολογιστής που το κατασκευάζει χρειάζεται Linux σε amd64 ή arm64, Docker και την έκδοση του πλαισίου agentenv που ορίζει ο οδηγός.

Ρύθμιση περιβαλλόντων εφαρμογών επιφάνειας εργασίας

Συχνές ερωτήσεις

Ποιοι agents μπορούν να χρησιμοποιήσουν το REA;

Κάθε agent που υποστηρίζει τοπικούς MCP servers. Η διαδικασία εγκατάστασης ρυθμίζει τους υποστηριζόμενους agents. Οι υπόλοιποι clients μπορούν να χρησιμοποιήσουν τη μη αυτόματη καταχώριση MCP.

Χρειάζομαι Hopper, Ghidra, IDA ή Kuna;

Η εις βάθος ανάλυση κώδικα μηχανής χρησιμοποιεί ένα από αυτά. Η στατική εξέταση JavaScript και .NET λειτουργεί χωρίς μηχανή ανάλυσης κώδικα μηχανής. Η διαδικασία εγκατάστασης μπορεί να εγκαταστήσει το Hopper μετά την έγκρισή σου· το Ghidra, το IDA και το Kuna χρησιμοποιούν τις υπάρχουσες εγκαταστάσεις σου. Δες τη ρύθμιση παρόχων ανάλυσης.

Πρέπει να ξεκινήσω πρώτα το Hopper;

Το REA ξεκινά το Hopper όταν το χρειάζεται κάποια λειτουργία. Στο macOS, κατά την πρώτη εκκίνηση μπορεί να εμφανιστεί παράθυρο που ζητά να επιλέξεις τη δοκιμαστική λειτουργία ή να ενεργοποιήσεις την άδειά σου. Ολοκλήρωσε αυτό το βήμα στην ίδια συνεδρία χρήστη πριν από την πρώτη λειτουργία CLI/MCP ή εργασία χωρίς επίβλεψη. Άνοιξε το Hopper χειροκίνητα αν χρειαστεί. Δες την εκκίνηση και αντιμετώπιση προβλημάτων του Hopper.

Τι προσφέρει η εγκατάσταση του skill από το skills.sh;

Το skill παρέχει οδηγίες διερεύνησης για τον agent σου. Χρησιμοποίησε npx rea-agents setup για να καταχωρίσεις τον MCP server του REA και να εγκαταστήσεις τις αντίστοιχες οδηγίες. Στη συνέχεια, επανεκκίνησε τον agent σου. Δες την εγκατάσταση μόνο του skill.

Τι κώδικα επιστρέφει το REA;

Η ανάλυση κώδικα μηχανής επιστρέφει ψευδοκώδικα και assembly. Η ανάλυση JavaScript/Electron ανακτά modules και τις σχέσεις τους. Ο agent σου χρησιμοποιεί αυτά τα ευρήματα για να γράψει και να δοκιμάσει μια υλοποίηση. Οι μελέτες περίπτωσης παρουσιάζουν ολοκληρωμένα παραδείγματα.

Το REA ανεβάζει την εφαρμογή μου στο διαδίκτυο;

Το REA αναλύει τους στόχους τοπικά. Ο agent σου λαμβάνει τα αποτελέσματα των εργαλείων και ο πάροχος του μοντέλου του έχει τη δική του πολιτική δεδομένων.

Τι να κάνω αν συναντήσω κάποιο σφάλμα;

Κάνε πρώτα ενημέρωση· μια πρόσφατη έκδοση μπορεί να το έχει ήδη διορθώσει.

Για CLI εγκατεστημένο με npm install --global ή bun add --global:

rea update

Για ρύθμιση agent μέσω npx:

npx rea-agents@latest setup

Αν χρησιμοποιείς agent, ολοκλήρωσε την ανανέωση της ρύθμισης και επανεκκίνησέ τον. Δοκίμασε ξανά την ίδια εργασία. Αν το πρόβλημα παραμένει, άνοιξε ένα issue με την έκδοση του REA, τον τύπο του στόχου, τα βήματα αναπαραγωγής και την έξοδο του σφάλματος.

Τεκμηρίωση

Ξεκίνα από τους οδηγούς με ολοκληρωμένα παραδείγματα στον ιστότοπο. Για τις ακριβείς επιλογές, τις προϋποθέσεις και τις προδιαγραφές των αποτελεσμάτων:

• Εγκατάσταση και ρύθμιση: καταχώριση agents, ρύθμιση παρόχων ανάλυσης, ενημερώσεις και απεγκατάσταση.
• Έλεγχος ετοιμότητας και αντιμετώπιση προβλημάτων: διάγνωση ενός agent ή μιας μηχανής ανάλυσης.
• CLI και Evidence: εντολές, επιλογή παρόχου, στιγμιότυπα, εισαγωγή/εξαγωγή και κωδικοί εξόδου.
• Προδιαγραφές MCP και prompts για agents: αποτελέσματα εργαλείων, συνεδρίες και καθοδηγούμενες διερευνήσεις.
• Κατάλογος εργαλείων: αυτόματα παραγόμενος κατάλογος εργαλείων, παρόχων και εντολών CLI.
• Οδικός χάρτης: προγραμματισμένες εργασίες και παρακολούθηση της ανάπτυξης δυνατοτήτων.

Ανάφερε ευπάθειες ακολουθώντας το SECURITY.md.

Ιστορικό αστεριών

🎉 400.000 αστέρια στο GitHub — σας ευχαριστούμε!

Ευχαριστούμε όλους όσοι χρησιμοποιούν το REA, αναφέρουν σφάλματα, ζητούν νέες λειτουργίες, δοκιμάζουν builds και συνεισφέρουν διορθώσεις.

Αποποίηση ευθύνης

Δες το DISCLAIMER.md για οδηγίες υπεύθυνης χρήσης.

Η θέση του έργου σχετικά με την παράνομη ή μη εξουσιοδοτημένη χρήση ισχύει για όλες τις εκδόσεις του REA, τα κανάλια διανομής και τις πλατφόρμες. Κάθε αντίγραφο διατηρεί τις άδειες που το διέπουν.

Το REA προορίζεται για νόμιμη έρευνα, εκπαίδευση, διαλειτουργικότητα, διατήρηση λογισμικού και ανάλυση λογισμικού που σου ανήκει ή για το οποίο έχεις άδεια εξέτασης.

Συνεισφορά

Θα χαρούμε να βοηθήσεις στο REA! Άνοιξε ένα issue για να αναφέρεις ένα σφάλμα ή να προτείνεις μια λειτουργία, ή στείλε ένα pull request για να βελτιώσεις τον κώδικα ή την τεκμηρίωση.

Δες το CONTRIBUTING.md για τη ρύθμιση του περιβάλλοντος ανάπτυξης και τους ελέγχους, τον οδηγό δοκιμών για τις διαδικασίες επαλήθευσης και τον χάρτη αρχιτεκτονικής για τη δομή του έργου.

Άδεια χρήσης

MIT

Ο κώδικας που έχει δημιουργηθεί για το REA διατίθεται με την άδεια MIT. Το υλικό τρίτων διατηρεί τις δικές του άδειες και δηλώσεις πνευματικών δικαιωμάτων. Δες τις δηλώσεις για υλικό τρίτων για τον κατάλογο εξαρτήσεων, τα διατηρημένα κείμενα αδειών και τους όρους των εξωτερικών εργαλείων.

Πρέπει να αποκτήσεις νόμιμα τα εμπορικά εργαλεία και να έχεις δικαίωμα χρήσης τους, συμπεριλαμβανομένων των IDA Pro / Hex-Rays decompilers, Hopper και JEB, σύμφωνα με τις αντίστοιχες άδειές τους. Το REA δεν παρέχει άδεια εργαλείου, κλειδί ή δικαίωμα ενεργοποίησης. Οι δοκιμαστικές εκδόσεις και τα demos εξακολουθούν να υπόκεινται στους όρους του προμηθευτή, συμπεριλαμβανομένων των περιορισμών χρήστη, λειτουργιών, αυτοματοποίησης και κοινοποίησης αποτελεσμάτων. Δεν επιτρέπονται σπασμένες εκδόσεις, κλεμμένα κλειδιά, μη εξουσιοδοτημένη κοινοποίηση κλειδιών ή παράκαμψη περιορισμών αδειοδότησης. Αυτές οι οδηγίες δεν τροποποιούν την άδεια MIT ή τις άδειες τρίτων.