هذه ترجمة آلية للمستند الأصلي باللغة الإنجليزية. في حال وجود أي تعارض بين هذه الترجمة والنسخة الإنجليزية الأصلية، تُعتمد النسخة الإنجليزية. اقرأ النسخة الإنجليزية الأصلية


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

شيء لا يعمل؟ ابدأ من هنا.

مشكلات إضافة المتصفح

الإضافة لا تفتح

  1. تأكد من تثبيتها من متجر Chrome الإلكتروني (وليس نسخة تطوير)
  2. اذهب إلى chrome://extensions وابحث عن رسائل الخطأ
  3. حاول تعطيل الإضافة وإعادة تمكينها
  4. أعد تشغيل Chrome تماماً إذا لم ينجح ذلك

اللوحة الجانبية لا تفتح

  1. انقر على أيقونة Caiioo في شريط الأدوات (أعلى اليمين)
  2. تأكد من أنك في صفحة ويب عادية (بعض الصفحات مثل إعدادات Chrome لا تسمح بالإضافات)
  3. اذهب إلى chrome://extensions ، وابحث عن Caiioo، وانقر على "إعادة تحميل"
  4. حاول النقر على الأيقونة مرة أخرى

شريط جانبي فارغ أو معطل بعد التحديث

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

مشكلات تسجيل الدخول

لا يمكن تسجيل الدخول باستخدام Google / Apple / Microsoft

  1. تأكد من أن متصفحك لا يحظر النوافذ المنبثقة — يتطلب OAuth نافذة منبثقة
  2. على نظام iOS، إذا توقف تسجيل الدخول عبر Google، جرب خيار "تسجيل الدخول باستخدام Apple" بدلاً من ذلك
  3. امسح ملفات تعريف الارتباط لـ caiioo.ai وحاول مرة أخرى
  4. إذا قمت بتغيير كلمات المرور مؤخرًا، فقم بتسجيل الخروج من المزود في متصفحك أولاً، ثم حاول مرة أخرى

عالق في شاشة تسجيل الدخول بعد الدخول

  • انتظر بضع ثوانٍ — التطبيق يجلب ملفك الشخصي
  • إذا ظل عالقًا، أغلق التطبيق وأعد فتحه (أو أعد تحميل الإضافة)
  • تأكد من صحة ساعة جهازك — يفشل التحقق من رمز OAuth إذا كانت الساعة غير دقيقة

مشكلات مفتاح API

مفتاح API لا يعمل

  1. انسخ مفتاحك مجددًا من موقع المزود والصقه بعناية (بدون مسافات في البداية أو النهاية)
  2. تحقق من وجود رصيد متبقٍ في حسابك
  3. جرّب إنشاء مفتاح جديد واستخدامه بدلاً منه
  4. تحقق من صحة تنسيق المفتاح — تبدأ مفاتيح OpenRouter بـ sk-or-

لا أستطيع العثور على مفتاح API الخاص بي

  • OpenRouter: openrouter.ai/keys
  • Ollama: لا حاجة لمفتاح — تأكد من تشغيل خادمك المحلي على http://localhost:11434

راجع مزودو الذكاء الاصطناعي ومفاتيح API لمزيد من التفاصيل.

"تم تقييد المعدل" أو "تحميل زائد" على النموذج الذي اخترته

هذا من المزود وليس من مفتاحك. عندما يتعرض النموذج الذي اخترته لتقييد المعدل أو التحميل الزائد أو عدم التوفر، يذكر Caiioo اسم النموذج ويوضح ما حدث بدلاً من نقلك بهدوء إلى نموذج آخر. انتظر دقيقة وأرسل مجددًا، أو اختر نموذجًا آخر بنفسك. (عندما يختار Caiioo النموذج نيابة عنك، فإنه يظل يبدّله تلقائيًا — هذا هو الفرق).

نموذج مجاني يرفض طلباتي باستمرار

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

تكامل Google (خطة Pro)

تعذر الاتصال بـ Google

  1. انتقل إلى الإعدادات > الموصلات
  2. انقر فوق "ربط حساب Google"
  3. تأكد من الموافقة على جميع الأذونات المطلوبة
  4. تحقق من ظهور حسابك كمتصل
  5. إذا استمر عدم العمل، فافصل الاتصال وحاول مرة أخرى

أدوات Google لا تعمل

  1. تحقق من اتصال Google (الإعدادات > الموصلات)
  2. جرب تحديث اتصال Google الخاص بك (زر "إعادة الاتصال بـ Google")
  3. تأكد من تمكين الأداة المحددة (الإعدادات > الأدوات وعمليات الربط > تكوين الأدوات)

مشكلات المزامنة الخاصة

المزامنة لا تعمل

  1. تحقق من تمكين المزامنة الخاصة بالفعل (الإعدادات > الاتصال > المزامنة الخاصة)
  2. تأكد من اتصال حساب Google الخاص بك
  3. تأكد من وجود مساحة تخزين متبقية في Google Drive
  4. انقر على "إعادة ربط Google" إذا انتهت صلاحية الرمز الخاص بك
  5. جرب إيقاف المزامنة ثم إعادة تشغيلها

لم تتم مزامنة البيانات عبر الأجهزة

  • تعمل المزامنة الخاصة في الخلفية — امنحها بضع ثوانٍ
  • تحقق من أنك تستخدم نفس حساب Google على جميع الأجهزة
  • تأكد من تمكين المزامنة الخاصة على الجهاز الآخر أيضًا
  • حدّث يدويًا عن طريق إيقاف المزامنة وإعادة تشغيلها

مشكلات الوصول إلى المتصفح عن بُعد

صفحة relay.caiioo.ai/app لا تتصل

  • على جهازك الرئيسي، تأكد من تشغيل Private Relay (الإعدادات > الاتصال > الأجهزة والترحيل) وظهور الحالة "متصل"
  • سجّل الدخول على المتصفح البعيد باستخدام نفس الحساب كجهازك الرئيسي — يصل الترحيل فقط إلى نسختك الخاصة
  • يجب أن يكون الامتداد أو تطبيق سطح المكتب لجهازك الرئيسي قيد التشغيل ومتصلاً بالإنترنت حتى يتمكن المتصفح البعيد من إدارته
  • عند الفتح لأول مرة، قد تعرض الصفحة مؤشر "جارٍ الاتصال" لبضع ثوانٍ أثناء إنشاء الجلسة المشفرة — دعه يكتمل قبل إعادة التحميل

تم تسجيل الدخول ولكن الصفحة البعيدة متوقفة عند شاشة تسجيل الدخول

  • انتظر بضع ثوانٍ — يبدأ تشغيل التطبيق فقط بمجرد إنشاء الجلسة المشفرة
  • إذا استمرت المشكلة، فتأكد من أن جهازك الرئيسي متصل بالإنترنت وأن Private Relay متصل، ثم أعد تحميل الصفحة

مشاكل الأداء

الردود بطيئة

  1. تحقق مما إذا كان مزود الذكاء الاصطناعي يواجه مشاكل (تحقق من صفحة الحالة الخاصة بهم)
  2. حاول استخدام نموذج أسرع وأرخص (مثل Gemini Flash أو Mistral)
  3. أرشفة المحادثات القديمة إذا كان لديك المئات منها
  4. تحقق من اتصالك بالإنترنت

المحادثات تستغرق وقتاً طويلاً

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

الاشتراك والفوترة

تعذر رؤية "إدارة الخطة"

  • تأكد من تسجيل الدخول بالحساب الذي يمتلك الاشتراك
  • إذا اشتركت على نظام iOS، فإن زر "إدارة الخطة" يوجهك إلى إعدادات اشتراك Apple
  • إذا اشتركت على الويب، فسيوجهك إلى بوابة فوترة Stripe
  • سجل الخروج وتسجيل الدخول مرة أخرى لتحديث حالة اشتراكك

"إدارة الخطة" تفتح في المكان الخطأ

  • تتم إدارة مشتريات داخل التطبيق لنظام iOS في الإعدادات > معرف Apple > الاشتراكات - وليس على caiioo.ai/account
  • تتم إدارة اشتراكات Stripe عبر رابط البوابة في الإعدادات > الحساب > ملف تعريف المستخدم أو على caiioo.ai/account
  • يوجهك Caiioo تلقائياً بناءً على المكان الذي اشتركت فيه - وهذا أمر متوقع

تمت الترقية ولكنك ما زلت على الفئة القديمة

  • تستغرق ترقيات Stripe دقيقة واحدة حتى تنتشر - أعد تحميل التطبيق
  • قد تستغرق عملية شراء داخل تطبيق Apple ما يصل إلى 24 ساعة للتحقق. انقر على "استعادة المشتريات" في الإعدادات > الحساب > ملف تعريف المستخدم لتسريع ذلك
  • إذا كان لديك اشتراك بالفعل على منصة أخرى، فسيعلمك زر "اشتراك" بإدارته هناك بدلاً من ذلك

مشكلات أخرى

شاشة فارغة في تطبيق سطح المكتب أو الهاتف المحمول

  • أعد تشغيل التطبيق بالكامل
  • تحقق من اتصالك بالإنترنت
  • جرب مسح ذاكرة التخزين المؤقت للتطبيق (تختلف حسب النظام الأساسي)
  • التحديث إلى أحدث إصدار

الأدوات لا تعمل

  1. انتقل إلى الإعدادات > الأدوات وعمليات الربط > تكوين الأدوات وتحقق من تمكين الأداة
  2. تتطلب بعض الأدوات أذونات أو إعدادًا (مثل حساب Google متصل لأدوات Google)
  3. إذا رأيت خطأ "يحتاج إلى إذن"، فأعد ربط الموفر في الإعدادات > الموصلات وأعد الموافقة على النطاقات

تعذر اتصال الامتداد بتطبيق سطح المكتب

  • أولاً، تحقق من تشغيل تمكين Caiioo Bridge (الإعدادات > الاتصال > الأجهزة والترحيل) — فهو معطل افتراضيًا، وطالما أنه معطل، فلن يتصل الامتداد بتطبيق سطح المكتب أبدًا وستكون عناصر التحكم في إعادة الاتصال/المنفذ رمادية
  • إذا كنت تستخدم كلاً من امتداد المتصفح وتطبيق سطح المكتب، يتصل الامتداد بتطبيق سطح المكتب عبر WebSocket محلي (جسر إمكانات، وليس مزامنة)
  • أعد تشغيل تطبيق سطح المكتب ثم أعد تحميل الامتداد
  • تأكد من عدم تشغيل أي نسخة أخرى من تطبيق سطح المكتب — فالنسخ المتعددة تتعارض مع بعضها

تحذير "المتصفح غير متصل" على macOS رغم فتح المتصفح

  • يتعرف Caiioo الآن على Chrome وSafari وEdge وFirefox — يختفي التحذير في اللحظة التي يتصل فيها أي منها
  • يتصل Safari عبر قناة مختلفة ويمكن أن يدخل في حالة خمول مؤقتة عندما لا يكون هو التطبيق في المقدمة؛ يظل متصلاً، ويقوم Caiioo بتنشيطه تلقائيًا عندما يحتاج أمر ما إليه
  • إذا استمر التحذير، فاجلب متصفحك إلى المقدمة مرة واحدة، ثم أعد المحاولة

مرفقات الرسائل لا يتم تحميلها

  • تحقق من دعم تنسيق الملف (PDF، والصور، ومستندات Word، وجداول البيانات، والعروض التقديمية)
  • جرب ملفًا أصغر حجمًا
  • تأكد من وجود اتصال بالإنترنت

الحصول على المساعدة

  • إجابات سريعة: انقر على أيقونة ؟ في الرأس
  • الإعدادات واستكشاف الأخطاء وإصلاحها: انقر على أيقونة الترس
  • هذا الدليل: الإعدادات > المساعدة > التوثيق والشؤون القانونية
  • دع Caiioo يقدم تقريراً بالخطأ نيابة عنك: اطلب منه الإبلاغ عن مشكلة وسوف يفتح نموذج الدعم المضمن مملوءاً مسبقاً بوصف تفصيلي لك لمراجعته وإرساله. قل "قم بتقديم التقرير فقط" - وبموافقتك - يقدم التذكرة مباشرة، مع إرفاق التفاصيل التقنية للمحادثة حتى يتمكن الفريق من إعادة إنتاج ما رأيته.

انظر أيضاً


This guide is maintained by the Caiioo team using Slate, our built-in editor.