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

# الاتصالات والملفات الشخصية

> شغّل الوكيل محليًا أو على بوابة بعيدة أو عبر SSH أو على Mibyan Cloud، واحتفظ بملفات شخصية منفصلة لكل منها إعداداتها ومهاراتها وشخصيتها

مبيان Desktop نافذة على **خلفية الوكيل** وتسمى أيضًا **البوابة (gateway)**. قد تعمل الخلفية على هذا الحاسوب أو في مكان آخر. و**الملفات الشخصية** هويات وكلاء منفصلة تعيش على بوابة. تشرح هذه الصفحة الأمرين.

## أربعة أنواع من البوابات

```mermaid theme={null}
flowchart LR
  APP["مبيان Desktop<br/>هذا التطبيق"]
  APP --> L["محلية<br/>تعمل على هذا الحاسوب"]
  APP --> R["بوابة بعيدة<br/>HTTP(S): شبكة محلية أو VPN أو الإنترنت"]
  APP --> S["SSH<br/>تُشغَّل عبر SSH وتُنفَّق"]
  APP --> C["Mibyan Cloud<br/>وكيل مستضاف على حسابك"]
```

| النوع | ما هو | مناسب لـ |
| - | - | - |
| **محلية** | بيئة تشغيل مبيان التي يديرها هذا التطبيق. خاصة على localhost وتعمل دون اتصال. لا توجد إلا واحدة | الاستخدام اليومي |
| **بوابة بعيدة** | بوابة مبيان يمكن الوصول إليها عبر HTTP أو HTTPS على شبكتك أو عبر VPN أو على الإنترنت | خادم مشترك أو مختبر منزلي أو جهاز عمل |
| **SSH** | تثبيت مبيان يُوصل إليه عبر SSH. يُشغَّل مبيان على المضيف البعيد ويُنفَّق إلى التطبيق، فلا شيء تشغّله أو تكشفه بنفسك | جهاز تستطيع الدخول إليه بـ SSH أصلًا |
| **Mibyan Cloud** | نسخة مستضافة تُكتشف عبر حسابك في Mibyan Cloud | وكيل يعمل دائمًا دون تشغيل خادم |

يشغّل الوكيل البعيد الأوامر ويقرأ الملفات **على ذلك الجهاز** لا على جهازك. لا تتصل إلا بمضيفين تثق بهم.

## إدارة البوابات

افتح **الإعدادات، البوابات**. تسرد كل البوابات المسجلة وتعلّم المستخدمة حاليًا (**الحالية**) والافتراضية (**الأساسية**) والتي يديرها التطبيق (**يديرها التطبيق**).

<Steps>
  <Step title="أضف اتصالًا">
    اختر **إضافة اتصال** ثم النوع وأعطه **اسمًا**. يجب أن تكون الأسماء فريدة، وتظهر أينما تظهر البوابة، مثل Homelab أو Work laptop.
  </Step>

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

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

من المفيد أن تعرف:

* الملفات الشخصية والمحادثات والمراسلة والمهام المجدولة **تبقى مع بوابتها**. والعمل على بوابة بدّلت عنها يستمر.
* إعداد **عند البدء، العودة إلى الجلسات على آخر بوابة مستخدمة** يحدد أين يفتح التطبيق. وإن كان مطفأً يفتح على البوابة الأساسية.
* لا يمكن إضافة اتصال محلي ثانٍ، وتُرفض الروابط ومضيفات SSH المكررة مع ذكر اسم الموجود.
* **إزالة** تخرج الاتصال من هذا التطبيق فقط. النسخة نفسها لا تُمس، ويمكنك إضافتها في أي وقت.
* **تحديث كل النسخ** يرسل تحديثًا لكل بوابة قابلة للتحديث. انظر [التثبيت والتحديث](/ar/products/desktop-guide/install-and-update).

### إعداد بوابة بعيدة

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

  <Step title="دع التطبيق يكتشف طريقة الدخول">
    يسأل التطبيق البوابة. البوابات المستضافة تستخدم OAuth (مثل الدخول عبر مزوّد هويتك) أو اسم مستخدم وكلمة مرور. والمستضافة ذاتيًا تستخدم **رمز جلسة**.
  </Step>

  <Step title="سجّل الدخول أو الصق الرمز">
    الدخول يفتح نافذة متصفح ويتجدد ذاتيًا بعد ذلك. والرمز الملصوق يُستخدم للوصول عبر REST وWebSocket. اترك الحقل فارغًا للإبقاء على رمز محفوظ.
  </Step>

  <Step title="اختبر ثم احفظ">
    **اختبار البعيدة** يتحقق من الاتصال. **حفظ وإعادة الاتصال** يطبّقه الآن ويُبقي التطبيق مفتوحًا. و**حفظ للتشغيل القادم** ينتظر.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="أين يُخزَّن رمزي؟" icon="key">
    في التخزين الآمن لنظام التشغيل. فإن لم يوجد تخزين آمن على الجهاز يسألك مبيان قبل حفظ الرمز **دون تشفير** في ملف إعدادات الاتصال، حيث يستطيع أي عملية تعمل بحسابك قراءته. على Linux ثبّت أو فعّل GNOME Keyring أو KWallet لتتجنب ذلك.
  </Accordion>

  <Accordion title="ترويسات إضافية للبوابة" icon="shield">
    للبوابات خلف وكيل وصول مثل Cloudflare Access أضف ترويسات مثل `CF-Access-Client-Id` و`CF-Access-Client-Secret`. تُرسل مع كل طلب HTTP وWebSocket إلى تلك البوابة وتُخزَّن مشفّرة. والترويسات التي يديرها مبيان بنفسه (مثل Authorization وCookie) تُتجاهل.
  </Accordion>

  <Accordion title="تجاوزات متغيرات البيئة" icon="terminal">
    إن ضُبط المتغيران `MIBYAN_DESKTOP_REMOTE_URL` و`MIBYAN_DESKTOP_REMOTE_TOKEN` فهما يتحكمان بالجلسة ويخبرك التطبيق بذلك. ألغِ ضبطهما لتستخدم الإعدادات المحفوظة.
  </Accordion>
</AccordionGroup>

### إعداد SSH

وضع SSH يشغّل مبيان على المضيف البعيد وينفّقه إلى هذا التطبيق، فلا شيء يحتاج كشفه. ويحتاج وصول SSH **بالمفاتيح** لأن مبيان يشغّل `ssh` دون تفاعل.

| الحقل | ماذا تدخل |
| - | - |
| **المضيف** | `user@host`، أو اختر اسم Host مستعارًا من `~/.ssh/config` |
| **المستخدم** | اتركه فارغًا لاستخدام `~/.ssh/config` أو مستخدمك الحالي |
| **المنفذ** | فارغ يعني 22 أو منفذ `~/.ssh/config` |
| **ملف الهوية** | مسار المفتاح الخاص. فارغ يستخدم `ssh-agent` أو `~/.ssh/config` |
| **مسار مبيان** | مسار كامل اختياري لمبيان البعيد. فارغ يكتشفه تلقائيًا |

أول مفتاح مضيف يُعرض **يُوثَق ويُثبَّت**، وأي تغيير لاحق يفشل بأمان. **اختبار SSH** يؤكد أن المضيف يمكن الوصول إليه وأن مبيان موجود. **حفظ** يطبّق عند التشغيل القادم، و**اتصال** يعيد الاتصال الآن. المضيفات البعيدة بأنظمة Linux وmacOS وWindows مدعومة.

رسائل SSH الشائعة وما تفعله:

| الرسالة | الحل |
| - | - |
| تعذّر الوصول إلى المضيف | افحص المضيف والمنفذ وشبكتك |
| فشلت المصادقة | حمّل مفتاحك في `ssh-agent` (`ssh-add`) أو اضبط `IdentityFile` في `~/.ssh/config` |
| تغيّر مفتاح المضيف | تأكد أنه متوقع ثم شغّل `ssh-keygen -R <host>` وأعد الاتصال |
| مبيان غير مثبّت على المضيف البعيد | ثبّته هناك أو حدد مسار مبيان |
| يلزم تحديث | حدّث مبيان على المضيف البعيد أولًا |

### استخدام Mibyan Cloud

<Steps>
  <Step title="سجّل الدخول مرة">
    اختر **تسجيل الدخول إلى Mibyan Cloud**. لا رابط تلصقه.
  </Step>

  <Step title="اختر مؤسسة">
    إن كان حسابك ينتمي إلى عدة مؤسسات فاختر واحدة. ويظهر دورك فيها.
  </Step>

  <Step title="اختر وكيلًا واتصل">
    تُسرد وكلاؤك مع حالتها. والجديد يظهر **قيد التجهيز** حتى يجهز. اختر **اتصال**.
  </Step>
</Steps>

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

### ما يخبرك به شريط الحالة

يعرض شريط الحالة الاتصال الحالي (مثل `Remote: host` أو `SSH: host` أو `Cloud: host`) وهل البوابة **جاهزة** أو **تحتاج إعدادًا** أو **تتصل** أو **غير متصلة** أو **تعيد التشغيل**، والإصدارين. وتقدم قائمة البوابة **إعادة الاتصال بالبوابة** وسجل النشاط الأخير ومنصات المراسلة. وإن انقطع الاتصال يواصل التطبيق المحاولة في الخلفية، وتستطيع القراءة والكتابة كمسودة.

## الملفات الشخصية

**الملف الشخصي** بيئة مبيان مستقلة: لها **إعداداتها ومهاراتها وذاكرتها وشخصيتها** (`SOUL.md`). استخدم الملفات الشخصية للفصل بين العمل والحياة الشخصية، أو لإعطاء وكلاء مختلفين مهامّ مختلفة.

```mermaid theme={null}
flowchart TB
  G["بوابة واحدة"] --> P1["default<br/>وكيلك الرئيسي"]
  G --> P2["coder<br/>مهاراته وشخصيته"]
  G --> P3["research<br/>إعداداته ومفاتيحه"]
```

### الإنشاء والإدارة

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

### التبديل بين الملفات

* استخدم منتقي الملفات، أو `Cmd`/`Ctrl` مع `1` إلى `9` لأول تسعة (و`Cmd`/`Ctrl` مع `Alt` ورقم للملفات من 10 إلى 18).
* `Cmd`/`Ctrl` مع `D` يعود إلى الملف الافتراضي. و`Cmd`/`Ctrl` مع `Shift` والأقواس المربعة ينتقل للتالي أو السابق، و`Cmd`/`Ctrl` مع `Shift` و`0` يبدّل عرض **كل الملفات**.
* `/profile <name>` يحدد الملف للمحادثات الجديدة.
* التبديل لا يعيد تشغيل التطبيق. تبقى النافذة مكانها، ومحادثات الملفات الأخرى **تواصل البث في الخلفية**.

تعرض صفحات الإعدادات أي ملف تنطبق عليه، فتعرف دائمًا إعدادات من تغيّر.

### تشغيل ملف شخصي واحد على مضيف بعيد

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

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

<Card title="التالي: المهارات والأدوات والأتمتة" icon="bolt" horizontal href="/ar/products/desktop-guide/skills-and-automation">
  وسّع الوكيل بالمهارات وخوادم MCP والإضافات والجداول وwebhooks والمراسلة.
</Card>