Skip to content

fa AI AGENTS

VD $ VD171 @ Priv8 edited this page Nov 18, 2026 · 1 revision

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 برای عامل‌های هوش مصنوعی

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

اگر یک دستیار برنامه‌نویسی هوش مصنوعی، یک ابزار LLM، یک اسکریپت تحلیل یا هر خودکارسازی‌ای هستید که از طریق یک شِل به دستگاه می‌رسد، این صفحه برای شماست.

چرا برای عامل‌ها دوستانه است

  • یک سند، نه یک صفحه. کل اسکن - هر کاوشگر، هر عدسی، هر حکم - یک شیء JSON واحد است. بدون OCR، بدون خراشیدن صفحه، بدون ضربه‌زدن در میان کارت‌های جمع‌شده.
  • همان داده‌ای که رابط دارد. فایل یک خلاصه نیست. دقیقاً همان چیزی است که برنامه به‌صورت درونی نگه می‌دارد: صفحه نخستین خوانش یک مورد جمع‌شده را نشان می‌دهد، فایل همهٔ آن‌ها را دارد.
  • شکل جبرگرایانه. ساختار پایدار و مستند است ( EXPORT-FORMAT را ببینید)، پس تجزیه‌گری که یک‌بار نوشته شود به کار کردن ادامه می‌دهد.
  • بدون شبکه، بدون حساب، بدون وضعیتی برای مدیریت. برنامه روی دستگاه می‌خواند و یک فایل می‌نویسد. عامل شما فایل را می‌خواند. این تمام قرارداد است.
  • آفلاین بنا به طراحی. به هیچ اینترنتی نیاز ندارد، پس درون یک محیط قفل‌شده یا جدا از شبکه که یک عامل ممکن است در آن عمل کند نیز همان‌گونه اجرا می‌شود.

خواندن تک‌فرمانی

هر اسکن گزارش کامل خود را در حافظهٔ خصوصی برنامه می‌نویسد. پس از آنکه یک اسکن اجرا شد، یک عامل نتیجهٔ کامل را با یک فرمان واحد می‌خواند:

su -c cat /data/data/ru.vd171.vdinfos/files/last_snapshot.json
  • چه چیزی در آن است: هر کاوشگر با حکم خود و مقدار هر عدسی، در همان JSONِ دکمهٔ خروجی.
  • چه زمانی به‌روز می‌شود: در پایان هر اسکن. اول یک اسکن اجرا کنید؛ فایل همیشه آخرین را نگه می‌دارد.
  • پیش‌نیاز: روت، چون فایل در حافظهٔ خصوصی برنامه زندگی می‌کند. بدون روت، به‌جای آن از عمل درون‌برنامه‌ایِ به‌اشتراک‌گذاری / ذخیره به‌صورت JSON استفاده کنید و فایلی را که به عامل تحویل داده می‌شود بخوانید.

یک جریان کاری معمول عامل

  1. مطمئن شوید برنامه نصب است (APK SDK_35 از انتشارها).
  2. یک اسکن را راه بیندازید - یک شخص روی اسکن ضربه می‌زند، یا یک خودکارسازی صفحهٔ اسکن برنامه را باز می‌کند - و منتظر بمانید تا تمام شود.
  3. files/last_snapshot.json را با فرمان بالا بخوانید.
  4. آن را با قالب خروجی به‌عنوان طرحوارهٔ خود تجزیه کنید: روی کاوشگرها تکرار کنید، verdict هر یک را بخوانید، و values هر عدسی را کنار هم بچینید.
  5. روی نتیجهٔ ساختارمند در جریان کاری خودتان عمل کنید.

عامل تصمیم می‌گیرد که خوانش‌ها برای کار پیشِ‌رو چه معنایی دارند؛ VD Infos شواهد را فراهم می‌کند، تمیز و کامل.

عامل چه می‌گیرد، و چه نمی‌گیرد

  • گزارش هر خوانش و هر حکم را حمل می‌کند، پس یک عامل تصویر کاملی را که برنامه ساخته است دارد.
  • مقادیر هویت‌دار (شماره‌های سریال، IMEI، نشانی‌های MAC، شناسه‌های تبلیغاتی و مانند آن) در گزارش به‌اشتراک‌گذاشته/خروجی‌گرفته‌شده پوشانده می‌شوند، پس گزارشی که دست‌به‌دست می‌شود از شناسه‌های شخصی تهی می‌ماند در حالی که حکم‌ها و ساختار خود را نگه می‌دارد. فایل last_snapshot.json روی‌دستگاه، که تنها به‌دست برنامه یا روت خواندنی است، مقادیر واقعی را برای یک عامل محلی که به آن‌ها نیاز دارد نگه می‌دارد.

مستندات، نوشته‌شده تا تجزیه شوند

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

صفحه‌های مرتبط


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

Clone this wiki locally