123SUDODocs
مرجع

استكشاف الأخطاء وإصلاحها

إصلاحات لأخطاء النماذج ومفاتيح واجهة برمجة التطبيقات والنماذج المحلية والأدوات والمرفقات والصور والصوت والاعتمادات والأجهزة.

قبل أي شيء آخر، تأكد من أنك على الإصدار الأخير. يتم إصلاح العديد من المشكلات ببساطة عن طريق التحديث - راجع التحديثات والإصدارات.

لن يتم تثبيت التطبيق أو فتحه

Windows

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

إذا تم تثبيت التطبيق ولكن لم يتم تشغيله، فحاول التثبيت من Microsoft Store بدلاً من المثبت المباشر - يتعامل إصدار المتجر مع تبعياته الخاصة.

macOS

إذا رفض macOS فتح التطبيق، فافتح إعدادات النظام ← الخصوصية والأمان واتركه هناك، ثم قم بتشغيله مرة أخرى.

تأكد من سحب 9xchat إلى التطبيقات بدلاً من تشغيله من صورة القرص المثبت.

Linux

تأكد من وضع علامة على الملف الذي تم تنزيله باعتباره قابلاً للتنفيذ. إذا لم يكن كذلك، قم بتعيين البت القابل للتنفيذ عليه وتشغيله مرة أخرى.

متحرك

قم بالتثبيت من خلال Google Play أو App Store حتى تصل التحديثات تلقائيًا. إذا لم يبدأ التطبيق، فقم بتحديثه، ثم أعد تشغيل جهازك.

تفشل الاستجابات أو تتوقف جزئيًا

العمل من خلال هذه بالترتيب:

  1. تحقق من اتصالك. تحتاج النماذج السحابية إلى الوصول إلى الإنترنت. النماذج المحلية تفعل ذلك لا - إذا فشلت الطلبات السحابية ولكن الطلبات المحلية تعمل، فإن المشكلة تكمن في الشبكة أو الموفر، وليس في 9xchat.

  2. تحقق من رصيدك الائتماني. إذا كنت تستخدم أرصدة 9xchat وكان لديهم نفاد، توقف الطلبات. قم بتعبئة الرصيد أو قم بالتبديل إلى مفتاح API الخاص بك.

  3. تحقق من مفتاح API الخاص بك. إذا أحضرت مفتاحك الخاص، فتأكد من أنه لا يزال موجودًا صالحة ولها حصة متبقية مع هذا المزود.

  4. جرّب نموذجًا مختلفًا. إذا فشل نموذج ونجح آخر، فهذه هي المشكلة مع هذا النموذج أو المزود المحدد.

النموذج مفقود أو لن يتم تحميله

  • النماذج السحابية تحتاج إما إلى أرصدة أو إلى مفتاح واجهة برمجة التطبيقات (API) الذي تم تكوينه لذلك مزود. ضمن المكتبة → النماذج، يظل الموفر محددًا بـ غير نشط حتى تضيف مفتاحه — وهذا التصنيف هو أسرع طريقة لمعرفة ما ليس لديك طريق إليه.

  • النماذج المحلية تحتاج إلى أن يبدأ عداءك المحلي قبل أن يتمكن 9xchat من الوصول إليهم. ابدأ تشغيله أولاً، ثم أعد فتح قائمة النماذج.

تم رفض مفتاح API الخاص بك

الفشل موجود عند الموفر، لذا فإن الإصلاح موجود أيضًا:

  1. الصق المفتاح مرة أخرى، بدون مسافات بادئة أو زائدة.
  2. تأكد من أن المفتاح ينتمي إلى الموفر الذي أضفته تحته.
  3. تأكد من أن المفتاح لا يزال موجودًا ولم يتم إبطاله أو تدويره.
  4. تأكد من إعداد الفوترة والحصة المتبقية لدى هذا المزود — أ المفتاح الصالح بدون رصيد يفشل بنفس الطريقة التي يفشل بها المفتاح السيئ.
  5. تأكد من أن النموذج الذي اخترته هو النموذج المسموح لحسابك باستخدامه. بعض تحتاج النماذج إلى طبقة منفصلة مع الموفر.

يتم تخزين المفاتيح مشفرة على جهازك. إذا توقف المفتاح عن العمل في كل مكان، فاستبدله لدى الموفر بدلاً من إعادة تثبيت 9xchat.

لن يتم توصيل النموذج المحلي

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

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

أداة أو خادم MCP لا يعمل

  1. تحقق من تمكين الأداة. تحتوي كل أداة على مفتاح تمكين أسفلها المكتبة → الأدوات.

  2. تحقق من الخطة. تحتاج أدوات الوكيل والبحث المباشر على الويب إلى الإصدار الاحترافي - راجع الاعتمادات والبرو والاستخدام.

  3. اقرأ سطر الأمان. فهو يوضح الأذونات التي تحتاجها الأداة. أداة الذي لا يستطيع الوصول إلى ما يحتاج إليه يفشل بدلاً من السؤال.

  4. بالنسبة لخوادم MCP، تأكد من توفير الأسرار المطلوبة — إدخال لا تزال علامة يحتاج إلى تكوين لم يتم إعدادها. تُظهر معاينة التكوين الأمر الدقيق الذي يتم تشغيله، والذي يستحق إعادة القراءة إذا لم يبدأ الخادم مطلقًا.

  5. اعزلها. قم بتعطيل الأداة، واطرح نفس السؤال، وانظر ما إذا كان تغييرات السلوك. يخبرك هذا ما إذا كانت الأداة متورطة على الإطلاق.

البحث عن المعرفة لا يجد شيئا

يجب فهرسة المجموعة قبل البحث فيها.

  • تأكد من إضافة الملفات إلى مجموعة، وليس فقط إرفاقها بالدردشة.
  • تأكد من تمكين أداة البحث عن المعرفة.
  • إذا تعذر الوصول إلى موفر عمليات التضمين لديك عند إضافة الملفات، يعود البحث إلى مطابقة الكلمات الرئيسية وسيفقد أي شيء يحتاج إلى الفهرس. أعد إضافة الملفات بمجرد إمكانية الوصول إلى الموفر.

راجع المعرفة والذكريات.

لن تتم معالجة المرفق

  • تأكد من أن النموذج الذي حددته يقبل هذا النوع من الملف. نموذج النص فقط لا يمكن قراءة الصورة، وتحدد قائمة النماذج التي تتعامل مع الرؤية.
  • يمكن أن تتجاوز الملفات الكبيرة جدًا سياق النموذج. حاول استخراج أصغر، أو نموذج مع نافذة سياق أكبر.
  • إذا تم فتح الملف بشكل صحيح في مكان آخر ولكنه فشل هنا، فحاول تحويله إلى ملف التنسيق المشترك أولاً.

فشل إنشاء الصورة

  • يحتاج إنشاء الصور إلى Pro.
  • تأكد من تحديد نموذج الصورة — حيث يتم اختياره بشكل منفصل عن النموذج الخاص بك نموذج الدردشة.
  • تحقق من رصيدك الائتماني إذا كنت تقوم بإنشاء أرصدة 9xchat.
  • يتم رفض بعض المطالبات من قبل الموفر بدلاً من 9xchat؛ إعادة الصياغة هي عادةً ما يكون أسرع من إعادة المحاولة.

فشل الإملاء أو القراءة بصوت عال

كلاهما يحتاج إلى موفر صوت فعال، ولا يوجد لدى أي منهما خيار محلي.

  • تأكد من تعيين موفر النسخضمنالإعدادات → الافتراضي النماذج.
  • امنح إذن الميكروفون 9xchat لخصوصية نظام التشغيل الخاص بك الإعدادات — على نظام التشغيل macOS، إعدادات النظام ← الخصوصية والأمان ← الميكروفون.
  • كلاهما يحتاج إلى اتصال حتى عندما يكون نموذج الدردشة الخاص بك محليًا.

يحتاج إدخال الميكروفون إلى Pro؛ قراءة بصوت عال لا.

الاعتمادات تنفد بشكل أسرع من المتوقع

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

يمكنك وضع حد أقصى لهذا لكل دردشة عن طريق خفض الحد الأقصى لرموز الاكتمال والحد الأقصى للسياق في إعدادات النموذج، كما يقلل Context Shield مقدار السجل الذي يتم إعادة إرساله مع كل رسالة.

لإيقاف إنفاق الأرصدة بالكامل، أضف مفتاح API الخاص بك أو استخدم نموذجًا محليًا.

الميزة باللون الرمادي أو مفقودة

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

إذا كنت تدفع بالفعل، فتأكد من تسجيل دخول هذا الجهاز باستخدام المعرف الفريد (UID) الذي يحمل الاشتراك، وأنك لم تتجاوز حد الجهاز - جهاز واحد مجانًا، وثلاثة في الإصدار Pro. اتبع UID على ثلاثة أجهزة لتوصيل جهاز أو تبديله أو إزالته.

هناك شيء مفقود على جهاز آخر

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

  • الذكريات لكل جهاز. التثبيت الجديد يبدأ بلا شيء.
  • تعمل Handoff على ربط جهازين لإجراء محادثة واحدة؛ لا ينسخ الباقي من مساحة العمل الخاصة بك.
  • لنقل المواد بنفسك، استخدم الإعدادات → البيانات والصادرات.

يتبع اشتراكك UID، لذا فإن الجهاز الذي يتحقق من خلاله يلتقط Pro على الرغم من عدم انتقال المحتوى.

لا شيء هنا ساعد

تواصل من خلال support مع:

  • نظام التشغيل الخاص بك وإصدار 9xchat،
  • النموذج والمزود الذي كنت تستخدمه،
  • سواء كنت تستخدم الاعتمادات، أو مفتاحك الخاص، أو نموذجًا محليًا،
  • ما فعلته والخطأ المرئي بالضبط.

لا تقم أبدا بتضمين هذه في التقرير

UID الخاص بك، أو أي مفتاح API، أو أسرار MCP، أو محتويات محادثة خاصة. الدعم لا يحتاج إليها أبدًا، ويمكن أن تكشف لقطة شاشة لشاشة النماذج عن المفتاح.

في هذه الصفحة