Repository navigation
ru 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 | 中文
Это высокоуровневая карта того, как устроен VD Infos. Она описывает форму приложения, а не каталог того, что он читает: смысл отладчика методов - положить каждое показание перед вами, а читать их вам самим на собственном устройстве.
- Одно значение, каждый метод. Для каждого фрагмента информации читать его через каждый метод, способный его прочитать, и выстраивать показания в ряд. Отладчик выносит улики на поверхность; он не выносит суждений.
- На устройстве и тихо. Без сети, без аккаунта, без фоновой работы. Приложение работает только пока оно открыто.
- Читаемо машинами. Весь результат - это один машиночитаемый документ, так что инструмент получает ту же картину, что и человек. Смотрите ИИ-агенты.
- Маленькое там, где это важно. Нативный компонент намеренно держится крошечным и простым.
Линза - это один способ прочитать значение. Одно и то же значение читается через несколько, чтобы их можно было сравнить:
| Линза | Что это |
|---|---|
| Java / SDK | API платформы, который вызывает обычное приложение. |
| Native / JNI | То же значение, прочитанное из нативного кода. |
| Shell via JVM | Команда оболочки, порождённая JVM. |
| Shell via JNI | Та же команда, порождённая из нативного кода. |
| TEE / Attestation | Аппаратно обеспеченная аттестация ключа, где она применима. |
Выстраивание линз в ряд - это вся идея: приложение показывает, где чтения совпадают, а где различаются. Что означает различие для данного значения, на данном устройстве, вам читать самим.
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
- Параллелизм. Зонды расходятся по диспетчеру с ограниченным числом разрешений; результаты поступают в интерфейс по мере завершения, с живым индикатором прогресса.
- Ничего в фоне. Без служб и без запланированных сканирований. Приложение читает только пока открыто и закрывает себя, когда его оставляют без дела.
-
Нативный слой. Один небольшой
.soбез зависимостей, привязанный по имени черезRegisterNatives, намеренно держимый крошечным и простым.
Каждое сканирование производит Snapshot: время, когда оно было сделано, версию приложения и список
результатов, по одному на зонд, каждый с показаниями от каждой линзы и вердиктом о том, как
они соотносятся. Приложение сохраняет это в приватное хранилище после каждого сканирования и может экспортировать
те же данные. Структура задокументирована как формат экспорта.
Большая часть того, что приложение ищет, живёт как списки обычного текста под
assets/data/, а не как код. Добавить или удалить цель - это отредактировать одну строку. Смотрите
Участие.
- Он никогда не меняет ничего в вашей системе. Он только читает и сравнивает.
- Он никогда не общается с сетью. Он полностью работает офлайн.
- Он никогда не работает в фоне, не планирует сканирование и не держит службу живой.
- Он никогда не отправляет показание куда-либо. Отчёт покидает устройство только когда вы отправляете или сохраняете его, с замаскированными значениями, несущими идентичность.
Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.