عندما يحاول فريق هندسي فهم كيف يحقق تطبيق مكتبي مغلق المصدر سرعة بحث محلية بأجزاء من المللي ثانية، أو أي قنوات IPC تمررها حزمة Electron عبر طبقة preload إلى العملية الرئيسية، أو كيف يوقّع ملف ثنائي قديم طلبات الشبكة، فالعقبة الحقيقية نادراً ما تكون غياب أدوات التفكيك. الهدر الفعلي للوقت يحدث أثناء نقل السياق يدوياً بين جداول رموز Ghidra، وشيفرات Hopper التقريبية، وأشجار JADX، وسجلات HAR. بعد تجاوزها 466,000 نجمة على GitHub، صُممت أداة morluto/rea (REA — Reverse Engineer Anything) لسد فجوة التنسيق هذه بدقة هندسية.
تُعد REA (rea-agents) حزمة أوامر طرفية (CLI) وخادم Model Context Protocol (MCP) مفتوح المصدر (io.github.morluto/rea) بترخيص MIT. وهي ليست أداة سحرية تنسخ الشيفرة المصدرية الأصلية من العدم، بل تعمل كجسر برمجي يربط وكلاء الذكاء الاصطناعي — مثل Claude Code وCursor وCodex وGemini CLI — بالمحللات الساكنة المدمجة وأدوات الهندسة العكسية الاحترافية مثل Ghidra وHopper وIDA Pro وKuna وJADX، مع إرجاع نتائج مدعومة بالعناوين المرجعية وحدود التحليل الصريحة.
الخلاصة التنفيذية والمرتكزات المعمارية
- تنسيق MCP قائم على الأدلة لا التخمين: تفحص REA الملفات الثنائية وحزم
.asarمحلياً، وتُرجع خرائط الاستدعاءات والشيفرة التقريبية والقيود المعروفة ليتمكن الوكيل من بناء تنفيذ برمجي نظيف ومختبر. - حماية نافذة السياق في النماذج اللغوية: عبر ملف تعريف مخططات الإدخال المضغوطة وميزانية 4,096 بايت لمخططات الإخراج (
REA_MCP_OUTPUT_SCHEMA_PROFILE=compact) وسقف 4 MiB للمخرجات، تمنع استنزاف الرموز (Tokens) عند تحليل الملفات الضخمة. - حتمية العزل الخادمي (Zero-Trust): نظراً لإمكانية رسم خرائط حزم Electron
.asarوملفاتsource mapsالمكشوفة خلال دقائق، يجب عزل منطق الأعمال الحساس بالكامل على الخادم.
مع توسع المؤسسات في تبني حلول الذكاء الاصطناعي للمؤسسات وخطوط الهندسة المعتمدة على الوكلاء، بات فحص الأنظمة الموروثة وتدقيق انكشاف حزم الواجهة جزءاً أصيلاً من تطوير البرمجيات المخصصة. نستعرض في هذا الدليل بنية الإصدار v6.9.0 من REA، وخطوات التشغيل ودمجها في CI/CD، وضوابط الحماية للمؤسسات.
1. البنية الجوهرية: جسر MCP للأدلة التقنية وليس مفكك شيفرات معزولاً
على خلاف المبالغات المتداولة على المنصات الاجتماعية، لا تختلق REA شيفرة مصدرية عبر التخمين الإحصائي. يعمل النظام على بيئة Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 كحزمة ESM خالصة ("type": "module") تحول أسئلة المهندس الطبيعية إلى استدعاءات حتمية لأدوات التحليل المحلية.

هندسة ميزانية السياق وضغط المخططات
إن إرسال جداول الرموز الخام مباشرة إلى نموذج لغوي يستهلك نافذة السياق فوراً. ووفقاً إلى التوثيق الرسمي لمنصة REA، يطبق الخادم ثلاثة ضوابط معمارية:
- ملف مخططات الإدخال المضغوطة: يعلن الخادم عن مخططات إدخال مختصرة أثناء
tools/listلتقليل استهلاك الرموز مع الحفاظ الكامل على التحقق الصارم من الأنواع داخل الخادم. - ميزانية 4,096 بايت لمخططات الإخراج: يحذف الخادم مخططات الإخراج افتراضياً من
tools/listويتحقق من كل نتيجة ذاتياً؛ وعند تفعيلREA_MCP_OUTPUT_SCHEMA_PROFILE=compactيقيّد كل مخطط بسقف 4,096 بايت. - عزل عمليات التحليل وسقف 4 MiB: تُنفذ تحليلات JavaScript وحزم الويب داخل عمليات مستقلة (
#javascript-analysis-workerو#web-bundle-analysis-worker) مع الاحتفاظ بحد أقصى قدره 4 MiB من مخرجاتstdout/stderr.
2. خطوات التثبيت وفحص الجاهزية وبوابة التدقيق الآلي في CI/CD
تعمل REA بنفس الكفاءة سواء عبر المحادثة داخل وكيل الذكاء الاصطناعي أو عبر أوامر الطرفية المباشرة. وفي أنظمة Linux، يتطلب تشغيل Ghidra وJADX وتحليل Electron الساكن وجود أداة ps متوافقة مع procps للتحقق من ملكية العمليات.
الخطوة 1: إعداد الوكيل وتثبيت الطرفية
من مجلد موثوق خارج نطاق المشروع المستهدف ومع توفر Node.js 22.23.4+:
# اكتشاف وكلاء الذكاء الاصطناعي تلقائياً وأخذ نسخة احتياطية وتسجيل خادم MCP
npx rea-agents setup
# تثبيت اختياري لأداة rea عالمياً للاستخدام المباشر في الطرفية
npm install --global rea-agents
# فحص جاهزية المحركات المرتبطة (Ghidra, Hopper, IDA, JADX)
rea doctor --json
# تحديث التثبيت العالمي عبر المسار الموثق
rea update
يتعرف المعالج تلقائياً على Claude Code وCursor وCodex وGemini CLI وGrok Build، ويعرض التعديلات المقترحة مع حفظ نسخة احتياطية قبل التطبيق. أعد تشغيل الوكيل بعد اكتمال الإعداد.
الخطوة 2: فحص انكشاف حزم Electron وJavaScript برمجياً داخل CI/CD
يفحص التحليل الساكن لتطبيقات JavaScript وحزم .asar وتجميعات .NET الملفات دون تشغيلها ودون الحاجة إلى مفكك خارجي. يوضح مثال TypeScript التالي بوابة تحقق تمنع نشر حزم إنتاج تتضمن ملفات source map مكشوفة:
import { execFile } from "node:child_process";
import { promisify } from "node:util";
import path from "node:path";
const execFileAsync = promisify(execFile);
export interface ReaJsModuleFinding {
readonly modulePath: string;
readonly imports: readonly string[];
readonly ipcChannels: readonly string[];
readonly hasSourceMap: boolean;
}
export interface ReaJsAnalysisReport {
readonly targetPath: string;
readonly electronBoundaries: readonly string[];
readonly modules: readonly ReaJsModuleFinding[];
readonly limitations: readonly string[];
}
export async function runReaBundleExposureGate(
rawAppDirectory: string,
): Promise<{ passed: boolean; violations: string[]; report: ReaJsAnalysisReport }> {
const resolvedTarget = path.resolve(rawAppDirectory);
const { stdout } = await execFileAsync(
"npx",
["-y", "rea-agents@latest", "analyze-javascript-application", resolvedTarget, "--json"],
{
timeout: 120_000,
maxBuffer: 4 * 1024 * 1024,
windowsHide: true,
},
);
const report = JSON.parse(stdout) as ReaJsAnalysisReport;
const violations: string[] = [];
for (const mod of report.modules) {
if (mod.hasSourceMap) {
violations.push(`تم رصد ملف source map مكشوف في حزمة الإنتاج: ${mod.modulePath}`);
}
}
return {
passed: violations.length === 0,
violations,
report,
};
}
3. نطاق الأهداف المدعومة: من التحليل الساكن إلى الملفات الأصلية وبيئات التعلم المعزز
يوفر الإصدار v6.9.0 تغطية لأكثر من 30 نوعاً من الملفات الثنائية وبيئات التشغيل:
أ. المحللات الساكنة المدمجة (دون محركات خارجية)
- تطبيقات JavaScript والويب وElectron: خرائط الوحدات، المسارات، حدود
preloadوIPC، الإضافات الأصلية، وفحصrea audit-release-exposure. - اللغات المترجمة والمدارة: ملفات Go الثنائية، وRust (
cargo-auditable)، وتجميعات.NET(تعليمات CIL)، وتنفيذيات PyInstaller (CArchive)، وملفاتDeno compile. - محركات الألعاب ونماذج الذكاء الاصطناعي وتحصين الملفات: بيانات Unity
IL2CPP(الإصدارات 24 و27 و29 و31 و39)، وأرشيفات GodotPCK، وترويسات نماذجGGUFوsafetensors، وكائنات CUDA/HIP/PTX، وشهادات PEAuthenticode(PKCS#7/X.509)، ورايات الحماية (PIEوNXوRELROوCFG).
ب. جسور مفككات الشيفرة الأصلية العميقة
لاستخراج تدفق التحكم والشيفرة التقريبية بلغة C/C++، تتكامل REA مع Hopper (hopper_bridge.py) وGhidra (ReaGhidraBridge.java شاملاً دعم DOS 16-bit وMIPS وRISC-V) وIDA Pro وKuna وCutter/Rizin وJEB (REA_JEB_MCP_URL)، مع إمكانية ضبط مهلة الإقلاع عبر REA_GHIDRA_STARTUP_TIMEOUT_MS.
ج. تطبيقات Android والبرمجيات الثابتة وتوليد بيئات AgentEnv (RL)
ترتبط المنصة بأدوات JADX وADB وApktool لتحليل حزم APK (إلى جانب فحص التواقيع inspect_apk_signature)، وBinwalk / Unblob للبرمجيات الثابتة، وWABT لملفات WebAssembly (inspect_wasm_artifact)، وevmole لعقود EVM الذكية. كما يحوّل الأمر rea environment-build ./session.har ./my-env --name my-env --json جلسات HAR المسجلة إلى بيئة AgentEnv قابلة للتشغيل لتدريب وكلاء الذكاء الاصطناعي بالتعلم المعزز (RL) دون المساس بالتطبيق الحي.
4. مصفوفة المقارنة المعمارية: الهندسة العكسية اليدوية مقابل تنسيق REA
| معيار التقييم | الهندسة العكسية اليدوية التقليدية | النسخ واللصق المباشر في النموذج | REA (بروتوكول MCP + أدلة موثقة) |
|---|---|---|---|
| التنقل بين الأدوات | انتقال يدوي مستمر بين Ghidra وJADX وHAR والطرفية | لصق مقتطفات مجتزأة بلا ترابط مرجعي | استعلام موحد لأكثر من 30 أداة عبر خادم MCP واحد |
| ضبط الهلوسة والإثبات | دقة عالية لكنها مقيدة بالجهد البشري | احتمال مرتفع لاختلاق تدفقات غير موجودة | كل نتيجة مرفقة بالعناوين والمراجع وقيود limitations |
| كفاءة نافذة السياق | لا ينطبق | استنزاف سريع للرموز بسبب المخرجات الخام | مخططات مضغوطة وسقف 4,096 بايت وحد 4 MiB للمخرجات |
| تدقيق حزم Electron / JS | فك ضغط .asar وفحص يدوي للملفات | عجز عن استيعاب الحزم المصغرة الكبيرة | عمليات معزولة ترسم الوحدات وقنوات IPC والانكشاف |
| بناء بيئات تدريب RL | يتطلب برمجة خوادم محاكاة يدوياً من الصفر | غير مدعوم | توليد بيئات AgentEnv جاهزة مباشرة من تسجيلات HAR |
5. دراسات حالة موثقة: DX-Ball وجسر حافظة Notion واستعادة حسابات 16-Bit
تُظهر ثلاث دراسات حالة موثقة في المعرض الرسمي كيف تعمل إعادة البناء المستندة إلى الأدلة عملياً:
- حساب توزيع الصوت في DX-Ball: بتتبع استدعاء الصوت داخل ملف x86 الأصلي وتحويل الشيفرة التقريبية إلى لغة C، اجتاز التنفيذ المعاد بناؤه 3,205 حالة اختبار x86 أصلية وأعاد إنتاج جميع البايتات المترجمة البالغ عددها 63 بايت بتطابق كامل.
- جسر الحافظة في تطبيق Notion المكتبي: تتبع واجهة الحافظة من طبقة
rendererمروراً بملفpreloadوقنواتIPCوصولاً إلى عمليةmainفي Electron وتوثيق تنسيق البيانات المنسقة. - استعادة معادلات الزوايا 16-Bit في TH04 (PC-98): فحص تعليمات DOS ذات 16 بت واستعادة معادلات الزوايا الثابتة والموجهة بلغة C++ ومطابقتها مع مخرجات المترجم التاريخي.
6. قوالب أوامر (Prompts) جاهزة للفحص والتحقيق عبر REA
بعد إتمام الإعداد عبر npx rea-agents setup، يمكنك استخدام قوالب الفحص الأربعة التالية مباشرة داخل Claude Code أو Cursor أو Gemini CLI. وللاطلاع على كيفية توظيف بروتوكول MCP ذاته في أتمتة تحليلات الإعلانات الرقمية، راجع دليل تكامل Claude و Meta Ads MCP.
# 1. تدقيق حدود الأمان بين Preload وIPC في تطبيقات Electron (.asar)
استخدم REA لفحص الحزمة /path/to/app.asar فحصاً ساكناً.
اعرض جميع قنوات IPC المكشوفة بين renderer وpreload وipcMain، وحدد المعالجات التي تفتقر
للتحقق من المخطط وملفات source maps المتبقية مع الأدلة المرجعية.
# 2. استخلاص الخوارزميات ومخطط الاستدعاءات من ملف ثنائي أصلي (Ghidra / Hopper)
افحص الملف /path/to/target-binary عبر REA لتحديد دالة التوقيع أو الضغط.
أرجع عناوين الرموز، سلسلة الاستدعاءات، الشيفرة التقريبية والقيود (limitations)،
ثم اكتب اختبار تحقق نظيفاً بلغة TypeScript.
# 3. فحص تواقيع حزمة Android APK (v1-v3.1) وطبقات الشبكة
شغّل REA على الملف /path/to/release.apk للتحقق من شهادات التوقيع عبر inspect_apk_signature
وتتبع فئات الاتصال الخارجي HTTPS/gRPC باستخدام JADX.
# 4. توليد بيئة تدريب AgentEnv (RL) من جلسة شبكة HAR مسجلة
استخدم REA لبناء بيئة AgentEnv قابلة للتشغيل من الملف ./session.har داخل المجلد ./my-env
ووضح العمليات التي يدعمها التسجيل وكيفية تشغيل الاختبار.
7. تشخيص أعطال التثبيت الشائعة وحلولها (rea doctor)
عند فحص جاهزية البيئة بالأمر rea doctor --json، إليك الحلول الجذرية لأبرز أربع مشكلات تشغيلية:
- توقف نافذة التشغيل الأول لبرنامج Hopper على macOS: يظهر Hopper عند تشغيله لأول مرة على نظام macOS نافذة رسومية لطلب الترخيص أو الوضع التجريبي مما يعلّق استدعاءات MCP الآلية؛ افتح Hopper يدوياً مرة واحدة داخل جلسة المستخدم الرسومية وأكمل النافذة قبل تشغيل الوكيل.
- متطلب حزمة
procpsعلى أنظمة Linux: تفشل الحاويات المصغرة المعتمدة على أداةpsالخاصة بـ BusyBox في فحص ملكية العمليات عند تشغيل Ghidra أو JADX أو فحص Electron؛ ثبّت حزمةprocpsالكاملة (apt-get install -y procps). - انتهاء مهلة الإقلاع في الملفات الثنائية الضخمة: عند تحليل ملفات C++ أو Rust أو Unity الكبيرة، ارفع مهلة الانتظار عبر ضبط المتغير
REA_GHIDRA_STARTUP_TIMEOUT_MS=300000أوREA_HOPPER_STARTUP_TIMEOUT_MS=180000. - تهيئة بيئة JDK على نظام Windows x64: تأكد من إشارة متغير
JAVA_HOMEإلى حزمة JDK كاملة وتحقق من مسارات المحركات عبرrea doctor --json.
الفرق بين رسوم AST للمصدر المتاح وفحص REA للملفات الثنائية
عندما تمتلك الشيفرة المصدرية الكاملة لمشروعك، تكون رسوم المعرفة المعتمدة على AST أسرع وأقل استهلاكاً للرموز؛ بينما صُممت أداة REA خصيصاً للملفات المترجمة المغلقة التي لا يتوفر مصدرها وفحص حزم الطرف الثالث. ويمكنك أيضاً قياس جاهزية موقعك لمحركات الذكاء الاصطناعي عبر أداة تدقيق GEO والبحث بالذكاء الاصطناعي.
8. الأمن المؤسسي ومعمارية عدم الثقة (Zero-Trust): افترض شفافية حزم الواجهة
إن انتشار أدوات الفحص المعتمدة على الوكلاء يفرض قواعد صارمة على فرق تطوير المنتجات البرمجية والمديرين التقنيين.
تنبيه أمن سلسلة الإمداد والتراخيص وحوكمة البيانات
- التحقق من المصادر الرسمية فقط: تجنب المستودعات المقلدة الخبيثة وثبّت الأداة حصرياً من
github.com/morluto/reaأوrea.toolsأو حزمةrea-agentsالرسمية على npm. - التحليل المحلي مقابل سياسة مزود النموذج: تعمل REA محلياً بالكامل ولا ترفع ملفاتك إلى خوادم خارجية، غير أن مخرجات الأدوات المرسلة للوكيل تخضع لسياسة مزود نموذج الذكاء الاصطناعي؛ لذا استخدم نقاط اتصال مؤسسية عديمة الاحتفاظ بالبيانات عند فحص برمجيات داخلية حساسة.
- الالتزام بالتراخيص والنطاق القانوني: تتطلب أدوات IDA Pro وHopper وJEB تراخيص تجارية سارية؛ وتُستخدم REA حصراً للأبحاث المشروعة والتوافقية والفحص المصرح به.

ثلاث قواعد دفاعية للمديرين التقنيين (CTOs) وفرق المنتجات
- إزالة ملفات Source Maps والأسرار من الإنتاج: أدرج فحص الانكشاف آلياً في خط CI/CD لمنع شحن ملفات
.mapأو المفاتيح السرية داخل حزم الواجهة. - تحصين حدود IPC وواجهات API بمنهجية Zero-Trust: تحقق من الصلاحيات والمخططات على الخادم وفي معالجات
ipcMainلكل طلب وارد. - إبقاء الخوارزميات التنافسية في الخادم: يجب تشغيل محركات التسعير وتقييم المخاطر وعزل المستأجرين داخل بنية خلفية مؤمنة بعيداً عن ملفات العميل.
حصّن معمارية تطبيقاتك المؤسسية مع Kling Digital
سواء كنت ترغب في تدقيق سطح الانكشاف في تطبيقاتك، أو بناء منصات SaaS بمعايير Zero-Trust، أو دمج وكلاء MCP مؤسسيين آمنين، يمكنك تقدير نطاق مشروعك عبر حاسبة تكلفة المشاريع التفاعلية أو التواصل مباشرة مع فريق الهندسة في Kling Digital.




