Repository navigation
ar AI AGENTS
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 مبني ليُقرأ بواسطة الآلات، لا بواسطة الناس فقط. يُنتج مُصحِّح طرق الجهاز قدرًا كبيرًا من الأدلة المنظّمة - كل قيمة، مقروءة عبر كل طريقة، مصفوفة للمقارنة - وهذه الأدلة أكثر فائدة بكثير للوكيل كبيانات منها كلقطة شاشة. لذلك تكون النتيجة بأكملها متاحة كمستند واحد قابل للقراءة آليًا، والتطبيق مصمّم حول ذلك من الأساس.
إذا كنت مساعد برمجة ذكاء اصطناعي، أو أداة LLM، أو سكربت تحليل، أو أي أتمتة تصل إلى الجهاز عبر shell، فهذه الصفحة لك.
- مستند واحد، لا شاشة. الفحص بأكمله - كل مسبار، كل عدسة، كل حكم - هو كائن JSON واحد. لا OCR، ولا كشط شاشة، ولا نقر عبر البطاقات المطوية.
- نفس البيانات التي تملكها الواجهة. الملف ليس ملخصًا. إنه بالضبط ما يحتفظ به التطبيق داخليًا: تُظهر الشاشة القراءة الأولى لعنصر مطوي، والملف يحوي كلها.
- شكل حتمي. البنية مستقرة وموثّقة (انظر EXPORT-FORMAT)، بحيث يظل المحلّل المكتوب مرة واحدة يعمل.
- لا شبكة، لا حساب، لا حالة للإدارة. يقرأ التطبيق على الجهاز ويكتب ملفًا. يقرأ وكيلك الملف. هذا هو العقد كله.
- دون اتصال بالتصميم. لا يحتاج إلى إنترنت، فيعمل كما هو داخل بيئة مغلقة أو معزولة عن الشبكة قد يعمل فيها وكيل.
كل فحص يكتب تقريره الكامل إلى التخزين الخاص بالتطبيق. بعد أن يكون فحص قد جرى، يقرأ الوكيل النتيجة الكاملة بأمر واحد:
su -c cat /data/data/ru.vd171.vdinfos/files/last_snapshot.json- ما يحتويه: كل مسبار بحكمه وقيمته من كل عدسة، في نفس الـ JSON الخاص بزر التصدير.
- متى يتحدّث: في نهاية كل فحص. شغّل فحصًا أولًا؛ الملف يحتفظ دائمًا بأحدث واحد.
- المتطلب: root، لأن الملف يقع في التخزين الخاص بالتطبيق. من دون root، استخدم بدلًا من ذلك إجراء مشاركة / حفظ بصيغة JSON داخل التطبيق واقرأ الملف الذي يُسلَّم للوكيل.
- تأكد من أن التطبيق مثبّت (ملف APK SDK_35 من Releases).
- شغّل فحصًا - شخص ينقر على الفحص، أو أتمتة تشغّل شاشة الفحص في التطبيق - وانتظر حتى ينتهي.
- اقرأ
files/last_snapshot.jsonبالأمر أعلاه. - حلّله باستخدام صيغة التصدير كمخطَّطك: كرّر على المسابير، واقرأ
verdictكل واحد، وصفّ قيمvaluesلكل عدسة. - تصرّف بناءً على النتيجة المنظّمة في سير عملك الخاص.
يقرّر الوكيل ما تعنيه القراءات للمهمة المطروحة؛ VD Infos يوفّر الأدلة، نظيفة وكاملة.
- يحمل التقرير كل قراءة وكل حكم، بحيث يملك الوكيل الصورة الكاملة التي بناها التطبيق.
- القيم الحاملة للهوية (الأرقام التسلسلية وIMEI وعناوين MAC ومعرّفات الإعلانات وما شابه)
تكون مُقنَّعة في التقرير المشارك/المُصدَّر، بحيث يبقى التقرير المتداول خاليًا من
المعرّفات الشخصية مع احتفاظه بأحكامه وبنيته. ملف
last_snapshot.jsonالموجود على الجهاز، القابل للقراءة فقط بواسطة التطبيق أو الـ root، يحتفظ بالقيم الحقيقية لوكيل محلي يحتاجها.
هذه الويكي منظّمة للقراءة الآلية بقدر ما هي للناس: أقسام قصيرة، وعناوين مستقرة، وأسماء حقول صريحة، وصفحة صيغة تصدير مخصّصة يمكن للوكيل أن يعاملها كمخطَّط. إذا كنت تبني أداة فوق VD Infos، فابدأ هناك.
- صيغة التصدير - مخطَّط الـ JSON، حقلًا بحقل.
- دليل المستخدم - التثبيت والفحص والمشاركة.
- البنية - كيف يُركَّب التطبيق.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.