1. جهّز جهازك
استخدم الجهاز الذي توجد عليه ملفات البرنامج المراد فحصه. يستطيع مساعد البرمجة المحلي قراءة هذه الملفات وتشغيل الأدوات لك.
كيف أفتح الطرفية؟
- Windows: افتح قائمة ابدأ ، اكتب PowerShell واضغط على إدخال.
- macOS: اضغط ⌘ Space، واكتب Terminal ثم اضغط Enter.
- Linux: اضغط Ctrl Alt T في معظم بيئات سطح المكتب.
لصق أمر مع Ctrl V (macOS: ⌘ V; Linux المحطات: Ctrl Shift V) ، ثم اضغط أدخل.
اكتب الأوامر في الطرفية. أما النصوص الموسومة «مساعد البرمجة» فأرسلها في محادثة المساعد.
سوف تحتاج Node.js 22 (22.19+), 24 (24.11+) أو 26+. npm يأتي مع Node.js.
ليس لديك Node.js, أو لست متأكدا?
افتح طرفية وتحقق:
node -v
npm -v
إذا عرض node -v v22.19+ أو v24.11+ أو v26+، فأنت جاهز. إذا عرض إصدارًا أقدم أو "not recognized" / "command not found"، فثبّت Node.js 24 LTS:
Windows (PowerShell)
winget install --exact --id OpenJS.NodeJS.LTS
اكتب Y إذا طُلب منك قبول الشروط. أغلق PowerShell وافتحه مجددًا، ثم شغّل node -v.
نزّل مثبت Node.js إذا لم يتوفر winget.
إذا ظهرت لاحقًا في PowerShell رسالة "running scripts is disabled on this system" عند تشغيل npx، فاستخدم npx.cmd بدلًا منه. ولـ npm، استخدم npm.cmd:
npx.cmd rea-agents@latest setup
macOS
للتثبيت لأول مرة، نزّل مثبت Node.js 24 LTS لـ macOS (.pkg)، وافتحه واتبع التعليمات. ثم أعد فتح Terminal.
هل تستخدم Homebrew بالفعل؟
brew install node
Linux
ثبّت curl وunzip أولًا إن لم يكونا موجودين. على Debian أو Ubuntu، شغّل sudo apt install curl unzip؛ وعلى التوزيعات الأخرى، استخدم مدير الحزم لديك.
curl -fsSL https://fnm.vercel.app/install | bash
أغلق الطرفية، ثم افتحها مجددًا ونفّذ:
fnm install 24
fnm use 24
fnm default 24
التوزيع الخاص بك nodejs غالبا ما تكون الحزمة أقدم من 22.19 ، لذا تحقق node -v إذا كنت تستخدم بدلا من ذلك.
تفضل المثبت العادي? تحميل النسخة لتس من nodejs.org.
أنشئ مجلد عمل لمساعدك
في الطرفية، أنشئ مجلدًا لهذا التمرين ثم انتقل إليه:
mkdir rea-work
cd rea-work
اترك هذه الطرفية مفتوحة للخطوة التالية. إذا كان لديك مجلد عمل بالفعل، فافتحه بدلًا من إنشاء مجلد جديد.
2. اختر مساعد برمجة
مساعدك هو الذكاء الاصطناعي الذي تتحدث إليه. يزوّده REA بأدوات الفحص. اختر أحد التطبيقات أدناه؛ افتح تعليماته إذا لم تستخدمه من قبل.
Codex · استخدم حساب ChatGPT
ثبّت Codex بالأمر المناسب لنظام تشغيلك:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
بعد التثبيت، أعد فتح الطرفية وعد إلى مجلد العمل. ثم شغّل Codex:
codex
اختر «Sign in with ChatGPT»، وأكمل تسجيل الدخول في المتصفح ثم عد إلى الطرفية. عندما تظهر خانة الرسائل، انتقل إلى الخطوة 3.
Cursor أو Windsurf أو VS Code · استخدم محررًا
- ثبّت المحرر المناسب لنظام تشغيلك وسجّل الدخول.
- افتح مجلد rea-work الذي أنشأته في الخطوة 1.
- افتح محادثة الذكاء الاصطناعي واختر وضع Agent. في Windsurf أو Devin Desktop، افتح محادثة المساعد؛ وفي VS Code، جهّز GitHub Copilot أولًا.
إعداد Cursor · إعداد Windsurf / Devin Desktop · إعداد VS Code وCopilot
Claude Code · استخدم حساب Claude
ثبّته بالأمر المناسب لنظام تشغيلك:
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.sh | bash
أعد فتح الطرفية، وعد إلى مجلد العمل وشغّل claude. اتبع تعليمات تسجيل الدخول. يتطلب الوصول اشتراك Claude مؤهلًا أو حساب API مُعدًّا.
Claude Desktop · استخدم محادثة سطح المكتب
ثبّت Claude Desktop على Windows أو macOS وسجّل الدخول. أغلقه بالكامل، ثم نفّذ هذا الأمر في طرفية فتحتها خارج Claude:
npx rea-agents@latest setup --client claude_desktop
راجع الخطة ووافق عليها، ثم أعد فتح Claude وتحقق من الاتصال في الخطوة 3.
OpenCode · اختر نموذج ذكاء اصطناعي
npm install --global opencode-ai
شغّل opencode في مجلد العمل. استخدم /connect في محادثته لربط حساب نموذجك، ثم اختر نموذجًا.
جميع التطبيقات المدعومة ومعرّفات الإعداد
يدعم إصدار npm 6.4.0 التطبيقات أدناه. استخدم المعرّف مع --client عند اختيار تطبيق محدد.
| التطبيق | معرّف الإعداد |
|---|---|
| Claude Code | claude_code |
| Claude Desktop | claude_desktop |
| Codex | codex |
| Cursor | cursor |
| Gemini CLI | gemini_cli |
| Windsurf | windsurf |
| Devin | devin |
| OpenCode | opencode |
| Antigravity | antigravity |
| GitHub Copilot CLI | copilot_cli |
| Command Code | commandcode |
| Qwen Code | qwen_code |
| VS Code | vscode |
| Grok Build | grok_build |
| OMP | omp |
| Pi | pi |
| Hermes | hermes |
يتوفر Qoder (qoder) وFactory Droid (droid) وTrae (trae) وZCode (zcode) وDeepSeek Harness (dsh) في فرع main للمستودع؛ استخدم بناءً من المصدر أو إصدارًا يتضمن هذه التكاملات.
إعداد التطبيقات وحل المشكلات · التوفر في الإصدارات
Grok Bot · اربطه على الجهاز المستضاف الذي يعمل عليه
في محادثة Grok Bot، اطلب منه إضافة خادم MCP مخصص باسم rea باستخدام هذا الأمر على جهاز Bot:
npx -y rea-agents@6.4.0 mcp
3. اربط REA
انسخ هذا الطلب إلى مساعد البرمجة لديك:
ثبّت REA واربطه بمساعد البرمجة هذا باستخدام npx rea-agents@latest setup. اعرض خطة الإعداد أولاً وانتظر موافقتي، ثم تحقّق من التثبيت.
أو قم بتشغيل الإعداد بنفسك
npx rea-agents@latest setup
لاختيار تطبيق محدد، أضف معرّف إعداده:
npx rea-agents@latest setup --client codex
إذا طلب npm تنزيل الحزمة، فاكتب y واضغط Enter. في قائمة تطبيقات REA، تنقّل بمفاتيح الأسهم، واضغط Space لتحديد تطبيقك وEnter للمتابعة.
اختر تطبيق المساعد وراجع خطة الإعداد. يضيف REA اتصال MCP ومهارة الفحص المناسبة، مع الاحتفاظ بنسخة احتياطية من الإعداد الحالي. يطلب موافقتك قبل تطبيق التغييرات.
MCP هو الاتصال الذي يتيح لمساعدك استدعاء REA. وتزوّده المهارة بخطوات عمل لفحص البرامج.
في التمرين الأول، يمكنك تخطي تثبيت Hopper الاختياري. أعد تشغيل تطبيق المساعد عند انتهاء الإعداد.
كيف أعيد تشغيل تطبيق المساعد؟
تطبيقات سطح المكتب (Claude Desktop وCursor وWindsurf وVS Code): أغلق التطبيق بالكامل ثم افتحه مجددًا. إغلاق النافذة وحده لا يكفي. على macOS اضغط ⌘ Q؛ وعلى Windows، أغلقه أيضًا من أيقونة علبة النظام إن وجدت.
وكلاء المحطة الطرفية (Claude Code, Codex, Gemini CLI): الخروج من الدورة وبدء تشغيله مرة أخرى.
npx -y rea-agents@latest doctor --client codex --json
استبدل codex بمعرّف إعداد تطبيقك. يعرض الفحص الناجح "healthy": true. ثم اسأل مساعدك:
تحقق من اتصال REA واعرض أدوات REA التي يمكنك استخدامها.
4. جرّب أول فحص لك
المثال هو ملف ستة Electron التطبيق مع ملاحظات التصدير زر. وكيلك يمكن فحص التعليمات البرمجية الخاصة به دون تثبيت أو إطلاق Electron.
تحميل https://rea.tools/examples/notes-example.zip في مجلد مثال جديد وفك ضغطه. استخدام REA للعثور على ما يحدث عند النقر فوق تصدير الملاحظات. أظهر أين notes.csv هو مكتوب ، والحقول التي يحتوي عليها ، والملفات والخطوط ذات الصلة.
ابحث عن شرح قصير مع مراجع الملفات والخط:
يرسل الزر رسالة
notes:export. تحوّل العملية الرئيسية الملاحظات إلى CSV وتحفظ ملفnotes.csvفي مجلد التنزيلات الخاص بالمستخدم. أسماء الأعمدة هيidوtitle.
اختبر توقعًا في التمرين الموجّه ←
نزّل المثال بنفسك أو استخدم تطبيقك
إذا لم يتمكن وكيلك من تنزيل الملفات ، فقم بفك ضغط هذا الأرشيف بنفسك. تعطيه الطريق إلى notes-example المجلد ونفس سؤال التصدير.
استخدم REA لفحص التطبيق الموجود في
/absolute/path/to/app. اعثر على طريقة تصديره للبيانات، واعرض الملفات والأسطر ذات الصلة.
كيف يمكنني الحصول على المسار الكامل للمجلد?
- Windows: في File Explorer، انقر بزر الفأرة الأيمن على المجلد واختر Copy as path. على Windows 10، اضغط باستمرار على Shift أثناء النقر بزر الفأرة الأيمن.
- macOS: في Finder، انقر بزر الفأرة الأيمن على المجلد، واضغط باستمرار على Option ثم اختر Copy "…" as Pathname.
- أي نظام: اسحب المجلد إلى نافذة طرفية ويظهر مساره.
في المحطة الطرفية ، ضع علامات اقتباس حول مسار يحتوي على مسافات.
حلّل نوعًا آخر من البرامج
اختر القسم المناسب لما تريد فحصه. موفر التحليل هو الأداة المحلية التي يستخدمها REA لتحليل هذا النوع من البرامج.
الملفات التنفيذية والمكتبات الأصلية · Hopper أو Ghidra أو IDA
ثبّت أداة تحليل واحدة على الجهاز الذي يشغّل REA. المضيف هو نظام تشغيلك، والهدف هو البرنامج الذي تريد فحصه.
| أداة التحليل | Windows | macOS | Linux |
|---|---|---|---|
| Hopper | غير متاح | 12+ | التوزيعات المدعومة |
| Ghidra | x64 · تجريبي | x64 / arm64 | x64 / arm64 |
| IDA | أنماط التشغيل المتحقق منها | نمط تشغيل دون واجهة رسومية متحقق منه | راجع دليل أداة التحليل |
Hopper · دع الإعداد يثبّته أو يربطه
الاتصال Hopper على macOS أو Linux. قم بتشغيل أمر الإعداد أعلاه ؛ يكتشف تثبيتا موجودا أو يقدم خطة تثبيت للموافقة عليها.
اختر Hopper أثناء الإعداد وراجع خطة تثبيته المنفصلة. على macOS، اختر الوضع التجريبي أو فعّل ترخيصك عندما يفتح Hopper لأول مرة. على Linux، يجهّز الإعداد النسخة التجريبية المدعومة وشاشتها الخاصة.
أنظمة Linux المضيفة: Ubuntu 24.04+ وFedora 41+ وNobara 44+ وArch Linux وCachyOS أو Omarchy. Hopper برنامج تجاري؛ للنسخة التجريبية حدود تحددها الشركة المنتجة.
npx -y rea-agents@latest doctor --provider hopper --json
إذا طلب macOS إذن Automation، فاسمح للتطبيق الذي يبدأ REA في System Settings → Privacy & Security → Automation، ثم أعد المحاولة.
Ghidra · ثبّت أداة التحليل المجانية وJava
- ثبّت JDK بإصدار 21 أو أحدث وبمعمارية 64 بت، بما فيه مترجم Java. اختر الحزمة المطابقة لمعمارية جهازك.
-
نزّل Ghidra 12.1.4 من قائمة Assets للإصدار وفك ضغط أرشيف
ghidra_…_PUBLIC_….zip. اختر أرشيف الإصدار، لا «Source code». -
اعثر على المجلد الذي يحتوي على
ghidraRunأوghidraRun.batبعد فك الضغط. استخدم هذا المجلد لـGHIDRA_INSTALL_DIR.
تنزيل JDK · تنزيل Ghidra 12.1.4
تحقق من Java. يعرض الأمر الأول java.home؛ استخدم ذلك المجلد لـ JAVA_HOME. ويتحقق الأمر الثاني من تثبيت المترجم:
java -XshowSettings:properties -version
javac -version
الاتصال Ghidra على Windows
على Windows x64، يتوفر دعم تجريبي للقراءة فقط لتطبيقات PE ومكتبات DLL الأصلية بمعمارية x86 وx64 على أقراص NTFS المحلية الثابتة. استخدم نسخة مثبتة من Ghidra 12.1.x وJDK بمعمارية 64 بت وإصدار 21 أو أحدث:
$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
استبدال المسارين مع المنشآت الخاصة بك ، ثم مراجعة خطة الإعداد.
ربط الخاص بك Ghidra تركيب
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"
استبدل المسارين بمساري نسختيك المثبتتين. عند تثبيت نسخة جديدة على macOS أو Linux arm64، ابنِ أداة فك الترجمة الأصلية لجهازك قبل المتابعة.
ابنِ أداة فك الترجمة الأصلية لـ Ghidra
على macOS، يتطلب البناء Xcode Command Line Tools وmake وbison. استخدم الدليل المناسب لجهازك:
ثم افحص Ghidra واحفظ مساراته لتطبيق المساعد:
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup
نفّذ هذه الأوامر في جلسة الطرفية نفسها. أعد تشغيل الإعداد بعد تعيين المسارات، ووافق على إعداد التطبيق المحدّث ثم أعد تشغيل مساعدك.
IDA · اربط نسخة مثبتة لديك
استخدم دليل موفر IDA لإعداد تسجيل MCP للخادم الأصلي. اختر واجهة رسومية متصلة يكون الملف الثنائي الأصلي مفتوحًا فيها، أو مشرفًا دون واجهة رسومية يفتح قاعدة بيانات خاصة.
تشمل أنماط التشغيل المتحقق منها واجهة Windows الرسومية القديمة والمشرف دون واجهة رسومية، إضافة إلى مشرف دون واجهة رسومية على macOS arm64 مع IDA Professional 9.1. لجسر الواجهة الرسومية الأصلي الاختياري متطلبات إصدار ومنصة خاصة به.
يتطلب وضع macOS دون واجهة والجسر الأصلي للواجهة الرسومية بناء REA من المصدر أو إصدارًا يتضمن هذه التغييرات. إصدار npm 6.4.0 لا يتضمنها.
من مجلد المصدر بعد بنائه، شغّل node scripts/rea.mjs doctor --provider ida --json وnode scripts/rea.mjs setup بدلًا من أوامر npx أدناه.
جهّز ملف تسجيل IDA
ثبّت الخادم الأصلي وأعدّه باتباع دليل IDA أدناه. ثم احفظ تسجيله العامل باسم ida-mcp.json في محرر نصوص. على Windows، اختر «All files» عند الحفظ في Notepad كي لا يضيف الامتداد .txt.
لمشرف دون واجهة رسومية يوفّر idb_open وidb_list وidb_close، يمكن أن يكون الملف بهذا الشكل:
{
"command": "idalib-mcp",
"args": ["--stdio", "--max-workers", "1"],
"mode": "headless"
}
لخادم الواجهة الرسومية القديمة المتصل بإصدار 1.4.0، انسخ قيم command وargs وenv الاختيارية من تسجيله العامل إلى الملف. افتح الملف الثنائي الأصلي في IDA وابدأ الملحق الأصلي قبل أن تطلب من REA فحصه.
$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
export REA_IDA_MCP_CONFIG="/absolute/path/to/ida-mcp.json"
export REA_ANALYSIS_PROVIDER="ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup
استخدم ملف تسجيل JSON الذي أعددته باتباع دليل الموفر، ثم أعد تشغيل الإعداد ومساعدك.
بعد الربط، أعط مساعدك المسار الكامل للملف التنفيذي الأصلي واذكر أداة التحليل:
استخدم REA مع أداة التحليل التي أعددتها لفحص
/absolute/path/to/program. اعرض الدوال والنصوص، ثم اشرح الجزء الذي يعالج مدخلات المستخدم مع الإشارة إلى الكود.
مواقع الويب وAndroid و.NET والبرامج الثابتة وغيرها
افتح دليل النوع الذي تريد فحصه. يوضح كل دليل الأدوات الإضافية والأنظمة المضيفة المدعومة والأمر الأول.
| الهدف | أدوات ينبغي تجهيزها | الدليل |
|---|---|---|
| JavaScript / Electron | Node.js + npm | افتح الدليل |
| موقع ويب | Chrome / Chromium / Edge | افتح الدليل |
| .NET / Flutter / الحزم | Node.js + npm | افتح الدليل |
| Android APK | JADX + JDK 17+ | افتح الدليل |
| جهاز Android | adb | افتح الدليل |
| موارد Android | Apktool + Java | افتح الدليل |
| مشروع JEB | JEB + MCP | افتح الدليل |
| البرامج الثابتة | Binwalk / Unblob · Linux | افتح الدليل |
| WASM | WABT | افتح الدليل |
| قاعدة بيانات SQLite | Node.js 24.15+ / 26+ | افتح الدليل |
| بايت كود EVM | Node.js · Linux x64 | افتح الدليل |
| ELF / تعطل Linux | pwntools / GDB / pwndbg | افتح الدليل |
| HAR / SAZ / mitmproxy | Node.js / mitmdump | افتح الدليل |
| PCAP / PCAPNG | TShark / capinfos · Linux | افتح الدليل |
| الإشارات المنطقية | sigrok-cli · Linux | افتح الدليل |
| سلوك العمليات | PTY · Linux / macOS | افتح الدليل |
دليل Flutter · الحزم والموارد · بايت كود EVM · جميع أدلة الفحص
استخدم REA من الطرفية
أوامر CLI والتثبيت العام وcurl
تحليل JavaScript أو Electron مجلد التطبيق أو ASAR الأرشيف دون تشغيل التطبيق:
npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json
استبدل المسار بدليل التطبيق المستخرج أو .asar ملف. على Windows، مسار مثل "D:/apps/example" يعمل هنا.
أين أجد ملف .asar للتطبيق؟
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 متاحًا دائمًا في بيئة الأوامر لديك:
npm install --global rea-agents
تواصل مع JavaScript دليل التطبيق
npx -y rea-agents@latest function "/absolute/path/to/program" main --provider ghidra --json
استبدل main باسم دالة أو عنوانها من قائمة دوال الهدف. يجب إعداد Ghidra أولًا.
على macOS أو Linux، يمكنك أيضًا استخدام مثبت curl بعد تجهيز Node.js:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
اتبع تعليمات الإعداد لربط وكيلك. إذا لم تظهر، شغّل rea setup.
إذا لم تجد الصدفة rea، فاستخدم مسار الملف التنفيذي الذي يطبعه المثبّت. في Linux، أمر الإعداد الافتراضي هو "$HOME/.local/bin/rea" setup.
الحصول على المساعدة
إذا كان وكيلك لا يرى REA
أعد تشغيل العميل أو أعد توصيله بعد الإعداد. تحقق لها REA اتصال مع doctor؛ إلى عن على Codex:
استخدم فحص التطبيق في الخطوة 3 مع معرّف إعدادك. في المحررات، فعّل REA في إعدادات MCP واسمح باستخدام أدواته في محادثة المساعد.
إذا احتاج مقدم الخدمة إلى الاهتمام
تحقق من الموفر الذي تستخدمه. ل Ghidra:
npx -y rea-agents@latest doctor --provider ghidra --json
يعطي التقرير الاختيار الفاشل والخطوة التالية المقترحة.
Windows وWSL والمسارات التي تحتوي على مسافات
استخدم Windows PowerShell لتطبيقات Windows وأدوات تحليله. إذا كان مساعدك يعمل داخل WSL، فثبّت Node.js وREA داخل بيئة Linux تلك واستخدم مسارات Linux فيها. تعمل موفرات التحليل دون واجهة رسومية على الجهاز نفسه الذي يشغّل REA.
في المحطة الطرفية ، ضع علامات اقتباس حول مسار يحتوي على مسافات.
أمر إعداد Windows:
npx.cmd rea-agents@latest setup
تحديث REA أو إزالته
لتحديث اتصال مساعدك، شغّل أحدث أمر إعداد مجددًا، وراجع خطته ثم أعد تشغيل تطبيق المساعد.
npx rea-agents@latest setup
إذا ثبّتَّ CLI العام، فحدّثه باستخدام rea update. استخدم npx rea-agents@latest uninstall لإزالة إعداد تطبيقات REA ومهارته.
- REA الأسئلة الشائعةإجابات سريعة على التحديثات والوكلاء والتحليل.
- اختر دليل التحقيقأمثلة عملت لثنائي ، وهو Electron التطبيق ومتصفح.
- GitHub القضاياالإبلاغ عن مشكلة في الأمر والتشخيص.
- REA المجتمعالأسئلة والتحقيقات والعمل الجاري.
