استكشاف الأخطاء وإصلاحها
ظهور خطأ بعد تشغيل إجراء آلي
Section titled “ظهور خطأ بعد تشغيل إجراء آلي”وسّع لوحة المهام العامة لعرض الخطأ كاملًا.
يمكن إعادة محاولة المهام الفاشلة بشكل عادي. وإذا بقيت مهمة قيد التشغيل أو في قائمة الانتظار دون أي تقدّم لفترة طويلة، فاستخدم إعادة المحاولة القسرية.
اقرأ رسالة الخطأ المحددة، ثم راجع أقسام استكشاف الأخطاء أدناه.
إذا لم تتمكن من حل المشكلة، فتواصل مع المطورين.
انتهاء مهلة الطلب
Section titled “انتهاء مهلة الطلب”يشير هذا عادةً إلى عدم استقرار الشبكة أو إلى أن خدمة المزوّد غير متاحة مؤقتًا. جرّب ما يلي:
- التحقق من استقرار الاتصال بالشبكة؛
- المحاولة مرة أخرى لاحقًا؛
الخطأ 401
Section titled “الخطأ 401”قد يبدو الخطأ كما يلي:
API returned status 401: {"error":{"message":"Authentication Fails, Your api key: ****u2sd is invalid","type":"authentication_error","param":null,"code":"invalid_request_error"}}يعني هذا أن مفتاح API غير صالح. تحقّق مما يلي:
- أن مفتاح API نُسخ كاملًا ولا يحتوي على مسافات زائدة.
- أن المزوّد وعنوان URL لواجهة API متطابقان.
الخطأ 429
Section titled “الخطأ 429”يشير هذا عادةً إلى تقييد الطلبات من جانب المزوّد أو إلى تزامن مفرط. جرّب ما يلي:
- إعادة محاولة العناصر الناقصة يدويًا؛
- ضبط إعدادات حد المعدل (راجع توثيق المزوّد)؛
- خفض التزامن؛
- زيادة الفاصل الزمني بين الطلبات.
لا تحدد جميع العناصر فورًا لإعادة معالجتها؛ فقد يزيد ذلك الوضع سوءًا بتحفيز مزيد من التقييد من جانب المزوّد.
الخطأ 400
Section titled “الخطأ 400”يعني هذا أن طلب API غير صالح. وقد تكون له أسباب كثيرة، لذا افحص محتوى الخطأ.
إذا بدا الخطأ هكذا:
API returned status 400: {"error":{"message":"The supported API model names are deepseek-v4-pro or deepseek-v4-flash, but you passed deepseek-v4-pro1111.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}فإن معرّف النموذج غير صالح. تحقّق مما يلي:
- أن المعرّف لم يُدخل بشكل خاطئ. استخدم المعرّف الذي يوفّره المزوّد، وليس اسم العرض للنموذج.
- قد يكون المزوّد قد أزال النموذج لتقادمه. في هذه الحالة، جرّب نموذجًا آخر.
إذا بدا الخطأ هكذا:
API returned status 400: {"error":{"message":"Failed to deserialize the JSON body into the target type: messages[0]: unknown variant `image_url`, expected `text` at line 1 column 3061412","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}فربما أُسندت إلى النموذج قدرة غير صحيحة عند إعداد الخدمة. على سبيل المثال:
- أُسندت مهمة متعلقة بالرؤية إلى نموذج لا يدعم الرؤية.
الخطأ «Expected X translations but got Y»
Section titled “الخطأ «Expected X translations but got Y»”على سبيل المثال:
Expected 6 translations but got 7. The AI likely returned malformed content, pleasetry again.يعني هذا أن النموذج لم يقدّم ترجمة واحدة لكل عنصر كما تشترط موجّهات النظام. يمكنك:
- تعديل إعداد النموذج وزيادة مستوى الاستدلال؛
- التبديل إلى نموذج آخر؛
- تجربة النموذج نفسه مرة أخرى لاحقًا.
إذا تكرر هذا كثيرًا، فقد لا يكون النموذج مناسبًا لهذه المهمة لأنه لا يتبع التعليمات بشكل موثوق.
فشل تحميل صفحة اختيار المزوّد
Section titled “فشل تحميل صفحة اختيار المزوّد”ربما تكون الشبكة غير متاحة. تحقّق مما إذا كان الجهاز يستطيع الاتصال بـ الموقع الرئيسي لـ Neko Translator.
إذا تعذّر حل مشكلة الشبكة، فاستخدم إضافة يدويًا لإعداد المزوّد الذي تريد استخدامه.
عدم اكتشاف الكتل النصية أو عدم استخراج النص المصدر
Section titled “عدم اكتشاف الكتل النصية أو عدم استخراج النص المصدر”- تأكّد من ضبط اللغة المصدر بشكل صحيح.
- تحقّق من أن الصورة واضحة، وأن النص ليس صغيرًا جدًا أو مائلًا أو محجوبًا أو ممتزجًا بالخلفية.
- جرّب خدمة كشف مختلفة.
- قد يصعب التعرف على الكتابة اليدوية والمؤثرات الصوتية والخطوط الزخرفية. أضف كتلة نصية يدويًا وأدخل النص المصدر بنفسك.
إجراء الترجمة معطّل
Section titled “إجراء الترجمة معطّل”تحتاج «ترجمة» إلى كتلة نصية واحدة على الأقل تحتوي على نص مصدر، وإلى نموذج مُعدّ بقدرة ترجمة.
إذا كان النص المصدر فارغًا، فشغّل «استخراج النص» أو أدخل النص يدويًا أولًا.
كيفية استكشاف أخطاء الترجمة
Section titled “كيفية استكشاف أخطاء الترجمة”تحقّق مما يلي بالترتيب:
- تحقّق من أن الكتلة النصية تغطي المنطقة المقصودة.
- تحقّق مما إذا كان النص المصدر المستخرج صحيحًا. وإن لم يكن كذلك، فأعد تشغيل التعرف باستخدام نموذج رؤية أكثر قدرة، أو أدخل النص المصدر يدويًا.
- جرّب حذف ملخص الصورة ثم الترجمة مرة أخرى؛ فقد يضلل الملخص غير الصحيح نموذج الترجمة.
- جرّب نموذجًا أكثر قدرة.
أسماء ملفات غير مقروءة عند استيراد ملف ZIP
Section titled “أسماء ملفات غير مقروءة عند استيراد ملف ZIP”إذا طلب منك التطبيق اختيار ترميز لأسماء الملفات، فاختر ترميزًا وتحقق من معاينة الأسماء. لا تتابع إلا عندما تظهر الأسماء بشكل صحيح ولا توجد أخطاء في فك الترميز أو أسماء مكررة.
تعذر فتح مساحة العمل
Section titled “تعذر فتح مساحة العمل”إذا تعذر فتح مساحة عمل، فاتبع خطوات استكشاف الأخطاء وإصلاحها المعروضة في الواجهة. إذا استمرت المشكلة، فتواصل مع المطورين للحصول على المساعدة.
فشل تنزيل النموذج المحلي أو استيراده
Section titled “فشل تنزيل النموذج المحلي أو استيراده”- تحقّق من مساحة القرص والوصول إلى الشبكة.
- يعني فشل استيراد ملف ZIP أو فشل التحقق من قيمة التجزئة عادةً أن الأرشيف غير مكتمل أو تم العبث به.