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/bg/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>'
  • Грешки при импортиране при стартиране на скриптове или тетрадки

Възможни причини:

  • Зависимостите не са инсталирани
  • Неправилна версия на 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 среда и създайте нова.
  2. Използвайте точни версии.
    Винаги изпълнявайте: 
    pip install -r requirements.txt
    Ако това не работи, ръчно инсталирайте липсващите пакети, както е описано в README.

Проблеми с конфигурацията

5. Променливите на средата не са зададени

Произход: Някои модули може да изискват ключове, токени или настройки за конфигурация.

Симптоми:

  • Грешка: 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. Стартирайте тетрадките на облачни платформи.
    Използвайте Google Colab или Azure Notebooks.

Проблеми с производителността

8. Тетрадките работят бавно

Произход: Някои AI задачи изискват значителна памет и CPU.

Симптоми:

  • Бавно изпълнение
  • Вентилаторът на лаптопа работи силно

Възможни причини:

  • Големи набори от данни или модели
  • Ограничени системни ресурси

Решения:

  1. Използвайте облачна платформа.
    • Качете тетрадката в Colab или Azure Notebooks.
  2. Намалете размера на набора от данни.
    • Използвайте примерни данни за практика.
  3. Затворете ненужни програми.
    • Освободете системната RAM.

Проблеми с уебсайта на учебника

9. Глава не се зарежда

Произход: Онлайн учебникът показва уроци и глави.

Симптоми:

  • Глава (например Transformers/BERT) липсва или не се отваря

Известен проблем:

  • Проблем #303: „18 Transformers. BERT. не може да се отвори на уебсайта на учебника.“ Причинено от грешка в името на файла (READMEtransformers.md вместо README.md).

Решения:

  1. Проверете за грешки при преименуване на файлове.
    Ако сте допринасящ, уверете се, че файловете на главите са именувани README.md.
  2. Докладвайте за липсващи файлове.
    Отворете GitHub проблем с името на главата и подробности за грешката.

Проблеми при допринасяне

10. PR не е приет или билдовете се провалят

Произход: Приносите трябва да преминат тестове и да следват указанията.

Симптоми:

  • Pull request е отхвърлен
  • Грешки в CI/CD pipeline

Възможни причини:

  • Провалени тестове
  • Неспазване на стандартите за кодиране

Решения:

  1. Прочетете указанията за допринасяне.
  2. Стартирайте тестовете локално преди да качите.
  3. Проверете за правила за форматиране или linting.

Често задавани въпроси

Къде мога да намеря помощ за конкретни модули?

  • Всеки модул обикновено има собствен README. Започнете оттам за съвети за настройка и използване.

Как да докладвам за грешка или да поискам нова функция?

Мога ли да поискам помощ, ако проблемът ми не е изброен?

  • Да! Потърсете съществуващи проблеми първо, и ако не намерите вашия проблем, създайте нов проблем.

Получаване на помощ

  • Проверете проблемите: GitHub Issues
  • Задавайте въпроси: Използвайте GitHub Discussions или отворете проблем.
  • Общност: Вижте връзките на хранилището за чат/форум опции.

Последна актуализация: 2025-09-20

Отказ от отговорност:
Този документ е преведен с помощта на AI услуга за превод Co-op Translator. Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за недоразумения или погрешни интерпретации, произтичащи от използването на този превод.