Files
reverse-engineering-anything/docs/readme/README_ro.md
T

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

Un singur server MCP pentru inginerie inversă: fișiere binare, aplicații și comportament în timpul execuției.

Ai găsit o funcționalitate care îți place? Înțelege cum funcționează, până la nivel de cod binar.

GitHub stars Monthly npm downloads Licența MIT Join the REA Discord Follow REA on X Supported platforms: macOS, Windows, and Linux skills.sh

Site web · Ghiduri · Studii de caz

Alătură-te comunității REA pe Discord

Pornire rapidă · Studii de caz · Cum funcționează REA · Ce poți analiza · Construiește medii RL · Întrebări frecvente · Documentație

npx rea-agents setup

Important

Descarcă REA din morluto/rea, de pe rea.tools sau prin pachetul npm rea-agents. Urmează linkurile de instalare și către versiunile publicate oferite de aceste surse oficiale. Un nume de repository asemănător sau un README copiat nu dovedește că descărcarea provine dintr-o sursă oficială.


REA pornește componenta de legătură pentru analiză în Hopper în timp ce inspectează un fișier binar nativ



Discord
Alătură-te comunității de inginerie inversă

Discord · Întrebări și răspunsuri · Prezentări și demonstrații


Ai văzut într-o aplicație o funcționalitate pe care ai vrea să o incluzi în propriul produs? Cere-i agentului tău să o investigheze cu REA. Poate inspecta aplicația fără codul ei sursă, poate explica modul în care funcționează acea funcționalitate, poate prezenta dovezile și poate construi o variantă pentru proiectul tău.

REA conectează agentul tău la unelte pentru inspectarea fișierelor binare native, a aplicațiilor JavaScript și Electron, a ansamblurilor .NET și a site-urilor web. Poți folosi aceleași unelte și din terminal. Analiza rulează local, iar rezultatele includ dovezile și limitările care stau la baza fiecărei concluzii.

Programul de configurare înregistrează REA în agentul tău și instalează instrucțiunile corespunzătoare pentru fluxul de lucru. Analiza nativă poate folosi o instalare existentă de Hopper, Ghidra, IDA sau Kuna; programul de configurare poate instala opțional Hopper, cu aprobarea ta. Analiza statică JavaScript nu necesită un motor de analiză nativă.

Pornire rapidă

Pornire rapidă · rea.tools

Configurează agentul (MCP)

După ce instalezi Node.js și npm, rulează comanda dintr-un director de încredere aflat în afara proiectului de analizat.

npx rea-agents setup

Alege agenții, verifică modificările propuse și aprobă-le. Configurarea adaugă serverul MCP REA și instrucțiunile corespunzătoare pentru fluxul de lucru, creând copii de siguranță ale configurației existente. Repornește apoi agentul.

instalarea și configurarea

Cere-i agentului:

Înțelege cum funcționează căutarea în aplicația Notes, arată-mi dovezile și
construiește o funcționalitate similară pentru proiectul meu.

Înlocuiește Notes cu aplicația vizată și precizează funcționalitatea pe care vrei să o înțelegi.

Folosește terminalul (CLI)

Inspectează directorul extras al unei aplicații JavaScript/Electron sau o arhivă ASAR:

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

Rezultatul include modulele, importurile, delimitările dintre componentele Electron și dovezile aferente. Înlocuiește calea cu cea a aplicației vizate, de exemplu "D:/apps/example" pe Windows.

Pentru a instala comanda rea și a o folosi în mod curent:

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

Pentru analiza nativă, configurează mai întâi un motor de analiză. Consultă ghidul CLI și Evidence pentru comenzile de analiză nativă, selectarea motorului, instantanee și utilizarea în scripturi.

Cerințe pentru Linux

Actualizează REA

Pentru o interfață CLI instalată cu npm install --global sau bun add --global:

rea update

Dacă folosești npx, actualizează configurarea agentului cu:

npx rea-agents@latest setup

Actualizare și dezinstalare

Studii de caz

Ilustrații pentru studiile de caz despre panoramarea sunetului în DX-Ball, legătura cu clipboardul în Notion și inelele de proiectile din TH04

DX-Ball: reconstruiește calculul panoramării sunetului

Urmărește un apel audio până la funcția auxiliară care transformă poziția în panoramare stereo, inspectează instrucțiunile și transformă pseudocodul incomplet în C. Reconstrucția trece 3.205 cazuri de test comparate cu originalul x86 și reproduce toți cei 63 de octeți ai funcției compilate.

Citește studiul de caz · Repository-ul reconstrucției

Notion: urmărește legătura Electron cu clipboardul

Găsește API-ul pentru clipboard din procesul de randare, urmărește-l prin preload și IPC până în procesul principal și inspectează formatul datelor cu formatare din clipboard.

Citește studiul de caz

TH04: recuperează calculul unui inel de proiectile DOS

Inspectează instrucțiunile pe 16 biți ale jocului original pentru PC-98, recuperează calculele unghiurilor fixe și ale celor orientate spre țintă și compară codul C++ reconstruit cu rezultatul compilatorului folosit la acea vreme.

Citește studiul de caz · Repository-ul reconstrucției

Dacă ai folosit REA pentru ceva interesant, ne-ar plăcea să vedem rezultatul. Prezintă cazul într-un issue sau într-un pull request, menționând ținta analizată, întrebarea ta, cum te-a ajutat REA și ce ai descoperit.

Cum funcționează REA

Agentul tău apelează REA prin MCP pentru a inspecta ținta și a urmări codul relevant. REA returnează constatările împreună cu dovezile aferente. Agentul le folosește pentru a pune întrebări suplimentare, a explica comportamentul sau a scrie și testa o implementare. Comenzile CLI folosesc aceleași fluxuri de lucru.

Fluxul unei investigații REA: agentul întreabă despre o țintă locală, REA o inspectează și îi urmărește comportamentul cu ajutorul uneltelor de analiză, iar agentul folosește codul, referințele și necunoscutele returnate pentru a explica, implementa și testa.

Deschide figura la dimensiunea originală.

Ce poți analiza

Fișiere binare native · JavaScript / Electron · Site-uri web · Ansambluri .NET · APK-uri Android · Firmware · Comportamentul proceselor

Formate acceptate și cerințe

Alegerea unui furnizor de analiză

Construiește medii RL

Creează un mediu local dintr-o sesiune web înregistrată sau dintr-o aplicație desktop Linux, în care un agent poate exersa o sarcină și verifica rezultatul.

Construiește medii RL

Întrebări frecvente

Ce agenți pot folosi REA?

Orice agent care acceptă servere MCP locale. Programul de configurare pregătește agenții acceptați; pentru ceilalți clienți poți folosi înregistrarea manuală MCP.

Am nevoie de Hopper, Ghidra, IDA sau Kuna?

Analiza nativă aprofundată folosește unul dintre aceste instrumente. Inspectarea statică JavaScript și .NET funcționează fără un motor de analiză nativă. Programul de configurare poate instala Hopper după aprobare; pentru Ghidra, IDA și Kuna folosește instalările existente. Consultă configurarea motoarelor de analiză.

Trebuie să pornesc mai întâi Hopper?

REA pornește Hopper când o operație are nevoie de el. Pe macOS, un dialog afișat la prima pornire îți poate cere să alegi modul demonstrativ sau să activezi licența. Finalizează acel pas în aceeași sesiune de utilizator înainte de prima operație CLI/MCP sau de prima sarcină nesupravegheată. Deschide Hopper manual dacă este nevoie. Consultă pornirea Hopper și depanarea.

Ce face instalarea skill-ului de pe skills.sh?

Skill-ul oferă agentului instrucțiuni de investigare. Folosește npx rea-agents setup pentru a înregistra serverul MCP REA și a instala instrucțiunile corespunzătoare, apoi repornește agentul. Consultă instalarea doar a skill-ului.

Ce cod returnează REA?

Analiza nativă returnează pseudocod și cod de asamblare. Analiza JavaScript/Electron recuperează modulele și relațiile dintre ele. Agentul tău folosește aceste constatări pentru a scrie și testa o implementare; studiile de caz oferă exemple detaliate.

REA îmi încarcă aplicația pe un server?

REA analizează țintele local. Agentul tău primește rezultatele uneltelor, iar furnizorul modelului său are propria politică privind datele.

Ce fac dacă întâlnesc o eroare?

Actualizează mai întâi; o versiune recentă ar putea să o fi remediat deja.

Pentru o interfață CLI instalată cu npm install --global sau bun add --global:

rea update

Pentru configurarea agentului prin npx:

npx rea-agents@latest setup

Dacă folosești un agent, finalizează actualizarea configurării și repornește-l. Reîncearcă aceeași sarcină. Dacă problema persistă, deschide un issue și include versiunea REA, tipul țintei analizate, pașii de reproducere și mesajele de eroare.

Documentație

Începe cu ghidurile practice de pe site. Pentru opțiunile exacte, cerințele preliminare și contractele rezultatelor:

Raportează vulnerabilitățile conform SECURITY.md.

Comunitate și asistență

  • Discord — Pune întrebări și discută ce investighezi cu peste 50.000 de oameni pasionați de inginerie inversă și de construirea de proiecte! Discord
  • Twitter / X — Urmărește @reatools pentru noutăți.
  • Sugestii și idei — Îți dorești o funcție sau suport pentru un format de fișier? Scrie-ne pe GitHub sau Discord.

Istoricul stelelor

🎉 400.000 de stele pe GitHub — vă mulțumim!

Mulțumim tuturor celor care folosesc REA, raportează erori, propun funcționalități, testează versiuni și contribuie cu remedieri.

Colaboratorii REA Istoricul stelelor REA pe GitHub

Contribuții

Ne-ar bucura să contribui la REA! Deschide un issue pentru a raporta o eroare sau a propune o funcționalitate ori trimite un pull request pentru a îmbunătăți codul sau documentația.

Consultă CONTRIBUTING.md pentru pregătirea mediului de dezvoltare și verificări, ghidul de testare pentru categoriile de verificări.

Precizări privind utilizarea

Consultă DISCLAIMER.md pentru îndrumări privind utilizarea responsabilă.

Poziția proiectului față de utilizarea ilegală sau neautorizată se aplică tuturor versiunilor REA, canalelor de distribuție și platformelor; fiecare copie își păstrează licențele aplicabile.

REA este destinat cercetării legale, educației, interoperabilității, conservării software-ului și analizei programelor pe care le deții sau pe care ai autorizarea să le examinezi.

Licență

MIT

Codul scris în cadrul REA este licențiat sub MIT. Materialele terților își păstrează propriile licențe și mențiuni privind drepturile de autor; consultă mențiunile privind terții pentru inventarul dependențelor, textele licențelor păstrate și condițiile aplicabile uneltelor externe.

Trebuie să obții legal uneltele comerciale și să ai dreptul să le folosești, inclusiv decompilatoarele IDA Pro / Hex-Rays, Hopper și JEB, în condițiile licențelor aplicabile. REA nu îți acordă nicio licență, cheie sau drept de activare pentru aceste unelte. Versiunile de evaluare și demonstrative rămân supuse condițiilor furnizorilor, inclusiv restricțiilor privind utilizatorii, funcționalitățile, automatizarea și partajarea rezultatelor. Nu sunt autorizate copiile piratate, cheile furate, partajarea neautorizată a cheilor sau ocolirea restricțiilor de licențiere. Aceste îndrumări nu modifică licența MIT sau licențele terților.