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

21 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: مهندسی معکوس هر چیزی

یک MCP برای مهندسی معکوس فایل‌های باینری، برنامه‌ها و رفتار زمان اجرا.

قابلیتی دیده‌اید که دوستش دارید؟ سازوکارش را تا سطح باینری درک کنید.

GitHub stars Monthly npm downloads MIT license Join the REA Discord Follow REA on X Supported platforms: macOS, Windows, and Linux skills.sh

وب‌سایت · راهنماها · نمونه‌های عملی

به انجمن REA در دیسکورد بپیوندید

شروع سریع · نمونه‌های عملی · REA چگونه کار می‌کند؟ · چه چیزهایی را میتوان تحلیل کرد؟ · ساخت محیط‌های RL · پرسش‌های متداول · مستندات

npx rea-agents setup

Important

منابع رسمی REA: morluto/rea, rea.tools, rea-agents (npm). از پیوندهای نصب و انتشار در این منابع رسمی استفاده کنید. نام مشابه مخزن یا README کپی‌شده ثابت نمی‌کند که فایل دانلودی رسمی است.


اجرای پل تحلیل REA در Hopper هنگام بررسی یک فایل باینری بومی



Discord
به انجمن مهندسی معکوس بپیوندید

دیسکورد · پرسش و پاسخ · نمایش دستاوردها


قابلیتی در یک برنامه دیده‌اید که می‌خواهید در محصول خودتان داشته باشید؟ از ایجنت خود بخواهید با REA آن را بررسی کند. ایجنت می‌تواند بدون دسترسی به کد منبع برنامه، نحوهٔ کار قابلیت را بررسی و توضیح دهد، شواهد را نشان دهد و نسخه‌ای مشابه برای پروژهٔ شما بسازد.

REA ایجنت شما را به ابزارهایی برای بررسی باینری‌های بومی، برنامه‌های JavaScript و Electron، اسمبلی‌های .NET و وب‌سایت‌ها متصل می‌کند. همین ابزارها از ترمینال نیز قابل استفاده‌اند. تحلیل به‌صورت محلی انجام می‌شود و نتایج شامل شواهد و محدودیت‌های پشت هر نتیجه‌گیری هستند.

راه‌اندازی، REA را در ایجنت ثبت و دستورالعمل‌های متناظر را نصب می‌کند. تحلیل بومی می‌تواند از Hopper، Ghidra، IDA یا Kuna موجود استفاده کند؛ نصب Hopper پس از تأیید شما ممکن است. تحلیل ایستای JavaScript به موتور تحلیل بومی نیاز ندارد.

شروع سریع

شروع سریع · rea.tools

ایجنت خود را راه‌اندازی کنید (MCP)

پس از نصب Node.js و npm، دستور زیر را از پوشه‌ای قابل اعتماد خارج از پروژه‌ای که می‌خواهید تحلیل کنید اجرا کنید.

npx rea-agents setup

ایجنت‌های موردنظر را انتخاب کنید، تغییرات پیشنهادی را بررسی و تأیید کنید. فرایند راه‌اندازی، سرور MCP مربوط به REA و دستورالعمل‌های گردش‌کار متناظر را اضافه می‌کند و از پیکربندی موجود نسخهٔ پشتیبان می‌گیرد. پس از آن ایجنت خود را مجدداً راه‌اندازی کنید.

نصب و راه‌اندازی

از ایجنت خود بپرسید:

بررسی کن جست‌وجو در برنامهٔ Notes چگونه کار می‌کند، شواهدش را نشان بده و قابلیتی مشابه برای پروژهٔ من بساز.

به‌جای Notes، نام برنامهٔ هدف و قابلیتی را قرار دهید که می‌خواهید درک کنید.

استفاده از ترمینال (CLI)

برای بررسی پوشهٔ استخراج‌شدهٔ یک برنامهٔ JavaScript/Electron یا فایل ASAR:

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json

نتیجه شامل ماژول‌ها، importها، مرزهای Electron و شواهد مربوط به آن‌هاست. مسیر را با مسیر برنامهٔ هدف جایگزین کنید؛ مثلاً در ویندوز "D:/apps/example".

برای نصب دستور rea جهت استفادهٔ مداوم:

npm install --global rea-agents
rea --help

برای تحلیل بومی ابتدا یک ارائه‌دهنده پیکربندی کنید. برای دستورات بومی، انتخاب ارائه‌دهنده، snapshotها و اسکریپت‌نویسی، راهنمای CLI و شواهد را ببینید.

پیش‌نیازهای لینوکس

به‌روزرسانی REA

برای CLI نصب‌شده از طریق npm install --global / bun add --global:

rea update

اگر از npx استفاده می‌کنید، راه‌اندازی ایجنت را با دستور زیر به‌روز کنید:

npx rea-agents@latest setup

به‌روزرسانی و حذف نصب

نمونه‌های عملی

تصویرهایی از نمونه‌های پنینگ صدای DX-Ball، پل کلیپ‌بورد Notion و حلقهٔ گلوله‌های TH04

DX-Ball: بازسازی محاسبهٔ موقعیت استریوی صدا

یک فراخوانی صوتی را تا تابع کمکی تبدیل موقعیت به pan دنبال کنید، دستورالعمل‌ها را بررسی کنید و شبه‌کد ناقص را به C تبدیل کنید. بازسازی حاصل، هر ۳٬۲۰۵ مورد آزمایش x86 اصلی را با موفقیت پشت سر می‌گذارد و هر ۶۳ بایت تابع کامپایل‌شده را دقیقاً بازتولید می‌کند.

مطالعهٔ موردی · مخزن بازسازی

Notion: ردیابی پل کلیپ‌بورد Electron

API کلیپ‌بورد در renderer را پیدا کنید، مسیر آن را از preload و IPC تا فرایند اصلی دنبال کنید و قالب غنی کلیپ‌بورد را بررسی کنید.

مطالعهٔ موردی

TH04: بازیابی محاسبهٔ حلقهٔ گلوله در DOS

دستورالعمل‌های ۱۶بیتی بازی اصلی PC-98 را بررسی کنید، محاسبات زاویهٔ ثابت و هدف‌گیری‌شده را بازیابی کنید و کد C++ بازسازی‌شده را با خروجی کامپایلر تاریخی مقایسه کنید.

مطالعهٔ موردی · مخزن بازسازی

اگر از REA برای بررسی موضوع جالبی استفاده کرده‌اید، خوشحال می‌شویم آن را به اشتراک بگذارید. یک issue یا pull request ثبت کنید و هدف، پرسش خود، نقش REA و یافته‌هایتان را توضیح دهید.

REA چگونه کار می‌کند؟

ایجنت شما از طریق MCP، REA را فراخوانی می‌کند تا هدف را بررسی و کد مرتبط را ردیابی کند. REA یافته‌ها را همراه با شواهد برمی‌گرداند. ایجنت از این نتایج برای طرح پرسش‌های تکمیلی، توضیح رفتار یا نوشتن و آزمایش یک پیاده‌سازی استفاده می‌کند. دستورات CLI نیز از همین گردش‌کارها بهره می‌برند.

جریان بررسی REA: ایجنت دربارهٔ هدف محلی سؤال می‌پرسد، REA آن را با ابزارهای تحلیل بررسی و ردیابی می‌کند و ایجنت از کد، ارجاعات و ناشناخته‌های بازگردانده‌شده برای توضیح، پیاده‌سازی و آزمایش استفاده می‌کند.

نمایش تصویر در اندازهٔ کامل.

چه چیزهایی را می‌توان تحلیل کرد؟

باینری‌های بومی · JavaScript / Electron · وب‌سایت‌ها · اسمبلی‌های .NET · فایل‌های APK اندروید · Firmware · رفتار فرایند

قالب‌های پشتیبانی‌شده و پیش‌نیازها

انتخاب ابزار تحلیل

ساخت محیط‌های RL

از یک نشست وب ضبط‌شده یا یک برنامهٔ دسکتاپ لینوکس محیطی محلی بسازید تا ایجنت بتواند کاری را تمرین کند و نتیجه‌اش را بررسی کند.

ساخت محیط‌های RL

پرسش‌های متداول

کدام ایجنت‌ها می‌توانند از REA استفاده کنند؟

هر ایجنتی که از سرورهای MCP محلی پشتیبانی کند. فرایند setup، ایجنت‌های پشتیبانی‌شده را پیکربندی می‌کند؛ سایر کلاینت‌ها می‌توانند از ثبت دستی MCP استفاده کنند.

آیا به Hopper، Ghidra، IDA یا Kuna نیاز دارم؟

تحلیل عمیق بومی به یکی از آن‌ها نیاز دارد. بررسی ایستای JavaScript و .NET بدون موتور تحلیل بومی کار می‌کند. setup می‌تواند با تأیید شما Hopper را نصب کند؛ Ghidra، IDA و Kuna از نصب‌های موجود شما استفاده می‌کنند. راه‌اندازی ارائه‌دهنده را ببینید.

آیا باید ابتدا Hopper را اجرا کنم؟

REA زمانی که عملیاتی به Hopper نیاز داشته باشد آن را اجرا می‌کند. در macOS، ممکن است هنگام نخستین اجرا پنجره‌ای برای انتخاب حالت آزمایشی یا فعال‌سازی مجوز نمایش داده شود. راه‌اندازی Hopper و رفع اشکال را ببینید.

نصب skill از skills.sh چه کاری انجام می‌دهد؟

این skill دستورالعمل‌های بررسی را برای ایجنت فراهم می‌کند. برای ثبت سرور MCP مربوط به REA و نصب دستورالعمل‌های متناظر، npx rea-agents setup را اجرا کنید و سپس ایجنت را مجدداً راه‌اندازی کنید. نصب مستقل skill را ببینید.

REA چه نوع کدی برمی‌گرداند؟

تحلیل بومی، شبه‌کد و اسمبلی برمی‌گرداند. تحلیل JavaScript/Electron ماژول‌ها و روابط میان آن‌ها را بازیابی می‌کند. ایجنت شما از این یافته‌ها برای نوشتن و آزمایش یک پیاده‌سازی استفاده می‌کند؛ نمونه‌های عملی مثال‌های گام‌به‌گام ارائه می‌دهند.

آیا REA برنامهٔ من را آپلود می‌کند؟

REA اهداف را به‌صورت محلی تحلیل می‌کند. ایجنت شما نتایج ابزارها را دریافت می‌کند و ارائه‌دهندهٔ مدل آن سیاست مستقل خود را دربارهٔ داده‌ها دارد.

اگر با خطا مواجه شدم چه کنم؟

ابتدا به‌روزرسانی کنید؛ ممکن است مشکل در نسخه‌ای جدید رفع شده باشد.

برای CLI نصب‌شده با npm:

rea update

برای راه‌اندازی ایجنت با npx:

npx rea-agents@latest setup

اگر از ایجنت استفاده می‌کنید، به‌روزرسانی راه‌اندازی را تکمیل و ایجنت را مجدداً اجرا کنید. همان کار را دوباره امتحان کنید. اگر مشکل ادامه داشت، یک issue ثبت کنید و نسخهٔ REA، نوع هدف، مراحل بازتولید و خروجی خطا را ذکر کنید.

مستندات

از راهنماهای عملی وب‌سایت شروع کنید. برای گزینه‌های دقیق، پیش‌نیازها و قراردادهای خروجی:

آسیب‌پذیری‌ها را از طریق SECURITY.md گزارش کنید.

جامعه و پشتیبانی

  • Discord — پرسش‌ها و یافته‌های خود را با جامعهٔ ما در میان بگذارید؛ بیش از ۵۰ هزار نفر که به مهندسی معکوس و ساخت پروژه‌های تازه علاقه دارند! Discord
  • Twitter / X — برای دریافت خبرها @reatools را دنبال کنید.
  • بازخورد و پیشنهادها — قابلیت تازه‌ای می‌خواهید یا به پشتیبانی از قالب فایل خاصی نیاز دارید؟ در GitHub یا Discord به ما بگویید.

تاریخچهٔ ستاره‌ها

🎉 ۴۰۰٬۰۰۰ ستارهٔ GitHub — سپاسگزاریم!

از همهٔ کسانی که از REA استفاده می‌کنند، خطاها را گزارش می‌دهند، قابلیت‌های جدید پیشنهاد می‌کنند، buildها را آزمایش می‌کنند و در بهبود پروژه مشارکت دارند سپاسگزاریم.

مشارکت‌کنندگان REA

تاریخچهٔ ستاره‌های GitHub پروژهٔ REA

مشارکت

از کمک شما به REA استقبال می‌کنیم! برای گزارش خطا یا پیشنهاد قابلیت، یک issue باز کنید یا برای بهبود کد و مستندات pull request بفرستید.

برای راه‌اندازی محیط توسعه و بررسی‌ها، CONTRIBUTING.md، برای مراحل اعتبارسنجی آزمایش‌ها را ببینید.

سلب مسئولیت

برای راهنمای استفادهٔ مسئولانه، DISCLAIMER.md را ببینید.

REA برای پژوهش، آموزش، تعامل‌پذیری، حفظ نرم‌افزار و تحلیل نرم‌افزارهایی است که مالک آن‌ها هستید یا اجازهٔ بررسی آن‌ها را دارید، در چارچوب قانون.

The project's position on illegal or unauthorized use covers all REA versions, distribution channels, and platforms; each copy retains its applicable licenses.

مجوز

MIT

REA-authored code is licensed under MIT. Third-party material retains its own licenses and copyright notices; see Third-party notices for the dependency inventory, preserved license texts, and external-tool terms.

You must legally obtain and be authorized to use commercial tools, including IDA Pro / Hex-Rays decompilers, Hopper, and JEB, under their applicable licenses. REA grants no tool license, key, or activation entitlement. Trials and demos remain subject to vendor terms, including user, feature, automation, and output sharing restrictions. Cracked copies, stolen keys, unauthorized key sharing, and bypassing license restrictions are not authorized. This guidance does not amend MIT or third-party licenses.