> ## 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: التثبيت ووضعا المحادثة وDev واللوحات والاتصالات والأتمتة والإعدادات والاختصارات وحل المشكلات

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

هو الوكيل نفسه بمهاراته وذاكرته الموجودة في سطر أوامر مبيان وبوابة المراسلة، لكن في نافذة بدل الطرفية.

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

## وضعان

```mermaid theme={null}
flowchart LR
  U["أنت"] --> M{"الوضع"}
  M -- "محادثة" --> C["فكّر بصوت عالٍ<br/>أسئلة ومسودات وبحث"]
  M -- "تطوير" --> D["أنجز العمل<br/>ملفات ومعاينات وأدوات وطرفية"]
  D --> P["لوحة معاينة بجوار المحادثة"]
  D --> A{"خطوة حسّاسة؟"}
  A -- "نعم" --> Y["يتوقف لاستئذانك"]
  A -- "لا" --> D
```

* **المحادثة** لتفكّر بصوت عالٍ وتحصل على جواب.
* **التطوير** للمهام التي تتطلب ملفات ومعاينات وأدوات.

## ماذا يستطيع

<CardGroup cols={2}>
  <Card title="محادثة مع الوكيل الكامل" icon="comments">
    إجابات متدفقة ونشاط أدوات مباشر ونفس سجل المحادثات في كل أسطح مبيان.
  </Card>

  <Card title="الملفات والمستندات" icon="folder-open">
    افتح مجلدًا فيقرأ مبيان وينظّم ويكتب داخله. ويتيح مستعرض الملفات تصفّح مجلد العمل دون مغادرة التطبيق.
  </Card>

  <Card title="معاينات جنبًا إلى جنب" icon="table-columns">
    تُعرض صفحات الويب والملفات ومخرجات الأدوات في لوحة يمنى بينما تواصل المحادثة.
  </Card>

  <Card title="الكود والطرفية" icon="terminal">
    يفحص المستودع ويشغّله ويرفع لك التقرير.
  </Card>

  <Card title="أدوات MCP" icon="plug">
    يتّصل بالخدمات التي يعتمد عليها فريقك عبر MCP.
  </Card>

  <Card title="بحث الويب" icon="globe">
    يبحث ويقارن ويُنجز مهام الويب.
  </Card>

  <Card title="الصوت" icon="microphone">
    تحدّث إلى مبيان واسمع رده.
  </Card>

  <Card title="عربي وإنجليزي" icon="language">
    اطلب واعمل واكتب بأيٍّ منهما أو بكليهما، من اليمين إلى اليسار من أول حرف.
  </Card>
</CardGroup>

## الموافقات تبقيك مسيطرًا

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

<Tip>
  ابدأ من مجلد يحوي فقط ما تحتاجه المهمة. يعمل الوكيل على الملفات الموجودة في المجلد الذي تفتحه.
</Tip>

## التثبيت

<Tabs>
  <Tab title="من سطر أوامر مبيان" icon="terminal">
    إن كان عندك سطر أوامر مبيان:

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

    يبني التطبيق ويشغّله فوق تثبيتك الحالي بنفس الإعدادات والمفاتيح والجلسات والمهارات. وإن لم يجد التطبيق بيئة تشغيل صالحة أو اتصالًا بعيدًا محفوظًا، فتتيح لك أول مرة تشغيل الاتصال ببوابة مبيان قائمة أو تثبيت مبيان محليًا، ثم ترافقك خطوات اختيار المزوّد والنموذج.
  </Tab>

  <Tab title="مُثبّت جاهز" icon="download">
    نزّل المُثبّت لنظامك من صفحة مبيان Desktop. يجهز المُثبّت ما يحتاجه التطبيق، ومنه Python وGit محمول وripgrep.
  </Tab>
</Tabs>

## ابقَ محدَّثًا

يفحص التطبيق التحديثات في الخلفية ويعرض تحديثًا بنقرة واحدة عند جاهزيته. وتستطيع التحديث من سطر الأوامر في أي وقت:

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

وإن بدا شيء غير سليم فشغّل التشخيص المدمج:

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

## سطر الأوامر والمراسلة

الوكيل نفسه متاح خارج نافذة سطح المكتب. أوامر مفيدة:

| الأمر | ماذا يفعل |
| - | - |
| `mibyan` | بدء محادثة تفاعلية في الطرفية |
| `mibyan model` | اختيار مزوّد النموذج والنموذج |
| `mibyan tools` | اختيار الأدوات المفعّلة |
| `mibyan gateway` | تشغيل بوابة المراسلة لتحدّث الوكيل من تطبيقات المحادثة |
| `mibyan setup` | تشغيل معالج الإعداد الكامل |
| `mibyan update` | التحديث لآخر إصدار |
| `mibyan doctor` | تشخيص المشكلات |

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

<Card title="التالي: كيف يتعاون الوكلاء" icon="users" horizontal href="/agents/overview">
  تعرّف على المنسّق والوكلاء المتخصصين وراء طلباتك.
</Card>
