الإعداد والتحديثات
كيف أثبّت REA؟
بعد تجهيز Node.js وnpm، شغّل الإعداد واختر مساعدك البرمجي وراجع التغييرات المقترحة.
npx rea-agents@latest setup
يسجّل أمر الإعداد اتصال MCP الخاص بـ REA ويثبّت مهارة التحليل المناسبة. بعد اكتماله، أعد تشغيل مساعدك وأعطه مسار الملف وسؤالك. يوضّح دليل الإعداد المتطلبات وخطوات التحليل الأول.
ما هي عوامل الترميز التي يمكن استخدامها REA?
يمكنك استخدام أي مساعد يدعم خوادم MCP المحلية. يشمل الإعداد Claude Code وClaude Desktop وCodex وCursor وGemini CLI وWindsurf وDevin وOpenCode وAntigravity وGitHub Copilot CLI وCommand Code وGrok Build وOMP وVS Code. تُضاف وصلة Grok Bot من محادثته.
كيف أحدّث REA؟
REA الإصدارات بشكل متكرر ، بما في ذلك إصلاحات الأخطاء. إذا قمت بتثبيت CLI مع npm:
rea update
اتبع أمر تحديث الإعداد الذي يظهر بعد التحديث. إذا أعددت مساعدك باستخدام npx، فنفّذ:
npx rea-agents@latest setup
راجع التغييرات وأعد تشغيل مساعدك. يستخدم اتصال REA إصدارًا محددًا من الحزمة، لذلك أعد تشغيل الإعداد لاستخدام الإصدار الجديد. لتنفيذ أمر CLI مرة واحدة، أضف الأمر بعد npx -y rea-agents@latest.
يتم تثبيت المهارة من skills.sh كفى?
تزوّد المهارة مساعدك بتعليمات التحليل. شغّل إعداد REA لتوصيل خادم MCP وتثبيت المهارة المناسبة، ثم أعد تشغيل مساعدك ليتمكّن من استخدام الأدوات.
التحليل
ماذا يمكنني تحليل مع REA?
تبدأ مع هذا النوع من البرامج لديك:
- الملفات التنفيذية والمكتبات الأصلية: الدوال وتعليمات التجميع والكود شبه البرمجي والمراجع.
- JavaScript و Electron التطبيقات: الوحدات والواردات والتصنيف الدولي للبراءات ومواقع المصدر.
- صفحات المتصفح: البرامج النصية والطلبات وملاحظات وقت التشغيل.
يدعم REA أيضًا تحليل تجميعات .NET وغيرها من التجميعات المُدارة وملفات Android APK والبرامج الثابتة والموارد المعبأة. تعرض دراسات الحالة أمثلة عملية.
هل أحتاج Hopper, Ghidra أو IDA?
يستخدم التحليل المتعمّق للبرامج الأصلية إحدى هذه الأدوات. أما الفحص الثابت لـ JavaScript و.NET فيعمل على الملفات المقدّمة ولا يحتاج إلى محرك تحليل أصلي.
وصّل تثبيت Ghidra أو IDA الموجود لديك، أو دع الإعداد يكتشف Hopper ويقترح تثبيته. تعتمد الأداة المتاحة على نظام التشغيل والهدف. إعداد التحليل الأصلي.
هل يمكنني استخدام REA بدون المساعد البرمجي?
نعم. تستخدم CLI عمليات التحليل نفسها. لتحليل تطبيق JavaScript أو Electron محلي:
npx -y rea-agents@latest analyze-javascript-application \
/absolute/path/to/app --json
استبدل المسار بمجلد التطبيق المستخرج أو ملف ASAR. راجع استخدام CLI لخيارات التثبيت.
ما الكود الذي يعيده REA؟
يعيد تحليل البرامج الأصلية تعليمات التجميع والكود شبه البرمجي، مع استدعاءات الدوال والمراجع والثوابت ذات الصلة. ويعيد تحليل JavaScript الوحدات والعلاقات بينها ومواقعها في الكود المصدري.
يستخدم مساعدك النتائج لشرح السلوك أو كتابة تنفيذ واختباره. توضح حسابات DX-Ball وأداة التحقق من flag في CTF هذه العملية.
ماذا أسأل مساعدي؟
أعطه هدفًا محليًا وسلوكًا واحدًا تريد فهمه. مثال لتطبيق JavaScript أو Electron:
استخدم REA لتحليل /absolute/path/to/app واشرح كيف يصدّر البيانات. اعرض الكود المرتبط ومواقعه في المصدر.
استبدل المسار بهدفك. تحتوي الأدلة على طلبات نموذجية للبرامج الأصلية وElectron والمتصفح.
استكشاف الأخطاء وإصلاحها
لماذا لا يستطيع وكيل أعمالي رؤية REA أدوات?
أعد تشغيل مساعدك أو اتصاله بعد الإعداد. افحص تسجيل REA باستخدام doctor؛ مثال لـ Codex:
npx -y rea-agents@latest doctor --client codex --json
استبدل codex بمعرّف العميل، مثل claude_code أو cursor. إذا أظهر التقرير تسجيلًا مفقودًا أو قديمًا، فأعد الإعداد لذلك العميل:
npx rea-agents@latest setup --client codex
راجع الخطة وأعد تشغيل العميل. إذا كان التسجيل سليمًا لكن الأدوات لا تظهر، فافحص خطأ اتصال MCP لدى العميل. تشخيصات إعداد إضافية.
هل أحتاج إلى البدء Hopper أولا?
يشغّل REA برنامج Hopper عندما تتطلّبه العملية. على macOS، اختر الوضع التجريبي أو فعّل الترخيص في شاشة التشغيل الأول قبل بدء التحليل دون تدخل. إعداد أدوات التحليل الأصلية.
ماذا أفعل إذا واجهت خطأ؟
حدّث REA وأعد تشغيل مساعدك، ثم جرّب المهمة نفسها. قد يكون الإصدار الأخير قد أصلح المشكلة بالفعل.
إذا استمرت المشكلة، افتح issue واذكر إصدار REA ونظام التشغيل ونوع الهدف وخطوات إعادة إنتاج المشكلة ومخرجات الخطأ. أضف اسم أداة التحليل إذا كانت المشكلة تتعلق بالتحليل الأصلي.
البيانات والمشاركة
هل REA تحميل تطبيقي?
يحلّل REA الأهداف على جهازك. يستقبل مساعدك النتائج، وتخضع هذه النتائج لسياسة البيانات الخاصة بمزوّد نموذجه.
كيف يمكنني مشاركة مثال أو المساهمة?
هل لديك مثال مفيد باستخدام REA؟ يسعدنا رؤيته. شارك الهدف وسؤالك والنتائج وطريقة التحقق منها في issue أو pull request. تساعد مقاطع الكود القصيرة والرسوم الآخرين على متابعة التحليل.
نرحب أيضًا بتقارير الأخطاء وطلبات الميزات وتحسينات الكود والوثائق. يمكنك مناقشة المثال في المجتمع.