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/el/troubleshoot.md

13 KiB
Raw Blame History

Οδηγός Αντιμετώπισης Προβλημάτων για το AI-For-Beginners

Αυτός ο οδηγός σας βοηθά να επιλύσετε κοινά προβλήματα που προκύπτουν κατά τη χρήση ή τη συνεισφορά στο αποθετήριο AI-For-Beginners. Κάθε πρόβλημα περιλαμβάνει υπόβαθρο, συμπτώματα, εξηγήσεις και βήμα-βήμα λύσεις.

Πίνακας Περιεχομένων

Γενικά Προβλήματα

1. Το Αποθετήριο Δεν Κλωνοποιείται Σωστά

Υπόβαθρο: Η κλωνοποίηση σας επιτρέπει να αντιγράψετε το αποθετήριο στον υπολογιστή σας.

Συμπτώματα:

  • Σφάλμα: fatal: repository not found
  • Σφάλμα: Permission denied (publickey)

Πιθανές Αιτίες:

  • Λανθασμένο URL αποθετηρίου
  • Ανεπαρκή δικαιώματα
  • Μη διαμορφωμένα κλειδιά SSH

Λύσεις:

  1. Ελέγξτε το URL του αποθετηρίου.
    Χρησιμοποιήστε το HTTPS URL: 
    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>'
  • Σφάλματα εισαγωγής κατά την εκτέλεση scripts ή σημειωματάριων

Πιθανές Αιτίες:

  • Μη εγκατεστημένες εξαρτήσεις
  • Λανθασμένη έκδοση 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. Μη Ρυθμισμένες Μεταβλητές Περιβάλλοντος

Υπόβαθρο: Ορισμένα modules μπορεί να απαιτούν κλειδιά, tokens ή ρυθμίσεις.

Συμπτώματα:

  • Σφάλμα: KeyError ή προειδοποιήσεις για ελλείπουσα ρύθμιση

Πιθανές Αιτίες:

  • Απαιτούμενες μεταβλητές περιβάλλοντος δεν έχουν ρυθμιστεί

Λύσεις:

  1. Ελέγξτε για αρχεία .env.example ή παρόμοια.
  2. Δημιουργήστε ένα αρχείο .env και συμπληρώστε τις απαιτούμενες τιμές.
  3. Επαναφορτώστε το τερματικό ή το IDE μετά τη ρύθμιση των μεταβλητών περιβάλλοντος.

Εκτέλεση Σημειωματάριων

6. Το Σημειωματάριο Δεν Ανοίγει ή Δεν Εκτελείται

Υπόβαθρο: Τα σημειωματάρια Jupyter χρειάζονται σωστή ρύθμιση.

Συμπτώματα:

  • Το σημειωματάριο δεν ανοίγει
  • Ο περιηγητής δεν ανοίγει αυτόματα

Πιθανές Αιτίες:

  • Το Jupyter δεν είναι εγκατεστημένο
  • Προβλήματα ρύθμισης περιηγητή

Λύσεις:

  1. Εγκαταστήστε το Jupyter (δείτε Προβλήματα Εγκατάστασης παραπάνω).
  2. Ανοίξτε τα σημειωματάρια χειροκίνητα.
    • Αντιγράψτε το URL από το τερματικό (π.χ., http://localhost:8888/?token=...) και επικολλήστε το στον περιηγητή σας.

7. Κατάρρευση ή Πάγωμα Πυρήνα

Υπόβαθρο: Οι πυρήνες σημειωματάριων μπορεί να καταρρεύσουν λόγω ορίων πόρων ή σφαλμάτων κώδικα.

Συμπτώματα:

  • Ο πυρήνας πεθαίνει ή επανεκκινείται επανειλημμένα
  • Σφάλματα μνήμης

Πιθανές Αιτίες:

  • Μεγάλα σύνολα δεδομένων
  • Ασυμβίβαστος κώδικας ή πακέτα

Λύσεις:

  1. Επανεκκινήστε τον πυρήνα.
    Χρησιμοποιήστε το κουμπί "Restart Kernel" στο Jupyter.
  2. Ελέγξτε τη χρήση μνήμης.
    Κλείστε αχρησιμοποίητες εφαρμογές.
  3. Εκτελέστε σημειωματάρια σε πλατφόρμες cloud.
    Χρησιμοποιήστε Google Colab ή Azure Notebooks.

Προβλήματα Απόδοσης

8. Τα Σημειωματάρια Εκτελούνται Αργά

Υπόβαθρο: Ορισμένες εργασίες AI απαιτούν σημαντική μνήμη και CPU.

Συμπτώματα:

  • Αργή εκτέλεση
  • Ο ανεμιστήρας του laptop λειτουργεί έντονα

Πιθανές Αιτίες:

  • Μεγάλα σύνολα δεδομένων ή μοντέλα
  • Περιορισμένοι πόροι συστήματος

Λύσεις:

  1. Χρησιμοποιήστε μια πλατφόρμα cloud.
    • Ανεβάστε το σημειωματάριο στο Colab ή Azure Notebooks.
  2. Μειώστε το μέγεθος του συνόλου δεδομένων.
    • Χρησιμοποιήστε δείγματα δεδομένων για εξάσκηση.
  3. Κλείστε περιττά προγράμματα.
    • Ελευθερώστε RAM συστήματος.

Προβλήματα Ιστοσελίδας Βιβλίου

9. Το Κεφάλαιο Δεν Φορτώνει

Υπόβαθρο: Το online βιβλίο εμφανίζει μαθήματα και κεφάλαια.

Συμπτώματα:

  • Ένα κεφάλαιο (π.χ., Transformers/BERT) λείπει ή δεν ανοίγει

Γνωστό Πρόβλημα:

  • Πρόβλημα #303: “18 Transformers. BERT. δεν μπορεί να ανοίξει στην ιστοσελίδα του βιβλίου.” Προκαλείται από σφάλμα ονόματος αρχείου (READMEtransformers.md αντί για README.md).

Λύσεις:

  1. Ελέγξτε για σφάλματα μετονομασίας αρχείων.
    Αν είστε συνεισφέρων, βεβαιωθείτε ότι τα αρχεία κεφαλαίων ονομάζονται README.md.
  2. Αναφέρετε ελλείποντα αρχεία.
    Ανοίξτε ένα ζήτημα στο GitHub με το όνομα του κεφαλαίου και λεπτομέρειες σφάλματος.

Προβλήματα Συνεισφοράς

10. Το PR Δεν Εγκρίνεται ή Οι Δοκιμές Αποτυγχάνουν

Υπόβαθρο: Οι συνεισφορές πρέπει να περάσουν δοκιμές και να ακολουθούν οδηγίες.

Συμπτώματα:

  • Το pull request απορρίπτεται
  • Σφάλματα στον CI/CD pipeline

Πιθανές Αιτίες:

  • Αποτυχημένες δοκιμές
  • Μη τήρηση προτύπων κώδικα

Λύσεις:

  1. Διαβάστε τις οδηγίες συνεισφοράς.
    • Ακολουθήστε το CONTRIBUTING.md του αποθετηρίου.
  2. Εκτελέστε δοκιμές τοπικά πριν την αποστολή.
  3. Ελέγξτε για κανόνες linting ή απαιτήσεις μορφοποίησης.

Συχνές Ερωτήσεις

Πού μπορώ να βρω βοήθεια για συγκεκριμένα modules;

  • Κάθε module συνήθως έχει το δικό του README. Ξεκινήστε από εκεί για οδηγίες ρύθμισης και χρήσης.

Πώς αναφέρω ένα σφάλμα ή ζητώ μια νέα δυνατότητα;

Μπορώ να ζητήσω βοήθεια αν το πρόβλημά μου δεν περιλαμβάνεται;

  • Ναι! Αναζητήστε υπάρχοντα ζητήματα πρώτα, και αν δεν βρείτε το πρόβλημά σας, δημιουργήστε ένα νέο ζήτημα.

Λήψη Βοήθειας

  • Ελέγξτε Ζητήματα: GitHub Issues
  • Κάντε Ερωτήσεις: Χρησιμοποιήστε τις Συζητήσεις GitHub ή ανοίξτε ένα ζήτημα.
  • Κοινότητα: Δείτε τους συνδέσμους του αποθετηρίου για επιλογές συνομιλίας/φόρουμ.

Τελευταία Ενημέρωση: 2025-09-20

Αποποίηση ευθύνης:
Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία μετάφρασης AI Co-op Translator. Παρόλο που καταβάλλουμε προσπάθειες για ακρίβεια, παρακαλούμε να έχετε υπόψη ότι οι αυτοματοποιημένες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα θα πρέπει να θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε ευθύνη για τυχόν παρεξηγήσεις ή εσφαλμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης.