Skip to content

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


Arsitektur

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.

Tujuan rancangan

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

Lensa-lensa

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.

Bagaimana pemindaian berjalan

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 .so kecil tanpa dependensi, diikat berdasarkan nama melalui RegisterNatives, dijaga dengan sengaja mungil dan sederhana.

Laporan

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.

Memperluasnya

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.

Apa yang tidak pernah dilakukan VD Infos

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

Clone this wiki locally