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

20 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 على Discord

البدء السريع · دراسات الحالة · كيف يعمل REA · ما الذي يمكنك تحليله · إنشاء بيئات التعلم المعزز · الأسئلة الشائعة · التوثيق

npx rea-agents setup

Important

المصادر الرسمية لـ REA: morluto/rea, rea.tools, rea-agents (npm). استخدم روابط التثبيت والإصدارات المنشورة في هذه المصادر الرسمية. تشابه اسم المستودع أو نسخ ملف README لا يثبت أن التنزيل رسمي.


REA يشغّل جسر التحليل داخل Hopper لفحص ملف ثنائي للشيفرة الأصلية



Discord
انضم إلى مجتمع الهندسة العكسية

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

تتضمن النتيجة الوحدات وعمليات الاستيراد وحدود Electron والأدلة المتعلقة بها. استبدل المسار بمسار هدفك، مثل "D:/apps/example" على Windows.

لتثبيت أمر rea للاستخدام المعتاد:

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

لتحليل الشيفرة الأصلية، هيّئ موفّرًا أولًا. راجع دليل CLI وEvidence لأوامر تحليل الشيفرة الأصلية، واختيار الموفّر، واللقطات، والاستخدام في السكربتات.

متطلبات Linux

تحديث REA

لواجهة CLI المثبّتة عبر npm install --global / bun add --global:

rea update

إذا كنت تستخدم npx، فحدّث إعداد وكيلك بالأمر التالي:

npx rea-agents@latest setup

التحديث وإلغاء التثبيت

دراسات الحالة

رسوم توضيحية لأمثلة توزيع الصوت في DX-Ball وجسر الحافظة في Notion وحلقة الطلقات في TH04

DX-Ball: إعادة بناء حساب توزيع الصوت بين القناتين

تتبّع استدعاء صوت إلى الدالة المساعدة التي تحوّل الموضع إلى توزيع بين القناتين، وافحص التعليمات، وحوّل الشيفرة شبه البرمجية غير المكتملة إلى C. تجتاز إعادة البناء 3,205 حالات اختبار على x86 الأصلي، وتعيد إنتاج جميع بايتات الدالة المترجمة البالغ عددها 63 بايتًا.

اقرأ دراسة الحالة · مستودع إعادة البناء

Notion: تتبّع جسر الحافظة في Electron

اعثر على API الحافظة في عملية العرض، وتتبّعه عبر preload وIPC إلى العملية الرئيسية، وافحص صيغة الحافظة ذات التنسيق الغني.

اقرأ دراسة الحالة

TH04: استعادة حساب حلقة المقذوفات في DOS

افحص تعليمات اللعبة الأصلية على PC-98 ذات 16 بت، واستعد حساب الزوايا الثابتة والموجّهة نحو الهدف، وقارن شيفرة C++ المعاد بناؤها بمخرجات المترجم المستخدم آنذاك.

اقرأ دراسة الحالة · مستودع إعادة البناء

إذا استخدمت REA لفحص هدف مثير للاهتمام، فنود الاطلاع عليه. شارك حالتك في issue أو pull request، مع ذكر الهدف، وسؤالك، وكيف ساعدك REA، وما توصلت إليه.

كيف يعمل REA

يستدعي وكيلك REA عبر MCP لفحص الهدف وتتبع الشيفرة ذات الصلة. يعيد REA النتائج مع أدلتها. يستخدمها الوكيل لطرح أسئلة متابعة، أو شرح السلوك، أو كتابة تنفيذ واختباره. تستخدم أوامر CLI سير العمل نفسه.

مسار الاستقصاء في REA: يسأل وكيلك عن هدف محلي، ويفحصه REA ويتتبعه بأدوات التحليل، ثم يستخدم الوكيل الشيفرة والمراجع والجوانب غير المحسومة التي أعادتها الأدوات لشرح السلوك وتنفيذه واختباره.

افتح الشكل بحجمه الكامل.

ما الذي يمكنك تحليله

الملفات الثنائية للشيفرة الأصلية · JavaScript / Electron · المواقع · تجميعات .NET · حزم Android APK · البرامج الثابتة · سلوك العمليات

التنسيقات المدعومة والمتطلبات

اختيار مزوّد التحليل

إنشاء بيئات التعلم المعزز

أنشئ بيئة محلية من جلسة ويب مسجّلة أو تطبيق سطح مكتب يعمل على Linux ليتدرّب الوكيل على مهمة ويتحقق من نتيجتها.

إنشاء بيئات التعلم المعزز

الأسئلة الشائعة

أي وكلاء يمكنهم استخدام REA؟

أي وكيل يدعم خوادم MCP المحلية. يهيّئ الإعداد الوكلاء المدعومين؛ ويمكن للعملاء الآخرين استخدام تسجيل MCP يدويًا.

هل أحتاج إلى Hopper أو Ghidra أو IDA أو Kuna؟

يستخدم تحليل الشيفرة الأصلية المتعمق أحدها. يعمل الفحص الثابت لـ JavaScript و.NET دون محرك لتحليل الشيفرة الأصلية. يستطيع الإعداد تثبيت Hopper بعد الموافقة؛ أما Ghidra وIDA وKuna فتستخدم تثبيتاتك الموجودة. راجع إعداد الموفّرين.

هل أحتاج إلى تشغيل Hopper أولًا؟

يشغّل REA برنامج Hopper عندما تحتاج العملية إليه. على macOS، قد تظهر عند التشغيل الأول نافذة تطلب اختيار وضع العرض التجريبي أو تفعيل الترخيص. راجع تشغيل Hopper واستكشاف الأخطاء.

ماذا يفعل تثبيت المهارة من skills.sh؟

توفّر المهارة تعليمات الاستقصاء لوكيلك. استخدم npx rea-agents setup لتسجيل خادم MCP الخاص بـ REA وتثبيت التعليمات المطابقة، ثم أعد تشغيل وكيلك. راجع تثبيت المهارة وحدها.

ما الشيفرة التي يعيدها 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.

سجل النجوم

🎉 400,000 نجمة على GitHub — شكرًا لكم!

شكرًا لكل من يستخدم REA، ويبلّغ عن الأخطاء، ويقترح ميزات، ويختبر إصدارات البناء، ويساهم بالإصلاحات.

المساهمون في REA سجل نجوم REA على GitHub

المساهمة

نرحّب بمساعدتك في تطوير 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.