استورد تطبيقًا موجودًا من GitHub أو ملف .zip أو Lovable
باختصارفي صفحة المشاريع، افتح استيراد واختر GitHub أو ملف .zip أو Lovable. يفحص MonstarX الشفرة خلال ثوانٍ ويخبرك إن كانت تعمل كما هي. اضغط استيراد وتشغيل، فيُفتح التطبيق في المعاينة، وتعمل المحادثة ووضع التحرير والإصدارات واختبارات QA كلها على شفرتك أنت. أما التطبيقات التي لا يستطيع MonstarX تشغيلها (تطبيقات الهاتف وDjango وRails…) فيمكن دراستها وإعادة إنشائها بدلًا من ذلك.
لديك تطبيق بالفعل، أنشأه مطوّر، أو صدّرته من أداة ذكاء اصطناعي أخرى لإنشاء التطبيقات، أو يقبع في مستودع على GitHub؟ استورده. يفحصه MonstarX أولًا ويخبرك خلال ثوانٍ إن كان يستطيع تشغيله. ثم يعمل في المعاينة كما هو تمامًا، وتواصل تحسينه بالمحادثة، تمامًا كأي تطبيق أنشأه MonstarX.
كيف أستورد تطبيقًا؟
Section titled “كيف أستورد تطبيقًا؟”افتح استيراد في مربع الطلب في صفحة المشاريع واختر مكان الشفرة.
-
اختر استيراد ← GitHub.
-
الصق عنوان مستودع (مثل
github.com/acme/shopأوacme/shopفقط) واضغط فحص. وإذا كان حسابك على GitHub مرتبطًا، تظهر مستودعاتك في قائمة لتختار منها، بما فيها المستودعات الخاصة. -
اقرأ النتيجة. اختر فرعًا آخر من فرع، أو مجلدًا آخر من مجلد إن كان التطبيق داخل مجلد، فيُعاد الفحص.
-
اضغط استيراد وتشغيل.
يمكن استيراد أي مستودع عام بعنوانه. أما المستودع الخاص فاربط GitHub أولًا من قائمة GitHub في أي مشروع. راجع GitHub.
-
اختر استيراد ← ملف .zip.
-
أفلت ملف .zip لمجلد مشروعك، أو اختره. يُفحص على جهازك أولًا، ولا يُرفع شيء حتى تستورده.
-
اقرأ النتيجة واضغط استيراد وتشغيل. تُنشئ الشفرة المشروع، ثم تتبعها الصور واحدة تلو الأخرى («جارٍ رفع الصور… 3 من 9»).
يُفك ضغط الملف في متصفحك، فلا تغادر node_modules ومجلدات البناء وأي ملف .env جهازك أبدًا. يمكن أن يصل حجم ملف zip إلى 500 MB. ارفع مجلد مشروعك كما هو: تُتخطّى التبعيات ومجلدات البناء تلقائيًا، ولا تُقرأ وتُستورد إلا ملفات التطبيق.
-
اختر استيراد ← Lovable.
-
الصق مفتاح API لمساحة عمل Lovable واضغط عرض المشاريع (تتطلب مفاتيح API مساحة عمل Business أو Enterprise في Lovable). يستخدم MonstarX المفتاح لتحميل القائمة فقط ولا يحفظه.
-
اختر مشروعك. لا يقدّم Lovable الشفرة عبر واجهة API الخاصة به، لذا يطلب MonstarX مستودع GitHub الذي يتزامن معه مشروعك في Lovable: في Lovable، افتح إعدادات المشروع ← Git → GitHub، واربطه عند الحاجة، ثم الصق عنوان المستودع.
-
اضغط فحص الشفرة، ثم استيراد وتشغيل.
ليس لديك مفتاح API؟ اختر ليس لديك مفتاح API؟ استخدم مستودع GitHub المتزامن والصق عنوان المستودع مباشرةً.
ماذا تعني النتائج؟
Section titled “ماذا تعني النتائج؟”| الشارة | العنوان | معناها |
|---|---|---|
| يعمل كما هو | «يعمل على MonstarX كما هو» | تطبيق Vite (أو تطبيق صُدّر من MonstarX ويعود إليه). يعمل ويُعدَّل ويُنشر على MonstarX. |
| يعمل كما هو · تنشره خدمة الاستضافة الخاصة بك | «يعمل على MonstarX ويُنشر لدى مزوّد الاستضافة» | تطبيق له خادمه الخاص: Next.js أو Remix أو Astro أو Nuxt أو SvelteKit أو Create React App. يعمل ويُعدَّل هنا، وتنشره من نشر ← Vercel، أو تحتفظ بخدمة الاستضافة الحالية بحفظ التغييرات في GitHub. |
| لا يمكن تشغيله هنا | «لا يستطيع MonstarX تشغيل هذا، لكنه يستطيع إعادة إنشائه» | تطبيق هاتف أو حاسوب، أو موقع HTML بسيط، أو موقع مبني بـ Django أو Rails أو Laravel أو Go وما شابهها. يستطيع MonstarX دراسته وإعادة إنشائه تطبيقَ ويب. |
| لا يمكن استيراده بعد | مثل «مكتبة، وليست تطبيقًا» أو «أكبر من أن يُستورد» | شيء لا يستطيع MonstarX تشغيله ولا إعادة إنشائه. توضّح الجملة السبب، وما الذي قد يغيّر النتيجة (غالبًا: استيراد المجلد الذي يضم التطبيق). |
تذكر كل نتيجة ما بُني به التطبيق، وحجمه، والمفاتيح (إعدادات مثل VITE_MAPBOX_TOKEN) التي يذكرها ملف البيئة النموذجي، دون قيمها أبدًا. وتظهر التحذيرات التي لا تمنع الاستيراد باللون الكهرماني: ملف .env مضاف إلى المستودع (لا يُنسخ، فمكان مفاتيحه الخدمات السحابية ← الأسرار)، أو خدمات تبدأ عبر Docker Compose، أو خادم API خاص به، أو ملفات في Git LFS، أو ملفات أكبر من 10 MB تُستبعد.
ماذا يحدث بعد الاستيراد؟
Section titled “ماذا يحدث بعد الاستيراد؟”تُفتح مساحة العمل مع بطاقة عمّا جرى استيراده، ويبدأ التطبيق في المعاينة (أول تشغيل يثبّت حزمه، وهذا يستغرق دقيقة أو اثنتين).
يسرد مفاتيحه كل إعداد تقرؤه الشفرة، مرتبًا بحسب حاجته الفعلية إليه: ضروري (الجزء الذي يقرؤه من التطبيق لا يعمل دونه)، واختياري (للشفرة بديل احتياطي)، وغير مستخدم. الصق قيمة واضغط إضافة، أو استخدم «…» عندما يقدّم ملف المشروع النموذجي قيمة، فيُعاد تشغيل المعاينة بها. وتُحفظ القيم مشفّرة في الخدمات السحابية ← الأسرار.
لا تعرف القيم؟ اضغط لا تعرف القيم؟ اسأل الأداة التي أُنشئ فيها المشروع لتحصل على رسالة تلصقها في الأداة التي جاء منها المشروع (في محادثة Lovable لمشروع من Lovable)، تطلب منها سرد كل مفتاح ومكان نسخه، دون تغيير أي شفرة.
وإذا لاحظ MonstarX مفتاحًا مكتوبًا مباشرةً في الشفرة، تذكر البطاقة نوعه وملفه (دون القيمة أبدًا)، وتضع المفاتيح السرية، كمفتاح Stripe السري أو مفتاح OpenAI، في الأعلى تحذيرًا.
ما الذي يعمل بعد الاستيراد؟
Section titled “ما الذي يعمل بعد الاستيراد؟”- المعاينة والمحادثة ووضع التحرير والإصدارات واختبارات QA تعمل كلها على شفرتك كما هي. يعمل MonstarX ضمن شفرة التطبيق وأنماطه، ويضيف أي حزمة يحتاجها تطبيقك.
- النشر: يُنشر تطبيق Vite على MonstarX مثل أي تطبيق آخر. أما التطبيق الذي له خادمه الخاص فتنشره خدمة الاستضافة الخاصة بك: من نشر ← Vercel، أو بالحفظ في GitHub حيث تلتقطه خدمة الاستضافة. راجع استضافات أخرى.
- التصدير يعطيك المستودع كما هو، بما فيه الصور.
- قاعدة بيانات MonstarX وحساباته لا تُضاف. يستمر التطبيق المستورد في استخدام ما تستخدمه شفرته (Supabase أو Firebase أو واجهة API خاصة به)، ويذكر الخدمات السحابية ← قاعدة البيانات ذلك. وتوضع المفاتيح التي يحتاجها في الخدمات السحابية ← الأسرار.
ما فرع monstarx؟
Section titled “ما فرع monstarx؟”عندما تستورد من GitHub بحسابك المرتبط وتملك صلاحية الإرسال إلى المستودع، يبقى المشروع مرتبطًا به. ينشئ MonstarX فرعًا باسم monstarx عند الـ commit الذي استوردته ويحفظ تغييراته فيه، ولا يتحرك فرعك الافتراضي أبدًا. افتح طلب دمج (pull request) من monstarx متى أردت نقل التغييرات إلى فرعك الرئيسي، وفي قائمة GitHub في المشروع رابط إلى صفحة المقارنة في GitHub. والتعديلات التي تُرسَل إلى ذلك الفرع على GitHub تعود إلى MonstarX أيضًا. راجع GitHub.
ماذا لو لم يستطع MonstarX تشغيل تطبيقي؟
Section titled “ماذا لو لم يستطع MonstarX تشغيل تطبيقي؟”لتطبيق هاتف (Expo أو React Native أو Flutter أو Swift أو Android)، أو تطبيق حاسوب، أو موقع مبني بـ Django أو Rails أو Laravel أو Go، تعرض النتيجة اقرأ شفرتي وخطّط لإعادة الإنشاء.
ينشئ MonstarX مشروعًا جديدًا، ويحتفظ بالشفرة الأصلية بجانبه (للقراءة فقط)، ويدرسها، ثم يقترح خطة إعادة الإنشاء: شاشاتها، وبياناتها، والقواعد في شفرتها، والخدمات التي تستخدمها ومصير كل منها (أُبقي أو استُبدل أو استُبعد)، وما لا يُنقل، والمنطق الذي يُنقل كما هو. قل ما هو خطأ فتُعدَّل الخطة، واضغط إنشاء لبدء الإنشاء. ويبقى الأصل على بُعد بحث واحد للرجوع إلى أي تفصيل. أما التطبيقات التي تعمل هنا فتعرض أعد الإنشاء على MonstarX بدلًا من ذلك، لمن يريد قاعدة بيانات MonstarX وحساباته ونشره.
ما أقصى حجم للتطبيق المستورد؟
Section titled “ما أقصى حجم للتطبيق المستورد؟”| الحد | القيمة |
|---|---|
| الشفرة | حتى 3,000 ملف و12 MB، و400 KB لكل ملف |
| الصور والملفات الأخرى | حتى 500 MB عند الاستيراد من ZIP (و100 MB من GitHub)، و10 MB لكل ملف |
| ملف .zip | حتى 500 MB قبل استبعاد التبعيات ونواتج البناء |
| إعادة الإنشاء | حتى 1,500 ملف و5 MB من الشفرة |
عند تجاوز حد ما، تذكر النتيجة الرقم والحد وطريقة الحل، وهي غالبًا استيراد المجلد الذي يضم التطبيق فقط.
الأسئلة الشائعة
Section titled “الأسئلة الشائعة”هل يغيّر الاستيراد مستودعي على GitHub؟
لا يغيّر فرعك الافتراضي. إذا كانت لديك صلاحية الإرسال، تذهب التغييرات إلى فرع monstarx، وإلا فالمستودع يُقرأ فقط.
هل يمكنني استيراد مستودع أحادي (monorepo)؟
نعم. يعثر MonstarX على المجلد الذي يضم التطبيق، ويتيح لك اختيار مجلد آخر من النتيجة.
هل يمكنني استيراد تطبيق صدّرته من MonstarX؟
نعم، فيعود مشروعًا كاملًا على MonstarX (بقاعدة بيانات جديدة فارغة، وتبقى بيانات التطبيق القديم في مكانها).
هل تشغيل الشفرة المستوردة آمن؟
تعمل على حاسوب سحابي آمن خاص بها، وتُثبَّت حزمها مع إيقاف نصوص التثبيت البرمجية.
هل يمكنني استيراد شفرة كتبها شخص آخر؟
فقط الشفرة التي تملك حق استخدامها. تعرض النتيجة ترخيص المستودع، أو تذكر أنه لم يُذكر ترخيص.