Repository navigation
hi 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 को कैसे जोड़ा गया है। यह ऐप के आकार का वर्णन करता है, उस सूची का नहीं जो वह पढ़ता है: एक मेथड डिबगर का मकसद हर पठन को आपके सामने रखना है, और उन्हें पढ़ना आपको ही अपने डिवाइस पर करना है।
- एक मान, हर मेथड। जानकारी के हर टुकड़े के लिए, उसे हर उस मेथड के ज़रिए पढ़ें जो उसे पढ़ सकता है और पठनों को पंक्तिबद्ध करें। एक डिबगर सबूत सामने लाता है; वह फ़ैसला नहीं सुनाता।
- डिवाइस पर और शांत। कोई नेटवर्क नहीं, कोई खाता नहीं, कोई पृष्ठभूमि कार्य नहीं। ऐप केवल तभी चलता है जब वह खुला हो।
- मशीनों द्वारा पठनीय। पूरा परिणाम एक ही मशीन-पठनीय दस्तावेज़ है, इसलिए एक टूल को वही चित्र मिलता है जो किसी व्यक्ति को मिलता है। देखें AI एजेंट्स।
- जहाँ मायने रखता है, वहाँ छोटा। नेटिव घटक को जानबूझकर बहुत छोटा और सरल रखा जाता है।
एक लेंस किसी मान को पढ़ने का एक तरीका है। एक ही मान को कई तरीकों से पढ़ा जाता है ताकि उनकी तुलना की जा सके:
| लेंस | यह क्या है |
|---|---|
| Java / SDK | वह प्लेटफ़ॉर्म API जिसे एक साधारण ऐप कॉल करती है। |
| Native / JNI | वही मान नेटिव कोड से पढ़ा गया। |
| Shell via JVM | JVM द्वारा स्पॉन किया गया एक शेल कमांड। |
| Shell via JNI | वही कमांड नेटिव कोड से स्पॉन किया गया। |
| TEE / Attestation | हार्डवेयर-समर्थित की अटेस्टेशन, जहाँ यह लागू हो। |
लेंसों को पंक्तिबद्ध करना ही पूरा विचार है: ऐप दिखाता है कि पठन कहाँ सहमत होते हैं और कहाँ भिन्न होते हैं। किसी दिए गए मान के लिए, किसी दिए गए डिवाइस पर, किसी भिन्नता का क्या मतलब है, यह आपको ही पढ़ना है।
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
- समानांतरता। जाँचें एक सीमित परमिट गणना वाले डिस्पैचर पर फैलती हैं; परिणाम पूरे होने पर UI में स्ट्रीम होते हैं, एक लाइव प्रगति संकेतक के साथ।
- पृष्ठभूमि में कुछ नहीं। कोई सेवाएँ नहीं और कोई निर्धारित स्कैन नहीं। ऐप केवल तभी पढ़ता है जब वह खुला हो और निष्क्रिय छोड़े जाने पर खुद को बंद कर लेता है।
-
नेटिव परत। एक छोटा, निर्भरता-मुक्त
.so,RegisterNativesके ज़रिए नाम से बँधा, जानबूझकर बहुत छोटा और सरल रखा गया।
हर स्कैन एक Snapshot उत्पन्न करता है: वह समय जब इसे लिया गया, ऐप संस्करण, और परिणामों की एक
सूची, प्रति जाँच एक, जिनमें से हर एक में हर लेंस के पठन और वे कैसे संबंधित हैं इसका एक निर्णय
होता है। ऐप इसे हर स्कैन के बाद निजी भंडारण में बनाए रखता है और उसी डेटा को एक्सपोर्ट कर सकता है।
संरचना एक्सपोर्ट प्रारूप के रूप में प्रलेखित है।
ऐप जो खोजता है उसका अधिकांश हिस्सा assets/data/ के अंतर्गत सादा-टेक्स्ट सूचियों के रूप में
रहता है, कोड के रूप में नहीं। किसी लक्ष्य को जोड़ना या हटाना एक पंक्ति को संपादित करना है। देखें
योगदान।
- यह आपके सिस्टम पर कभी कुछ नहीं बदलता। यह केवल पढ़ता और तुलना करता है।
- यह कभी नेटवर्क से बात नहीं करता। यह पूरी तरह ऑफ़लाइन काम करता है।
- यह कभी पृष्ठभूमि में नहीं चलता, कोई स्कैन निर्धारित नहीं करता, या किसी सेवा को जीवित नहीं रखता।
- यह कभी किसी पठन को कहीं नहीं भेजता। एक रिपोर्ट डिवाइस को केवल तभी छोड़ती है जब आप उसे साझा या सहेजते हैं, पहचान-वाहक मानों को मास्क करके।
यह दस्तावेज़ Claude (Anthropic) से तैयार किया गया है और इसे VD171 द्वारा अनुरक्षित किया जाता है। सुधार और संशोधन का स्वागत है; देखें CONTRIBUTING.md।