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

25 KiB
Raw Blame History

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 сървър за обратно инженерство на бинарни файлове, приложения и поведение по време на изпълнение.

Харесва ви функция в някое приложение? Разберете как работи, чак до ниво бинарен код.

GitHub stars Monthly npm downloads Лиценз MIT Join the REA Discord Follow REA on X Supported platforms: macOS, Windows, and Linux skills.sh

Уебсайт · Ръководства · Примери

Присъединете се към общността на REA в Discord

Бърз старт · Примери · Как работи REA · Какво можете да анализирате · Създаване на RL среди · Често задавани въпроси · Документация

npx rea-agents setup

Important

Изтегляйте REA от morluto/rea, rea.tools или npm пакета rea-agents. Следвайте връзките за инсталиране и издания от тези официални източници. Подобно име на хранилище или копиран README не доказва, че дадено изтегляне е официално.


REA стартира своя мост за анализ в Hopper, докато изследва нативен бинарен файл



Discord
Присъединете се към общността за обратно инженерство

Discord · Въпроси и отговори · Покажете какво сте направили


Видели сте функция в приложение и искате същата във вашия продукт? Помолете агента си да я проучи с REA. Той може да изследва приложението без изходния му код, да обясни как работи функцията, да покаже доказателствата и да изгради подобна версия за вашия проект.

REA свързва агента ви с инструменти за изследване на нативни бинарни файлове, JavaScript и Electron приложения, .NET асемблита и уебсайтове. Същите инструменти можете да използвате и от терминала. Анализът се извършва локално, а резултатите включват доказателствата и ограниченията зад всеки извод.

Настройката регистрира REA в агента ви и инсталира съответните инструкции за работния процес. Нативният анализ може да използва вече инсталиран Hopper, Ghidra, IDA или Kuna; по желание настройката може да инсталира Hopper след ваше одобрение. Статичният анализ на JavaScript не изисква двигател за нативен анализ.

Бърз старт

Бърз старт · rea.tools

Настройте агента си (MCP)

След като инсталирате Node.js и npm, изпълнете командата в доверена директория извън проекта за анализ.

npx rea-agents setup

Изберете агентите си, прегледайте предложените промени и ги одобрете. Настройката добавя MCP сървъра на REA и съответните инструкции за работния процес, като прави резервни копия на съществуващата конфигурация. След това рестартирайте агента. Настройката записва директно избраната среда за изпълнение и входния скрипт на REA. Ако сте получили REA чрез инструмент за изпълнение на пакети (package runner), не изтривайте записа му в кеша. Изтегляйте пакета от доверена директория извън целевия проект. Подробности за инсталирането и отстраняването на проблеми има в ръководството за настройка по-долу.

инсталиране и настройка

Попитайте агента си:

Разбери как работи търсенето в приложението Notes, покажи ми доказателствата и
изгради подобна функция за моя проект.

Заменете Notes с целевото си приложение и функцията, която искате да разберете.

Използвайте терминала (CLI)

Изследвайте директорията на разархивирано JavaScript/Electron приложение или ASAR архив:

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

Резултатът включва модули, импорти, границите на Electron и доказателствата за тях. Заменете пътя с вашата цел, например "D:/apps/example" в Windows.

За да инсталирате командата rea за редовна употреба:

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

За нативен анализ първо конфигурирайте доставчик на анализ. Вижте ръководството за CLI и Evidence за нативните команди, избора на доставчик, моментните снимки (snapshots) и скриптирането.

Изисквания за Linux

Обновяване на REA

За CLI, инсталиран с npm install --global или bun add --global:

rea update

Ако използвате npx, обновете настройката на агента си с:

npx rea-agents@latest setup

Обновяване и деинсталиране

Примери

Илюстрации на примерите DX-Ball (звукова панорама), Notion (мост за клипборда) и TH04 (пръстен от куршуми)

DX-Ball: реконструиране на изчислението на звуковата панорама

Проследете извикване на звук до помощната функция, която превръща позицията в панорама, изследвайте инструкциите и превърнете непълния псевдокод в C. Реконструкцията минава 3 205 тестови случая спрямо оригиналния x86 код и възпроизвежда всичките 63 байта на компилираната функция.

Прочетете казуса · Хранилище с реконструкцията

Notion: проследяване на моста за клипборда в Electron

Открийте API-то за клипборда в renderer процеса, проследете го през preload скрипта и IPC до главния процес и изследвайте формата за форматирано съдържание в клипборда.

Прочетете казуса

TH04: възстановяване на изчислението на пръстена от куршуми в DOS

Изследвайте 16-битовите инструкции на оригиналната игра за PC-98, възстановете изчисленията на фиксираните и насочените ъгли и сравнете реконструирания C++ код с изхода на историческия компилатор.

Прочетете казуса · Хранилище с реконструкцията

Ако сте използвали REA за нещо интересно, ще се радваме да го видим. Споделете случая си в issue или pull request, като включите целта, въпроса си, как ви помогна REA и какво открихте.

Как работи REA

Агентът ви извиква REA чрез MCP, за да изследва целта и да проследи съответния код. REA връща констатации заедно с доказателствата за тях. Агентът ги използва, за да задава допълнителни въпроси, да обяснява поведението или да напише и тества реализация. CLI командите използват същите работни процеси.

Процес на изследване с REA: агентът ви пита за локална цел, REA я изследва и проследява с инструменти за анализ, а агентът използва върнатия код, препратките и неизвестните, за да обясни, реализира и тества.

Отворете фигурата в пълен размер.

Какво можете да анализирате

Нативни бинарни файлове · JavaScript / Electron · Уебсайтове · .NET асемблита · Android APK файлове · Фърмуер · Поведение на процеси

Поддържани формати и изисквания

Избор на доставчик за анализ

Създаване на RL среди

Създайте локална среда от записана уеб сесия или настолно приложение за Linux, за да може агентът да упражнява задача и да проверява резултата.

Създаване на RL среди

Често задавани въпроси

Кои агенти могат да използват REA?

Всеки агент, който поддържа локални MCP сървъри. Настройката конфигурира поддържаните агенти; другите клиенти могат да използват ръчна MCP регистрация.

Нужен ли ми е двигател за нативен анализ?

Задълбоченият нативен анализ използва Hopper, Ghidra, IDA или Kuna в зависимост от целта и операцията. Статичната проверка на JavaScript и .NET работи без двигател за нативен анализ. Настройката може да инсталира Hopper след ваше одобрение; Ghidra, IDA и Kuna се използват от вече съществуващите ви инсталации. Вижте настройката на доставчиците за възможностите и поддържаните от тях цели.

Трябва ли първо да стартирам Hopper?

REA стартира Hopper, когато дадена операция се нуждае от него. В macOS при първо стартиране може да се появи диалогов прозорец, който ви пита дали да изберете демо режим, или да активирате лиценза си. Завършете този диалог в същата потребителска сесия преди първата си CLI/MCP операция или задача, която ще се изпълнява без надзор. При нужда отворете Hopper ръчно. Вижте стартиране и отстраняване на проблеми с Hopper.

Какво прави инсталирането на умението (skill) от skills.sh?

Умението дава на агента ви инструкции как да провежда изследвания. Използвайте npx rea-agents setup, за да регистрирате MCP сървъра на REA и да инсталирате съответните инструкции, след което рестартирайте агента. Вижте инсталиране само на умението.

Какъв код връща REA?

Нативният анализ връща псевдокод и асемблер. Анализът на JavaScript/Electron възстановява модулите и връзките между тях. Агентът ви използва тези констатации, за да напише и тества реализация; примерите показват цялостни разработени случаи.

Качва ли REA приложението ми някъде?

REA анализира целите локално. Агентът ви получава резултатите от инструментите, а доставчикът на модела, който агентът използва, има собствена политика за данните.

Какво да направя, ако попадна на грешка?

Първо обновете; възможно е скорошно издание вече да я е поправило.

За CLI, инсталиран с npm install --global или bun add --global:

rea update

За настройка на агента чрез npx:

npx rea-agents@latest setup

Ако използвате агент, извършете опресняването на настройката и го рестартирайте. Опитайте отново същата задача. Ако проблемът продължава, отворете issue, като посочите версията на REA, типа на целта, стъпките за възпроизвеждане и изхода с грешката.

Документация

Започнете с практическите ръководства на уебсайта. За точните опции, предварителните изисквания и договорите за резултатите:

Съобщавайте за уязвимости чрез SECURITY.md.

Общност и поддръжка

  • Discord — Задавайте въпроси и споделяйте проучванията си с над 50 000 души, които се увличат по обратното инженерство и създават свои проекти! Discord
  • Twitter / X — Следете @reatools за новини.
  • Отзиви и идеи — Искате нова функция или поддръжка на файлов формат? Пишете ни в GitHub или Discord.

История на звездите

🎉 400 000 звезди в GitHub — благодарим ви!

Благодарим на всички, които използват REA, съобщават за грешки, предлагат нови функции, тестват версии и допринасят с поправки.

Участници в проекта REA История на звездите на REA в GitHub

Принос към проекта

Ще се радваме на помощта ви с REA! Отворете issue, за да съобщите за грешка или да предложите функция, или изпратете pull request, за да подобрите кода или документацията.

Вижте CONTRIBUTING.md за настройка на средата за разработка и проверките, тестване за видовете проверки.

Отказ от отговорност

Вижте DISCLAIMER.md за насоки за отговорна употреба.

Позицията на проекта относно незаконната или неразрешената употреба обхваща всички версии, канали за разпространение и платформи на REA; всяко копие запазва приложимите за него лицензи.

REA е предназначен за законни изследвания, обучение, оперативна съвместимост, съхраняване на софтуер и анализ на софтуер, който притежавате или имате разрешение да изследвате.

Лиценз

MIT

Кодът, написан за проекта REA, е лицензиран под MIT. Материалите от трети страни запазват собствените си лицензи и бележки за авторски права; вижте бележките за трети страни за списъка със зависимости, запазените текстове на лицензите и условията на външните инструменти.

Трябва да сте придобили законно търговските инструменти и да имате право да ги използвате, включително IDA Pro / декомпилаторите на Hex-Rays, Hopper и JEB, съгласно приложимите им лицензи. REA не предоставя лиценз, ключ или право на активиране за нито един инструмент. Пробните и демо версиите остават обект на условията на производителя, включително ограниченията за брой потребители, функции, автоматизация и споделяне на резултатите. Кракнати копия, откраднати ключове, неразрешено споделяне на ключове и заобикаляне на лицензионни ограничения не са разрешени. Тези насоки не изменят лиценза MIT или лицензите на трети страни.