# اكتشف ما الذي حدث

Canonical page: https://phishdestroy.github.io/TgWitness/ar/docs/troubleshooting/

ابدأ بالأعراض. تحقق من كل طبقة على حدة.

## تطلب اللوحة رمزًا رمزيًا

استخدم رمز اللوحة (panel token) الموجود في الملف المحلي الذي يعرضه المشغل. بالنسبة لـ Docker، قم بتشغيل `docker compose exec tgwitness cat /data/panel-token.txt`. يخدم رمز تسجيل الدخول إلى Telegram ورمز BotFather ورمز الشاهد للقراءة فقط أغراضًا مختلفة.

## Telegram لا يتصل

افتح إعدادات الاتصال وقم بإجراء فحص الاتصال. في حالة استخدام بروكسي عام، جرب إدخالًا آخر واحفظ المسار بشكل صريح. تحقق من نوع البروكسي وتنسيق السر المدعوم. لا يؤدي تحديث قائمة عامة إلى تغيير مسار الحساب.

## متصل، ولكن لا توجد رسائل جديدة

1. تأكد من أن المراقبة تعمل في مساحة العمل الصحيحة.
2. تأكد من أن المصدر محدد ومرئي لهذا الحساب.
3. أرسل رسالة جديدة فريدة في مجموعة خاضعة للرقابة وابحث عن ذلك النص بالضبط.
4. راجع السجل التشغيلي للتحقق من وجود أي انقطاعات أو تأخيرات في العمل أو أخطاء في Telegram.

تختلف اللقطات التاريخية عن أحداث الرسائل الجديدة. يمكن توصيل مصدر خفي دون إنتاج رسائل جديدة. استخدم اختبار التسليم الخاضع للرقابة عندما يكون الاكتمال أمرًا مهمًا.

## FloodWait أو فجوة بعد إعادة التشغيل

تعني عبارة «FloodWait» أن Telegram يتطلب توقفًا مؤقتًا. انتظر المدة المحددة وراجع حجم العمل المتراكم؛ فعمليات إعادة الاتصال المتكررة لا تزيل هذا الحد. تساعد حالة التحديث المحفوظة على استكمال العمل بعد إعادة التشغيل، لكن التحديثات منتهية الصلاحية وبعض فترات الانقطاع تظل تشكل قيودًا. قم بتسجيل الفجوة بدلاً من اعتبار السجل مكتملًا.

## تم تكوين البوت ولكنه لا ينشر أي شيء

تأكد من أن عملية «Witness» قيد التشغيل فعليًّا، وأن الروبوت قادر على النشر في القناة، وأن «Witness» يمكنه الوصول إلى أداة التجميع وواجهة برمجة تطبيقات الروبوت (Bot API). افحص سجله بحثًا عن أي عمليات نشر فاشلة. لا يُعد استقصاء أداة التجميع الناجح وحده تأكيدًا على نشر رسالة في القناة.

## أين تكمن ميزة تكامل رمز GitHub؟

**قيد التخطيط.** تصف قسم «Extras» (الإضافات) عملية التحقق المقترحة من التفرع (fork) والتجميع (build). لا يوجد حاليًا نموذج رمز GitHub أو شهادة آلية تؤكد أن التثبيت قيد التشغيل يتطابق مع المستودع. انظر [حالة الميزات الحالية](https://phishdestroy.github.io/TgWitness/ar/docs/reference/features/).

عند الإبلاغ عن مشكلة، يرجى ذكر الإصدار ونظام التشغيل والخطوات المتبعة ونص الخطأ بعد حجب المعلومات الحساسة. يرجى عدم ذكر الجلسات ورموز الدخول والرسائل الخاصة ودليل البيانات في المشكلات العامة.