كيفية استخدام REA مع وكلاء البرمجة: تحقيقك الأول

لاستخدام REA مع وكيل برمجة، شغّل npx rea-agents@latest setup، ووافق على تغييرات الإعداد للعميل الذي اخترته، ثم أعد تشغيل ذلك العميل. بعد ذلك، حدّد للوكيل برنامجًا محليًا وسلوكًا واحدًا بعينه للتحقيق فيه؛ واطلب الشيفرة ذات الصلة ومواضعها في المصدر والقيود قبل أن تطلب منه بناء أي شيء.

REA واجهة سطر أوامر (CLI) وخادم MCP مفتوحا المصدر. هذه المقالة دليل مجتمعي مستقل؛ أما rea.tools ومستودع morluto/rea فهما المصدران الرسميان للمشروع.

ما الذي تحتاج إليه قبل تثبيت REA؟

يتطلب REA استخدام Node.js 22.x بدءًا من 22.19، أو Node.js 24.x بدءًا من 24.11، أو Node.js 26 وما بعده، بالإضافة إلى npm. تقع إصدارات Node.js 23 و25 والإصدارات التجريبية السابقة للإصدار النهائي خارج نطاق الدعم الموثّق. راجع دليل التثبيت الرسمي عند إعداد جهاز جديد.

اختر هدفًا تملكه أو لديك إذن بفحصه. يُعدّ تطبيق JavaScript مستخرج الملفات أو أرشيف ASAR لتطبيق Electron هدفًا أوليًا مناسبًا، لأن التحليل الساكن للتطبيقات في REA لا يتطلب Hopper أو Ghidra أو IDA. أما التحليل المتعمق للملفات الثنائية الأصلية فيستخدم أحد هذه المحركات، وله متطلبات إضافية تخص المنصة والإصدار. يسرد ملف README الخاص بـ REA فئات الأهداف المدعومة ومتطلباتها المسبقة.

ما الذي تريد فعله؟	نقطة البداية الموصى بها	المدخلات	النتيجة
مطالبة وكيل بشرح ميزة	إعداد REA MCP	مسار الهدف المحلي وسؤال محدد	نتائج وأدلة ومتابعة للتحقيق
فحص تطبيق دون وكيل	REA CLI	مجلد تطبيق JavaScript مستخرج الملفات أو أرشيف ASAR	أدلة منظّمة عن التطبيق
فحص تخطيط صفحة ويب يدويًا أو إيقاف JavaScript مؤقتًا	Chrome DevTools	صفحة مفتوحة في Chrome	تعديل DOM/CSS مباشرة والتحكم في نقاط التوقف
استكشاف دوال ملف ثنائي ورسومه البيانية بنفسك	Ghidra	ملف تنفيذي أو مكتبة مدعومة	تفكيك تفاعلي للتعليمات وفك ترجمة ومشروع تحليل

يوفر Chrome DevTools وGhidra واجهتين قويتين للفحص المباشر. ويفيد REA عندما تريد من وكيلك أن يساعدك في توجيه التحقيق وتحويل نتائج محددة إلى شرح أو تنفيذ. راجع مقارنتنا مع Ghidra ومقارنتنا مع Chrome DevTools.

كيف تربط REA بوكيل برمجة؟

شغّل أمر الإعداد الرسمي في الطرفية:

npx rea-agents@latest setup

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

لفحص التسجيل لدى Codex، استخدم:

npx -y rea-agents@latest doctor --client codex --json

استبدل codex بمعرّف العميل المدعوم الذي تستخدمه عند الاقتضاء. تفحص نتيجة doctor السليمة ملفات التسجيل والمتطلبات المسبقة؛ لكنها لا تثبت أن جلسة الوكيل الحالية قد أعادت الاتصال. إذا ظل الوكيل عاجزًا عن رؤية REA، فأعد تشغيله أو توصيله، وافحص خطأ اتصاله بـ MCP. يوفّر تثبيت المهارة وحدها من skills.sh تعليمات، ولا يوفّر اتصال MCP. تتناول إرشادات استكشاف الأخطاء الرسمية هذه الفروق.

عمّ ينبغي أن تطلب من REA البحث في طلبك الأول؟

اختر سلوكًا واحدًا قابلًا للملاحظة بدلًا من طلب إعادة بناء تطبيق كامل. لتطبيق لديك إذن بفحصه، يمكن أن يكون الطلب المحدد كالتالي:

استخدم REA لفحص /absolute/path/to/my-notes-app.
اشرح كيف يصدّر التطبيق الملاحظات بصيغة CSV.
اعرض الوحدات ذات الصلة ومواضعها في المصدر والأدلة.
ميّز السلوك المؤكد عن أي شيء لا يمكنك تحديده.

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

إذا لم يكن MCP متاحًا، فيمكن أيضًا تشغيل الفحص الساكن لـ JavaScript مباشرة:

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

يقبل الأمر مجلد تطبيق مستخرج الملفات أو أرشيف ASAR، ويعيد سجل Evidence. ولا تمنع حالات فشل مزوّدي تحليل الملفات الثنائية الأصلية أثناء التدقيق هذا المسار المنفصل لـ JavaScript تلقائيًا. توصي إرشادات REA للتحقق من الجاهزية ضمن نطاق محدد بفحص المهمة التي تحتاج إليها فعلًا.

كيف تراجع نتيجة قبل إعادة بناء ميزة؟

حوّل الشرح إلى توقّع صغير. عند فحص أداة لتصدير CSV، قارن ملاحظة عادية بملاحظة تحتوي على فاصلة أو علامة اقتباس أو سطر جديد. اسأل الوكيل عن فرع الشيفرة الذي يعالج هذه المحارف، وكيف يتوافق الناتج المتوقع مع التصدير المرصود من التطبيق الأصلي. أبقِ الناتج المرصود منفصلًا عن الشيفرة البديلة التي يقترحها الوكيل.

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

ما حدود الإصدارات والخصوصية؟

قد يوثّق فرع main من المستودع وظائف أحدث من حزمة npm المنشورة. يطلب @latest الإصدار الحالي من npm؛ أما تسجيلات MCP الدائمة فتُثبّت على الإصدار المحدد الذي نفّذ الإعداد. حدّث الإعداد وأعد تشغيل الوكيل عند التحديث. اختر الميزات من قائمة الأدوات الفعلية ومخططاتها في الخادم المتصل، بدلًا من افتراض تثبيت كل ميزة موجودة في فرع main. يشرح التوضيح الرسمي للفاصل بين الإصدارات هذا الفرق.

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

ما الأسئلة التي تُطرح بعد التحقيق الأول؟

هل يمكنني استخدام REA دون Hopper أو Ghidra أو IDA؟

نعم. لا يتطلب الفحص الساكن لـ JavaScript/Electron و.NET محركًا لتحليل الملفات الثنائية الأصلية، بينما يتطلبه التحليل المتعمق لهذه الملفات. اختر المتطلبات المسبقة وفقًا للهدف، بدلًا من اعتبار كل مزوّد اختياري إلزاميًا.

هل يستعيد REA الشيفرة المصدرية الأصلية؟

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

هل يمكنني تشغيل REA دون اشتراك في خدمة ذكاء اصطناعي؟

تستطيع واجهة CLI الخاصة بـ REA تشغيل أساليب عمل التحليل مباشرة. أما استخدام وكيل برمجة فيرتبط بمتطلبات الوصول الخاصة بذلك العميل وشروط مزوّد النموذج. ولا يوفّر ترخيص MIT الخاص بـ REA وصولًا إلى نموذج أو ترخيصًا لمحرك تحليل تجاري.

ماذا أفعل عندما يفشل أمر؟

تحقّق أولًا من المتطلبات المسبقة الموثّقة وحدّث REA. إذا كانت واجهة CLI مثبّتة على مستوى النظام، فإن rea update يحدّث التثبيت الذي تتبع له؛ أما إذا كان إعداد الوكيل يعتمد على npx، فأعد تشغيل npx rea-agents@latest setup ثم أعد تشغيل العميل. إذا استمر الفشل، فأبلغ عن إصدار REA ونظام التشغيل ونوع الهدف والمزوّد والخطوات ومخرجات الخطأ عبر نظام تتبّع المشكلات الرسمي.