[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · [Bahasa Indonesia](README_id.md) · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md) · **Български** # REA: Reverse Engineer Anything ### Един MCP сървър за обратно инженерство на бинарни файлове, приложения и поведение по време на изпълнение. **Харесва ви функция в някое приложение? Разберете как работи, чак до ниво бинарен код.** [![GitHub stars](https://img.shields.io/github/stars/morluto/rea?style=flat-square&logo=github)](https://github.com/morluto/rea/stargazers) [![Monthly npm downloads](https://img.shields.io/npm/dm/rea-agents?style=flat-square&label=npm%20downloads)](https://www.npmjs.com/package/rea-agents) [![Лиценз MIT](https://img.shields.io/badge/license-MIT-f4c430?style=flat-square)](../../LICENSE) [![Join the REA Discord](https://img.shields.io/badge/Discord-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/GkcryMnJDM) [![Follow REA on X](https://img.shields.io/badge/X-000000?style=flat-square&logo=x&logoColor=white)](https://x.com/reatools) [![Supported platforms: macOS, Windows, and Linux](https://img.shields.io/badge/macOS%20%7C%20Windows%20%7C%20Linux-4493F8?style=flat-square)](../getting-started/installation.md) [![skills.sh](https://skills.sh/b/morluto/rea?style=flat-square)](https://skills.sh/morluto/rea/reverse-engineer-anything) **[Уебсайт](https://rea.tools/) · [Ръководства](https://rea.tools/guides/) · [Примери](https://rea.tools/showcase/)** Присъединете се към общността на REA в Discord [Бърз старт](#бърз-старт) · [Примери](#примери) · [Как работи REA](#как-работи-rea) · [Какво можете да анализирате](#какво-можете-да-анализирате) · [Създаване на RL среди](#build-rl-environments) · [Често задавани въпроси](#често-задавани-въпроси) · [Документация](#документация) npx rea-agents setup
> [!IMPORTANT] > Изтегляйте REA от [morluto/rea](https://github.com/morluto/rea), > [rea.tools](https://rea.tools/) или [npm пакета rea-agents](https://www.npmjs.com/package/rea-agents). > Следвайте връзките за инсталиране и издания от тези официални източници. Подобно > име на хранилище или копиран README не доказва, че дадено изтегляне е официално.

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

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

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

--- Видели сте функция в приложение и искате същата във вашия продукт? Помолете агента си да я проучи с REA. Той може да изследва приложението без изходния му код, да обясни как работи функцията, да покаже доказателствата и да изгради подобна версия за вашия проект. REA свързва агента ви с инструменти за изследване на нативни бинарни файлове, JavaScript и Electron приложения, .NET асемблита и уебсайтове. Същите инструменти можете да използвате и от терминала. Анализът се извършва локално, а резултатите включват доказателствата и ограниченията зад всеки извод. Настройката регистрира REA в агента ви и инсталира съответните инструкции за работния процес. Нативният анализ може да използва вече инсталиран Hopper, Ghidra, IDA или Kuna; по желание настройката може да инсталира Hopper след ваше одобрение. Статичният анализ на JavaScript не изисква двигател за нативен анализ. ## Бърз старт **[Бърз старт · rea.tools](https://rea.tools/bg/get-started/)** ### Настройте агента си (MCP) След като инсталирате [Node.js и npm](../reference/supported-targets.md), изпълнете командата в доверена директория извън проекта за анализ. ```bash npx rea-agents setup ``` Изберете агентите си, прегледайте предложените промени и ги одобрете. Настройката добавя MCP сървъра на REA и съответните инструкции за работния процес, като прави резервни копия на съществуващата конфигурация. След това рестартирайте агента. Настройката записва директно избраната среда за изпълнение и входния скрипт на REA. Ако сте получили REA чрез инструмент за изпълнение на пакети (package runner), не изтривайте записа му в кеша. Изтегляйте пакета от доверена директория извън целевия проект. Подробности за инсталирането и отстраняването на проблеми има в ръководството за настройка по-долу. [инсталиране и настройка](../getting-started/installation.md) Попитайте агента си: ```text Разбери как работи търсенето в приложението Notes, покажи ми доказателствата и изгради подобна функция за моя проект. ``` Заменете Notes с целевото си приложение и функцията, която искате да разберете. ### Използвайте терминала (CLI) Изследвайте директорията на разархивирано JavaScript/Electron приложение или ASAR архив: ```bash npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json ``` Резултатът включва модули, импорти, границите на Electron и доказателствата за тях. Заменете пътя с вашата цел, например `"D:/apps/example"` в Windows. За да инсталирате командата `rea` за редовна употреба: ```bash npm install --global rea-agents rea --help ``` За нативен анализ първо конфигурирайте доставчик на анализ. Вижте [ръководството за CLI и Evidence](../getting-started/cli.md) за нативните команди, избора на доставчик, моментните снимки (snapshots) и скриптирането. [Изисквания за Linux](../getting-started/installation.md#linux-owned-process-prerequisite) ### Обновяване на REA За CLI, инсталиран с `npm install --global` или `bun add --global`: ```bash rea update ``` Ако използвате `npx`, обновете настройката на агента си с: ```bash npx rea-agents@latest setup ``` [Обновяване и деинсталиране](../getting-started/installation.md#diagnose-update-and-remove) ## Примери Илюстрации на примерите 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](https://github.com/morluto/rea/issues) или [pull request](https://github.com/morluto/rea/pulls), като включите целта, въпроса си, как ви помогна REA и какво открихте. ## Как работи REA Агентът ви извиква REA чрез MCP, за да изследва целта и да проследи съответния код. REA връща констатации заедно с доказателствата за тях. Агентът ги използва, за да задава допълнителни въпроси, да обяснява поведението или да напише и тества реализация. CLI командите използват същите работни процеси. ![Процес на изследване с REA: агентът ви пита за локална цел, REA я изследва и проследява с инструменти за анализ, а агентът използва върнатия код, препратките и неизвестните, за да обясни, реализира и тества.](../../website/public/assets/figures/rea-investigation-flow.svg) [Отворете фигурата в пълен размер](../../website/public/assets/figures/rea-investigation-flow.svg). ## Какво можете да анализирате Нативни бинарни файлове · JavaScript / Electron · Уебсайтове · .NET асемблита · Android APK файлове · Фърмуер · Поведение на процеси [Поддържани формати и изисквания](../reference/supported-targets.md) [Избор на доставчик за анализ](../reference/supported-targets.md#choosing-a-deep-analysis-provider) ## Създаване на RL среди Създайте локална среда от записана уеб сесия или настолно приложение за Linux, за да може агентът да упражнява задача и да проверява резултата. [Създаване на RL среди](https://rea.tools/guides/rl-environments/) ## Често задавани въпроси
Кои агенти могат да използват REA? Всеки агент, който поддържа локални MCP сървъри. Настройката конфигурира [поддържаните агенти](../getting-started/installation.md#supported-agents); другите клиенти могат да използват [ръчна MCP регистрация](../getting-started/installation.md#mcp-registry).
Нужен ли ми е двигател за нативен анализ? Задълбоченият нативен анализ използва Hopper, Ghidra, IDA или Kuna в зависимост от целта и операцията. Статичната проверка на JavaScript и .NET работи без двигател за нативен анализ. Настройката може да инсталира Hopper след ваше одобрение; Ghidra, IDA и Kuna се използват от вече съществуващите ви инсталации. Вижте [настройката на доставчиците](../getting-started/installation.md#hopper) за възможностите и поддържаните от тях цели.
Трябва ли първо да стартирам Hopper? REA стартира Hopper, когато дадена операция се нуждае от него. В macOS при първо стартиране може да се появи диалогов прозорец, който ви пита дали да изберете демо режим, или да активирате лиценза си. Завършете този диалог в същата потребителска сесия преди първата си CLI/MCP операция или задача, която ще се изпълнява без надзор. При нужда отворете Hopper ръчно. Вижте [стартиране и отстраняване на проблеми с Hopper](../getting-started/installation.md#launcher-paths-and-troubleshooting).
Какво прави инсталирането на умението (skill) от skills.sh? Умението дава на агента ви инструкции как да провежда изследвания. Използвайте `npx rea-agents setup`, за да регистрирате MCP сървъра на REA и да инсталирате съответните инструкции, след което рестартирайте агента. Вижте [инсталиране само на умението](../getting-started/installation.md#skill-only-installation).
Какъв код връща REA? Нативният анализ връща псевдокод и асемблер. Анализът на JavaScript/Electron възстановява модулите и връзките между тях. Агентът ви използва тези констатации, за да напише и тества реализация; [примерите](#примери) показват цялостни разработени случаи.
Качва ли REA приложението ми някъде? REA анализира целите локално. Агентът ви получава резултатите от инструментите, а доставчикът на модела, който агентът използва, има собствена политика за данните.
Какво да направя, ако попадна на грешка? Първо обновете; възможно е скорошно издание вече да я е поправило. За CLI, инсталиран с `npm install --global` или `bun add --global`: ```bash rea update ``` За настройка на агента чрез `npx`: ```bash npx rea-agents@latest setup ``` Ако използвате агент, извършете [опресняването на настройката](#обновяване-на-rea) и го рестартирайте. Опитайте отново същата задача. Ако проблемът продължава, [отворете issue](https://github.com/morluto/rea/issues), като посочите версията на REA, типа на целта, стъпките за възпроизвеждане и изхода с грешката.
## Документация Започнете с [практическите ръководства](https://rea.tools/guides/) на уебсайта. За точните опции, предварителните изисквания и договорите за резултатите: - [Инсталиране и настройка](../getting-started/installation.md): регистриране на агенти, конфигуриране на доставчици, обновяване и деинсталиране. - [Готовност и отстраняване на проблеми](../getting-started/installation.md#check-readiness-for-your-task): диагностика на конкретен агент или двигател за анализ. - [CLI и Evidence](../getting-started/cli.md): команди, избор на доставчик, моментни снимки, импорт/експорт и изходни статуси. - [MCP договори](../reference/mcp-contracts.md) и [подсказки за агенти](../getting-started/mcp-prompts.md): резултати от инструментите, сесии и насочвани изследвания. - [Каталог с инструменти](../reference/mcp-contracts.md#generated-catalog): генериран списък с инструменти, доставчици и CLI команди. Съобщавайте за уязвимости чрез [SECURITY.md](../../SECURITY.md). ## Общност и поддръжка - **Discord** — Задавайте въпроси и споделяйте проучванията си с над 50 000 души, които се увличат по обратното инженерство и създават свои проекти! [![Discord](https://img.shields.io/badge/Join%20Discord-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/GkcryMnJDM) - **Twitter / X** — Следете [@reatools](https://x.com/reatools) за новини. - **Отзиви и идеи** — Искате нова функция или поддръжка на файлов формат? Пишете ни в [GitHub](https://github.com/morluto/rea/issues) или [Discord](https://discord.gg/GkcryMnJDM). ## История на звездите 🎉 **400 000 звезди в GitHub — благодарим ви!** Благодарим на всички, които използват REA, съобщават за грешки, предлагат нови функции, тестват версии и допринасят с поправки. Участници в проекта REA История на звездите на REA в GitHub ## Принос към проекта Ще се радваме на помощта ви с REA! [Отворете issue](https://github.com/morluto/rea/issues), за да съобщите за грешка или да предложите функция, или [изпратете pull request](https://github.com/morluto/rea/pulls), за да подобрите кода или документацията. Вижте [CONTRIBUTING.md](../../CONTRIBUTING.md) за настройка на средата за разработка и проверките, [тестване](../development/testing.md) за видовете проверки. ## Отказ от отговорност Вижте [DISCLAIMER.md](../../DISCLAIMER.md) за насоки за отговорна употреба. Позицията на проекта относно незаконната или неразрешената употреба обхваща всички версии, канали за разпространение и платформи на REA; всяко копие запазва приложимите за него лицензи. REA е предназначен за законни изследвания, обучение, оперативна съвместимост, съхраняване на софтуер и анализ на софтуер, който притежавате или имате разрешение да изследвате. ## Лиценз [MIT](../../LICENSE) Кодът, написан за проекта REA, е лицензиран под MIT. Материалите от трети страни запазват собствените си лицензи и бележки за авторски права; вижте [бележките за трети страни](../../THIRD_PARTY_NOTICES.md) за списъка със зависимости, запазените текстове на лицензите и условията на външните инструменти. **Трябва да сте придобили законно търговските инструменти и да имате право да ги използвате**, включително IDA Pro / декомпилаторите на Hex-Rays, Hopper и JEB, съгласно приложимите им лицензи. REA не предоставя лиценз, ключ или право на активиране за нито един инструмент. Пробните и демо версиите остават обект на условията на производителя, включително ограниченията за брой потребители, функции, автоматизация и споделяне на резултатите. Кракнати копия, откраднати ключове, неразрешено споделяне на ключове и заобикаляне на лицензионни ограничения не са разрешени. Тези насоки не изменят лиценза MIT или лицензите на трети страни.