14 KiB

Raw Blame History

English · 简体中文 · 日本語 · 한국어 · العربية

REA: هندسة أي شيء عكسيًا

واجهة CLI وخادم MCP واحدان يمكّنان وكلاء البرمجة من إجراء هندسة عكسية لأي شيء

اعثر على ميزة تعجبك. افهم آلية عملها. ابنها بالطريقة التي تريدها.

البدء السريع · من الملف التنفيذي إلى السلوك · 46 أداة · كيف يعمل · الأسئلة الشائعة

npx skills add morluto/rea

هل وجدت في تطبيق ما ميزة تريدها في منتجك؟ أعط التطبيق إلى وكيل البرمجة حتى من دون شيفرته المصدرية. باستخدام REA، يستطيع الوكيل استقصاء الميزة وفهم آلية عملها ثم بناء نسخة ملائمة لتقنياتك وتصميمك ومتطلباتك.

يوفر REA هذه العملية عبر CLI وخادم MCP واحدين. يستطيع الوكيل قراءة شيفرة التطبيق وتتبع طريقة عمل الميزات ثم استخدام الأدلة مباشرة في عمله البرمجي المعتاد. ويتولى REA أدوات الهندسة العكسية المعقدة خلف واجهة واحدة.

اطلب من وكيلك مباشرة

npx skills add morluto/rea

ثم اطلب:

أعد REA وأجر هندسة عكسية لتطبيق Notes. اشرح طريقة عمل البحث وكيف توصلت إلى ذلك،
ثم ابنِ ميزة مشابهة لمشروعي.

تطبيق Notes مجرد مثال. يمكنك تسمية أي تطبيق تريد فهمه أو طلب البدء بنظرة عامة.

من الملف التنفيذي إلى السلوك

فك الترجمة	الفهم	إعادة الإنشاء
استخرج الشيفرة شبه المصدرية، والتعليمات، والسلاسل النصية، والرموز	تتبع تدفق التحكم والمراجع المتبادلة والاستدعاءات والأنواع	حوّل ما تعلمه الوكيل إلى ميزة تناسب تقنياتك وواجهتك ومتطلباتك

يوضح REA كيف وصل إلى نتائجه. وهو لا يدّعي استعادة الشيفرة المصدرية الأصلية أو استنساخ التطبيق تلقائيًا.

لماذا REA؟


مصمم للوكلاء	اسأل عما يفعله تطبيق مترجم ودع الوكيل يجمع الأدلة بدلًا من التخمين.
CLI وMCP	استخدم قدرات الهندسة العكسية نفسها من الطرفية أو وكيل البرمجة.
يتولى التعقيد	يدير REA إعداد الأدوات وفتح التطبيق واستمرار الاستقصاء والتنظيف بعد الانتهاء.
سير عمل كامل	انتقل من النظرة الأولى إلى الشيفرة شبه المصدرية وعلاقات الاستدعاء والأنواع وأدلة التنفيذ.
محلي حسب التصميم	يجري التحليل على جهاز Mac ولا يرفع REA الملف التنفيذي إلى خدمة تحليل مستضافة.
يحافظ على السياق	استقصِ عدة ملفات تنفيذية من دون بدء التحليل من جديد عند كل سؤال.

البدء السريع

باستخدام وكيل برمجة — موصى به

npx skills add morluto/rea

اطلب من الوكيل إعداد REA. سيفحص جهاز Mac ويشرح ما يحتاج إلى تثبيته ويطلب الموافقة ويرشدك خلال رسائل النظام. أعد تشغيل الوكيل بعد الإعداد إذا طلب ذلك لتحميل مجموعة الأدوات الكاملة.

قبل البدء

macOS 12 أو أحدث
Node.js 22 أو أحدث

لا تحتاج إلى تثبيت أدوات الهندسة العكسية يدويًا. يثبت Setup برنامج Homebrew وHopper عند الحاجة، ثم يهيئ وكلاء البرمجة المدعومين. Hopper برنامج منفصل يحتاج إلى ترخيص خاص به؛ يثبته Setup لكنه لا يوفر الترخيص.

1. إعداد REA

npx -y @morluto/rea setup --yes

إذا طلب macOS أو برنامج التثبيت تأكيدًا، فأكمل الخطوة ثم شغّل الأمر نفسه مرة أخرى.

2. إعادة تشغيل وكيل البرمجة

يهيئ Setup تلقائيًا نسخ Claude Desktop وCursor التي يعثر عليها. أعد تشغيل التطبيق كي يحمّل REA.

3. اطلب من الوكيل

يمكنك ذكر التطبيق باسمه. سيعثر وكيل البرمجة عليه ويمرر ملف البرنامج الذي يحتاجه REA.

استخدم REA لإجراء هندسة عكسية لتطبيق Notes. اشرح طريقة عمل البحث واعرض الأدلة،
ثم ابنِ ميزة مشابهة لمشروعي باستخدام SQLite.

إذا واجهت مشكلة، فشغّل:

npx -y @morluto/rea doctor

استقصاء كامل بطلب واحد

بعد الإعداد، يمكنك أن تطلب من وكيلك:

افتح التطبيق، واكتشف آلية عمل البحث من دون اتصال، واشرح تدفق التحكم، ثم ابنِ نسخة لمشروعي باستخدام TypeScript وSQLite.

يمكن للوكيل تحويل ذلك إلى سير عمل قابل للتحقق:

فتح الهدف
  → انتظار اكتمال تحليل Hopper
  → جرد المعماريات والرموز والسلاسل النصية
  → تحديد نقاط الدخول والدوال المهمة
  → تتبع الاستدعاءات والمراجع المتبادلة وتدفق التحكم
  → فك ترجمة التنفيذ ذي الصلة
  → تلخيص السلوك والقيود والحالات الطرفية
  → بناء الميزة بما يلائم تقنيات المشروع ومتطلباته

ما الذي يمكنك فعله؟

فهم تطبيق لا تملك مصدره

اكشف نقاط الدخول، وأسماء الفئات، والسلاسل النصية، والأطر المستخدمة، ومسارات الميزات من الملف التنفيذي وحده.

بناء ميزة تعجبك بطريقتك

استقصِ الميزة، وافهم سلوكها، ثم ابنِ نسخة ملائمة لمنتجك وتقنياتك ومتطلباتك.

توثيق بروتوكول أو تنسيق غير موثق

تتبع الموزعات، والثوابت، والمقارنات، والقراءة والكتابة لفهم الرسائل وتنسيقات الملفات وآلات الحالات.

إعادة إنشاء سلوك متوافق

حوّل منطقًا مفكوك الترجمة إلى مواصفات واضحة، ثم نفذ بديلًا نظيفًا تحكمه اختبارات السلوك الملحوظ.

تدقيق منطق أمني حساس

افحص التحقق من الإدخال، والتشفير، والصلاحيات، والتخزين، ومسارات الأخطاء من دون رفع الملف التنفيذي إلى خدمة بعيدة.

منصة من 46 أداة

عائلة الأدوات	العدد	أمثلة
فحص الملفات التنفيذية	33	الدوال، والشيفرة شبه المصدرية، والتعليمات، والسلاسل، والأسماء، والمراجع، والتعليقات
التحليل المركب	10	النظرة العامة، وفك الترجمة الدفعي، ومخططات الاستدعاء، والمراجع، واكتشاف الأنواع
جلسة الملف التنفيذي	3	`open_binary` و`binary_session` و`close_binary`

استخدام REA مع وكلاء برمجة آخرين

يهيئ Setup حاليًا Claude Desktop وCursor تلقائيًا. يمكن لأي وكيل برمجة يدعم خوادم MCP المحلية استخدام REA بالإعداد التالي:

{
  "mcpServers": {
    "rea": {
      "command": "npx",
      "args": ["-y", "@morluto/rea", "mcp"]
    }
  }
}

كيف يعمل؟

flowchart LR
    Human[المستخدم] --> Agent[وكيل البرمجة]
    Agent --> REA[REA]
    Human -->|CLI| REA
    REA --> Hopper[محرك التحليل]
    Hopper --> App[تطبيقك]

يستخدم CLI وخادم MCP محرك التحليل نفسه. تغلق أوامر الطرفية التطبيق عند انتهائها، بينما تبقيه جلسة الوكيل مفتوحًا أثناء الاستقصاء.

أوامر CLI

سير عمل الوكيل أعلاه هو أسهل طريقة لاستخدام REA. للحصول على نظرة سريعة على تطبيق من الطرفية:

npx -y @morluto/rea analyze /Applications/Notes.app

شغّل npx -y @morluto/rea --help لمعرفة خيارات فك الترجمة المباشر والخيارات الأخرى.

يمكن لـ REA فتح مجلد .app على Mac مباشرة. إذا لم يعثر الوكيل على التطبيق، فأخبره بمكان تثبيته.

سلوك Hopper

يستطيع REA تشغيل Hopper تلقائيًا؛ لا حاجة إلى افتراض أنه يعمل مسبقًا. لكنه تطبيق macOS رسومي، لذلك قد يطلب التركيز أو يعرض حوارًا عندما يفرض Hopper قرارًا تفاعليًا. لا يمكن لـ REA ضمان تشغيل غير مرئي تمامًا لأن هذه الواجهة يملكها Hopper وmacOS.

لتجنب مربع اختيار معمارية ملف شامل، حدد معطيات المحمل مسبقًا:

export HOPPER_LOADER_ARGS_JSON='["-l", "Mach-O", "--aarch64"]'

يدير REA دورة حياة Hopper ويحاول إغلاق العمليات التي بدأها عند انتهاء الأمر أو جلسة MCP.

الأمان والخصوصية

يبقى تحليل الملف التنفيذي محليًا بين REA وHopper.
لا يرفع REA الأهداف إلى خدمة مستضافة.
راجع الملفات التنفيذية غير الموثوقة واعزلها كما تفعل مع أي مدخل أصلي قد يكون ضارًا.
أبلغ عن الثغرات وفق سياسة الأمان، وليس عبر قضية عامة.

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

هل يتضمن REA محرك فك ترجمة خاصًا به؟

لا. يستطيع Setup تثبيت Hopper، لكنه يظل برنامجًا منفصلًا بترخيص خاص به. يوفر REA واجهة CLI وخادم MCP وسير العمل المخصص للوكلاء.

هل يجب أن يكون Hopper مفتوحًا مسبقًا؟

لا. يستطيع REA تشغيله. لكن Hopper قد يصبح مرئيًا أو يطلب إدخالًا عند الحاجة إلى قرار تفاعلي.

هل يعمل REA على Linux أو Windows؟

ليس حاليًا. يعتمد المحول الحالي على تطبيق Hopper لنظام macOS وواجهة Python الخاصة به.

هل يمكنني تحليل قواعد Hopper المحفوظة؟

نعم. يدعم وقت التشغيل الملفات التنفيذية وقواعد .hop.

التطوير

راجع CONTRIBUTING.md لإعداد بيئة التطوير وبنية المشروع والاختبارات وإرشادات الإصدار.

المشروع

الترخيص

MIT

14 KiB Raw Blame History