> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/data-logic/referencing/debug-input.md).

# Debug Input

هذا البلوك يكتب محتوى مدخله إلى نافذة السجل (log) حتى تتمكن من فحص القيم أثناء زمن التشغيل. مفيد لإجراء فحوصات سريعة أثناء تصميم السيناريو ولأغراض استكشاف الأخطاء وإصلاحها.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

`Input`\
بيانات عامة للفحص. إذا كان المدخل صورة، سيعرض السجل ملخصًا للصورة (min, max, std, size). بالنسبة لأنواع البيانات الأخرى، يعرض السجل تمثيلًا قابلاً للقراءة.

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

هذا البلوك لا ينتج أية مخرجات.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Controls` لا شيء — هذا البلوك لا يحتوي على عناصر تفاعلية.

## 🎯 الميزات <a href="#features" id="features"></a>

* فحص بسيط أثناء التشغيل لأي بيانات متصلة.
* تلخيص تلقائي للصور عند استلام مصفوفات الصور (يعرض min، max، standard deviation والأبعاد).
* خفيف الوزن: مخصص للفحوصات السريعة وتصحيح الأخطاء أثناء بناء سير العمل.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. قم بتوصيل البيانات التي تريد فحصها بمقبس `Input`.
2. شغّل السيناريو. سيُطبع محتوى `Input` في نافذة السجل في كل مرة يتم فيها تقييم البلوك.
3. استخدم مخرجات السجل للتحقق من القيم المتوقعة، أشكال البيانات، أو لاكتشاف قيم None/فارغة غير متوقعة.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

عند التقييم، يقرأ هذا البلوك المدخل الحالي وينشر رسالة وصفية في السجل. تُلخّص الصور؛ وتُحوّل أنواع البيانات الأخرى إلى نص قابل للقراءة قبل التسجيل.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* استخدم `Is None` قبل هذا البلوك لتجنب تسجيل قيم None المتكررة ولتصفية البيانات ذات المغزى فقط.
* اجمعه مع `Rising Edge` أو `Logic Input` لتسجيل الدخول فقط عند أحداث محددة (مثل عندما تصبح حالة ما true) ليبقى السجل قابلاً للقراءة.
* عند فحص تدفقات الصور، اجمعه مع `Show Image` للتأكد بصريًا مما تشير إليه ملخصات الصورة.
* لحفظ القيم المفحوصة للتحليل لاحقًا، قم بتوجيه البيانات إلى `Data Write Local` أو `Data Write Global` واطلع عليها عبر `Data Read Local` / `Data Read Global`.
* إذا رغبت في تسجيل مصفوفات رقمية أو بيانات جدولة، ففكّر أيضًا في توصيل المخرجات إلى `CSV Export` للتسجيل الدائم.
* مجموعات مفيدة للفحوصات الشائعة:
  * فحوصات الكائنات البصرية: وصل المخرجات من `Object Detection` أو `Find Object` أو `Mask Detection` إلى هذا البلوك لفحص قوائم الاكتشاف والأعداد.
  * فحوصات OCR والنص: مرّر مخرجات من `OCR` أو `OCR (EasyOCR)` هنا للتحقق من النص المعترف به قبل التصدير.
  * تصحيح خطوات ما قبل المعالجة: ضع هذا البلوك بعد `Blur` أو `Image Threshold` أو `HSV Filter` لفحص النتائج الوسيطة.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* لا يوجد خرج في السجل: تأكد من توصيل البلوك وأن السيناريو قيد التشغيل. إذا لم يتم تقييم المدخل، جرّب إضافة مُشَغّل من الأعلى (مثل `Logic Input` أو `Rising Edge`).
* السجل يعرض هياكل كبيرة غير قابلة للقراءة: بالنسبة للصور الكبيرة أو القوائم الطويلة، استخدم `Show Image` أو احفظ البيانات باستخدام `Image Logger` / `CSV Export` بدلاً من الاعتماد فقط على السجل.
* رسائل متكررة ومطابقة تغمر السجل: استخدم بلوكات بوابة الأحداث مثل `Rising Edge`، `All True`، أو منطق البوابة (`And` / `Or`) لتقليل تكرار تقييم هذا البلوك.