Skip to content

pl 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 | 中文


Architektura

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.

Cele projektowe

  • 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.

Soczewki

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.

Jak przebiega skanowanie

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 .so bez zależności, związane po nazwie przez RegisterNatives, utrzymane celowo maleńkie i proste.

Raport

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.

Rozszerzanie

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.

Czego VD Infos nigdy nie robi

  • 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.

Clone this wiki locally