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

# البناء محليًا في Manus Studio

> أنشئ مواقع ويب وتطبيقات ويب وتطبيقات جوّال وألعابًا في مجلد على حاسوبك الخاص باستخدام Manus Studio. اختر خدمات تديرها Manus أو مشروعًا محليًا عاديًا.

## ما هو

تتيح ميزة **البناء محليًا (Build locally)** لـ Manus إنشاء موقع ويب أو تطبيق ويب أو تطبيق جوّال أو لعبة في مجلد على حاسوبك الخاص. تعمل داخل **Manus Studio**، وهو تطبيق Manus لسطح المكتب على macOS (Apple Silicon) وWindows. تكتب Manus الشيفرة، وتشغّل المشروع، وتعرض معاينة مباشرة. وتستخدم الملفات والمجلدات والأدوات الموجودة بالفعل على حاسوبك. لمعرفة ما يمكن أن يفعله Manus Studio على حاسوبك، اقرأ [Manus Studio](https://manus.im/docs/ar/features/desktop.md).

استخدم هذه الميزة في الحالات التالية:

* مشروعك موجود بالفعل على حاسوبك.
* تريد الحفاظ على سير عمل Git الخاص بك.
* تريد استخدام أدواتك الخاصة إلى جانب Manus.

يمكنك أيضًا استخدام سير العمل نفسه على [Cloud Computer](https://help.manus.im/en/articles/15392111-what-is-the-cloud-computer). وفي هذه الحالة، يكون مجلد المشروع على Cloud Computer بدلًا من جهازك الخاص.

لكل موقع ويب أو تطبيق جوّال، تختار أحد نوعين من المشاريع:

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

يوضح الجدول الخيارات المتاحة لكل نوع من المشاريع.

| نوع المشروع | خياراتك | أين يجري التطوير |
| :- | :- | :- |
| **موقع ويب أو تطبيق ويب** | تديره Manus أو محلي عادي | حاسوبك |
| **تطبيق جوّال** | تديره Manus أو محلي عادي | تديره Manus: ‏Manus Cloud. محلي عادي: حاسوبك. |
| **لعبة** | تديره Manus دائمًا | حاسوبك |

***

## كيفية استخدامه

### إعداد Manus Studio

**1. نزّل Manus Studio**

افتح [manus.im/desktop](https://manus.im/desktop). اختر **macOS (Apple Silicon)** أو **Windows**، ثم شغّل برنامج التثبيت.

**2. سجّل الدخول**

افتح Manus Studio وسجّل الدخول بحسابك في Manus. إذا طلبت منك Manus التحديث قبل استخدام مجلد محلي، فثبّت أحدث إصدار.

**3. فعّل العمل محليًا واختر المجلد**

في مربع المحادثة، فعّل **العمل محليًا (Work locally)**. انقر على **اختيار مجلد (Choose a folder)** واختر المجلد الذي يوجد فيه مشروعك، أو المجلد الذي يجب أن تنشئه Manus فيه. اقرأ [Manus Studio](https://manus.im/docs/ar/features/desktop.md) لمعرفة أوضاع الأذونات والوصول إلى المجلدات.

### بدء موقع ويب جديد على حاسوبك

**1. صِف الموقع وموقعه**

ابدأ مهمة في Manus Studio. صِف الموقع، وأخبر Manus بالمكان الذي يجب أن تبنيه فيه على حاسوبك.

**2. اختر نوع المشروع**

تسألك Manus عن الطريقة التي تريد بها إعداد الموقع. اختر **تديره Manus (Manus-managed)** لاستخدام استضافة Manus، وقاعدة البيانات، وتسجيل الدخول، وسجل الإصدارات، والنشر. واختر **محلي عادي (plain local)** لاستخدام أدواتك وخدماتك الخاصة فقط.

**3. اسمح بتخزين الشيفرة إذا لم يكن المجلد فارغًا**

بالنسبة إلى المشروع الذي تديره Manus، تفحص Manus المجلد. إذا كان يحتوي على ملفات بالفعل، تعرض Manus بطاقة **تخزين شيفرة المشروع (Project code storage)**. تسألك البطاقة: "هل تسمح لـ Manus بمزامنة شيفرة مشروعك؟" انقر على **السماح والتهيئة (Allow and initialize)** للمتابعة. إذا ألغيت، فلن تُعِدّ Manus المشروع.

**4. راجِع الخطة**

تعرض Manus خطة للموقع. اطلب التغييرات قبل أن تبدأ Manus البناء.

**5. عايِن وحسِّن**

تشغّل Manus الموقع على حاسوبك وتفتح معاينة مباشرة في Manus Studio. صِف التغييرات التي تريدها في المهمة نفسها.

مثال على مطالبة:

```text theme={null}
Build a booking website for my yoga studio in a new folder called yoga-site
in my Documents folder. Include a class schedule, a booking form, and a contact page.
```

> [!NOTE]
>
> إذا كنت قد اخترت نوع المشروع في مطالبتك بالفعل، على سبيل المثال "أبقِ هذا محليًا، بدون استضافة Manus"، فلن تسألك Manus مرة أخرى.

### متابعة موقع ويب موجود بالفعل على حاسوبك

**1. وجّه Manus إلى المجلد**

في Manus Studio، أخبر Manus بالمشروع الذي تريد متابعته. اذكر المسار الكامل للمجلد إن أمكن.

**2. أكّد النسخة الصحيحة**

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

**3. اختر طريقة ربط الشيفرة الموجودة**

قد يحتوي المجلد على شيفرة غير مرتبطة بـ Manus بعد. في هذه الحالة، تطلب منك Manus الاختيار بين "تديره Manus" و"محلي عادي". تحتفظ Manus بملفاتك الموجودة ولا تطبّق قالبًا مبدئيًا فوقها.

### إضافة موقع ويب إلى مشروع أكبر

يمكنك إضافة موقع ويب إلى مشروع ليس موقع ويب، على سبيل المثال موقع رسمي للعبة.

1. أخبر Manus بأنك تريد موقع ويب منفصلًا داخل المشروع الأكبر. على سبيل المثال: "أضف موقعًا رسميًا لهذه اللعبة."
2. تنشئ Manus الموقع في مجلد فرعي خاص به، على سبيل المثال `website/`.
3. لا ينتمي إلى الموقع سوى ذلك المجلد الفرعي. ولا تُدرج Manus بقية المشروع في إصدارات الموقع.

### بناء تطبيق جوّال

**1. صِف التطبيق**

في Manus Studio، صِف تطبيق الجوّال الذي تريد بناءه.

**2. اختر نوع المشروع**

تطلب منك Manus الاختيار قبل أن تبدأ. يمنحك خيار **تديره Manus (Manus-managed)** واجهة خلفية، وقاعدة بيانات، وتسجيل دخول، وميزات ذكاء اصطناعي، وسجل إصدارات، وإصدارات بناء للتطبيق. أما خيار **محلي عادي (Plain local)** فيُبقي التطوير على حاسوبك مع واجهتك الخلفية وخدماتك الخاصة.

**3. أكّد الانتقال إلى Manus Cloud**

يعمل تطبيق الجوّال الذي تديره Manus حاليًا في Manus Cloud. إذا اخترته، تنقل Manus المهمة من حاسوبك إلى Manus Cloud قبل بدء التطوير. وتخبرك Manus بهذا الانتقال قبل أن تختار.

> [!WARNING]
>
> قد لا تنتقل الملفات الموجودة في مجلدك المحلي مع المهمة إلى Manus Cloud. إذا كانت لديك شيفرة موجودة، فأخبر Manus قبل أن تختار حتى تتمكن من التخطيط لكيفية نقل الشيفرة.

### بناء لعبة

1. في Manus Studio، صِف اللعبة وأخبر Manus بالمكان الذي يجب أن تبنيها فيه على حاسوبك.
2. تُعِدّ Manus اللعبة كمشروع تديره Manus. ولا تطلب منك اختيار نوع المشروع.
3. تابع سير عمل Game Dev المعتاد. اقرأ [Game Developer](https://manus.im/docs/ar/features/game-developer.md).

### حفظ الإصدارات ونشر مشروع تديره Manus

**1. اطلب من Manus حفظ إصدار**

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

**2. انشر عندما تكون مستعدًا**

اطلب من Manus النشر، أو انشر كما هو موضح في [النشر](https://manus.im/docs/ar/website-builder/publishing.md). تسألك Manus: "هل تسمح لـ Manus بالنشر؟" اختر **السماح مرة واحدة (Allow once)**، أو **السماح دائمًا لهذا الموقع (Always allow for this website)** لتخطي هذا السؤال في المرة القادمة. لا يمكن نشر المشروع المحلي إلا لمالك المشروع. ولا يؤدي حفظ إصدار إلى نشر موقعك من تلقاء نفسه، إلا إذا فعّلت النشر التلقائي.

> [!NOTE]
>
> لا يؤدي إنشاء commit في مستودع Git الخاص بك إلى إنشاء إصدار في Manus، ولا ينشر موقعك.

### اختبار مدفوعات Stripe في مشروع محلي

1. اطلب من Manus إضافة المدفوعات. تُعِدّ Manus خدمة Stripe في وضع الاختبار. اقرأ [المدفوعات](https://manus.im/docs/ar/website-builder/payments.md).
2. اختبر عملية الدفع باستخدام بطاقة اختبار Stripe ‏`4242 4242 4242 4242`.
3. لإجراء اختبار كامل للمدفوعات، يجب أن يرسل Stripe أحداث الدفع (webhooks) إلى تطبيقك. ولا يمكن للمعاينة على حاسوبك الخاص استقبال هذه الأحداث. اطلب من Manus نقل المشروع إلى بيئة معزولة (sandbox) سحابية مؤقتة لهذا الاختبار. وستطلب Manus موافقتك أولًا.
4. قبل أن تنشر للمرة الأولى، اطلب من Manus ربط webhook الخاص بـ Stripe من معاينة سحابية.

### ربط مشروع محلي عادي بـ Manus لاحقًا

1. افتح مجلد المشروع في Manus Studio.
2. اطلب من Manus ربط الموقع بـ Manus.
3. تربط Manus المجلد الموجود بمشروع جديد تديره Manus. وتحتفظ بملفات المصدر الخاصة بك ولا تعيد بناء الموقع.

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

***

## ما تحتاج إلى معرفته

### ما الذي يعمل وأين

* **تعمل المعاينة على حاسوبك.** يفتح Manus Studio المعاينة من عنوان محلي على جهازك. ولا يمكن للأجهزة الأخرى فتح هذا العنوان.
* **شارك مع الآخرين عبر النشر.** لتتيح للآخرين رؤية الموقع، انشره، أو تابع المهمة في Manus Cloud.
* **زامِن قبل المتابعة في السحابة.** تبدأ المهمة السحابية الجديدة من أحدث إصدار تمت مزامنته. ولا تُضمَّن التغييرات الموجودة على حاسوبك فقط. اطلب من Manus المزامنة أولًا، ثم اختر **المتابعة في مهمة سحابية جديدة (Continue in a new cloud task)**.
* **لا يمكن استخدام الملفات المحلية إلا للمالك.** الملفات المحلية، والنشر المحلي، والمتابعة في مهمة جديدة متاحة لمالك المشروع فقط.
* **تعمل تطبيقات الجوّال المُدارة في Manus Cloud.** تبقى مواقع الويب وتطبيقات الويب والألعاب على حاسوبك. أما تطبيقات الجوّال التي تديرها Manus فتنتقل إلى Manus Cloud.

### ما الذي ترفعه Manus

* **المشاريع التي تديرها Manus:** عندما تحفظ إصدارًا أو تزامنه، ترفع Manus الشيفرة الموجودة في مجلد الموقع. ولا ترفع بقية المشروع الأكبر، مثل اللعبة المحيطة بموقع مرافق.
* **الإعداد وحده لا يرفع الشيفرة.** لا يؤدي ربط مجلد أو إعداد مشروع تديره Manus إلى رفع شيفرتك من تلقاء نفسه.
* **اختيار "تديره Manus" لا ينشر أي شيء.** لا يصبح موقعك عامًا إلا عندما تنشره.
* **المشاريع المحلية العادية:** لا تُعِدّ Manus خدمات Manus ولا تحفظ الإصدارات في Manus. ويمكنك ربط المشروع بـ Manus لاحقًا.

### كيف تعمل Manus مع مستودع Git الخاص بك

* **سجلّان منفصلان.** تحتفظ Manus بسجل إصدارات خاص بها للمشروع الذي تديره Manus. ويبقى مستودع Git الخاص بك وسجله منفصلين.
* **يبقى إعداد Git الخاص بك كما هو.** لا تغيّر Manus المستودعات البعيدة (remotes)، أو الفروع، أو hooks، أو بيانات الاعتماد. ولا تستورد سجل Git الخاص بك.
* **لا تُنسخ commits بين السجلين.** لا تظهر commits الخاصة بك في سجل إصدارات Manus، ولا تظهر إصدارات Manus كـ commits في مستودعك.
* **ملفات مشتركة.** يتتبع السجلان الملفات نفسها في المجلد. وعندما تجلب Manus تغييرات من سجلها الخاص، تظهر هذه التغييرات في مستودع Git الخاص بك كتغييرات غير مُثبَّتة (uncommitted).
* **المجلدات التي ليس لها مستودع Git خاص بها.** إذا لم يكن مجلد الموقع داخل مستودع Git، فستعرض أدوات Git الخاصة بك سجل إصدارات Manus لذلك المجلد. لاستخدام مستودع منفصل هناك، اطلب من Manus إعداده. لا تشغّل `git init` في ذلك المجلد بنفسك.
* **تضيف Manus عنصرين إلى مجلد الموقع.** ملف مشروع صغير يربط المجلد بمشروعك في Manus، ومجلد مخفي يخزّن سجل إصدارات Manus. لا تحذف أيًا منهما. ولا تُثبّت (commit) المجلد المخفي في مستودعك الخاص.
* **Git worktrees والفروع.** يمكنك تثبيت (commit) ملف المشروع الصغير في مستودعك. وبعد ذلك يبقى أي فرع أو worktree جديد مرتبطًا بمشروع Manus نفسه.
* **المشاريع السحابية وGitHub.** بالنسبة إلى المشاريع التي تبنيها في Manus Cloud، اقرأ [تكامل GitHub](https://manus.im/docs/ar/website-builder/github-integration.md) و[التحكم في الشيفرة](https://manus.im/docs/ar/website-builder/code-control.md).

### القيود الحالية

* **التراجع غير متاح بعد للمشاريع المحلية.** لا يمكنك التراجع بمشروع محلي تديره Manus إلى إصدار محفوظ سابق. للتراجع عن التغييرات، استخدم سجل Git الخاص بك.
* **يتطلب الاختبار الكامل لـ webhook الخاص بـ Stripe بيئة معزولة سحابية.** تعمل عملية الدفع في وضع الاختبار محليًا. أما أحداث الدفع فتحتاج إلى بيئة معزولة سحابية مؤقتة.
* **الألعاب تديرها Manus دائمًا.** خيار "محلي عادي" غير متاح للألعاب.
* **تحتاج تطبيقات الجوّال المُدارة إلى Manus Cloud.** لا يمكنك تطوير تطبيق جوّال تديره Manus على حاسوبك الخاص.

### الأدوات على حاسوبك

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

### نقل مجلد مشروع أو نسخه

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

### الأرصدة

تستهلك المهام التي تعمل مع حاسوبك الأرصدة بالمعدل نفسه الذي تستهلكه المهام المماثلة في السحابة. يحدد تعقيد المهمة التكلفة، وليس مكان الملفات. اقرأ [Understanding Credit Consumption in the Manus Desktop App](https://help.manus.im/en/articles/14134826-understanding-credit-consumption-in-the-manus-desktop-app).

***

## نصائح

* **أعطِ Manus المسار الكامل للمجلد.** يساعد المسار الكامل، مثل `~/Documents/yoga-site`، Manus على العثور على المشروع الصحيح من المرة الأولى.
* **استخدم مجلدًا جديدًا وفارغًا للموقع الجديد.** عندئذٍ تُعِدّ Manus المشروع دون أن تطلب منك تأكيد تخزين الشيفرة.
* **حدّد نوع مشروعك في المطالبة الأولى.** قل "تديره Manus" أو "أبقِ هذا محليًا" لتخطي سؤال الإعداد.
* **اختر "تديره Manus" إذا كنت تخطط للنشر باستخدام Manus.** تحصل على الاستضافة وسجل الإصدارات والنشر دون إعداد إضافي.
* **احتفظ بالموقع المرافق في مجلد فرعي خاص به.** عندئذٍ يقتصر سجل الإصدارات وعمليات الرفع على الموقع فقط، وليس المشروع بأكمله.
* **ثبّت (commit) عملك في Git قبل إجراء تغييرات كبيرة.** التراجع غير متاح بعد للمشاريع المحلية التي تديرها Manus، لذا فإن سجل Git الخاص بك هو شبكة الأمان.
* **ثبّت ملف المشروع الصغير، وليس المجلد المخفي.** عندئذٍ تبقى فروعك وworktrees مرتبطة بمشروع Manus نفسه.
* **خطّط لاختبار المدفوعات مبكرًا.** اطلب من Manus إعداد بيئة معزولة سحابية مؤقتة عندما تكون مستعدًا لاختبار مسار الدفع بالكامل.
* **انشر للمشاركة.** لا تعمل المعاينة المحلية إلا على حاسوبك. انشر الموقع لإرسال رابط إلى الآخرين.

***

## الأسئلة الشائعة

> [accordion] هل أحتاج إلى Manus Studio للبناء محليًا؟
>
> نعم. يتطلب البناء على حاسوبك الخاص Manus Studio لنظام macOS (Apple Silicon) أو Windows. نزّله من [manus.im/desktop](https://manus.im/desktop). ويمكنك أيضًا استخدام سير العمل نفسه على Cloud Computer.

> [accordion] ما الفرق بين المشروع الذي تديره Manus والمشروع المحلي العادي؟
>
> يتصل المشروع الذي تديره Manus بخدمات Manus مثل الاستضافة، وقاعدة البيانات، وتسجيل الدخول، وسجل الإصدارات، والنشر. أما المشروع المحلي العادي فهو مشروع عادي على حاسوبك. تستخدم فيه أدواتك وخدماتك الخاصة، ولا تُعِدّ Manus الاستضافة أو النشر.

> [accordion] هل ترفع Manus شيفرتي؟
>
> بالنسبة إلى المشروع الذي تديره Manus، ترفع Manus الشيفرة الموجودة في مجلد الموقع عندما تحفظ إصدارًا أو تزامنه. ولا يؤدي إعداد المشروع إلى رفع الشيفرة من تلقاء نفسه. أما بالنسبة إلى المشروع المحلي العادي، فلا تحفظ Manus الإصدارات في Manus.

> [accordion] هل ستغيّر Manus مستودع Git الخاص بي؟
>
> لا. تحتفظ Manus بسجل إصدارات خاص بها، منفصل عن مستودعك. ولا تغيّر المستودعات البعيدة (remotes)، أو الفروع، أو hooks، أو بيانات الاعتماد. وعندما تغيّر Manus الملفات، تظهر هذه التغييرات في مستودعك كتغييرات غير مُثبَّتة (uncommitted).

> [accordion] لماذا انتقلت مهمة تطبيق الجوّال الخاص بي إلى السحابة؟
>
> يعمل تطبيق الجوّال الذي تديره Manus حاليًا في Manus Cloud. وتخبرك Manus بذلك قبل أن تختار. للإبقاء على التطبيق على حاسوبك، اختر التطوير المحلي العادي بدلًا من ذلك.

> [accordion] لماذا لا تطلب مني Manus اختيار نوع المشروع للعبتي؟
>
> الألعاب التي تُبنى محليًا تديرها Manus دائمًا. تُعِدّ Manus اللعبة باستخدام خدمات Manus وتنتقل إلى الخطوة التالية.

> [accordion] هل يمكنني التراجع بمشروع محلي إلى إصدار سابق؟
>
> ليس بعد. التراجع غير متاح للمشاريع المحلية التي تديرها Manus في هذا الإصدار. ثبّت (commit) عملك في مستودع Git الخاص بك قبل إجراء تغييرات كبيرة حتى تتمكن من استعادة الملفات بنفسك.

> [accordion] هل يمكنني اختبار مدفوعات Stripe على حاسوبي؟
>
> يمكنك اختبار عملية الدفع في وضع الاختبار في Stripe. أما الاختبار الكامل لأحداث الدفع (webhooks) فيحتاج إلى بيئة معزولة سحابية مؤقتة. اطلب من Manus إعدادها. وستطلب Manus موافقتك قبل نقل المشروع.

> [accordion] هل يمكن لشخص آخر فتح المعاينة المحلية الخاصة بي؟
>
> لا. تعمل المعاينة على عنوان محلي على حاسوبك. لمشاركة الموقع، انشره أو تابع المهمة في Manus Cloud.

> [accordion] هل يمكنني ربط موقع محلي عادي بـ Manus لاحقًا؟
>
> نعم. اطلب من Manus ربط الموقع. تربط Manus المجلد الموجود بمشروع تديره Manus وتحتفظ بملفات المصدر الخاصة بك.

> [accordion] طلبت مني Manus تثبيت أداة على حاسوبي. لماذا؟
>
> يحتاج مشروعك إلى أداة مفقودة، أو قديمة، أو لا تعمل على حاسوبك. تشرح Manus التغيير وتطلب إذنك قبل أن تثبّت أداة أو تصلحها على مستوى حاسوبك بالكامل.

> [accordion] هل يستهلك البناء محليًا أرصدة أكثر؟
>
> لا. تستهلك المهام التي تعمل مع حاسوبك الأرصدة بالمعدل نفسه الذي تستهلكه المهام المماثلة في السحابة. اقرأ [الخطط والأسعار](https://manus.im/docs/ar/introduction/plans.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.