Repository navigation
id 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 | 中文
Ini adalah peta tingkat tinggi tentang bagaimana VD Infos disusun. Ia mendeskripsikan bentuk aplikasi, bukan katalog apa yang ia baca: inti dari debugger metode adalah menaruh setiap pembacaan di depan Anda, dan membacanya adalah milik Anda untuk dilakukan di perangkat Anda sendiri.
- Satu nilai, setiap metode. Untuk setiap potong informasi, baca ia melalui setiap metode yang dapat membacanya dan sejajarkan pembacaannya. Sebuah debugger memunculkan bukti; ia tidak menjatuhkan penilaian.
- Di perangkat dan senyap. Tanpa jaringan, tanpa akun, tanpa pekerjaan latar belakang. Aplikasi berjalan hanya selagi ia terbuka.
- Dapat dibaca oleh mesin. Seluruh hasil adalah satu dokumen yang dapat dibaca mesin, jadi sebuah alat mendapat gambaran yang sama dengan yang didapat seseorang. Lihat Agen AI.
- Kecil di tempat yang penting. Komponen nativa dijaga dengan sengaja mungil dan sederhana.
Sebuah lensa adalah satu cara membaca sebuah nilai. Nilai yang sama dibaca melalui beberapa cara sehingga mereka dapat dibandingkan:
| Lensa | Apa itu |
|---|---|
| Java / SDK | API platform yang dipanggil oleh aplikasi biasa. |
| Native / JNI | Nilai yang sama dibaca dari kode nativa. |
| Shell via JVM | Perintah shell yang dilahirkan oleh JVM. |
| Shell via JNI | Perintah yang sama dilahirkan dari kode nativa. |
| TEE / Attestation | Atestasi kunci yang didukung perangkat keras, di mana ia berlaku. |
Menyejajarkan lensa-lensa adalah seluruh idenya: aplikasi menunjukkan di mana bacaan-bacaan itu sepakat dan di mana mereka berbeda. Apa arti sebuah perbedaan bagi suatu nilai, pada suatu perangkat, adalah milik Anda untuk dibaca.
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
- Paralelisme. Sonda menyebar di sebuah dispatcher dengan jumlah izin terbatas; hasil mengalir ke dalam UI saat mereka selesai, dengan indikator kemajuan langsung.
- Tidak ada apa pun di latar belakang. Tanpa layanan dan tanpa pemindaian terjadwal. Aplikasi membaca hanya selagi terbuka dan menutup dirinya sendiri ketika dibiarkan menganggur.
-
Lapisan nativa. Satu
.sokecil tanpa dependensi, diikat berdasarkan nama melaluiRegisterNatives, dijaga dengan sengaja mungil dan sederhana.
Setiap pemindaian menghasilkan sebuah Snapshot: waktu ia diambil, versi aplikasi, dan daftar
hasil, satu per sonda, masing-masing dengan pembacaan dari setiap lensa dan vonis tentang bagaimana
mereka berhubungan. Aplikasi mempersistenkan ini ke penyimpanan privat setelah setiap pemindaian dan dapat mengekspor
data yang sama. Strukturnya terdokumentasi sebagai format ekspor.
Sebagian besar dari apa yang dicari aplikasi berada sebagai daftar teks biasa di bawah
assets/data/, bukan sebagai kode. Menambah atau menghapus target adalah mengubah satu baris. Lihat
Berkontribusi.
- Ia tidak pernah mengubah apa pun pada sistem Anda. Ia hanya membaca dan membandingkan.
- Ia tidak pernah berbicara ke jaringan. Ia bekerja sepenuhnya luring.
- Ia tidak pernah berjalan di latar belakang, menjadwalkan pemindaian, atau menjaga sebuah layanan tetap hidup.
- Ia tidak pernah mengirim sebuah pembacaan ke mana pun. Sebuah laporan meninggalkan perangkat hanya ketika Anda membagikan atau menyimpannya, dengan nilai yang membawa identitas disamarkan.
Dokumentasi ini dibuat dengan Claude (Anthropic) dan dikelola oleh VD171. Koreksi dan perbaikan dipersilakan; lihat CONTRIBUTING.md.