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

# استكشاف الأخطاء وإصلاحها

> خطوات عملية لحل تحديات التطوير الشائعة.

## عالق في "محاولة الإصلاح"

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

إليك دليل خطوة بخطوة لمساعدتك في حل هذه المشكلات والعودة إلى البناء:

<Steps>
  <Step title="استخدم زر 'محاولة الإصلاح' أولاً">
    عندما يظهر خطأ، يجب أن تكون خطوتك الأولى هي النقر على زر "محاولة الإصلاح". سيقوم Lumi بتحليل السجلات وتحديد المشكلة وتطبيق إصلاح سريع. إذا لم يحل هذا المشكلة، فقد حان الوقت للانتقال إلى الخطوة التالية.
  </Step>

  <Step title="تشخيص السلوك غير المتوقع">
    أحيانًا يعمل الكود الخاص بك دون أخطاء ولكنه لا يعمل كما هو مقصود. يُعرف هذا بالسلوك غير المتوقع وقد يكون من الصعب تصحيحه. إليك كيفية التعامل معه:

    * **مراجعة توجيهك:** تحقق مرة أخرى من تعليماتك الأصلية للتأكد من أنها كانت واضحة.
    * **عزل المشكلة:** افحص المكونات والمنطق الفردي لتحديد أين حدث الخطأ.
    * **توفير سياق مرئي:** استخدم لقطات الشاشة أو التسجيلات لتُظهر للذكاء الاصطناعي ما لا يعمل بالضبط.
  </Step>

  <Step title="كتابة توجيهات أكثر فعالية">
    التوجيهات الواضحة والمنظمة تنتج نتائج أفضل. اتبع هذا التنسيق للحصول على أفضل النتائج:

    * **نظرة عامة على المشروع:** صف بإيجاز ما تقوم ببنائه.
    * **هيكل الصفحة:** اذكر الصفحات والمكونات الرئيسية.
    * **منطق التنقل:** اشرح تدفق المستخدم المقصود.
    * **مساعدات بصرية:** قم بتحميل الإطارات الشبكية أو النماذج الأولية.
    * **خطوات التنفيذ:** حدد ترتيب البناء المطلوب.
  </Step>

  <Step title="البناء بترتيب منطقي">
    يمنع النهج المنظم للتطوير العديد من المشكلات الشائعة. اتبع سير العمل الموصى به هذا:

    1. إنشاء التخطيط الرئيسي والصفحات.
    2. ربط الواجهة الخلفية أو قاعدة البيانات الخاصة بك.
    3. إعداد مصادقة المستخدم والأدوار.
    4. تخطيط منطق كل ميزة.
    5. توجيه Lumi لتنفيذ الميزات واحدة تلو الأخرى.
  </Step>

  <Step title="استخدم وضع المناقشة (Discuss Mode) للإرشاد">
    إذا شعرت بأنك عالق، فانتقل إلى وضع المناقشة (Discuss Mode) للحصول على المساعدة:

    * اطلب من Lumi تحليل الحالة الحالية لمشروعك.
    * اطلب ملخصًا للحلول التي تمت تجربتها بالفعل.
    * اطلب استراتيجيات جديدة لمعالجة المشكلات المستمرة.
  </Step>

  <Step title="تطبيق تكتيكات متقدمة للأخطاء الصعبة">
    إذا استمرت المشكلة، جرب هذه التقنيات الأكثر تقدمًا:

    * **كن محددًا:** صف الخطأ بوضوح وما تتوقع حدوثه.
    * **استخدم المرئيات:** لقطات الشاشة أو تسجيلات الشاشة مفيدة بشكل لا يصدق لتوضيح المشكلات المعقدة.
    * **اطلب بدائل:** اسأل مباشرة، "ماذا يمكننا أن نجرب أيضًا؟" لتوليد أفكار جديدة.
    * **التراجع:** استعد مشروعك إلى إصدار سابق كان يعمل وأعد بناء الميزة التي بها مشكلة خطوة بخطوة.
  </Step>
</Steps>

## **مجالات استكشاف الأخطاء الشائعة**

تقع معظم المشكلات التي ستواجهها في إحدى الفئات التالية:

* أخطاء واجهة المستخدم والتخطيط
* أخطاء API أو الواجهة الخلفية
* سوء تفسير التوجيهات
* عدم استجابة الذكاء الاصطناعي أو أعطاله
* فشل المنصة أو التكامل

قم بتوسيع الأقسام أدناه لتحديد أعراض معينة والعثور على حلول عملية لكل منها.

### مشكلة عامة

<Accordion title="كيف يمكنني الحصول على تشخيص سريع لمشكلة ما؟">
  انتقل إلى وضع الدردشة (Chat Mode) واسأل: "هناك شيء لا يعمل بشكل صحيح. هل يمكنك شرح المشكلة وإخباري بما جربته بالفعل؟"
</Accordion>

<Accordion title="ماذا يجب أن أفعل لمشاكل واجهة المستخدم أو التخطيط؟">
  * افحص التسلسل الهرمي للمكونات وراجع الأنماط المطبقة.
  * استخدم لقطات الشاشة لتوضيح أي أخطاء بصرية بوضوح.
  * وجه Lumi مباشرة: "هذا العنصر غير محاذٍ. يرجى إصلاحه."
</Accordion>

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

<Accordion title="ماذا يعني 'خطأ في صندوق الرمل البرمجي' (code sandbox error)؟">
  يشير هذا إلى وجود مشكلة في المنصة ولا ينبغي أن يحدث. يرجى إبلاغ فريق الدعم لدينا على الفور.
</Accordion>

<Accordion title="ماذا يجب أن أفعل إذا رأيت رسالة 'لم يتم العثور على المعاينة' (Not found preview) أو 'جاري تشغيل صندوق الرمل' (spinning up sandbox)؟">
  أولاً، جرب تحديث المتصفح بقوة. إذا لم يتم حل المشكلة، يرجى الاتصال بالدعم للحصول على المساعدة.
</Accordion>

### موثوقية الذكاء الاصطناعي

<Accordion title="كيف يمكنني تجنب أخطاء الذكاء الاصطناعي عند هندسة التوجيهات؟">
  * اكتب توجيهات واضحة ومنظمة جيدًا.
  * استخدم تقنيات التوجيه الوصفي العكسي.
  * اختبر التوجيهات في وضع المناقشة (Discuss Mode) قبل تنفيذ تغييرات كبيرة.
</Accordion>

<Accordion title="ماذا يجب أن أفعل إذا كان الذكاء الاصطناعي لا يستجيب؟">
  هذه مشكلة غير متوقعة. يرجى إبلاغ فريق الدعم لدينا للحصول على مساعدة فورية.
</Accordion>

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

<Accordion title="ماذا يجب أن أفعل إذا تسببت إعادة الهيكلة في مشكلات كبيرة؟">
  نفذ التغييرات بشكل تدريجي. إذا استمرت المشاكل، فارجع إلى إصدار مستقر أو استخدم وضع المناقشة (Discuss Mode) لتصحيح الأخطاء.
</Accordion>

<Accordion title="ماذا لو دخل الذكاء الاصطناعي في حلقة خطأ، أو هلوس، أو استخدم منطقًا معطلاً؟">
  إذا واجهت حلقات خطأ أو منطقًا معيبًا، فارجع إلى إصدار مستقر. بعد ذلك، قدم سياقًا أكثر تحديدًا في توجيهك التالي، باستخدام المحرر المرئي أو عن طريق إرفاق ملف معرفي.
</Accordion>

<Accordion title="ماذا يمكنني أن أفعل إذا فشل الذكاء الاصطناعي في تنفيذ التغييرات التي طلبتها؟">
  قد يسيء الذكاء الاصطناعي تفسير طلبك أو يستهدف الملفات الخاطئة. قدم تعليمات محددة للغاية، أو قم بإجراء التعديلات يدويًا.
</Accordion>

<Accordion title="ماذا لو لم يستجب وضع المناقشة (Discuss Mode) أو وضع الوكيل (Agent Mode) أو أعطى إجابة غير مكتملة؟">
  هذه مشكلة غير متوقعة. يرجى إبلاغ فريق الدعم لدينا للحصول على مساعدة فورية.
</Accordion>

<Accordion title="ماذا يجب أن أفعل حيال الأعطال أو الأخطاء أو الحلقات غير المتوقعة؟">
  * تجنب إعادة محاولة نفس التوجيه بالضبط؛ بدلاً من ذلك، قم بتبسيطه أو إعادة صياغته.
  * اسأل الذكاء الاصطناعي: "ما الحلول التي جربناها بالفعل؟"
  * استعد إصدارًا سابقًا عاملاً من مشروعك.
</Accordion>