AI-translated from English; not yet reviewed by a fluent editor.

# افحص سلوك تطبيق Electron باستخدام REA

> يرسم REA خريطة للوحدات وحدود Electron في تطبيق محلي. يوضح هذا الدليل كيفية تتبّع ميزة واحدة استنادًا إلى الأدلة، ثم التحقق من سلوكها على نحو مستقل.

By BIG CHANGE Editorial

Published: 2026-10-14T04:55:21.558Z
Updated: 2026-10-14T04:55:21.558Z
Canonical: https://bigchange.ai/blog/rea-static-electron-app-inspection-guide

![Conceptual charcoal illustration of an external storage drive beside a desktop monitor showing unlabeled file-tree and code-like lines.](https://bigchange.ai/api/media/file/rea-local-artifact-inspection-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual REA interface, application finding or runtime result is depicted.

يمكن لـ REA رسم خريطة لتطبيق JavaScript أو Electron محلي انطلاقًا من الملفات المصرح لك بفحصها، حتى إن لم يكن لديك شجرة المصدر. والنتيجة المفيدة هي سلسلة أدلة لسلوك واحد: الوحدة التي تعرضه، وموضع عبور الاستدعاء لحدود العملية، والأجزاء التي تحتاج إلى تحقق منفصل. يستخدم هذا الدليل [وثائق مشروع REA الحالية](https://github.com/morluto/rea/blob/main/README.md)التي جرى التحقق منها في 14 أكتوبر 2026. لم يشغّل BIG CHANGE أداة REA على أي تطبيق.

## التغيير الكبير

- **ما الذي تغيّر:**يقدّم REA لوكيل البرمجة خريطة منظمة للوحدات والاستيرادات وخرائط المصدر والمسارات وElectron IPC من دليل التطبيق أو ملف ASAR المقدّم. ويمكن لكل نتيجة أن تشير إلى الملفات التي تستند إليها.
- **لماذا يهم ذلك:**يمكن للمطوّر الذي يحقق في ميزة واحدة تتبّع واجهة API مسماة أو قناة IPC داخل التطبيق المعبأ قبل تحديد ما يجب فحصه يدويًا. فيصبح السؤال أضيق والأدلة أسهل تحققًا.
- **ما ينبغي الانتباه إليه:**مسارات الشيفرة الساكنة احتمالات، وليست دليلًا على أن التطبيق يسلكها أثناء الاستخدام. وما زال الادعاء بشأن سلوك محدد يتطلب ملاحظة مستقلة أو اختبارًا على الهدف المصرح به.

## قبل أن تبدأ

هذا المسار مخصص لمطوّر يملك تطبيق JavaScript أو Electron محليًا أو يملك الإذن بفحصه. تحتاج إلى دليل التطبيق المستخرج أو ملف `app.asar` ومساره المطلق. يذكر [بيان حزمة REA](https://github.com/morluto/rea/blob/main/package.json) الإصدار `rea-agents` 6.4.0  **ويتطلب Node.js 22.19 أو أحدث ضمن سلسلة 22.x، أو 24.11 أو أحدث ضمن 24.x، أو الإصدار 26 وما بعده. وتحتاج أيضًا إلى npm. على Linux، يتطلب تحليل REA الساكن لـJavaScript وElectron أداة متوافقة مع procps وهي**  أيضًا، من أجل `ps` في REA  `PATH` للتحقق من مالك العملية، كما يوضح دليله  [ دليل التثبيت ](https://github.com/morluto/rea/blob/main/docs/installation.md#linux-owned-process-prerequisite) يوضح. هذه متطلبات المضيف الذي يشغّل REA، وهي منفصلة عن متطلبات تشغيل التطبيق المستهدف.

لا يحتاج مسار JavaScript الساكن إلى Hopper أو Ghidra أو IDA أو متصفح أو عملية Electron قيد التشغيل. فهذه الأدوات تخص مسارات أخرى في REA. تحقق من امتلاكك صلاحية فحص الهدف، واحتفظ بنسخة من الملفات الأصلية لتحديد artifact الذي أنتج النتيجة بدقة. استخدم المستودع الرسمي [`morluto/rea` للتثبيت ](https://github.com/morluto/rea) أو حزمة npm المرتبطة به؛ فتشابه الاسم لا يثبت المصدر.

## 1. أعد إعداد REA أو استخدم CLI لمرة واحدة

 بالنسبة إلى وكيل برمجة متصل، فإن [ أمر الإعداد الموثق ](https://github.com/morluto/rea/blob/main/README.md#quick-start) هو:

```sh
npx rea-agents setup
```

راجع التغييرات المقترحة على إعداد الوكيل، ووافق على ما تريده ثم أعد تشغيله. إذا كنت تحتاج إلى الفحص من الطرفية فقط، فيستدعي الأمر الموثق أدناه الحزمة لذلك التشغيل.  `@latest` يختار الإصدار الحالي عند التنفيذ؛ دوّن الإصدار الفعلي مع أدلتك لأن تفاصيل المخرجات قد تتغير. الإصدار 6.4.0 أعلاه هو ما عرضه بيان المشروع عند فحص هذا المقال في 14 أكتوبر.

## 2. حلّل الملفات المقدمة

استبدل المسار التوضيحي بالمسار المطلق لمجلد التطبيق المصرح لك بفحصه أو لملف ASAR:

```sh
npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json > app-evidence.json
```

 دليل CLI [ يحذر من أن Evidence الكامل قد يكون ضخمًا جدًا. احفظه في ملف، ثم اقرأ ملخصًا أو عرضًا لوحدة محددة. لا تلصق النتيجة كلها في موجّه. إذا فشل الأمر، احتفظ بالخطأ ومسار الهدف للتشخيص؛ فقد يصاحب رمز الخروج الصفري تغطية جزئية أو تحذيرات أو نتائج لم تُحسم. يعرض README في Windows مسارًا مثل: ](https://github.com/morluto/rea/blob/main/docs/cli.md) . `"D:/apps/example"`مرجع إعادة بناء artifact

 يذكر أن العملية تقرأ الملفات المختارة كبيانات من دون تشغيل التطبيق. وهي تحصي مسارات artifacts وبصماتها، وتحلل JavaScript وTypeScript المتاحين، وتعرض نقاط الدخول المحتملة والاستيرادات وخرائط المصدر والمسارات ونقاط الشبكة وروابط Electron preload وrenderer، [ وواجهات API واستدعاءات IPC ومعالجاتها وطلبات الإضافات الأصلية. والنتيجة المتوقعة سجل Evidence يتضمن رسمًا وملخص Electron ساكنًا وتغطية وحدودًا. أما ](https://github.com/morluto/rea/blob/main/docs/javascript-artifact-reconstruction.md) الارتباط المبلّغ عنه فهو علاقة تستحق الفحص، وليس فكًا لتلك الوحدة الأصلية. `contextBridge` 3. تتبّع ميزة واحدة محددة `.node` اختر ميزة يمكن العثور عليها باسمها، مثل إجراء في قائمة أو طريقة API مكشوفة. سجّل اسمها الظاهر للمستخدم وابحث في نتيجة REA عن الوحدة أو قناة IPC الحرفية أو المسار المقابل. اتبع مواضع المصدر بالترتيب: استدعاء renderer أو الصفحة، جسر preload، نقل IPC، معالج العملية الرئيسية المطابق، ثم الملف أو عملية الخدمة التي يستدعيها المعالج. يوضح مثال REA لـ

## Electron CSV

هذا النمط باستخدام [ والقناة ](https://rea.tools/guides/javascript/) وكاتب في العملية الرئيسية. هذه أسماء في التطبيق النموذجي؛ وستختلف في هدفك. `notes.exportCsv()` أي  `notes:export` القناة وكاتب في العملية الرئيسية. هذه أسماء في التطبيق النموذجي؛ وستختلف الأسماء في هدفك.

لكل رابط، سجّل بصمة الأثر ومسار الملف وموضعه وما يوضحه الشيفرة فعليًا. ميّز بين قناة حرفية مرتبطة بمعالج واحد وقناة تُحسب أثناء التشغيل أو اقتران ملتبس. راجع حقلي التغطية والقيود قبل اعتبار غياب وحدة أو معالج دليلًا على عدم وجوده. توضح REA أن الملفات التالفة أو غير المتاحة، وغياب البايتات المرافقة لـ ASAR، والتعبيرات غير المحسومة، وحدود التحليل قد تترك العلاقات مجهولة. قد تكشف خريطة المصدر أسماء المصادر الأصلية، لكن الأداة لا تضمن شجرة المصدر الأصلية.

## 4. تحقّق من السلوك بصورة مستقلة

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

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

## إذا كانت النتيجة غير مكتملة

تحقق أولًا من أن المسار يشير إلى مجلد مستخرج بالكامل أو ملف ASAR، وأن أي ملفات `.asar.unpacked` مرافقة مطلوبة موجودة. راجع تغطية REA وتشخيصاتها؛ فالمصدر المفقود أو الذي فشل تحميله مجهول، وليس نتيجة نفي. وللتطبيقات الكبيرة، يشرح [المرجع](https://github.com/morluto/rea/blob/main/docs/javascript-artifact-reconstruction.md) طريقة تحديد `--source-path` اختيارات دقيقة، لكن الملفات غير المحددة تبقى خارج نطاق التحليل. إذا كانت مطابقة IPC الحرفية ملتبسة أو كانت القناة محسوبة، افحص الملفات المشار إليها وضَيّق السؤال. أبقِ الالتباس في الملاحظات النهائية إن استمر.

 شيفرة REA مرخّصة بموجب MIT، لكن للبرنامج المستهدف ومحرك التحليل الخارجي تراخيص وشروط خاصة بهما. يعالج التحليل الساكن ملفات الهدف محليًا. وإذا أرسلت نتائج REA إلى وكيل برمجة، فلدى مزوّد النموذج سياسة بيانات خاصة به؛ تجنّب إرسال الأسرار أو المخرجات المملوكة قبل موافقة مؤسستك على ذلك الاستخدام. راجع أيضًا شروط وكلفة وكيلك وأي محرك اختياري. وقد جرى التحقق من الإجراء وإصدار الحزمة هنا بالاستناد إلى الوثائق في   **14 أكتوبر 2026**  ؛ وهما مستندان إلى الوثائق.

## Sources

- [REA README](https://github.com/morluto/rea/blob/main/README.md) — الهوية الرسمية، والإعداد، وأمر تحليل JS، والمخرجات، ومتطلبات Node وLinux ps، وحدود المعالجة المحلية والخصوصية.
- [REA package manifest](https://github.com/morluto/rea/blob/main/package.json) — rea-agents 6.4.0 ونطاق إصدارات محرك Node.
- [JavaScript and Electron Analysis guide](https://rea.tools/guides/javascript/) — مثال عملي لتتبّع renderer وpreload وIPC حتى معالج في العملية الرئيسية؛ يسجل المثال REA 4.1.0.
- [JavaScript artifact reconstruction](https://github.com/morluto/rea/blob/main/docs/javascript-artifact-reconstruction.md) — نطاق التحليل الساكن، واختيار المصدر، والسلامة، والتغطية، ودلالات المسارات غير المحسومة.
- [CLI and Evidence](https://github.com/morluto/rea/blob/main/docs/cli.md) — أمر CLI، وحجم مخرجات Evidence، وحدود حالة الخروج.
- [REA installation guide](https://github.com/morluto/rea/blob/main/docs/installation.md) — يوضح صراحةً أن ps المتوافق مع procps في Linux مطلوب أيضًا لتحليل JavaScript/Electron الساكن، مع إرشادات الاستعادة.