> ## 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.

# المحادثة والمشاريع

> الجلسات والمشاريع وأشجار العمل ومربع الكتابة والمرفقات والصوت والنماذج والموافقات ونقاط الاستعادة وكل ما يحدث داخل المحادثة

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

## الجلسات

كل محادثة هي **جلسة**. يسردها الشريط الأيسر، ويُشارَك السجل نفسه مع كل واجهات مبيان الأخرى.

### البحث والتنظيم

| لتفعل هذا | افعل هذا |
| - | - |
| بدء محادثة | **محادثة جديدة**، أو `Cmd`/`Ctrl` مع `N`. و`T` تفتح تبويبًا جديدًا، و`Shift` مع `N` نافذة جديدة |
| البحث في المحادثات | مربع البحث، أو `Cmd`/`Ctrl` مع `Shift` و`F`. وبحث شريط العنوان يجد أيضًا العروض والإجراءات |
| تثبيت محادثة | **تثبيت**، أو `Shift` مع النقر على المحادثة. تبقى المثبتة في الأعلى ولا تُؤرشف تلقائيًا أبدًا |
| التنقل السريع | `Ctrl` مع `1` إلى `9` ينتقل إلى جلسة حديثة، و`Ctrl` مع `Tab` يتنقل بينها |
| التجميع حسب المشروع | بدّل **التجميع حسب مساحة العمل** لترى المحادثات تحت مشروعها أو في قائمة واحدة |
| مقروء أو غير مقروء | من قائمة الصف، أو **تعليم الكل كمقروء** |

تُقسَّم المحادثات حسب التاريخ (في وقت سابق اليوم، أمس، في وقت سابق هذا الأسبوع، الأسبوع الماضي، في وقت سابق هذا الشهر) وحسب الحالة (**قيد العمل** و**منتهية**). ويخبرك الصف بما يحدث دون فتحه:

| حالة الصف | المعنى |
| - | - |
| الجلسة تعمل | الوكيل يعمل الآن |
| تحتاج إدخالك | تنتظر إجابة أو موافقة |
| انتهت ولم تُقرأ | انتهت دورة أثناء وجودك في مكان آخر |
| مهمة خلفية تعمل | أمر في الخلفية ما زال جاريًا |
| مسودة | لم يُرسل شيء بعد |
| مُحوَّلة من منصة | بدأت المحادثة على Telegram أو Slack أو قناة أخرى |
| ملف شخصي | أي [ملف شخصي](/ar/products/desktop-guide/connections-and-profiles#الملفات-الشخصية) يملكها |

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

### الأرشفة والحذف والتنظيف

* **الأرشفة** تخفي المحادثة من الشريط وتحتفظ بكل رسائلها. انقر على المحادثة مع `Ctrl` أو `Cmd` لأرشفتها. واستعدها من **الإعدادات، المحادثات المؤرشفة**.
* **الأرشفة التلقائية للمحادثات الراكدة** تؤرشف المحادثات التي لم تلمسها منذ عدد أيام تختاره. المثبتة لا تُؤرشف أبدًا ولا يُحذف شيء.
* **الحذف** يزيل المحادثة نهائيًا ولا يمكن التراجع عنه، ويسألك دائمًا قبل ذلك.

## وضع المحادثة ووضع Dev

<CardGroup cols={2}>
  <Card title="المحادثة (Chat)" icon="comments">
    للتفكير والأسئلة والمسودات والبحث. لا تحتاج مشروعًا.
  </Card>

  <Card title="التطوير (Dev)" icon="code">
    للعمل على الملفات. اختر مشروعًا فيقرأ الوكيل ويعدّل ويشغّل ويعاين داخله.
  </Card>
</CardGroup>

تعرض شاشة بدء Dev **المشاريع الأخيرة** و**فتح مشروع** و**مشروع جديد** و**الطرفية**.

## المشاريع

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

<Steps>
  <Step title="أنشئ أو افتح">
    اختر **مشروع جديد** لتسمية مساحة عمل وإضافة مجلدات، أو **فتح مجلد كمشروع** (`Cmd`/`Ctrl` مع `O`) لاستخدام مجلد موجود.
  </Step>

  <Step title="أضف المجلدات">
    يمكن أن يضم المشروع عدة مجلدات. يُعلَّم أحدها **أساسيًا** وتبدأ المحادثات الجديدة فيه.
  </Step>

  <Step title="صِف الفكرة (اختياري)">
    يُحفظ حقل **الفكرة** في ملف `IDEA.md` داخل المشروع. **توليد فكرة** يصوغ لك واحدة، و**خلط القوالب** يقترح نقاط انطلاق.
  </Step>

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

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

### أشجار العمل والفروع

تتيح أشجار العمل (worktrees) للوكيل العمل على فرع دون إزعاج نسختك الحالية.

| الإجراء | ماذا يفعل |
| - | - |
| **شجرة عمل جديدة** (`Cmd`/`Ctrl` مع `Shift` و`B`) | سمِّ فرعًا واختر الفرع الأساسي الذي يتفرع منه |
| **تحويل فرع** | افتح فروعًا مسحوبة أصلًا، أو أنشئ شجرة عمل لفرع حر، أو تتبّع فرعًا بعيدًا |
| **إزالة شجرة العمل** | تزيل مجلد الشجرة من git (ويبقى الفرع)، أو تخفي المسار من الشريط فقط وتتركها على القرص |
| **إزالة قسرية** | لازمة حين تحوي الشجرة تغييرات غير مُودَعة. وهي تتخلص منها |

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

### أدوات قاعدة البيانات في مشاريع Dev

تتضمن مشاريع Dev عرض **قاعدة البيانات**:

* **قاعدة محلية (SQLite).** أنشئ قاعدة للمشروع أو أضف ملف `.db` موجودًا. تصفّح المخطط ونفّذ استعلامات (للقراءة فقط وبحد 200 صف) واكتب **ترحيلات**: تراجع الأثر أولًا، ويأخذ مبيان نسخة احتياطية تلقائية، وتحصل التغييرات المدمّرة على تأكيد إضافي.
* **مشروع Supabase الخاص بك.** أدخل رابط المشروع والمفتاح العام (publishable). يُحفظ المفتاح في تخزين آمن على الجهاز. المتصفح للقراءة فقط ويعرض حتى 100 صف تسمح بها سياسات Supabase عندك، ولا يحتاج أبدًا مفتاح `service_role`.

تبديل مصدر البيانات لا ينقل بياناتك ولا يحذفها.

## مربع الكتابة

مربع الكتابة هو الصندوق في الأسفل. اكتب طلبك وأرسله. `Enter` يرسل و`Shift` مع `Enter` يضيف سطرًا.

### أعطه سياقًا

| الطريقة | ماذا يحدث |
| - | - |
| **ملفات ومجلد وصور** | أرفق من قائمة الإرفاق أو بسحب الملفات إليه |
| **لصق صورة** | الصق من الحافظة |
| **رابط (URL)** | يجلب مبيان الصفحة ويضمّها سياقًا لتلك الدورة |
| **إشارة `@`** | أشِر إلى ملفات ومجلدات وروابط وgit أثناء الكتابة |
| **إسقاط محادثة** | أسقط محادثة أخرى على مربع الكتابة لربطها |
| **مقتطفات الطلبات** | طلبات جاهزة: مراجعة الكود، وخطة التنفيذ، وشرح هذا |

تبدأ أوامر الشرطة المائلة بـ`/` وتفتح لوحة. انظر [الاختصارات والأوامر](/ar/products/desktop-guide/shortcuts-and-commands).

### اقتراحات تظهر أثناء الكتابة

يعرض مربع الكتابة شارات بنقرة واحدة حين توحي كلماتك بشيء:

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

### أثناء عمل الوكيل

| التحكم | ماذا يفعل |
| - | - |
| **إيقاف** | يوقف الدورة الحالية |
| **توجيه (Steer)** | يعيد توجيه الدورة الجارية بعد أداتها التالية |
| **طابور** | يضيف رسالة تُرسل بعد الدورة الحالية. تستطيع تعديل الدور المنتظر أو تقديمه أو توجيه به أو حذفه |
| **إيقاف الطابور واستئنافه** | **إيقاف** يوقف الطابور مؤقتًا، و**استئناف** يرسل الأدوار المنتظرة مجددًا |

إن فشلت رسالة منتظرة في الإرسال مرارًا فتبقى في الطابور ويُخبَر بذلك، فلا يضيع شيء.

### الصوت

يدعم مبيان Desktop ثلاث ميزات صوتية، كلها من مربع الكتابة:

<Tabs>
  <Tab title="الإملاء" icon="microphone">
    تكلّم بدل الكتابة. يُفرَّغ التسجيل نصًا داخل مربع الكتابة.
  </Tab>

  <Tab title="محادثة صوتية" icon="comments">
    حوار حر اليدين. تظهر الحالة: **يستمع** أو **يفكر** أو **يتكلم** أو **مكتوم**. يمكنك كتم الميكروفون، أو إيقاف الاستماع والإرسال، أو **إنهاء** المحادثة. للبدء أو الإيقاف `Ctrl` مع `B` على macOS.
  </Tab>

  <Tab title="قراءة الردود بصوت عالٍ" icon="volume-high">
    فعّل قراءة الردود بصوت عالٍ، أو استخدم **قراءة بصوت عالٍ** على رسالة واحدة.
  </Tab>
</Tabs>

يمكن لـ**كلمة إيقاظ** بدء الصوت دون يدين: `/wake on` و`/wake off` و`/wake status`. وتتوقف مؤقتًا أثناء المحادثة الصوتية.

يحتاج الصوت إلى مزوّد تحويل كلام إلى نص مُعدّ، وإذن الميكروفون من نظامك. وإن لم يعمل فانظر [حل المشكلات](/ar/products/desktop-guide/troubleshooting#مشكلات-الصوت).

## اختر النموذج

افتح منتقي النموذج من شريط الحالة أو بـ`Cmd`/`Ctrl` مع `Shift` و`M`. يسرد المزوّدين الذين سجّلت دخولك إليهم مع مربع تصفية.

* نماذج **مبيان** تعمل عبر حسابك. بعض نماذج **Pro** تحتاج اشتراك مبيان مدفوعًا.
* يعرض كل نموذج سعر الإدخال والإخراج لكل مليون رمز.
* **الخيارات** تعتمد على النموذج: **التفكير** ووضع **السرعة (Fast)** و**الجهد (Effort)** (أدنى، منخفض، متوسط، عالٍ، عالٍ جدًا، أقصى، فائق).
* اختيار نموذج لمحادثة **يثبّته** لتلك المحادثة. المحادثات الجديدة تستخدم الافتراضي من الإعدادات.

ويمكنك إضافة نماذج احتياطية في الإعدادات، لتستمر المحادثة إن فشل النموذج الرئيسي.

## قراءة المحادثة

* **التفكير.** يظهر الاستدلال المتدفق «يفكّر» ثم «فكّر لمدة ...». يمكنك طيّه افتراضيًا من الإعدادات.
* **نشاط الأدوات.** خطوات مثل قراءة ملف أو البحث في الويب أو تشغيل أمر تظهر مباشرة. عرض **المنتج** يلخصها بلغة بسيطة، وعرض **التقني** يعرض المدخل والمخرج الخام. الخطوات التي فشلت ثم تعافت تُعلَّم **تعافى**.
* **الملفات المتغيرة.** حين تعدّل الدورة ملفات يظهر ملخص يربط بـ**المراجعة**.
* **إجراءات الرسالة.** نسخ وتحديث (إعادة توليد) و**تفريع في محادثة جديدة** وتفاعل بإيموجي و**قراءة بصوت عالٍ** وتعديل وتوسيع رسالة طويلة.
* **الزمن.** تعرض كل دورة المدة التي استغرقتها.

### التعديل والتفريع والاستعادة

<AccordionGroup>
  <Accordion title="تعديل رسالة" icon="pen">
    عدّل إحدى رسائلك السابقة وأرسل النسخة المعدّلة. إن لم تعد تلك الدورة في سجل الخادم (ربما ضُغطت) فيُخبَر بذلك.
  </Accordion>

  <Accordion title="التفريع" icon="code-branch">
    **تفريع في محادثة جديدة** يبدأ محادثة جديدة من رسالة، وتُحفظ مسودة باسم «فرع» ورقم. أوقف الدورة الحالية أولًا.
  </Accordion>

  <Accordion title="استعادة نقطة" icon="clock-rotate-left">
    **استعادة نقطة** ترجع إلى طلب سابق. كل ما بعده يُزال من المحادثة، ويُعاد تشغيل الطلب من هناك. تستطيع الانتقال إلى النقطة السابقة أو التالية، والتقدم مرة أخرى.
  </Accordion>

  <Accordion title="إعادة المحاولة والتراجع" icon="rotate-left">
    `/retry` يعيد إرسال آخر رسالة لك، و`/undo` يزيل آخر تبادل، و`/rollback` يسرد نقاط الاستعادة في نظام الملفات أو يستعيدها.
  </Accordion>
</AccordionGroup>

## الموافقات والأمان

يسألك مبيان قبل أن يفعل شيئًا يحتاج إذنك. وأنت تختار مقدار ما تُسأل عنه:

| وضع الموافقة | السلوك |
| - | - |
| **يدوي** | يسأل قبل كل إجراء يتطلب موافقة |
| **ذكي** | يقيّم كل إجراء تلقائيًا ويسأل عند الحاجة فقط |
| **إيقاف** | يعمل دون طلبات موافقة |

اضبطه من شريط الحالة أو بـ`/approvals manual` أو `/approvals smart` أو `/approvals off`.

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

<Warning>
  **وضع YOLO** يوافق تلقائيًا على الأوامر الخطرة. `/yolo` يفعّله للمحادثة الحالية، والنقر مع `Shift` على مؤشره يبدّله عمومًا. استخدمه فقط في مجلد وبيئة يكون الخطأ فيهما رخيصًا.
</Warning>

بعض الطلبات تأتي كنوافذ مستقلة:

* **كلمة مرور المسؤول.** حين يحتاج أمر مميز إلى `sudo` يطلب مبيان كلمة المرور ويرسلها **إلى وكيلك المحلي فقط**.
* **سر مطلوب.** نافذة لقيمة اعتماد يحتاجها الوكيل.
* **الأسئلة.** يمكن للوكيل أن يسألك سؤالًا أو عدة أسئلة بخيارات، وإجابة «أخرى» نصية حرة، أو تخطٍّ. وإن أجبت بعد انتهاء صلاحية النافذة فيمكنك صياغتها كرسالة متابعة.
* **إعداد MCP.** يمكن للوكيل أن يعرض تثبيت خادم MCP أو تفعيله أو تخويله من كتالوج معتمد من مبيان، ويسألك أولًا. وتُملأ بيانات الاعتماد المطلوبة قبل التثبيت.

حين يكون مبيان في الخلفية يصلك إشعار نظام بـ**موافقة مطلوبة** مع زرَّي **موافقة** و**رفض**، و**إدخال مطلوب** و**الرد جاهز** و**فشلت الدورة**.

## العمل الطويل

| الميزة | ماذا تفعل |
| - | - |
| `/goal` | تحدد هدفًا دائمًا للجلسة. يظهر: الهدف نشط أو متوقف أو ينتظر أو منتهٍ |
| `/loop` | يعيد تشغيل طلب بفاصل متكرر داخل هذه الجلسة |
| `/background` | يشغّل طلبًا في الخلفية. وتستأنف المحادثة حين تنتهي المهام الخلفية |
| **المهام** | قائمة مهام الوكيل تظهر بعدد المكتمل من الإجمالي |
| **الوكلاء الفرعيون** | حين يفوّض الوكيل تبث الوكلاء الأبناء تقدمهم في عرض **الوكلاء** (شجرة توزيع بأعداد العامل والفاشل والمنتهي والأدوات المستخدمة والملفات المعدّلة) |
| `/compress` | يضغط المحادثة لتحرير السياق |

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

## المتابعة في مكان آخر

* **التحويل (Handoff).** `/handoff` يرسل الجلسة إلى منصة مراسلة مثل Telegram. وتستطيع استئنافها في Desktop في أي وقت. يتطلب ذلك تشغيل بوابة المراسلة.
* **التصدير.** احفظ جلسة من قائمتها، أو `/save` لحفظ السجل بصيغة JSON.
* **نافذة أو تبويب أو تقسيم جديد.** افتح المحادثة نفسها بجوار نفسها.

## حين تفشل دورة

تذكر الأخطاء أي طبقة فشلت: المصادقة، أو نفاد الرصيد، أو امتلاء القرص، أو نقطة نهاية مخصصة، أو البوابة، أو المزوّد، أو بيئة التشغيل المحلية، أو اتصال البث. وتحصل على الخطوة التالية المناسبة مثل **إعادة المحاولة** أو **تبديل المزوّد** أو **فتح السجلات** أو **نسخ تفاصيل الخطأ** أو **إرسال التشخيصات**. انظر [حل المشكلات](/ar/products/desktop-guide/troubleshooting).

<Card title="التالي: مساحة العمل واللوحات" icon="table-columns" horizontal href="/ar/products/desktop-guide/workspace">
  متصفح الملفات ولوحة المراجعة والطرفيات والمعاينة الحية والتخطيطات ووضع HUD.
</Card>