Repository navigation
pl 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 | 中文
To jest wysokopoziomowa mapa tego, jak VD Infos jest zbudowany. Opisuje kształt aplikacji, a nie katalog tego, co odczytuje: sednem debuggera metod jest postawienie każdego odczytu przed tobą, a ich odczytanie masz wykonać sam na własnym urządzeniu.
- Jedna wartość, każda metoda. Dla każdej informacji odczytaj ją przez każdą metodę, która potrafi ją odczytać, i ustaw odczyty obok siebie. Debugger wydobywa dowody; nie wydaje osądu.
- Na urządzeniu i cicho. Bez sieci, bez konta, bez pracy w tle. Aplikacja działa tylko wtedy, gdy jest otwarta.
- Czytelne dla maszyn. Cały wynik jest jednym czytelnym dla maszyny dokumentem, więc narzędzie dostaje ten sam obraz co człowiek. Zobacz Agenci AI.
- Małe tam, gdzie to ważne. Komponent natywny jest celowo utrzymany maleńki i prosty.
Soczewka to jeden sposób odczytania wartości. Ta sama wartość jest odczytywana przez kilka, aby mogły być porównane:
| Soczewka | Czym jest |
|---|---|
| Java / SDK | API platformy, które wywołuje zwykła aplikacja. |
| Native / JNI | Ta sama wartość odczytana z kodu natywnego. |
| Shell via JVM | Polecenie powłoki uruchomione przez JVM. |
| Shell via JNI | To samo polecenie uruchomione z kodu natywnego. |
| TEE / Attestation | Atestacja klucza wsparta sprzętowo, tam gdzie ma zastosowanie. |
Ustawienie soczewek obok siebie to cała idea: aplikacja pokazuje, gdzie odczyty się zgadzają, a gdzie się różnią. Co dana różnica oznacza dla danej wartości, na danym urządzeniu, masz odczytać sam.
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
- Równoległość. Sondy rozsyłają się po dyspozytorze z ograniczoną liczbą pozwoleń; wyniki strumieniują się do interfejsu w miarę ich ukończenia, z aktywnym wskaźnikiem postępu.
- Nic w tle. Bez usług i bez zaplanowanych skanowań. Aplikacja odczytuje tylko gdy jest otwarta i zamyka się sama, gdy pozostawiona bezczynnie.
-
Warstwa natywna. Jedno małe
.sobez zależności, związane po nazwie przezRegisterNatives, utrzymane celowo maleńkie i proste.
Każde skanowanie wytwarza Snapshot: czas, w którym zostało wykonane, wersję aplikacji oraz listę
wyników, po jednym na sondę, każdy z odczytami z każdej soczewki i werdyktem, jak
się one mają do siebie. Aplikacja utrwala to w prywatnej pamięci po każdym skanowaniu i może eksportować
te same dane. Struktura jest udokumentowana jako format eksportu.
Większość tego, czego aplikacja szuka, mieści się jako listy zwykłego tekstu pod
assets/data/, a nie jako kod. Dodanie lub usunięcie celu to edycja jednej linii. Zobacz
Współtworzenie.
- Nigdy nie zmienia niczego w twoim systemie. Tylko odczytuje i porównuje.
- Nigdy nie rozmawia z siecią. Działa w pełni offline.
- Nigdy nie działa w tle, nie planuje skanowania ani nie utrzymuje usługi przy życiu.
- Nigdy nie wysyła odczytu nigdzie. Raport opuszcza urządzenie tylko wtedy, gdy udostępnisz lub zapiszesz, z zamaskowanymi wartościami noszącymi tożsamość.
Ta dokumentacja została wygenerowana za pomocą Claude (Anthropic) i jest utrzymywana przez VD171. Poprawki i ulepszenia są mile widziane; zobacz CONTRIBUTING.md.