Files
reverse-engineering-anything/docs/readme/README_bg.md
T
morluto 0ddc732c69 docs: describe omitted output schemas as the default in README translations (#10658)
* test(mcp): check advertised schemas against a portable dialect in every profile

* fix(mcp): re-emit advertised patterns in a portable regex grammar

* fix(mcp): present discover_tools input through the selected profile

The hot-cold catalog registered discover_tools directly with the SDK, so
the default compact input profile still advertised its canonical schema,
including page-size defaults clients apply on their own (#5322). Route
every listed input schema, transport discovery included, through one
server-owned presentation, and pass the selected presentation to the
deferred server, which serves recorded tool schemas but not discovery.

* fix(mcp): keep the Evidence union on described borrowed inputs

borrowEvidenceInput installed its advertised projection on one schema
instance. A call site's .describe() rebuilds the schema from its
definition, so match_native_functions advertised left and right as
unconstrained values in every input profile. Install the projection in
the borrowed parser's constructor so derived schemas keep it, for both
borrowed inputs and borrowed arrays.

* fix(mcp): validate advertised dialect by selected profile

* fix(mcp): preserve schema widening through references

* feat(mcp): project compact input schemas into the portable advertised dialect

One projection (advertisedDialectProjection.ts) owns the compact input
advertisement: one type per node, items on every array, string literals
as enums, oneOf widened to anyOf, allOf merged, tuples as element unions,
exclusive bounds made inclusive, and every keyword outside the dialect
dropped. Each rewrite is exact or widening; server validation is
unchanged. The root description and sentences for dropped cross-field
constraints move to the tool description, which Codex and Zed keep.

The compact baseline falls to nullable values only (29), which the
dialect cannot express without narrowing an input. The gateway shape
repairs (typeArrayItemUnions, hasGatewayIncompatibleShape), the second
dependentRequired-to-prose copy and the strict-gateway test denylist are
removed; the dialect checker gates the inline presentation instead.

* feat(mcp): omit output schemas from tools/list by default

No surveyed model API reads an output schema, MCP client validators
repeat REA's own result validation, and complete output schemas were
about 92% of the default tools/list. REA_MCP_OUTPUT_SCHEMA_PROFILE now
resolves to off through one owner (resolveMcpOutputSchemaProfile);
compact and full remain selectable. structuredContent is still
delivered, and the deferred server serves both off and full from the
recorded catalog with the matching recorded identity.

Tests and artifact verifiers that validate results against complete
advertised output contracts select full explicitly.

* docs: describe omitted output schemas as the default in README translations

* fix(mcp): select schemas in verification workflows

* fix(mcp): refuse zero-padded repeat bounds and record host-specific path patterns

* fix(mcp): keep projected schemas permissive

* fix(mcp): keep references valid when presentation widens their targets

* fix(mcp): keep a single union branch's closure scoped to its properties

* fix(mcp): select complete output schemas in the Electron verifier

* fix(mcp): select complete output schemas in standalone verifier probes

* fix(mcp): keep an allOf member's tuple tail with its own positions

* fix(mcp): relax references into negations and conditionals presentation may remove

* test(mcp): select the borrowed Evidence contract from its family

* fix(mcp): keep astral literals and dynamic references widening in every mode

* fix(mcp): omit astral literals and relax untracked references when presentation widens

* fix(mcp): select complete output schemas in every verifier transport

* fix(mcp): read reference pointers by schema position, not segment spelling

* fix(mcp): protect references into collapsing boolean unions and keep referencing branches out of the collapse

* fix(mcp): keep reduced schemas open when their root admits names by pattern

* test(mcp): keep the reduced-schema pattern case outside the size-limited block

* fix(mcp): omit patterns whose classes name astral characters

* fix(mcp): decide union collapse and pointer protection from canonical branches

* docs(mcp): document non-u astral matching and pin BMP agreement across V8 modes

* fix(mcp): keep prototype-named properties as own properties in the dialect projection

* test(mcp): select full output schemas in packet and signal schema checks

* test(mcp): expect the advertised base64 schema to omit the unbounded pad-bit probe

* fix(mcp): protect references into unevaluated keywords lost evaluation removes

* fix(mcp): validate the doctor probe reply against the canonical output contract (#10655)

* fix(mcp): validate the doctor probe reply against the canonical output contract

* test(mcp): replay doctor probe validation under every output profile

* test(mcp): accept typed-branch nullable unions in the advertised dialect (#10649)

* test(mcp): select full output schemas in HTTP session workflows

* fix(mcp): emit stack-safe classes with non-ASCII members and protect draft-07 reference siblings

* fix(mcp): protect references into literal siblings of relaxed draft-07 references

* feat(mcp): omit output schemas from tools/list by default (#10646)

* feat(mcp): omit output schemas from tools/list by default

No surveyed model API reads an output schema, MCP client validators
repeat REA's own result validation, and complete output schemas were
about 92% of the default tools/list. REA_MCP_OUTPUT_SCHEMA_PROFILE now
resolves to off through one owner (resolveMcpOutputSchemaProfile);
compact and full remain selectable. structuredContent is still
delivered, and the deferred server serves both off and full from the
recorded catalog with the matching recorded identity.

Tests and artifact verifiers that validate results against complete
advertised output contracts select full explicitly.

* fix(mcp): select schemas in verification workflows

* fix(mcp): select complete output schemas in the Electron verifier

* fix(mcp): select complete output schemas in standalone verifier probes

* fix(mcp): select complete output schemas in every verifier transport

* test(mcp): select full output schemas in packet and signal schema checks

* fix(mcp): validate the doctor probe reply against the canonical output contract (#10655)

* fix(mcp): validate the doctor probe reply against the canonical output contract

* test(mcp): replay doctor probe validation under every output profile

* test(mcp): accept typed-branch nullable unions in the advertised dialect (#10649)

* test(mcp): select full output schemas in HTTP session workflows

* fix(mcp): keep the Evidence union on described borrowed inputs (#10597)

* fix(mcp): keep the Evidence union on described borrowed inputs

borrowEvidenceInput installed its advertised projection on one schema
instance. A call site's .describe() rebuilds the schema from its
definition, so match_native_functions advertised left and right as
unconstrained values in every input profile. Install the projection in
the borrowed parser's constructor so derived schemas keep it, for both
borrowed inputs and borrowed arrays.

* test(mcp): select the borrowed Evidence contract from its family

* docs(mcp): admit baseline growth only for restored contract declarations

* fix(mcp): state reduced multi-type properties as typed branches, not type lists

The reduced fallback derived a property's types and emitted them as a type
list, which Gemini, Moonshot and Ark reject. A property whose canonical
schema is anyOf string and number therefore traded a typed union for a
rejected construct when the inline projection fell back. Emit one type, or
anyOf typed branches, so [T, null] becomes the dialect's nullable union.
2026-11-15 18:37:55 +08:00

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

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

Версия в 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 използва компактни входни схеми, за да заема по-малко от контекста. Задайте REA_MCP_INPUT_SCHEMA_PROFILE=full в MCP регистрацията си, когато са ви нужни пълните описания на полетата и подробностите за вложената валидация. И двата профила запазват пълния набор от инструменти и каноничната валидация на сървъра. Вижте „Compact input schema profile“ в ръководството за MCP договорите.

По подразбиране изходните схеми се пропускат от tools/list: никой API на модел не ги чете, а REA сам валидира всеки резултат. Задайте REA_MCP_OUTPUT_SCHEMA_PROFILE=compact, за да обявите всяка изходна схема в рамките на 4096 байта, или full за пълни изходни схеми (за MCP клиенти, които валидират резултатите). Всички настройки запазват каноничната валидация от страна на сървъра и пълните структурирани резултати. Вижте „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 бележки
Защита на бинарни файлове 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
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 или лицензите на трети страни.