Repository navigation
ar ARCHITECTURE
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/، لا ككود. إضافة هدف أو إزالته هي تحرير سطر واحد. انظر
المساهمة.
- لا يغيّر أبدًا شيئًا في نظامك. إنه يقرأ ويقارن فقط.
- لا يتحدث أبدًا إلى الشبكة. يعمل بالكامل دون اتصال.
- لا يعمل أبدًا في الخلفية، ولا يجدول فحصًا، ولا يُبقي خدمة على قيد التشغيل.
- لا يرسل أبدًا قراءة إلى أي مكان. لا يغادر تقرير الجهاز إلا عندما تشاركه أو تحفظه، مع تقنيع القيم الحاملة للهوية.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.