قراءة سجلّ البناء
عند فشل البناء، يظهر شريط أحمر في شاشة البناء يحتوي على رابط عرض السجلّ. ينقسم سجلّ البناء إلى ثلاث مراحل — ومعرفة المرحلة التي فشلت تخبرك على الفور بالموضع الذي يجب التركيز عليه:
1
مرحلة المواصفات
تفسّر مايندلاب مطالبتك وتنتج مواصفة مُهيكلة. تعني الإخفاقات هنا أن المطالبة كانت غير واضحة أو متناقضة أو طلبت شيئًا خارج حزمة التقنيات المدعومة في مايندلاب.
2
مرحلة توليد الشيفرة
يولّد الذكاء الاصطناعي شيفرة الواجهة الأمامية والخلفية وملفات الترحيل كاملةً. تنتج الإخفاقات هنا عادةً عن تعارض في الاعتماديات، أو مزيج مكتبات غير مدعوم، أو ميزة بالغة التعقيد تجاوزت سياق التوليد.
3
مرحلة النشر
يُبنى الكود المُولَّد داخل حاوية، وتُطبَّق ملفات الترحيل، ويُشغَّل التطبيق. الإخفاقات هنا هي أخطاء وقت التشغيل — تعارضات في المنافذ، أو أخطاء ترحيل قاعدة البيانات، أو متغيرات بيئة مفقودة، أو تعطّل عند بدء التشغيل.
تظهر كل مرحلة كقسم قابل للطيّ في السجلّ. تُوسَّع المرحلة الفاشلة تلقائيًا ويُبرَز أول سطر خطأ فيها.
إخفاقات مرحلة المواصفات
تنتج إخفاقات المواصفات دائمًا عن المطالبة. الأنماط الشائعة وطرق إصلاحها:
1
مطالبة غامضة أو متناقضة
مثال: "استخدم كلًّا من PostgreSQL وMongoDB لمخزن البيانات الرئيسي". الإصلاح: اختَر واحدًا. أعد كتابة المطالبة لتحديد قاعدة بيانات واحدة لكل فئة بيانات.
2
تقنية غير مدعومة
مثال: "استخدم Svelte للواجهة الأمامية". تولّد مايندلاب تطبيقات React + FastAPI + PostgreSQL. طلب إطار عمل مختلف يسبّب إخفاق المواصفات. استخدم ميزة التصدير كملف ZIP وعدّل الكود يدويًا إذا احتجت إلى حزمة تقنيات مختلفة.
3
مطالبة مبهمة للغاية
مثال: "ابنِ شيئًا بالذكاء الاصطناعي". أضف تفاصيل — أيّ نوع من ميزات الذكاء الاصطناعي، وعلى أيّ بيانات يعمل، وكيف يبدو تفاعل المستخدم.
💡نصيحة.الإصلاح الأكثر شيوعًا لأيّ بناء فاشل هو توضيح المطالبة. انسخ المطالبة الفاشلة، وأضف جملة تشرح ما الذي لم ينجح أو ما الذي قصدته فعلًا، ثم أعد البناء.
إخفاقات توليد الشيفرة
إخفاقات توليد الشيفرة أقل شيوعًا لكنها قد تحدث في مواقف محدّدة:
1
تعارض الاعتماديات
تتطلّب مكتبتان مطلوبتان إصدارين غير متوافقين من اعتمادية مشتركة. سيذكر السجلّ الحزم المتعارضة. حاول إزالة إحداها أو استبدالها في مطالبة لاحقة.
2
مزيج حزمة تقنيات غير مدعوم
بعض مجموعات الميزات لها حالات عدم توافق معروفة (مثل مكتبات معيّنة للزمن الحقيقي إلى جانب أنماط مصادقة محدّدة). ستقترح رسالة الخطأ في السجلّ نهجًا بديلًا.
3
تجاوز سياق التوليد
المطالبات الضخمة المعقّدة التي تطلب عشرات الميزات في بناء واحد قد تتجاوز سياق التوليد. قسّم البناء إلى عدة مطالبات — ابدأ بنموذج البيانات الأساسي والمصادقة، ثم أضف الميزات تدريجيًا.
إخفاقات مرحلة النشر
تحدث إخفاقات النشر بعد نجاح توليد الشيفرة. الكود المُولَّد صحيح، لكن حدث خطأ ما أثناء وقت التشغيل:
1
تعارض المنافذ
خدمة أخرى مرتبطة بالفعل بالمنفذ المتوقَّع. هذا نادر في بيئة مايندلاب المُدارة لكنه قد يحدث إذا كانت لديك عدة مشاريع على خطة استضافة ذاتية.
2
خطأ في ترحيل قاعدة البيانات
يحتوي ملف ترحيل على خطأ SQL، أو يحاول ملف ترحيل تطبيق تغيير يتعارض مع المخطّط الحالي. سيعرض السجلّ عبارة SQL المحدّدة التي فشلت.
3
تعطّل الحاوية عند بدء التشغيل
بدأ التطبيق لكنه خرج على الفور — عادةً بسبب متغير بيئة مفقود أو خطأ في الاستيراد. تحقّق من سجلّات الحاوية بحثًا عن تتبّع Python أو خطأ Node.js.
فحص سجلّات الحاوية
بالنسبة لإخفاقات مرحلة النشر، تمنحك سجلّات الحاوية الخرج الخام للعملية — تفاصيل أكثر من سجلّ البناء المُهيكل. يمكنك الوصول إليها من واجهة سطر أوامر مايندلاب (CLI):
bash
# Install the Myndlab CLI (once)
npm install -g @myndlab/cli
# Authenticate
myndlab login
# Stream container logs for your project
myndlab logs --project <your-project-slug> --tail 100
يمكنك أيضًا عرض آخر ٢٠٠ سطر من السجلّ في المتصفح بفتح شاشة البناء، والنقر على قائمة النقاط الثلاث في الشريط العلوي، واختيار سجلّات الحاوية.
زرّ إعادة المحاولة التلقائية
بعد فشل البناء، تحلّل مايندلاب الخطأ — وإذا توفّر لديها إصلاح عالي الثقة — تعرض شريط الإصلاح المقترح أعلى سجلّ البناء. يصف الشريط التغيير المقترح بلغة مبسّطة. انقر على تطبيق الإصلاح وإعادة المحاولة للسماح لمايندلاب بتعديل الكود المُولَّد وإعادة تشغيل مرحلة النشر دون استهلاك رصيد إضافي.
تعمل آلية إعادة المحاولة التلقائية مرة واحدة لكل بناء فاشل. إذا فشلت إعادة المحاولة أيضًا، فستحتاج إلى مراجعة المطالبة يدويًا أو التواصل مع الدعم.