> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mibyanai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# حل مشكلات مبيان Desktop

> حلول لمشكلات البدء والاتصال والرصيد والصوت والإشعارات والمعاينة والتحديثات، وكيف ترسل التشخيصات بأمان

ابدأ من الرسالة التي تراها. يذكر مبيان Desktop الطبقة التي فشلت، فالحل عادة نقرة واحدة.

<Info>
  لا شيء في شاشات الاسترداد يحذف محادثاتك أو إعداداتك. وإن لم تكن متأكدًا فابدأ بـ**فتح السجلات**. يكشف سجل سطح المكتب في مدير الملفات.
</Info>

## ابحث عن مشكلتك

```mermaid theme={null}
flowchart TD
  A["هناك مشكلة"] --> B{"أين؟"}
  B -- "التطبيق لا يبدأ" --> S["البدء"]
  B -- "لا أصل إلى الوكيل" --> C["الاتصال"]
  B -- "فشلت دورة" --> T["أخطاء الدورات"]
  B -- "الصوت" --> V["الصوت"]
  B -- "معاينة أو طرفية" --> P["المعاينة"]
  B -- "تحديث" --> U["التحديثات"]
```

## البدء

### «لم يستطع مبيان البدء»

لم تعمل بوابة الخلفية. جرّب بالترتيب:

| الزر | ماذا يفعل |
| - | - |
| **إعادة المحاولة** | يبدأ الخلفية مجددًا |
| **إصلاح التثبيت** | يعيد تشغيل المثبّت. قد يستغرق بضع دقائق على جهاز جديد |
| **استخدام البوابة المحلية** | ينتقل من بوابة بعيدة إلى المحلية المدمجة |
| **إعدادات البوابة** | تحقق من الرابط والدخول |
| **فتح السجلات** و**إظهار السجلات الأخيرة** | اطلع على سبب الفشل |
| **رجوع** | العودة إلى الشاشة السابقة |

<AccordionGroup>
  <Accordion title="تسجيل دخول البوابة البعيدة مطلوب" icon="right-to-bracket">
    انتهت جلسة بوابتك البعيدة. **تسجيل الخروج ثم الدخول** يمسح جلسة المتصفح المحفوظة ويفتح نافذة الدخول. و**استخدام البوابة المحلية** ينتقل إلى الخلفية المدمجة. وإن أُغلقت نافذة الدخول قبل أن تنتهي ترى **تسجيل الدخول غير مكتمل**. أعد المحاولة.
  </Accordion>

  <Accordion title="وكيل Mibyan Cloud متوقف" icon="cloud">
    الوكيل المستضاف الذي تتصل به بوابتك يعيد خطأ خادم، ولا يمكن إعادة تشغيله من التطبيق. استخدم **فحص حالة البوابة** لترى حالته وأدوات التحكم، أو **استخدام البوابة المحلية** لتواصل العمل، أو روابط الدعم.
  </Accordion>

  <Accordion title="فشل المثبّت على Windows" icon="windows">
    قد يكون سطر أوامر مبيان أو نسخة Desktop أخرى تعمل. أوقفهما وأعد المحاولة. وإن عزل مكافح الفيروسات لديك ملف `uv.exe` من مجلد `bin` لمبيان فهذا **إنذار خاطئ**: هو مدير الحزم الذي يستخدمه مبيان لبيئة Python. أضف **المجلد** (لا الملف) إلى استثناءات مكافح الفيروسات، لأن الملف يتغير مع كل إصدار.
  </Accordion>

  <Accordion title="النافذة تومض على شاشة بعيدة" icon="display">
    حين يكتشف مبيان شاشة بعيدة ينتقل إلى التصيير البرمجي لمنع الوميض، ويخبرك بلافتة.
  </Accordion>
</AccordionGroup>

## الاتصال

| ترى | ما يعنيه | افعل هذا |
| - | - | - |
| **فُقد الاتصال بالبوابة** | انقطع الرابط. يواصل التطبيق المحاولة في الخلفية، وتستطيع القراءة والكتابة كمسودة | انتظر، أو افتح **إعدادات البوابة** إن استمر. استخدم **إعادة الاتصال بالبوابة** من قائمة شريط الحالة |
| **تسجيل دخول البوابة مطلوب** | لم يعد الدخول المحفوظ صالحًا | سجّل الدخول مجددًا في **الإعدادات، البوابات** |
| **فشلت مصادقة البوابة** | المفتاح الذي تتوقعه البوابة لا يطابق | تحقق من مفتاح خادم API للبوابة |
| **405 Method Not Allowed** | رفضت خلفية Desktop طلبًا | أعد تشغيل مبيان Desktop |
| **تعذّر تحميل هذه الجلسة** | فشل الاتصال بالجلسة وتخلت المحاولات التلقائية | تأكد أن البوابة تعمل ثم **أعد المحاولة** |
| منصة مراسلة تظهر **تحتاج إعادة تشغيل** | تغيير يحتاج إعادة تشغيل البوابة | أعد تشغيل البوابة من شريط الحالة |
| **بوابة المراسلة متوقفة** | بوابة المراسلة لا تعمل | شغّلها من شريط الحالة، أو نفّذ `mibyan gateway` |
| انتهاء مهلة التحويل | لم ترد بوابة المراسلة | تأكد أن `mibyan gateway` يعمل |

قد ينجح اختبار الاتصال بينما يفشل الاتصال الحي. اختبار التطبيق يجرّب مسار الدخول وWebSocket نفسه الذي يستخدمه فعلًا، فإن نجح فالإعداد سليم.

## أخطاء الدورات

تسمّي الدورة الفاشلة طبقتها، فتعرف أين تنظر:

| الطبقة | السبب الشائع | الإجراء |
| - | - | - |
| **خطأ مصادقة** | رُفض مفتاح أو تسجيل دخول | أعد إدخال المفتاح، أو **أعد ربط حساب مبيان** |
| **نفاد الرصيد** | حسابك بلا رصيد | **فتح الفوترة** أو **إضافة رصيد**، أو استخدم مزوّدك الخاص |
| **امتلاء القرص** | لا مساحة للكتابة | أفرغ مساحة ثم حاول مجددًا |
| **خطأ نقطة نهاية مخصصة** | فشل خادمك المتوافق مع OpenAI | افحص الخادم ورابطه |
| **خطأ في البوابة** | واجهت الخلفية مشكلة | **فتح السجلات** |
| **خطأ مزوّد** | رفض مزوّد النموذج الاستدعاء | **تبديل المزوّد** |
| **خطأ في بيئة التشغيل المحلية** | مشكلة في الخلفية المحلية | **إعادة المحاولة** ثم **إصلاح التثبيت** |
| **خطأ اتصال البث** | انقطع البث أثناء الإجابة | **إعادة المحاولة** |

كل خطأ يقدم **نسخ تفاصيل الخطأ** و**إرسال التشخيصات**.

## مشكلات الصوت

| ترى | الحل |
| - | - |
| أعدّ تحويل الكلام إلى نص لاستخدام وضع الصوت | فعّل **تحويل الكلام إلى نص** واختر مزوّدًا في **الإعدادات، الصوت** |
| تم رفض إذن الميكروفون | اسمح لمبيان بالميكروفون من إعدادات خصوصية نظامك |
| الميكروفون مستخدم من تطبيق آخر | أغلق التطبيق الآخر |
| لم يُعثر على ميكروفون | صل واحدًا، أو اختر مدخلًا آخر من إعدادات نظامك |
| لم يُكتشف كلام | تحدّث أقرب من الميكروفون وحاول التسجيل مجددًا |
| مزوّد رفض المفتاح أو المفتاح مفقود | أضف المفتاح الذي يحتاجه في **الإعدادات، الأدوات والمفاتيح**. مثلًا تحويل الكلام إلى نص عبر ElevenLabs يحتاج `ELEVENLABS_API_KEY`، وتحويل النص إلى كلام عبر OpenAI يحتاج `VOICE_TOOLS_OPENAI_KEY` أو `OPENAI_API_KEY` |
| تحويل الكلام إلى نص غير متاح بعد | خدمة التفريغ غير جاهزة. افحص إعدادات المزوّد |

## الإشعارات لا تظهر

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

## الأدوات وMCP

* **خادم MCP يحتاج مصادقة جديدة:** افتحه في **القدرات، MCP** واختر **مصادقة**.
* **خادم MCP غير متاح:** فشل فحص الصحة. استخدم **اختبار الاتصال** ثم **إعادة تحميل MCP**.
* استدعاء أداة فشل بخطأ اتصال: استخدم شارة **إعادة الربط** التي تظهر في مربع الكتابة.
* أداة مفقودة: تسري التغييرات على **الجلسات الجديدة**، فابدأ محادثة جديدة.

## المعاينة والطرفيات

| المشكلة | الحل |
| - | - |
| «الخادم غير موجود» أو لا تتحمل المعاينة | **اطلب من مبيان إعادة تشغيل الخادم** وراقب وحدة تحكم المعاينة |
| العنوان يشير إلى جهاز الوكيل | على خلفية بعيدة لا يمكن الوصول إلى عنوان `localhost` من حاسوبك. استخدم إعادة توجيه منفذ أو اسم مضيف يمكن الوصول إليه |
| سكربتات وحدات تُقدّم بنوع خاطئ | خادم ملفات ثابت يقدم تطبيق Vite أو React بدل خادم تطوير المشروع. اطلب من مبيان تشغيل خادم التطوير |
| ملف ضخم أو ثنائي | تُعرض أول 512 كيلوبايت فقط. اختر **معاينة على أي حال**، أو أرفقه كسياق |
| أيقونات الطرفية متشوهة | اختر خط Nerd من **الإعدادات، المظهر، خط الطرفية** |

## التحديثات

| ترى | الحل |
| - | - |
| **توقف التحديث** أو **لم يكتمل التحديث** | لم يضع شيء. حاول مجددًا |
| **أغلق المعاينات المحلية للتحديث** | اختر **أغلق المعاينات وحدّث**. لا تُمس ملفاتك |
| **أغلق عمليات أخرى للتحديث** | أغلق التطبيق أو الطرفية أو الخدمة التي تملك كل عملية مدرجة |
| **الخلفية قديمة** | اختر **تحديث مبيان** |
| **إصدار التطبيق قديم** أو **حدّث تطبيق سطح المكتب** | حدّث أو أعد تثبيت التطبيق من أحدث مثبّت |
| لم تعد الخلفية بعد التحديث | افحص مضيف الخلفية |

انظر [التثبيت والتحديث](/ar/products/desktop-guide/install-and-update).

## إرسال التشخيصات إلى مبيان

حين تحتاج مساعدة يرفع **إرسال التشخيصات** حزمة تصحيح بشكل خاص ليرى الدعم سجلاتك. وتعرض النافذة ما تحتويه **قبل** الرفع.

* **ما تحتويه:** معلومات النظام (النظام والإصدارات والمزوّد وأي مفاتيح API مضبوطة، لا المفاتيح نفسها) وسجلات الوكيل والبوابة وسطح المكتب، حتى 512 كيلوبايت لكل منها.
* **قد تحوي:** محتوى محادثات ومخرجات أدوات ومسارات ملفات، لأن السجلات قد تشملها. تُنقَّح الأسرار قبل الرفع.
* **من يراها:** موظفو مبيان ومشرفو الدعم المعتمدون فقط. ليست صفحة لصق عامة، وتُحذف تلقائيًا بعد **14 يومًا**.

يمكنك أيضًا تشغيل `mibyan debug share` من الطرفية، أو `mibyan debug share --local` لطباعة التقرير **دون رفع**. أما إجراء **مشاركة التصحيح** في مركز القيادة فيرفع تقريرًا منقّحًا تُحذف روابطه تلقائيًا بعد **6 ساعات**.

بعد الرفع انسخ الرابط إلى محادثة الدعم. تربطك النافذة بـ**دعم مبيان** و**Discord** و**GitHub Issues** لتكمل الحوار. وإن لم يُعد رابط عرض فذكّر الدعم بمعرّف الرفع.

<Warning>
  اقرأ إشعار الخصوصية في النافذة قبل الرفع. إن كانت سجلاتك قد تحوي محتوى خاصًا فاستخدم `mibyan debug share --local` وراجع التقرير أولًا.
</Warning>