RomanNum3ral
/
AI-For-Beginners
mirror of https://github.com/microsoft/AI-For-Beginners.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
AI-For-Beginners/translations/ar/troubleshoot.md

11 KiB
Raw Blame History

دليل استكشاف الأخطاء وإصلاحها للمبتدئين في الذكاء الاصطناعي

يساعدك هذا الدليل في حل المشكلات الشائعة التي قد تواجهها أثناء استخدام أو المساهمة في مستودع AI-For-Beginners. يتضمن كل مشكلة خلفية، أعراض، تفسيرات، وحلول خطوة بخطوة.

جدول المحتويات

مشكلات عامة

1. المستودع لا يتم نسخه بشكل صحيح

الخلفية: النسخ يسمح لك بنقل المستودع إلى جهازك.

الأعراض:

  • خطأ: fatal: repository not found
  • خطأ: Permission denied (publickey)

الأسباب المحتملة:

  • عنوان URL للمستودع غير صحيح
  • عدم وجود أذونات كافية
  • مفاتيح SSH غير مهيأة

الحلول:

  1. تحقق من عنوان URL للمستودع.
    استخدم عنوان HTTPS: 
    git clone https://github.com/microsoft/AI-For-Beginners.git
  2. استخدم HTTPS إذا فشل SSH.
    إذا رأيت Permission denied (publickey)، استخدم الرابط HTTPS أعلاه بدلاً من SSH.
  3. تهيئة مفاتيح SSH (اختياري).
    إذا كنت ترغب في استخدام SSH، اتبع دليل SSH الخاص بـ GitHub.

مشكلات التثبيت

2. مشكلات بيئة Python

الخلفية: يعتمد المستودع على Python ومكتبات مختلفة.

الأعراض:

  • خطأ: ModuleNotFoundError: No module named '<package>'
  • أخطاء استيراد عند تشغيل البرامج النصية أو دفاتر الملاحظات

الأسباب المحتملة:

  • عدم تثبيت التبعيات
  • إصدار Python غير صحيح

الحلول:

  1. إعداد بيئة افتراضية. 
    python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate
  2. تثبيت التبعيات. 
    pip install -r requirements.txt
  3. التحقق من إصدار Python.
    استخدم Python 3.7 أو أحدث. 
    python --version

3. Jupyter غير مثبت

الخلفية: دفاتر الملاحظات هي مورد تعليمي أساسي.

الأعراض:

  • خطأ: jupyter: command not found
  • دفاتر الملاحظات تفشل في التشغيل

الأسباب المحتملة:

  • عدم تثبيت Jupyter

الحلول:

  1. تثبيت Jupyter Notebook. 
    pip install notebook
    أو، إذا كنت تستخدم Anaconda: 
    conda install notebook
  2. تشغيل Jupyter Notebook. 
    jupyter notebook

4. تعارض إصدارات التبعيات

الخلفية: يمكن أن تتعطل المشاريع إذا كانت إصدارات الحزم غير متطابقة.

الأعراض:

  • أخطاء أو تحذيرات حول الإصدارات غير المتوافقة

الأسباب المحتملة:

  • حزم Python قديمة أو متعارضة

الحلول:

  1. التثبيت في بيئة نظيفة.
    احذف venv/conda env القديمة وأنشئ واحدة جديدة.
  2. استخدام الإصدارات الدقيقة.
    قم دائمًا بتشغيل: 
    pip install -r requirements.txt
    إذا فشل هذا، قم بتثبيت الحزم المفقودة يدويًا كما هو موضح في README.

مشكلات التكوين

5. عدم إعداد متغيرات البيئة

الخلفية: قد تتطلب بعض الوحدات مفاتيح، رموز، أو إعدادات تكوين.

الأعراض:

  • خطأ: KeyError أو تحذيرات حول تكوين مفقود

الأسباب المحتملة:

  • عدم إعداد متغيرات البيئة المطلوبة

الحلول:

  1. التحقق من ملفات .env.example أو ملفات مشابهة.
  2. إنشاء ملف .env وملء القيم المطلوبة.
  3. إعادة تحميل الطرفية أو بيئة التطوير بعد إعداد متغيرات البيئة.

تشغيل دفاتر الملاحظات

6. دفتر الملاحظات لا يفتح أو يعمل

الخلفية: دفاتر Jupyter تحتاج إلى إعداد صحيح.

الأعراض:

  • دفتر الملاحظات يفشل في التشغيل
  • المتصفح لا يفتح تلقائيًا

الأسباب المحتملة:

  • عدم تثبيت Jupyter
  • مشكلات في إعداد المتصفح

الحلول:

  1. تثبيت Jupyter (راجع مشكلات التثبيت أعلاه).
  2. فتح دفاتر الملاحظات يدويًا.
    • انسخ الرابط من الطرفية (مثل http://localhost:8888/?token=...) والصقه في المتصفح.

7. تعطل أو تجميد النواة

الخلفية: يمكن أن تتعطل نواة دفاتر الملاحظات بسبب حدود الموارد أو أخطاء في الكود.

الأعراض:

  • النواة تتوقف أو تعيد التشغيل بشكل متكرر
  • أخطاء نفاد الذاكرة

الأسباب المحتملة:

  • مجموعات بيانات كبيرة
  • كود أو حزم غير متوافقة

الحلول:

  1. إعادة تشغيل النواة.
    استخدم زر "Restart Kernel" في Jupyter.
  2. التحقق من استخدام الذاكرة.
    أغلق التطبيقات غير المستخدمة.
  3. تشغيل دفاتر الملاحظات على منصات السحابة.
    استخدم Google Colab أو Azure Notebooks.

مشكلات الأداء

8. دفاتر الملاحظات تعمل ببطء

الخلفية: تتطلب بعض مهام الذكاء الاصطناعي ذاكرة ووحدة معالجة مركزية كبيرة.

الأعراض:

  • تنفيذ بطيء
  • صوت مروحة الكمبيوتر المحمول مرتفع

الأسباب المحتملة:

  • مجموعات بيانات أو نماذج كبيرة
  • موارد النظام محدودة

الحلول:

  1. استخدام منصة سحابية.
    • قم برفع دفتر الملاحظات إلى Colab أو Azure Notebooks.
  2. تقليل حجم مجموعة البيانات.
    • استخدم بيانات عينة للتدريب.
  3. إغلاق البرامج غير الضرورية.
    • تحرير ذاكرة النظام.

مشكلات موقع الكتاب الإلكتروني

9. الفصل لا يتم تحميله

الخلفية: يعرض الكتاب الإلكتروني الدروس والفصول.

الأعراض:

  • فصل (مثل Transformers/BERT) مفقود أو لا يفتح

المشكلة المعروفة:

  • Issue #303: "18 Transformers. BERT. can't be opened on the textbook website." بسبب خطأ في اسم الملف (READMEtransformers.md بدلاً من README.md).

الحلول:

  1. التحقق من أخطاء إعادة تسمية الملفات.
    إذا كنت مساهمًا، تأكد من أن ملفات الفصل مسماة README.md.
  2. الإبلاغ عن الملفات المفقودة.
    افتح مشكلة على GitHub مع اسم الفصل وتفاصيل الخطأ.

مشكلات المساهمة

10. PR غير مقبول أو فشل البناء

الخلفية: يجب أن تمر المساهمات بالاختبارات وتتبع الإرشادات.

الأعراض:

  • رفض طلب السحب
  • أخطاء في خط أنابيب CI/CD

الأسباب المحتملة:

  • فشل الاختبارات
  • عدم اتباع معايير الترميز

الحلول:

  1. قراءة إرشادات المساهمة.
  2. تشغيل الاختبارات محليًا قبل الدفع.
  3. التحقق من قواعد التنسيق أو متطلبات التنسيق.

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

أين يمكنني العثور على مساعدة لوحدات معينة؟

  • عادةً ما تحتوي كل وحدة على ملف README خاص بها. ابدأ من هناك للحصول على نصائح الإعداد والاستخدام.

كيف يمكنني الإبلاغ عن خطأ أو طلب ميزة؟

هل يمكنني طلب المساعدة إذا لم تكن مشكلتي مدرجة؟

  • نعم! ابحث أولاً في المشكلات الموجودة، وإذا لم تجد مشكلتك، قم بإنشاء مشكلة جديدة.

الحصول على المساعدة

  • التحقق من المشكلات: مشكلات GitHub
  • طرح الأسئلة: استخدم مناقشات GitHub أو افتح مشكلة.
  • المجتمع: راجع روابط المستودع للحصول على خيارات الدردشة/المنتدى.

آخر تحديث: 20-09-2025

إخلاء المسؤولية:
تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي. للحصول على معلومات حاسمة، يُوصى بالترجمة البشرية الاحترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسير خاطئ ينشأ عن استخدام هذه الترجمة.