> ## 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 على حاسوبك، وماذا يحدث في أول تشغيل، وكيف تعمل التحديثات. وإن حدث خطأ فراجع [حل المشكلات](/ar/products/desktop-guide/troubleshooting).

## اختر طريقة التثبيت

<Tabs>
  <Tab title="مثبّت جاهز" icon="download">
    نزّل المثبّت المناسب لنظامك من صفحة مبيان Desktop.

    | النظام | الصيغ |
    | - | - |
    | macOS 12 أو أحدث | DMG وzip شاملان (Apple silicon وIntel) |
    | Windows | مثبّت NSIS وMSI |
    | Linux | AppImage و`.deb` و`.rpm` |

    يجهّز المثبّت ما يحتاجه التطبيق، ومنه Python 3.11 أو أحدث وGit محمول وripgrep. على Windows يُفك Git المحمول داخل ملفك الشخصي ولا يمس أي Git مثبّت عندك.

    <Note>
      الإصدار العام لماك يُفتح عبر قائمة الوصول المبكر. انضم إليها من صفحة مبيان Desktop وسنخبرك حين يجهز أول إصدار عام.
    </Note>
  </Tab>

  <Tab title="من سطر أوامر مبيان" icon="terminal">
    إن كان عندك سطر أوامر مبيان فشغّل:

    ```bash theme={null}
    mibyan desktop
    ```

    يبني هذا التطبيق ويشغّله فوق تثبيتك الحالي بنفس الإعدادات والمفاتيح والجلسات والمهارات. لا يُنسخ شيء ولا يُنقل.
  </Tab>

  <Tab title="اتصال ببوابة تديرها" icon="network-wired">
    تستطيع تخطي التثبيت المحلي كليًا وتوجيه التطبيق إلى بوابة مبيان تعمل عندك. انظر [الاتصال بمبيان موجود](#الاتصال-بمبيان-موجود) أدناه و[الاتصالات والملفات الشخصية](/ar/products/desktop-guide/connections-and-profiles).
  </Tab>
</Tabs>

## أول تشغيل

```mermaid theme={null}
flowchart TD
  A["التشغيل"] --> B["تسجيل الدخول بحساب مبيان"]
  B --> C{"بيئة تشغيل صالحة أو اتصال بعيد محفوظ؟"}
  C -- "نعم" --> H["بدء مبيان"]
  C -- "لا" --> D["إعداد مبيان Desktop"]
  D --> E["الاتصال بمبيان موجود"]
  D --> F["تثبيت مبيان محليًا"]
  E --> G["اختبار الاتصال ثم التطبيق وإعادة الاتصال"]
  F --> I["تثبيت لمرة واحدة مرحلة بعد مرحلة"]
  G --> H
  I --> H
  H --> J["اختيار طريقة التشغيل والنموذج الافتراضي"]
```

تعرض شاشة الإقلاع خطوات بلغة بسيطة أثناء العمل: بدء مبيان Desktop، وبدء اتصال سطح المكتب، والاتصال ببوابة سطح المكتب المباشرة، وتحميل الإعدادات، وتحميل المحادثات الأخيرة. وإن كانت الخلفية بعيدة وبطيئة الرد فتخبرك أنها تعيد الاتصال بالخلفية البعيدة.

### التثبيت المحلي لمرة واحدة

اختيار **تثبيت مبيان محليًا** ينزّل مبيان وينشئ بيئة Python الخاصة به ويشغّل الخلفية على هذا الحاسوب. خطوة تحدث مرة واحدة، وتتخطاها التشغيلات اللاحقة.

تظهر كل مرحلة بإحدى خمس حالات: **قيد الانتظار** أو **جارٍ التثبيت** أو **تم** أو **تم التخطي** أو **فشل**. وتعرض الشاشة عدد الخطوات المكتملة والمرحلة الجارية حاليًا، وتتيح لك فتح مخرجات المثبّت.

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

يُحفظ السجل الكامل في ملف على القرص ويظهر موقعه لتُرفقه ببلاغك.

<Warning>
  على Windows قد يفشل التثبيت إن كان سطر أوامر مبيان أو نسخة Desktop أخرى تعمل. أوقف أي عمليات مبيان جارية ثم أعد المحاولة.
</Warning>

إن لم يتوفر التثبيت الآلي عند أول تشغيل على نظامك بعد، يعرض التطبيق أمر التثبيت بالضبط لتشغّله في الطرفية، ومكان التثبيت، وزر **إعادة المحاولة** بعد تشغيله. انسخ الأمر بـ**نسخ الأمر** أو افتح **عرض وثائق التثبيت**.

### الاتصال بمبيان موجود

استخدمه حين تكون بوابة تعمل في مكان آخر (خادم أو مختبر منزلي أو جهاز عمل).

<Steps>
  <Step title="أدخل رابط البوابة">
    استخدم الرابط الأساسي شاملًا `https://` إن كانت بعيدة. وبادئة المسار مثل `/mibyan` مدعومة.
  </Step>

  <Step title="دع التطبيق يكتشف المصادقة">
    يفحص Desktop هل تحتاج البوابة **رمز جلسة** أم **تسجيل دخول عبر المتصفح**. البوابات المستضافة تستخدم OAuth أو اسم مستخدم وكلمة مرور، والمستضافة ذاتيًا قد تستخدم رمز جلسة من ملف `.env` للبوابة.
  </Step>

  <Step title="سجّل الدخول">
    سجّل الدخول عبر مزوّد الهوية في نافذة المتصفح، أو الصق رمز الجلسة.
  </Step>

  <Step title="اختبر ثم طبّق">
    **اختبار الاتصال** يجرّب المسار نفسه الذي سيستخدمه التطبيق. فإن نجح فاختر **تطبيق وإعادة الاتصال**.
  </Step>
</Steps>

<Info>
  بيانات الدخول ذات الاستخدام الواحد لا تُعاد. يطلب كل اتصال بيانات جديدة، ولا يبدأ تسجيل دخول جديد إلا عند رفض مؤكد من البوابة. انتهاء المهلة أو مشكلة الشبكة تُعامل كمشكلة اتصال لا كمشكلة دخول.
</Info>

### اختر طريقة تشغيل مبيان

بعد جاهزية الخلفية يسألك الإعداد كيف يصل الوكيل إلى النموذج:

| الخيار | معناه |
| - | - |
| **حساب مبيان** | يعمل عبر بوابة مبيان على حسابك، وتُحتسب الاستدعاءات والاستخدام على ذلك الحساب. موصى به |
| **مزوّدك الخاص** | حساب أو مفتاح API من مزوّد مثل OpenRouter أو OpenAI أو Gemini أو xAI أو Fireworks. تذهب الاستدعاءات مباشرة إلى المزوّد ويحاسبك هو |
| **نموذج محلي** | وجّه مبيان إلى خادم على جهازك مثل Ollama أو LM Studio أو vLLM أو llama.cpp. اختر الخادم واكتشف نماذجه ثم اختر واحدًا |
| **اختر لاحقًا** | تخطَّ واضبط المزوّد لاحقًا من الإعدادات |

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

ينتهي الإعداد بـ**النموذج الافتراضي** و**ابدأ**. ويمكنك تغيير النموذج في أي وقت.

## إبقاء مبيان محدَّثًا

لمبيان Desktop جزءان يتحدّثان بجدولين منفصلين: **تطبيق سطح المكتب** و**الخلفية** (الوكيل). يظهر الإصداران في شريط الحالة (`Mibyan Desktop v...` و`Backend v...`) وفي **الإعدادات، حول**.

### الفحص التلقائي

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

### شكل التحديث

```mermaid theme={null}
flowchart LR
  A["التجهيز"] --> B["التنزيل"]
  B --> C["أوشكنا"]
  C --> D["الإنهاء"]
  D --> E["تحديث مبيان"]
  E --> F["إعادة بناء تطبيق سطح المكتب"]
  F --> G["إعادة تشغيل مبيان"]
  G --> H["اكتمل التحديث"]
```

حين تختار **حدّث الآن** يتولى محدّث مبيان الأمر في نافذته الخاصة ويعيد فتح مبيان تلقائيًا عند الانتهاء. لا تعد فتح مبيان بنفسك أثناء التحديث. وإن لم يكتمل التحديث فلا يضيع شيء ويمكنك المحاولة مجددًا.

### حين لا يستطيع التحديث العمل تلقائيًا

<AccordionGroup>
  <Accordion title="ثبّتّه من سطر الأوامر" icon="terminal">
    تعمل التحديثات في الطرفية أيضًا. يعرض التطبيق الأمر لتلصقه، ويلتقط مبيان الإصدار الجديد عند التشغيل التالي. ويمكنك تشغيل `mibyan update` بنفسك.
  </Accordion>

  <Accordion title="تحدّثت الخلفية ولم تتحدث حزمة التطبيق" icon="code-compare">
    تظهر باسم **حدّث تطبيق سطح المكتب**. على Linux حدّث AppImage أو `.deb` أو `.rpm` أو أعد تثبيته ليتطابق. وتظهر الحالة نفسها باسم **إصدار التطبيق قديم** في **حول** حين تكون بيئة التشغيل أحدث من التطبيق، لأن ميزات الواجهة الجديدة تغيب حتى يتحدث التطبيق. وإن لم يزل التحديث التحذير فأعد التثبيت من أحدث مثبّت.
  </Accordion>

  <Accordion title="الخلفية أقدم من التطبيق" icon="triangle-exclamation">
    ترى **الخلفية قديمة**: الخلفية أقدم من إصدار سطح المكتب هذا وقد لا تعمل جيدًا. اختر **تحديث مبيان** لتوحيد الإصدارين.
  </Accordion>

  <Accordion title="خلفية بعيدة" icon="server">
    تطبّق الخلفية البعيدة التحديث وتعيد التشغيل، ويعيد التطبيق الاتصال تلقائيًا حين تعود. فإن لم تعد الخلفية فقد لا يكون التحديث اكتمل، فافحص مضيف الخلفية.
  </Accordion>

  <Accordion title="معاينات محلية تحجز منافذ" icon="plug-circle-xmark">
    يحتاج مبيان إلى إيقاف خوادم المعاينة المحلية قبل التحديث. **أغلق المعاينات وحدّث** توقفها دون المساس بملفاتك. أما العمليات التي لا يستطيع مبيان إغلاقها بأمان (تطبيق آخر أو طرفية أو خدمة) فعليك إغلاقها بنفسك قبل المحاولة مجددًا.
  </Accordion>
</AccordionGroup>

### تحديث كل البوابات دفعة واحدة

في **الإعدادات، البوابات** اختر **تحديث كل النسخ** لإرسال تحديث لكل بوابة مسجّلة. النسخ التي يديرها Mibyan Cloud تُتخطى لأن مبيان يحدّثها. ويبلّغ كل صف: تم إرسال التحديث أو تم التخطي أو فشل التحديث.

## فحوص الصحة والنسخ الاحتياطي

افتح مركز القيادة (`Cmd` أو `Ctrl` مع `.`) ثم **الصيانة**:

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

من الطرفية يؤدي `mibyan doctor` و`mibyan debug share` الدور نفسه. ويطبع `mibyan debug share --local` التقرير دون رفعه.

## السجلات وتقارير الأعطال

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

<Card title="التالي: المحادثة والمشاريع" icon="folder-tree" horizontal href="/ar/products/desktop-guide/chat-and-projects">
  تعرّف على مربع الكتابة والمشاريع والموافقات وأوامر الشرطة المائلة.
</Card>