استكشاف الأخطاء
شخّص المشكلات الشائعة وأصلحها دون دعم.
الشبكة / انتهاء مهلة الاتصال
- •جدار الحماية يحجب HTTPS الصادر إلى api.whisperx.ai
- •مشكلات توجيه VPN
- •إعداد DNS خاطئ
اختبر الاتصال خطوة بخطوة:
# 1. DNS resolution nslookup api.whisperx.ai # 2. TCP port 443 nc -zv api.whisperx.ai 443 # 3. HTTPS GET curl -v --max-time 5 "https://api.whisperx.ai/api/tags/trending"
إذا فشلت الخطوة 1: تحقق من إعدادات DNS. إذا فشلت الخطوة 2: جدار الحماية يحجب المنفذ 443 — اتصل بمدير الشبكة. إذا فشلت الخطوة 3: مشكلة TLS — تأكد من تحديث شهادات الجذر.
نتائج فارغة
- •الاستعلام دقيق جداً أو متخصص
- •فلتر العلامات مقيّد جداً
- •تاريخ since حديث جداً
- •فلتر القطاع يستبعد المعلومات المطابقة
جرّب استعلامات أوسع تدريجياً:
# Remove tag filter curl "https://api.whisperx.ai/api/intel?q=OpenAI&limit=10" # Remove sector filter curl "https://api.whisperx.ai/api/intel?q=layoff&limit=10" # Extend time window (no since filter) curl "https://api.whisperx.ai/api/intel?q=funding&limit=10" # Try trending tags to see what's active curl "https://api.whisperx.ai/api/tags/trending?limit=20"
النتائج الفارغة ليست خطأ — تعني أنه لا توجد معلومات تطابق فلاترك الآن. تنمو المنصة يومياً؛ حاول غداً أو وسّع بحثك.
429 — تجاوز حد الاستخدام
- •أكثر من 60 استدعاء API في الدقيقة من نفس IP
- •حلقة آلية بلا تأخير بين الطلبات
- •وكلاء متعددون يشاركون اتصالاً واحداً
تراجع وقلل التكرار:
- • انتظر 60 ثانية قبل إعادة المحاولة
- • أضف sleep 2 بين الطلبات في السكريبتات
- • قلل المعامل limit (جرّب 5-10 بدلاً من 50)
- • احفظ العلامات الرائجة — تتغير ببطء، لا داعي للاستعلام كل دقيقة
إذا كنت تحتاج حدوداً أعلى للاستخدام الإنتاجي، تواصل معنا.
5xx — خطأ في الخادم
- •خطأ عابر في المصدر
- •بدء بارد للعامل تحت الضغط
- •قاعدة البيانات غير متاحة مؤقتاً
استراتيجية إعادة المحاولة:
# Retry once after 10 seconds sleep 10 && curl "https://api.whisperx.ai/api/intel?q=test&limit=1" # If 5xx persists, fall back to trending tags (lighter endpoint) curl "https://api.whisperx.ai/api/tags/trending?limit=10"
إذا استمرت الأخطاء أكثر من 5 دقائق، تحقق من whisperx.ai للحصول على تحديثات الحالة. معظم المشكلات تُحل في دقائق.
استجابات بطيئة / انتهاء المهلة
- •البحث الدلالي مفعّل (مسح كامل للجدول — مكلف جداً)
- •المعامل limit مرتفع جداً (>50)
- •زمن انتقال الشبكة إلى حافة Cloudflare
تأكد من تعطيل البحث الدلالي وخفض limit:
# Good: keyword search, compact mode, small limit curl "https://api.whisperx.ai/api/intel?q=OpenAI&mode=compact&limit=10" # Bad: semantic search (avoid — full-table scan) # /api/intel?semantic=... ← do NOT use this
تُعطّل مهارة WhisperX البحث الدلالي تلقائياً. إذا كنت تستدعي API مباشرة، لا تستخدم المعامل semantic في الإنتاج.
المهارة غير موجودة / الأدوات لا تُحمّل
- •المهارة مثبّتة في مجلد خاطئ
- •SKILL.md مفقود أو فارغ
- •سكريبتات Shell غير قابلة للتنفيذ
- •متغير البيئة WHISPERX_BASE_URL مضبوط بشكل خاطئ
تحقق من تثبيتك:
# Check skill files exist ls ~/.claude/skills/whisperx/ # Expected: SKILL.md tools/ ls ~/.claude/skills/whisperx/tools/ # Expected: search.sh get.sh trending.sh trends.sh connections.sh export.sh # Check scripts are executable ls -la ~/.claude/skills/whisperx/tools/*.sh # Should show -rwxr-xr-x permissions # Fix permissions if needed chmod +x ~/.claude/skills/whisperx/tools/*.sh # Quick smoke test bash ~/.claude/skills/whisperx/tools/trending.sh 5
لا يزال لا يعمل؟ أعد تشغيل التثبيت من دليل البدء السريع.
إنشاء تقرير تشخيصي
إذا كنت لا تزال عالقاً، نفّذ هذا لإنشاء حزمة تشخيصية قابلة للمشاركة (لا بيانات حساسة):
echo "=== WhisperX Diagnostic ===" && \
echo "Date: $(date -u)" && \
echo "OS: $(uname -a)" && \
echo " && \
echo "--- Connectivity ---" && \
curl -s -o /dev/null -w "HTTP %{http_code} | Time %{time_total}s" \
"https://api.whisperx.ai/api/tags/trending?limit=1" && \
echo " && \
echo "--- Skill files ---" && \
ls -la ~/.claude/skills/whisperx/tools/ 2>/dev/null || echo "Skill not installed"الصق الناتج عند طلب الدعم. لا يتضمن IP أو استعلاماتك أو مفاتيحك.