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

384 lines
25 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<div align="center">
[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/)**
<a href="https://discord.com/invite/GkcryMnJDM"><img alt="Присъединете се към общността на REA в Discord" src="https://img.shields.io/badge/Join%20us%20on%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" height="40"></a>
[Бърз старт](#бърз-старт) · [Примери](#примери) · [Как работи REA](#как-работи-rea) · [Какво можете да анализирате](#какво-можете-да-анализирате) · [Създаване на RL среди](#build-rl-environments) · [Често задавани въпроси](#често-задавани-въпроси) · [Документация](#документация)
<code>npx rea-agents setup</code>
</div>
> [!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 не доказва, че дадено изтегляне е официално.
<div align="center">
<br />
<img src="../assets/rea-hopper-analysis.png" alt="REA стартира своя мост за анализ в Hopper, докато изследва нативен бинарен файл" width="1200" />
<br /><br />
<table aria-label="Общността на REA">
<tr>
<td align="center" width="360">
<a href="https://discord.gg/GkcryMnJDM">
<img src="../assets/discord.svg" height="42" alt="Discord" /><br />
<strong>Присъединете се към общността за обратно инженерство</strong>
</a><br />
<sub>Discord · Въпроси и отговори · Покажете какво сте направили</sub>
</td>
</tr>
</table>
<br />
</div>
---
Видели сте функция в приложение и искате същата във вашия продукт? Помолете агента си да я проучи с 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)
## Примери
<a href="https://rea.tools/showcase/">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="../assets/rea-showcases-dark.svg" />
<img alt="Илюстрации на примерите DX-Ball (звукова панорама), Notion (мост за клипборда) и TH04 (пръстен от куршуми)" src="../assets/rea-showcases.svg" />
</picture>
</a>
<table>
<tbody>
<tr><td>
<h3>DX-Ball: реконструиране на изчислението на звуковата панорама</h3>
<p>Проследете извикване на звук до помощната функция, която превръща позицията в
панорама, изследвайте инструкциите и превърнете непълния псевдокод в C.
Реконструкцията минава 3 205 тестови случая спрямо оригиналния x86 код и
възпроизвежда всичките 63 байта на компилираната функция.</p>
<p><a href="https://rea.tools/showcase/dx-ball/">Прочетете казуса</a> ·
<a href="https://github.com/N0zoM1z0/dx-ball">Хранилище с реконструкцията</a></p>
</td></tr>
<tr><td>
<h3>Notion: проследяване на моста за клипборда в Electron</h3>
<p>Открийте API-то за клипборда в renderer процеса, проследете го през preload
скрипта и IPC до главния процес и изследвайте формата за форматирано съдържание
в клипборда.</p>
<p><a href="https://rea.tools/showcase/notion/">Прочетете казуса</a></p>
</td></tr>
<tr><td>
<h3>TH04: възстановяване на изчислението на пръстена от куршуми в DOS</h3>
<p>Изследвайте 16-битовите инструкции на оригиналната игра за PC-98, възстановете
изчисленията на фиксираните и насочените ъгли и сравнете реконструирания C++ код
с изхода на историческия компилатор.</p>
<p><a href="https://rea.tools/showcase/th04/">Прочетете казуса</a> ·
<a href="https://github.com/N0zoM1z0/th04">Хранилище с реконструкцията</a></p>
</td></tr>
</tbody>
</table>
Ако сте използвали 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).
<a id="current-status"></a>
## Какво можете да анализирате
Нативни бинарни файлове · JavaScript / Electron · Уебсайтове · .NET асемблита · Android APK файлове · Фърмуер · Поведение на процеси
[Поддържани формати и изисквания](../reference/supported-targets.md)
<a id="choosing-a-deep-analysis-provider"></a>
[Избор на доставчик за анализ](../reference/supported-targets.md#choosing-a-deep-analysis-provider)
<a id="build-rl-environments"></a>
## Създаване на RL среди
Създайте локална среда от записана уеб сесия или настолно приложение за Linux, за да може агентът да упражнява задача и да проверява резултата.
[Създаване на RL среди](https://rea.tools/guides/rl-environments/)
## Често задавани въпроси
<details>
<summary><strong>Кои агенти могат да използват REA?</strong></summary>
Всеки агент, който поддържа локални MCP сървъри. Настройката конфигурира
[поддържаните агенти](../getting-started/installation.md#supported-agents);
другите клиенти могат да използват
[ръчна MCP регистрация](../getting-started/installation.md#mcp-registry).
</details>
<details>
<summary><strong>Нужен ли ми е двигател за нативен анализ?</strong></summary>
Задълбоченият нативен анализ използва Hopper, Ghidra, IDA или Kuna в зависимост
от целта и операцията. Статичната проверка на JavaScript и .NET работи без
двигател за нативен анализ. Настройката може да инсталира Hopper след ваше
одобрение; Ghidra, IDA и Kuna се използват от вече съществуващите ви инсталации.
Вижте [настройката на доставчиците](../getting-started/installation.md#hopper)
за възможностите и поддържаните от тях цели.
</details>
<details>
<summary><strong>Трябва ли първо да стартирам Hopper?</strong></summary>
REA стартира Hopper, когато дадена операция се нуждае от него. В macOS при първо
стартиране може да се появи диалогов прозорец, който ви пита дали да изберете
демо режим, или да активирате лиценза си. Завършете този диалог в същата
потребителска сесия преди първата си CLI/MCP операция или задача, която ще се
изпълнява без надзор. При нужда отворете Hopper ръчно. Вижте
[стартиране и отстраняване на проблеми с Hopper](../getting-started/installation.md#launcher-paths-and-troubleshooting).
</details>
<details>
<summary><strong>Какво прави инсталирането на умението (skill) от skills.sh?</strong></summary>
Умението дава на агента ви инструкции как да провежда изследвания. Използвайте
`npx rea-agents setup`, за да регистрирате MCP сървъра на REA и да инсталирате
съответните инструкции, след което рестартирайте агента. Вижте
[инсталиране само на умението](../getting-started/installation.md#skill-only-installation).
</details>
<details>
<summary><strong>Какъв код връща REA?</strong></summary>
Нативният анализ връща псевдокод и асемблер. Анализът на JavaScript/Electron
възстановява модулите и връзките между тях. Агентът ви използва тези
констатации, за да напише и тества реализация; [примерите](#примери) показват
цялостни разработени случаи.
</details>
<details>
<summary><strong>Качва ли REA приложението ми някъде?</strong></summary>
REA анализира целите локално. Агентът ви получава резултатите от инструментите,
а доставчикът на модела, който агентът използва, има собствена политика за
данните.
</details>
<details>
<summary><strong>Какво да направя, ако попадна на грешка?</strong></summary>
Първо обновете; възможно е скорошно издание вече да я е поправило.
За 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, типа на целта, стъпките за възпроизвеждане и изхода с грешката.
</details>
## Документация
Започнете с [практическите ръководства](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, съобщават за грешки, предлагат нови функции, тестват версии и допринасят с поправки.
<a href="https://rea.tools/bg/contributors/">
<img src="../../website/public/contributors/avatars.png" alt="Участници в проекта REA" />
</a>
<a href="https://www.star-history.com/?repos=morluto%2Frea&amp;type=date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=morluto/rea&amp;type=date&amp;theme=dark&amp;legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=morluto/rea&amp;type=date" />
<img alt="История на звездите на REA в GitHub" src="https://api.star-history.com/chart?repos=morluto/rea&amp;type=date" />
</picture>
</a>
## Принос към проекта
Ще се радваме на помощта ви с 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 или лицензите на
трети страни.