Repository navigation
cs 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 | 中文
Toto je mapa vysoké úrovně toho, jak je VD Infos poskládán. Popisuje tvar aplikace, ne katalog toho, co čte: smyslem ladicího nástroje metod je položit každý naměřený údaj před vás, a jejich čtení je na vás, na vašem vlastním zařízení.
- Jedna hodnota, každá metoda. Pro každou informaci ji přečtěte přes každou metodu, která ji umí přečíst, a seřaďte naměřené údaje. Ladicí nástroj vynáší důkazy na povrch; nevynáší soud.
- Na zařízení a tiše. Žádná síť, žádný účet, žádná práce na pozadí. Aplikace běží jen, když je otevřená.
- Čitelné stroji. Celý výsledek je jeden strojově čitelný dokument, takže nástroj dostane stejný obraz jako člověk. Viz AI agenti.
- Malé tam, kde na tom záleží. Nativní komponenta je držena záměrně drobná a jednoduchá.
Čočka je jeden způsob čtení hodnoty. Stejná hodnota je čtena přes několik, aby bylo možné je porovnat:
| Čočka | Co to je |
|---|---|
| Java / SDK | Platformové API, které volá běžná aplikace. |
| Nativní / JNI | Stejná hodnota čtená z nativního kódu. |
| Shell přes JVM | Příkaz shellu spuštěný JVM. |
| Shell přes JNI | Stejný příkaz spuštěný z nativního kódu. |
| TEE / Atestace | Hardwarově podložená atestace klíčů, kde se uplatňuje. |
Seřazení čoček je celá myšlenka: aplikace ukazuje, kde se čtení shodují a kde se liší. Co znamená rozdíl pro danou hodnotu, na daném zařízení, je na vás, abyste si přečetli.
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
- Paralelismus. Sondy se rozvětví napříč dispatcherem s omezeným počtem povolení; výsledky streamují do uživatelského rozhraní, jak se dokončují, s živým ukazatelem postupu.
- Nic na pozadí. Žádné služby a žádné naplánované skeny. Aplikace čte jen, když je otevřená, a sama se zavře, když je ponechána nečinná.
-
Nativní vrstva. Jedna malá
.sobez závislostí, vázaná podle názvu přesRegisterNatives, držená záměrně drobná a jednoduchá.
Každý sken produkuje Snapshot: čas, kdy byl pořízen, verzi aplikace a seznam výsledků,
jeden na sondu, každý s naměřenými údaji z každé čočky a verdiktem o tom, jak spolu
souvisejí. Aplikace to po každém skenu uchová do soukromého úložiště a může exportovat
stejná data. Struktura je zdokumentována jako formát exportu.
Většina toho, co aplikace hledá, žije jako seznamy prostého textu pod
assets/data/, ne jako kód. Přidání nebo odebrání cíle je úprava jednoho řádku. Viz
Přispívání.
- Nikdy nemění nic na vašem systému. Pouze čte a porovnává.
- Nikdy nemluví se sítí. Funguje plně offline.
- Nikdy neběží na pozadí, neplánuje sken ani neudržuje službu naživu.
- Nikdy neodesílá naměřený údaj nikam. Zpráva opustí zařízení jen, když ji sdílíte nebo uložíte, s maskovanými hodnotami nesoucími identitu.
Tato dokumentace byla vytvořena pomocí Claude (Anthropic) a spravuje ji VD171. Opravy a vylepšení jsou vítány; viz CONTRIBUTING.md.