Skip to content

ar ARCHITECTURE

github-actions[bot] edited this page Nov 18, 2026 · 2 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


البنية

هذه خريطة عالية المستوى لكيفية تركيب VD Infos. تصف شكل التطبيق، لا كتالوج ما يقرأه: فالغاية من مُصحِّح الطرق هي وضع كل قراءة أمامك، وقراءتها أمر متروك لك على جهازك الخاص.

أهداف التصميم

  • قيمة واحدة، كل طريقة. لكل معلومة، اقرأها عبر كل طريقة يمكنها قراءتها وصفّ القراءات. المُصحِّح يُظهر الأدلة؛ ولا يصدر حكمًا.
  • على الجهاز وهادئ. لا شبكة، لا حساب، لا عمل في الخلفية. يعمل التطبيق فقط أثناء فتحه.
  • قابل للقراءة بواسطة الآلات. النتيجة بأكملها مستند واحد قابل للقراءة آليًا، بحيث تحصل أداة على الصورة نفسها التي يحصل عليها الشخص. انظر وكلاء الذكاء الاصطناعي.
  • صغير حيث يهمّ. يُبقى المكوّن الأصلي صغيرًا وبسيطًا عن قصد.

العدسات

العدسة هي طريقة واحدة لقراءة قيمة. تُقرأ القيمة نفسها عبر عدة عدسات حتى يمكن مقارنتها:

العدسة ما هي
Java / SDK واجهة المنصة البرمجية التي يستدعيها تطبيق عادي.
أصلي / JNI القيمة نفسها مقروءة من الكود الأصلي.
Shell عبر JVM أمر shell تُطلقه الـ JVM.
Shell عبر JNI الأمر نفسه مُطلَق من الكود الأصلي.
TEE / إشهاد شهادة مفاتيح مدعومة بالعتاد، حيث تنطبق.

صفّ العدسات هو الفكرة كلها: يُظهر التطبيق أين تتفق القراءات وأين تختلف. وما يعنيه الاختلاف لقيمة معيّنة، على جهاز معيّن، أمر متروك لك لتقرأه.

كيف يجري الفحص

core/model      immutable domain: Lens, Category, Verdict, ProbeSpec, ProbeResult
probe/          the probes and the bridges they use (JNI, reflection, data lists)
engine/         ProbeEngine: parallel fan-out, streams results as they land
data/           SnapshotStore (persist the report), Exporter (share as JSON / text)
ui/             Jetpack Compose, Material 3, dynamic colour, live progress
cpp/            native_probes.cpp: the native lens, dependency-free
  • التوازي. تتوزّع المسابير عبر موزِّع بعدد تصاريح محدود؛ وتُبثّ النتائج إلى الواجهة فور اكتمالها، مع مؤشر تقدّم حيّ.
  • لا شيء في الخلفية. لا خدمات ولا فحوص مجدولة. يقرأ التطبيق فقط أثناء فتحه ويغلق نفسه عند تركه خاملًا.
  • الطبقة الأصلية. ملف .so صغير واحد دون تبعيات، مربوط بالاسم عبر RegisterNatives، يُبقى صغيرًا وبسيطًا عن قصد.

التقرير

كل فحص يُنتج Snapshot: الوقت الذي أُخذ فيه، وإصدار التطبيق، وقائمة نتائج، واحدة لكل مسبار، كل منها بقراءات من كل عدسة وحكم عن كيفية ارتباطها. يحفظ التطبيق هذا في التخزين الخاص بعد كل فحص ويمكنه تصدير البيانات نفسها. البنية موثّقة بوصفها صيغة التصدير.

توسيعه

معظم ما يبحث عنه التطبيق يعيش كـ قوائم نص عادي تحت assets/data/، لا ككود. إضافة هدف أو إزالته هي تحرير سطر واحد. انظر المساهمة.

ما لا يفعله VD Infos أبدًا

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

تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.

Clone this wiki locally