إعداد REA.

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

سوف تحتاج Node.js 22 (22.19+), 24 (24.11+) أو 26+. npm يأتي مع Node.js.

ليس لديك Node.js, أو لست متأكدا?

افتح محطة وتحقق:

محطة
node -v
npm -v

إذا node -v يطبع الإصدار 22.19+ أو الإصدار 24.11+ أو الإصدار 26+ ، فأنت جاهز. إذا قام بطباعة إصدار أقدم أو "غير معروف" / "لم يتم العثور على الأمر" ، فقم بالتثبيت Node.js 24 لتر:

Windows (PowerShell)

Windows PowerShell
winget install OpenJS.NodeJS.LTS

اكتب Y إذا طُلب منك قبول الشروط. أغلق PowerShell وافتحه مجددًا، ثم شغّل node -v.

إذا قال PowerShell لاحقا "تشغيل البرامج النصية معطل على هذا النظام" عند تشغيل npx، قم بتشغيل هذا مرة واحدة وحاول مرة أخرى:

Windows PowerShell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

macOS

إذا كنت تستخدم Homebrew:

macOS · Homebrew
brew install node

خلاف ذلك:

macOS
curl -fsSL https://fnm.vercel.app/install | bash

إغلاق المحطة ، فتحه مرة أخرى ، ثم:

macOS
fnm install 24
fnm default 24

Linux

Linux
curl -fsSL https://fnm.vercel.app/install | bash

يحتاج المثبت curl و unzip (على دبيان / أوبونتو: sudo apt install curl unzip). إغلاق المحطة ، فتحه مرة أخرى ، ثم:

Linux
fnm install 24
fnm default 24

التوزيع الخاص بك nodejs غالبا ما تكون الحزمة أقدم من 22.19 ، لذا تحقق node -v إذا كنت تستخدم بدلا من ذلك.

تفضل المثبت العادي? تحميل النسخة لتس من nodejs.org.

قم بتوصيل مساعدك البرمجي

تشغيل الإعداد للاتصال REA إلى مساعدك البرمجي. تشمل خيارات العميل ما يلي Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Grok Build، وغيرها من الدعم MCP العملاء. يضاف موصل Grok Bot من الدردشة لها.

جديد في وكلاء الترميز?

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

إذا لم يكن لديك واحدة حتى الآن ، فاختر واحدة ، واتبع صفحة التثبيت الخاصة بها وقم بتسجيل الدخول:

  • Claude Code بواسطة Anthropic. يحتاج إلى دفع Claude خطة.
  • Codex بواسطة OpenAI. تسجيل الدخول باستخدام حساب تشاتغبت الخاص بك.
  • OpenCode, المصدر المفتوح. قم بتوصيل موفر النموذج الذي تختاره.

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

مساعدك البرمجي

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

أو قم بتشغيل الإعداد بنفسك
كيف يمكنني فتح محطة?
  • Windows: افتح قائمة ابدأ ، اكتب PowerShell واضغط على إدخال.
  • macOS: الصحافة ⌘ Space، النوع محطة واضغط على إدخال.
  • Linux: الصحافة Ctrl Alt T على معظم أجهزة الكمبيوتر المكتبية.

لصق أمر مع Ctrl V (macOS: ⌘ V; Linux المحطات: Ctrl Shift V) ، ثم اضغط أدخل.

محطة
npx rea-agents@latest setup

اختر عميلك وراجع خطة الإعداد. REA يضيف لها MCP الاتصال ومهارة التحقيق المطابقة ، مع الاحتفاظ بنسخة احتياطية من التكوين الحالي. يسأل قبل تطبيق التغييرات.

أعد تشغيل العميل عند انتهاء الإعداد.

كيف يمكنني إعادة تشغيل موكلي?

تطبيقات سطح المكتب (Claude سطح المكتب, Cursor, Windsurf, VS Code): قم بإنهاء التطبيق تماما ، ثم فتحه مرة أخرى. إغلاق النافذة لا يكفي. على macOS الصحافة ⌘ Q؛ على Windows، قم أيضا بإنهاء رمز الدرج إذا كان هناك رمز.

وكلاء المحطة الطرفية (Claude Code, Codex, Gemini CLI): الخروج من الدورة وبدء تشغيله مرة أخرى.

إعطاء وكيلك مسار الهدف وسؤال محدد. ل JavaScript أو Electron التطبيق ، قد تبدأ مع:

انظر إلى /absolute/path/to/app والعثور على كيفية تصدير البيانات. عرض نقاط الدخول والمكالمات والتبعيات المعنية ، مع مواقع المصدر للنتائج الخاصة بك.

استبدال المسار مع الهدف المحلي الخاص بك.

كيف يمكنني الحصول على المسار الكامل للمجلد?
  • Windows: في مستكشف الملفات ، انقر بزر الماوس الأيمن فوق المجلد واختر نسخ كمسار. على Windows 10 ، عقد التحول أثناء النقر بزر الماوس الأيمن.
  • macOS: في الباحث ، انقر بزر الماوس الأيمن فوق المجلد ، وعقد الخيار واختيار نسخ " as " كاسم مسار.
  • أي نظام: اسحب المجلد إلى نافذة طرفية ويظهر مساره.

في المحطة الطرفية ، ضع علامات اقتباس حول مسار يحتوي على مسافات.

استخدام CLI

تحليل JavaScript أو Electron مجلد التطبيق أو ASAR الأرشيف دون تشغيل التطبيق:

تحليل التطبيق الثابت
npx -y rea-agents@latest analyze-javascript-application \
  /absolute/path/to/app --json

استبدل المسار بدليل التطبيق المستخرج أو .asar ملف. على Windows، مسار مثل "D:/apps/example" يعمل هنا.

أين أجد التطبيق .ملف اسار?

Electron تطبيقات عادة يبقيه في resources المجلد:

  • Windows: C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar
  • macOS: /Applications/<App>.app/Contents/Resources/app.asar (انقر بزر الماوس الأيمن فوق التطبيق واختر عرض محتويات الحزمة)
  • Linux: في كثير من الأحيان /opt/<App>/resources/app.asar

يتم تثبيت بعض التطبيقات في مكان آخر. ابحث في مجلد التطبيق عن app.asar.

تحدد النتيجة التطبيق ، وتظهر الاتصالات بين الوحدات وتعطي مواقع مصدرها. اتصالات REA لا يمكن حل يتم وضع علامة في النتيجة.

إذا كنت ترغب في الحصول على وظيفة دائمة rea الأمر في قذيفة الخاص بك:

تثبيت CLI
npm install --global rea-agents

تواصل مع JavaScript دليل التطبيق

إعداد تحليل برامج رمز الجهاز

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

اختر أداة: Ghidra, Hopper أو IDA

Ghidra

استخدام القائمة Ghidra 12.1.س التثبيت و 64 بت جدك 21 أو أحدث على Linux أو macOS، على إكس 64 أو أرم 64. الخاص بك Ghidra يحتاج التثبيت إلى برنامج فك التحويل الأصلي لهندسة المضيف. اضبط المسارات قبل تشغيل الإعداد:

ربط الخاص بك Ghidra تركيب
Ghidra اتصال · macOS / Linux
export GHIDRA_INSTALL_DIR=/absolute/path/to/ghidra_12.1.4_PUBLIC
export JAVA_HOME=/absolute/path/to/jdk-21
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

استبدل كلا المسارين بالتثبيتات الموجودة لديك. يتحقق الإعداد منها ويسجل إعدادات صالحة للعميل الذي اخترته. على Linux أرم 64 ، قد تحتاج إلى بناء Ghidraالصورة المفكك الأصلي بشكل منفصل.

الاتصال Ghidra على Windows

Windows إكس 64 لديه دعم تجريبي للقراءة فقط لتطبيقات إكس 86 و إكس 64 بي و دلز على محركات نتفس المحلية الثابتة. استخدام القائمة Ghidra 12.1.س التثبيت و 64 بت جدك 21 أو أحدث:

Ghidra اتصال · Windows PowerShell
$env:GHIDRA_INSTALL_DIR = "C:/tools/ghidra_12.1.4_PUBLIC"
$env:JAVA_HOME = "C:/tools/jdk-21"
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

استبدال المسارين مع المنشآت الخاصة بك ، ثم مراجعة خطة الإعداد.

Hopper

الاتصال Hopper على macOS أو Linux. قم بتشغيل أمر الإعداد أعلاه ؛ يكتشف تثبيتا موجودا أو يقدم خطة تثبيت للموافقة عليها.

على macOS، كاملة Hopperخيار التشغيل الأول للوضع التجريبي أو تنشيط الترخيص قبل إجراء تحليل غير مراقب.

IDA

التحقق IDA استخدام الاجهزة Windows، مع وجود MCP التسجيل للحصول على واجهة المستخدم الرسومية المرفقة أو قاعدة بيانات مقطوعة الرأس. Linux و macOS لا يزال تحليل مقطوعة الرأس لم يتم التحقق منها.

ربط القائمة IDA MCP التسجيل

الحفاظ على عمل الخادم المنبع command, args واختياري env في ملف جسون. القائمة mcpServers كائن مع ida-pro-mcp يتم قبول الدخول أيضا. نقطة REA في هذا الملف قبل الإعداد:

IDA اتصال · Windows PowerShell
$env:REA_IDA_MCP_CONFIG = "C:/analysis/ida-mcp.json"
$env:REA_ANALYSIS_PROVIDER = "ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup

يستخدم الملف الشخصي المرفق أدوات 1.4.0 القديمة مع فتح الثنائي الأصلي بالفعل IDA. يستخدم الملف الشخصي مقطوعة الرأس واجهة برمجة تطبيقات المشرف على قاعدة البيانات الأولية والتسجيل باستخدام "mode": "headless"; التحقق الحقيقي يغطي IDA 9.3 Windows 64 مشرف. يتحقق الطبيب من التسجيل دون البدء IDA.

أعط REA المسار القابل للتنفيذ الأصلي ، مع --provider ida في CLI الاستعلام. بالنسبة للوكيل ، تشمل REA_IDA_MCP_CONFIG في ال REA بيئة التسجيل واختيار IDA عند فتح ثنائي.

للحصول على القائمة Ghidra الإعداد ، فحص وظيفة مع:

تحليل الوظيفة
npx -y rea-agents@latest function /absolute/path/to/program main \
  --provider ghidra --json

استبدال main مع اسم الوظيفة أو العنوان الذي تريد فحصه.

كيف يعمل تحليل جلسات برامج كود الآلة

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

اتبع مثال تحليل برامج كود الآلة لنرى كيف تؤدي نتيجة الوظيفة إلى عملية حسابية مستردة.

الحصول على المساعدة

إذا كان وكيلك لا يرى REA

أعد تشغيل العميل أو أعد توصيله بعد الإعداد. تحقق لها REA اتصال مع doctor؛ إلى عن على Codex:

تحقق من عميل واحد
npx -y rea-agents@latest doctor --client codex --json

إذا احتاج مقدم الخدمة إلى الاهتمام

تحقق من الموفر الذي تستخدمه. ل Ghidra:

تحقق من مزود واحد
npx -y rea-agents@latest doctor --provider ghidra --json

يعطي التقرير الاختيار الفاشل والخطوة التالية المقترحة.

أعلى