Repository navigation
fa 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ِ پلتفرم که یک برنامهٔ معمولی فرا میخواند. |
| بومی / 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/ زندگی میکند، نه بهصورت کد. افزودن یا برداشتن یک هدف ویرایش یک خط است.
مشارکت را ببینید.
- هرگز چیزی را روی سیستم شما تغییر نمیدهد. فقط میخواند و مقایسه میکند.
- هرگز با شبکه سخن نمیگوید. بهطور کامل آفلاین کار میکند.
- هرگز در پسزمینه اجرا نمیشود، اسکنی را زمانبندی نمیکند، و سرویسی را زنده نگه نمیدارد.
- هرگز خوانشی را به جایی نمیفرستد. یک گزارش تنها زمانی از دستگاه خارج میشود که آن را بهاشتراک بگذارید یا ذخیره کنید، با مقادیر هویتدارِ پوشاندهشده.
این مستندات با Claude (Anthropic) تولید شده و توسط VD171 نگهداری میشود. اصلاحات و بهبودها خوشآمد است؛ به CONTRIBUTING.md مراجعه کنید.