25 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
Един MCP сървър за обратно инженерство на бинарни файлове, приложения и поведение по време на изпълнение.
Харесва ви функция в някое приложение? Разберете как работи, чак до ниво бинарен код.
Уебсайт · Ръководства · Примери
Бърз старт · Примери · Как работи REA · Какво можете да анализирате · Създаване на RL среди · Често задавани въпроси · Документация
npx rea-agents setup
Important
Изтегляйте REA от morluto/rea, rea.tools или npm пакета rea-agents. Следвайте връзките за инсталиране и издания от тези официални източници. Подобно име на хранилище или копиран README не доказва, че дадено изтегляне е официално.
|
Присъединете се към общността за обратно инженерство Discord · Въпроси и отговори · Покажете какво сте направили |
Видели сте функция в приложение и искате същата във вашия продукт? Помолете агента си да я проучи с REA. Той може да изследва приложението без изходния му код, да обясни как работи функцията, да покаже доказателствата и да изгради подобна версия за вашия проект.
REA свързва агента ви с инструменти за изследване на нативни бинарни файлове, JavaScript и Electron приложения, .NET асемблита и уебсайтове. Същите инструменти можете да използвате и от терминала. Анализът се извършва локално, а резултатите включват доказателствата и ограниченията зад всеки извод.
Настройката регистрира REA в агента ви и инсталира съответните инструкции за работния процес. Нативният анализ може да използва вече инсталиран Hopper, Ghidra, IDA или Kuna; по желание настройката може да инсталира Hopper след ваше одобрение. Статичният анализ на JavaScript не изисква двигател за нативен анализ.
Бърз старт
Настройте агента си (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) и скриптирането.
Обновяване на REA
За CLI, инсталиран с npm install --global или bun add --global:
rea update
Ако използвате npx, обновете настройката на агента си с:
npx rea-agents@latest setup
Примери
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 командите използват същите работни процеси.
Отворете фигурата в пълен размер.
Какво можете да анализирате
Нативни бинарни файлове · JavaScript / Electron · Уебсайтове · .NET асемблита · Android APK файлове · Фърмуер · Поведение на процеси
Поддържани формати и изисквания
Създаване на RL среди
Създайте локална среда от записана уеб сесия или настолно приложение за Linux, за да може агентът да упражнява задача и да проверява резултата.
Често задавани въпроси
Кои агенти могат да използват 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, типа на целта, стъпките за възпроизвеждане и изхода с грешката.
Документация
Започнете с практическите ръководства на уебсайта. За точните опции, предварителните изисквания и договорите за резултатите:
- Инсталиране и настройка: регистриране на агенти, конфигуриране на доставчици, обновяване и деинсталиране.
- Готовност и отстраняване на проблеми: диагностика на конкретен агент или двигател за анализ.
- CLI и Evidence: команди, избор на доставчик, моментни снимки, импорт/експорт и изходни статуси.
- MCP договори и подсказки за агенти: резултати от инструментите, сесии и насочвани изследвания.
- Каталог с инструменти: генериран списък с инструменти, доставчици и CLI команди.
Съобщавайте за уязвимости чрез SECURITY.md.
Общност и поддръжка
- Discord — Задавайте въпроси и споделяйте проучванията си с над 50 000 души, които се увличат по обратното инженерство и създават свои проекти!
- Twitter / X — Следете @reatools за новини.
- Отзиви и идеи — Искате нова функция или поддръжка на файлов формат? Пишете ни в GitHub или Discord.
История на звездите
🎉 400 000 звезди в GitHub — благодарим ви!
Благодарим на всички, които използват REA, съобщават за грешки, предлагат нови функции, тестват версии и допринасят с поправки.
Принос към проекта
Ще се радваме на помощта ви с REA! Отворете issue, за да съобщите за грешка или да предложите функция, или изпратете pull request, за да подобрите кода или документацията.
Вижте CONTRIBUTING.md за настройка на средата за разработка и проверките, тестване за видовете проверки.
Отказ от отговорност
Вижте DISCLAIMER.md за насоки за отговорна употреба.
Позицията на проекта относно незаконната или неразрешената употреба обхваща всички версии, канали за разпространение и платформи на REA; всяко копие запазва приложимите за него лицензи.
REA е предназначен за законни изследвания, обучение, оперативна съвместимост, съхраняване на софтуер и анализ на софтуер, който притежавате или имате разрешение да изследвате.
Лиценз
Кодът, написан за проекта REA, е лицензиран под MIT. Материалите от трети страни запазват собствените си лицензи и бележки за авторски права; вижте бележките за трети страни за списъка със зависимости, запазените текстове на лицензите и условията на външните инструменти.
Трябва да сте придобили законно търговските инструменти и да имате право да ги използвате, включително IDA Pro / декомпилаторите на Hex-Rays, Hopper и JEB, съгласно приложимите им лицензи. REA не предоставя лиценз, ключ или право на активиране за нито един инструмент. Пробните и демо версиите остават обект на условията на производителя, включително ограниченията за брой потребители, функции, автоматизация и споделяне на резултатите. Кракнати копия, откраднати ключове, неразрешено споделяне на ключове и заобикаляне на лицензионни ограничения не са разрешени. Тези насоки не изменят лиценза MIT или лицензите на трети страни.