Skip to content

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


معماری

این یک نقشهٔ سطح‌بالا از چگونگی کنار هم چیده‌شدن VD Infos است. شکل برنامه را توصیف می‌کند، نه فهرست آنچه را که می‌خواند: نکتهٔ یک اشکال‌زدای متد این است که هر خوانش را پیش روی شما بگذارد، و خواندن آن‌ها از آنِ شماست تا روی دستگاه خودتان انجام دهید.

اهداف طراحی

  • یک مقدار، هر متد. برای هر تکه اطلاعات، آن را از طریق هر متدی که می‌تواند بخواند بخوانید و خوانش‌ها را کنار هم بچینید. یک اشکال‌زدا شواهد را به‌سطح می‌آورد؛ داوری نمی‌کند.
  • روی‌دستگاه و بی‌سروصدا. بدون شبکه، بدون حساب، بدون کار پس‌زمینه. برنامه تنها تا زمانی که باز است اجرا می‌شود.
  • خواندنی به‌دست ماشین‌ها. کل نتیجه یک سند ماشین‌خوان است، پس یک ابزار همان تصویری را می‌گیرد که یک شخص می‌گیرد. عامل‌های هوش مصنوعی را ببینید.
  • کوچک جایی که مهم است. مؤلفهٔ بومی عمداً بسیار کوچک و ساده نگه داشته شده است.

عدسی‌ها

یک عدسی یک راه خواندن یک مقدار است. همان مقدار از طریق چندین عدسی خوانده می‌شود تا بتوان آن‌ها را مقایسه کرد:

عدسی چیست
Java / SDK APIِ پلتفرم که یک برنامهٔ معمولی فرا می‌خواند.
بومی / JNI همان مقدار خوانده‌شده از کد بومی.
شِل از طریق JVM یک فرمان شِل که به‌دست JVM زاده می‌شود.
شِل از طریق JNI همان فرمان که از کد بومی زاده می‌شود.
TEE / گواهی گواهی کلید پشتیبانی‌شده با سخت‌افزار، جایی که کاربرد دارد.

کنار هم چیدن عدسی‌ها تمام ایده است: برنامه نشان می‌دهد خوانش‌ها کجا توافق دارند و کجا تفاوت. اینکه یک تفاوت برای یک مقدار معین، روی یک دستگاه معین، چه معنایی دارد، از آنِ شماست تا بخوانید.

یک اسکن چگونه اجرا می‌شود

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/ زندگی می‌کند، نه به‌صورت کد. افزودن یا برداشتن یک هدف ویرایش یک خط است. مشارکت را ببینید.

آنچه VD Infos هرگز نمی‌کند

  • هرگز چیزی را روی سیستم شما تغییر نمی‌دهد. فقط می‌خواند و مقایسه می‌کند.
  • هرگز با شبکه سخن نمی‌گوید. به‌طور کامل آفلاین کار می‌کند.
  • هرگز در پس‌زمینه اجرا نمی‌شود، اسکنی را زمان‌بندی نمی‌کند، و سرویسی را زنده نگه نمی‌دارد.
  • هرگز خوانشی را به جایی نمی‌فرستد. یک گزارش تنها زمانی از دستگاه خارج می‌شود که آن را به‌اشتراک بگذارید یا ذخیره کنید، با مقادیر هویت‌دارِ پوشانده‌شده.

این مستندات با Claude (Anthropic) تولید شده و توسط VD171 نگهداری می‌شود. اصلاحات و بهبودها خوش‌آمد است؛ به CONTRIBUTING.md مراجعه کنید.

Clone this wiki locally