Files
Matt Van Horn 43b9fa87fb feat(artifacts): inspect NuGet package metadata and dependencies
Inspect supplied NuGet packages as local Evidence with bounded ZIP parsing, preserved caller choices and credential-safe metadata.

Fixes #8144

Assisted-by: Suika (gensokyo-skills:suika-scatter-gather-planning)
Co-authored-by: gensokyo-dev <342580529+gensokyo-dev@users.noreply.github.com>
2026-11-17 13:13:02 +00:00

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

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

Версия в npm Каталог с MCP инструменти Изисквания за Node.js skills.sh Лиценз MIT Discord

morluto%2Frea | Trendshift

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

Присъединете се към общността на 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 за инструкции за настройка, илюстрирани ръководства и реални казуси.

Бърз старт

В Linux стартирането на Ghidra, JADX и инструментите за фърмуер, както и статичният анализ на JavaScript/Electron, изискват съвместима с procps команда ps в PATH на REA за проверките кой процес на кого принадлежи. Стъпките за отстраняване на проблема са в docs/getting-started/installation.md, в раздела „Linux owned-process prerequisite“.

Настройте агента си

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

npx rea-agents setup

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

Настройката поддържа Claude Code, Codex, Cursor, Gemini CLI, Grok Build и други агенти. Вижте инсталиране и настройка за конфигуриране на доставчици на анализ, ръчна регистрация на MCP и инсталиране на плъгина за Claude Code/Codex.

MCP обявява компактни входни схеми, за да заема по-малко от контекста; указанията, които компактната схема пропуска, следват описанието на инструмента. Пълният набор от инструменти и каноничната валидация на сървъра остават непроменени. Вижте „Compact input schema profile“ в ръководството за MCP договорите.

По подразбиране изходните схеми се пропускат от tools/list: никой API на модел не ги чете, а REA сам валидира всеки резултат. Задайте REA_MCP_OUTPUT_SCHEMA_PROFILE=compact, за да обявите всяка изходна схема в рамките на 4096 байта. Всички настройки запазват каноничната валидация от страна на сървъра и пълните структурирани резултати. Вижте „Output schemas“ в ръководството за MCP договорите.

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

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

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

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

Изследвайте директорията на разархивирано 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

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

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

rea update

rea --update е псевдоним на същия проверен процес и приема същите глобални флагове за изхода. Използвайте rea update, когато го комбинирате с други опции на командата.

Командите за обновяване запазват общо най-много 4 MiB от stdout и stderr. Твърде големите отговори с метаданни се отхвърлят след приключване на командата; подробните (verbose) инсталации продължават с ограничена диагностика. Изходът за напредъка, предназначен за хора, се съобразява с обратното налягане (backpressure) на терминала и изчаква изпратените записи да завършат.

Глобалните обновявания чрез Bun изискват Bun 1.2.17 или по-нова версия. При по-стара версия първо обновете Bun ръчно и след това изпълнете rea update.

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

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

npx rea-agents@latest setup

Прегледайте промените от настройката и рестартирайте агента. За еднократни CLI команди използвайте npx rea-agents@latest, последвано от командата. С Bun използвайте bunx rea-agents@latest вместо npx rea-agents@latest.

Как работи REA

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

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

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

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

REA изисква Node.js 22.x (>=22.23.4), 24.x (>=24.22.1) или 26.12.1+, както и npm. Допълнителните инструменти и поддържаните операционни системи зависят от целта:

Цел Какво връща REA Изисквания и ръководство
Инсталирани настолни приложения Кандидати за среда за изпълнение, поддържащи файлове, маркери на компоненти и следващи проверки Вградена ограничена проверка на директории и заглавни части; настолни приложения
Нативни бинарни файлове Псевдокод, асемблер, низове, символи, извиквания и препратки Hopper, Ghidra, IDA или Kuna; нативен анализ
Структура на ELF (офлайн) Секции, сегменти, оригинални символи/релокации и кандидати за статични защитни механизми Предоставен от вас pwntools на Linux x64; диагностика на бинарни файлове
Go бинарни файлове Вградена версия на компилатора, модули, замени и настройки на компилацията Вградена статична проверка на ELF/PE/thin Mach-O; не изисква инсталиран Go
GPU кодови обекти CUDA/HIP цели, избрани параметри и ресурси на ядрата, запазен PTX текст Вградена статична проверка на ELF/PE/fatbin/CUBIN/PTX; GPU кодови обекти
Файлове на модели Метаданни на GGUF / safetensors, декларации на тензори и изчислени общи стойности Вградена проверка на заглавните части; по желание хеш на целия файл; файлове на модели
IL2CPP метаданни Образи на асемблита от Unity global-metadata.dat, имена на типове и методи и диапазони на индекси Вградено статично декодиране на версии 24, 27, 29, 31 и 39; не изисква Unity
Godot PCK Опис и извличане на архива, оригинални данни от заглавната част и директорията и идентичност на избрано съдържание Вградена статична поддръжка на формати 2, 3 и 4; не изисква Godot
Rust бинарни файлове Вградени от cargo-auditable имена на crate-ове, версии, източници и връзки между зависимостите Вградена статична проверка на ELF/PE/thin Mach-O; Rust бинарни файлове
PE сертификати Записи Authenticode WIN_CERTIFICATE и полета за самоличност на подписващия от PKCS#7/X.509 Вградена статична проверка на PE; PE сертификати
PE импорти Имена на импортирани и отложено зареждани (delay-load) DLL библиотеки, ординали, IAT RVA адреси и pefile хеш на импортите Вградена статична проверка на PE; PE импорти
Windows преки пътища Цел, аргументи, работна директория и данни от Shell Link Вградена статична проверка на LNK; Windows преки пътища
ELF бележки Собственици и типове на PT_NOTE/SHT_NOTE, полета GNU build-id и ABI-tag Вградена статична проверка на ELF; ELF бележки
DWARF compile units Compile-unit name, directory, producer, language, and dwo_name Built-in static ELF, Mach-O, and PE inspection; DWARF compile units
ELF dependencies DT_NEEDED, SONAME, RPATH/RUNPATH, GNU versions, and undefined imports Built-in static ELF inspection; ELF dependencies
Защита на бинарни файлове PIE, NX, RELRO, CFG и свързаните с тях флагове в заглавните части на ELF, PE и Mach-O Вградена статична проверка на заглавните части; защита на бинарни файлове
Сривове на Apple (IPS) Метаданни от .ips, нишки, образи, регистри и документирани класове сривове Вградена статична проверка на JSON; Apple IPS
Модули на ядрото на Linux Ключове от .modinfo, CRC стойности от __versions, наличие на this_module и подпис в края на файла Вградена статична проверка на ELF; модули на ядрото
Erlang BEAM IFF блокове (chunks), атоми, експорти, импорти, ламбди и заглавната част Code Вградена статична проверка на BEAM; Erlang BEAM
NuGet пакети Идентичност на пакета, групи зависимости, лиценз, хранилище и съдържание на ZIP Вградена статична проверка на .nupkg; NuGet пакети
WASM артефакти Валидация, секции, точни WAT форми на импортите/експортите и декодиран WAT Предоставен от вас WABT 1.0.42; inspect_wasm_artifact
EVM байткод Селектори на функции, отмествания в байтове, изведени аргументи и променливост (mutability) Локален raw/hex носител на Linux x64; ръководство за офлайн EVM
SQLite бази данни Таблици, колони, индекси, изгледи, тригери и избрани редове от обикновени таблици Локална моментна снимка на базата/WAL; Node.js 24.x >=24.15 или 26+ с нативни ограничения на SQLite
Записани сривове в Linux Сурови бележки, регистри/сигнали на всяка записана нишка и по желание кандидати за съпоставяне с файлове в паметта Предоставен от вас pwntools на Linux x64; по желание GDB/pwndbg; записани сривове
JavaScript / Electron Модули, импорти, source maps, маршрути, IPC и връзки с нативни добавки Node.js и npm; Linux: съвместима с procps команда ps; анализ на приложения
Уебсайтове Структура на страниците, скриптове, мрежови наблюдения и заявени екранни снимки Браузър от семейството на Chrome; анализ в браузъра
Запазени мрежови записи Заявки, отговори, открити полезни данни (payloads) и местоположения в изходния код HAR или Fiddler Everywhere SAZ; mitmdump на Linux за нативен mitmproxy; ръководство за мрежови записи
.NET асемблита Метаданни, CIL инструкции, декларирани нативни зависимости и сравнения между компилации Няма (само статичен анализ); ръководство за управляван код
Android APK файлове Декларации в манифеста, класове, декомпилирани методи и препратки JADX без графичен интерфейс и пълен JDK на Linux/macOS/Windows x64; ръководство за Android
Подписи на APK Подписващи v1/v2/v3/v3.1, отпечатъци на сертификати, ротация на ключове и вътрешна съгласуваност на хешовете Няма (само статичен анализ); inspect_apk_signature
Android устройства Устройства, пакети, процеси, логове, дъмпове, екранни снимки и прехвърляне на APK/файлове Предоставен от вас adb (емулатор или физическо устройство); ръководство за ADB
JEB проекти Единици на проекта от двигателя на JEB, хешове на артефакти и псевдокод на типове/методи Стартиран от вас JEB клиент, който обслужва MCP и е избран чрез REA_JEB_MCP_URL; ръководство за JEB
Android ресурси Декодиран манифест, таблици с низове, локали и данни за версията Предоставен от вас стартер за Apktool; ръководство за ресурси
Flutter приложения Хеш на Dart snapshot, хешове на библиотеките за всяко ABI и произход на компилацията на двигателя Няма (статичен анализ на APK); ръководство за Flutter
Фърмуер Региони, резултати от извличането и предаване към нативен анализ Binwalk / Unblob на Linux; ръководство за фърмуер
Записани пакети Избрани полета, повтарящи се стойности, филтри и правила decode-as Linux: TShark 4.x + prlimit; ръководство за записи
Обобщения на пакети Крайни точки, DNS, TLS SNI, разпределение по протоколи и HTTP заявки Предоставени от вас tshark и capinfos (проверено на Linux); ръководство за pcap
Записани логически сигнали Анотации от декодерите, диапазони от семпли и диагностика Linux: sigrok-cli 0.7.2 + prlimit; записи на сигнали
Пакети и ресурси Описи на файлове, хешове, plist файлове, устройство на Apple пакети (bundles) и извлечени ресурси Ръководство за артефакти и JavaScript, Apple приложения
Поведение на процеси Изход в терминала, взаимодействия, наблюдения на изхода от процеса и на файловата система и сравнения между изпълнения Linux/macOS с нативен PTY; запис на процеси
PyInstaller изпълними файлове Членове на CArchive, версия на Python, входни скриптове и извлечен байткод Няма (само статичен анализ); пакетирани Python приложения
Изпълними файлове на Deno Виртуални файлове, входна точка, опции и размер на npm снимката Няма (само статичен анализ); изпълними файлове на Deno

Статичната проверка на JavaScript и .NET чете предоставените файлове, без да стартира приложението. Записът по време на изпълнение стартира избраната цел или взаимодейства с нея с правата на вашия потребител; всяко ръководство за анализ по време на изпълнение описва какво точно прави.

За офлайн проверка на нативни бинарни файлове REA поддържа и предоставени от вас GNU objdump и Rizin. Вижте ръководството за инструменти за обратно инженерство за настройка на доставчиците, CLI командите и ограниченията на Evidence. REA не инсталира и не обновява нито един от двата доставчика.

Поддържаните нативни формати и операционни системи зависят от доставчика. Вижте настройката на Hopper и Ghidra, ръководството за IDA (включително незадължителен нативен MCP мост), ръководството за декомпилатора Kuna и експерименталната поддръжка на Ghidra за Windows. Ghidra поддържа и анализ на 16-битов DOS код. За големи бинарни файлове увеличете времето за стартиране на доставчика с REA_GHIDRA_STARTUP_TIMEOUT_MS или REA_HOPPER_STARTUP_TIMEOUT_MS. За избора на доставчик вижте ръководството за CLI. Проверете наличността в изданията за функции, добавени след последното издание в npm.

Примери

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

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

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

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

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

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

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

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

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

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

Създавайте RL среди с REA

Запишете сесия в уеб приложение, превърнете неговото API в инструменти и експортирайте среда, която AI агент може да използва. Стартирайте я с AgentEnv, след което добавете задачи и проверки за награда за RL обучение или оценка.

Прочетете ръководството · Гледайте видеото

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

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

Дайте на AI агент локална среда, в която да упражнява задачи като намиране на issue или създаване на папка, без да стартира оригиналното приложение. Използвайте я за обучение с подсилване (reinforcement learning, 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 рамка, за да зададете целите на задачите, да добавите проверки за награда и да стартирате обучението.

Изградете среда · Справочник за средите · Гледайте демонстрацията в X

Среди за настолни приложения

REA може да създаде среда за Linux настолно приложение: агентът го управлява чрез снимки на екрана, мишка и клавиатура. От кратка заявка агентът инсталира приложението, създава задача, експортира средата и я проверява на нов компютър. За изграждането са необходими Linux на amd64 или arm64, Docker и версията на agentenv, посочена в ръководството.

Настройка на среди за настолни приложения

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

Кои агенти могат да използват 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.

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

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

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

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

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

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

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

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

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

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

Вижте CONTRIBUTING.md за настройка на средата за разработка и проверките, тестване за видовете проверки и картата на архитектурата за избрани слоеве и пътища на зависимостите.

Лиценз

MIT

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

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