Repository navigation
fa AI AGENTS
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 ساخته شده تا بهدست ماشینها خوانده شود، نه فقط بهدست مردم. یک اشکالزدای متدهای دستگاه شواهد ساختارمند زیادی تولید میکند - هر مقدار، خواندهشده از طریق هر متد، کنار هم چیدهشده برای مقایسه - و این شواهد برای یک عامل بهصورت داده بسیار مفیدتر است تا بهصورت تصویر صفحه. پس کل نتیجه بهصورت یک سند ماشینخوان در دسترس است، و برنامه از همان بنیاد حول آن طراحی شده است.
اگر یک دستیار برنامهنویسی هوش مصنوعی، یک ابزار LLM، یک اسکریپت تحلیل یا هر خودکارسازیای هستید که از طریق یک شِل به دستگاه میرسد، این صفحه برای شماست.
- یک سند، نه یک صفحه. کل اسکن - هر کاوشگر، هر عدسی، هر حکم - یک شیء JSON واحد است. بدون OCR، بدون خراشیدن صفحه، بدون ضربهزدن در میان کارتهای جمعشده.
- همان دادهای که رابط دارد. فایل یک خلاصه نیست. دقیقاً همان چیزی است که برنامه بهصورت درونی نگه میدارد: صفحه نخستین خوانش یک مورد جمعشده را نشان میدهد، فایل همهٔ آنها را دارد.
- شکل جبرگرایانه. ساختار پایدار و مستند است ( EXPORT-FORMAT را ببینید)، پس تجزیهگری که یکبار نوشته شود به کار کردن ادامه میدهد.
- بدون شبکه، بدون حساب، بدون وضعیتی برای مدیریت. برنامه روی دستگاه میخواند و یک فایل مینویسد. عامل شما فایل را میخواند. این تمام قرارداد است.
- آفلاین بنا به طراحی. به هیچ اینترنتی نیاز ندارد، پس درون یک محیط قفلشده یا جدا از شبکه که یک عامل ممکن است در آن عمل کند نیز همانگونه اجرا میشود.
هر اسکن گزارش کامل خود را در حافظهٔ خصوصی برنامه مینویسد. پس از آنکه یک اسکن اجرا شد، یک عامل نتیجهٔ کامل را با یک فرمان واحد میخواند:
su -c cat /data/data/ru.vd171.vdinfos/files/last_snapshot.json- چه چیزی در آن است: هر کاوشگر با حکم خود و مقدار هر عدسی، در همان JSONِ دکمهٔ خروجی.
- چه زمانی بهروز میشود: در پایان هر اسکن. اول یک اسکن اجرا کنید؛ فایل همیشه آخرین را نگه میدارد.
- پیشنیاز: روت، چون فایل در حافظهٔ خصوصی برنامه زندگی میکند. بدون روت، بهجای آن از عمل درونبرنامهایِ بهاشتراکگذاری / ذخیره بهصورت JSON استفاده کنید و فایلی را که به عامل تحویل داده میشود بخوانید.
- مطمئن شوید برنامه نصب است (APK SDK_35 از انتشارها).
- یک اسکن را راه بیندازید - یک شخص روی اسکن ضربه میزند، یا یک خودکارسازی صفحهٔ اسکن برنامه را باز میکند - و منتظر بمانید تا تمام شود.
-
files/last_snapshot.jsonرا با فرمان بالا بخوانید. - آن را با قالب خروجی بهعنوان طرحوارهٔ خود تجزیه کنید: روی
کاوشگرها تکرار کنید،
verdictهر یک را بخوانید، وvaluesهر عدسی را کنار هم بچینید. - روی نتیجهٔ ساختارمند در جریان کاری خودتان عمل کنید.
عامل تصمیم میگیرد که خوانشها برای کار پیشِرو چه معنایی دارند؛ VD Infos شواهد را فراهم میکند، تمیز و کامل.
- گزارش هر خوانش و هر حکم را حمل میکند، پس یک عامل تصویر کاملی را که برنامه ساخته است دارد.
- مقادیر هویتدار (شمارههای سریال، IMEI، نشانیهای MAC، شناسههای تبلیغاتی و مانند آن)
در گزارش بهاشتراکگذاشته/خروجیگرفتهشده پوشانده میشوند، پس گزارشی که دستبهدست میشود از
شناسههای شخصی تهی میماند در حالی که حکمها و ساختار خود را نگه میدارد. فایل
last_snapshot.jsonرویدستگاه، که تنها بهدست برنامه یا روت خواندنی است، مقادیر واقعی را برای یک عامل محلی که به آنها نیاز دارد نگه میدارد.
این ویکی به اندازهٔ مردم برای خواندن ماشینی نیز ساختار یافته است: بخشهای کوتاه، سرنوشتههای پایدار، نامهای صریح فیلد، و یک صفحهٔ اختصاصیِ قالب خروجی که یک عامل میتواند آن را بهعنوان یک طرحواره تلقی کند. اگر در حال ساخت ابزاری روی VD Infos هستید، از آنجا شروع کنید.
- قالب خروجی - طرحوارهٔ JSON، فیلد به فیلد.
- راهنمای کاربری - نصب، اسکن و بهاشتراکگذاری.
- معماری - اینکه برنامه چگونه کنار هم چیده شده است.
این مستندات با Claude (Anthropic) تولید شده و توسط VD171 نگهداری میشود. اصلاحات و بهبودها خوشآمد است؛ به CONTRIBUTING.md مراجعه کنید.