============================================
  MuraveyChina — Решение проблем
  (Все известные проблемы и решения)
============================================


  1. БЕЗОПАСНОСТЬ WINDOWS БЛОКИРУЕТ ПРОГРАММУ
  ────────────────────────────────────────────

  ПРОБЛЕМА: SmartScreen пишет "Система Windows защитила ваш ПК"
  РЕШЕНИЕ:
    1. Нажмите "Подробнее"
    2. Нажмите "Выполнить в любом случае"

  ПРОБЛЕМА: Smart App Control блокирует (Windows 11)
  РЕШЕНИЕ:
    1. Откройте Параметры Windows (Win + I)
    2. Конфиденциальность → Безопасность Windows → Открыть
    3. Управление приложениями → Параметры Smart App Control
    4. Выберите "Выключено" → Подтвердите "Да"

  ПРОБЛЕМА: Защитник Windows удаляет файлы
  РЕШЕНИЕ:
    1. Откройте Безопасность Windows
    2. Защита от вирусов → Управление настройками
    3. Прокрутите до Исключения → Добавить исключение
    4. Папка → выберите папку MuraveyChina
    5. ТАКЖЕ добавьте папку Python:
       C:\Users\ВашеИмя\AppData\Local\Programs\Python\

  ПРОБЛЕМА: INSTALL.bat не запускается
  РЕШЕНИЕ:
    1. Правый клик на INSTALL.bat → Свойства
    2. Внизу поставьте галочку "Разблокировать"
    3. Нажмите ОК
    4. Попробуйте снова


  2. ПРОБЛЕМЫ С PYTHON
  ────────────────────

  ПРОБЛЕМА: "python не является командой"
  РЕШЕНИЕ:
    Переустановите Python с python.org
    ВАЖНО: Поставьте галочку "Add Python to PATH"!

  ПРОБЛЕМА: Неправильная версия Python
  РЕШЕНИЕ:
    Нужен Python 3.10 или выше. Проверьте:
    python --version
    Если ниже 3.10 — переустановите

  ПРОБЛЕМА: Установлено несколько версий Python
  РЕШЕНИЕ:
    Используйте правильную:
    py -3.11 launch.py
    Или удалите старые версии


  3. ПРОБЛЕМЫ СО СКАЧИВАНИЕМ МОДЕЛЕЙ
  ───────────────────────────────────

  ПРОБЛЕМА: Скачивание зависло или очень медленное
  РЕШЕНИЕ:
    - Проверьте интернет
    - Модели ~6.6 ГБ, нужен стабильный интернет
    - Запустите INSTALL.bat ещё раз — продолжит скачивание

  ПРОБЛЕМА: "SSL error" при скачивании
  РЕШЕНИЕ:
    - Ваша сеть может блокировать huggingface.co
    - Используйте VPN или другую сеть
    - Или скачайте модели вручную через браузер
    - Положите файлы в: %USERPROFILE%\.muravey-china\models\

  ПРОБЛЕМА: "Model not found" при запуске
  РЕШЕНИЕ:
    Проверьте что файлы на месте:
    dir "%USERPROFILE%\.muravey-china\models\qwen25vl\"
    Должны быть 2 файла (~1.8 ГБ и ~1.2 ГБ)

  ПРОБЛЕМА: Модель скачалась не полностью
  РЕШЕНИЕ:
    Удалите и скачайте заново:
    del "%USERPROFILE%\.muravey-china\models\qwen25vl\*.gguf"
    del "%USERPROFILE%\.muravey-china\models\*.gguf"
    Запустите INSTALL.bat снова


  4. ПРОБЛЕМЫ С llama-cpp-python
  ──────────────────────────────

  ПРОБЛЕМА: "Failed building wheel for llama-cpp-python"
  РЕШЕНИЕ:
    Сначала установите Visual Studio Build Tools:
    https://visualstudio.microsoft.com/visual-cpp-build-tools/
    Выберите "Разработка классических приложений на C++"
    Потом запустите INSTALL.bat снова

  ПРОБЛЕМА: "RuntimeError: Failed to load ggml"
  РЕШЕНИЕ:
    Переустановите:
    pip uninstall llama-cpp-python -y
    set CMAKE_ARGS=-DGGML_CUDA=OFF
    pip install llama-cpp-python==0.3.19 --no-cache-dir

  ПРОБЛЕМА: GPU версия не работает
  РЕШЕНИЕ:
    Программа работает и на CPU. Просто медленнее.
    Для GPU нужно:
    1. Видеокарта NVIDIA
    2. CUDA Toolkit: developer.nvidia.com/cuda-downloads
    3. Добавить в PATH: C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v13.0\bin\x64


  5. ПРОБЛЕМЫ С АКТИВАЦИЕЙ
  ────────────────────────

  ПРОБЛЕМА: Окно активации не появляется
  РЕШЕНИЕ:
    Machine ID ТАКЖЕ показывается в консоли (чёрное окно).
    Посмотрите там. Или запустите вручную:
    1. Откройте cmd
    2. cd /d папку установки
    3. python launch.py
    4. Machine ID появится в консоли

  ПРОБЛЕМА: Токен не принимается
  РЕШЕНИЕ:
    - Скопируйте ВЕСЬ токен (начинается с MC-v1-)
    - Токен действует только 24 часа
    - Токен привязан к ОДНОМУ компьютеру
    - Убедитесь что нет лишних пробелов

  ПРОБЛЕМА: "Error: Token expired"
  РЕШЕНИЕ:
    Купите новый токен на license.muravey.app/buy

  ПРОБЛЕМА: "Error: Machine ID mismatch"
  РЕШЕНИЕ:
    Токен создан для другого компьютера.
    Нужен токен для ВАШЕГО Machine ID.


  6. ПРОБЛЕМЫ С ГОРЯЧИМИ КЛАВИШАМИ
  ─────────────────────────────────

  ПРОБЛЕМА: Ctrl+` не работает
  РЕШЕНИЕ:
    1. Убедитесь что программа запущена (иконка в трее)
    2. Запустите от администратора:
       Правый клик на ярлык → Запуск от имени администратора
    3. Если внутри CSCA — подождите 5 секунд

  ПРОБЛЕМА: Клавиши работают через раз
  РЕШЕНИЕ:
    - Не нажимайте клавиши много раз подряд
    - Дождитесь "..." перед повторным нажатием
    - Если программа обрабатывает запрос — она игнорирует повторы

  ПРОБЛЕМА: Старая комбинация (Ctrl+Shift+F7) не работает
  РЕШЕНИЕ:
    Новая комбинация: Ctrl+`
    Удалите старый конфиг:
    del "%APPDATA%\MuraveyChina\config.yaml"
    Перезапустите программу


  7. ПРОБЛЕМЫ С ПРОИЗВОДИТЕЛЬНОСТЬЮ
  ──────────────────────────────────

  ПРОБЛЕМА: Ответ приходит дольше 2 минут
  РЕШЕНИЕ:
    Первый вопрос всегда медленный (загрузка модели).
    Дальше будет 15-50 секунд.
    Если всегда медленно — нет GPU (режим CPU).

  ПРОБЛЕМА: "..." показывается бесконечно
  РЕШЕНИЕ:
    - Первый раз: подождите до 2 минут
    - Если зависло: нажмите Ctrl+C в консоли, перезапустите
    - Проверьте что модели скачались полностью

  ПРОБЛЕМА: ".." появляется (ошибка)
  РЕШЕНИЕ:
    - Увеличьте шрифт на экране
    - Убедитесь что весь вопрос виден
    - Попробуйте нажать Ctrl+` ещё раз


  8. ПРОБЛЕМЫ С CSCA / ЭКЗАМЕНАЦИОННЫМ ПО
  ─────────────────────────────────────────

  ПРОБЛЕМА: Клавиши не работают внутри CSCA
  РЕШЕНИЕ:
    Запустите от администратора:
    Правый клик на cmd → Запуск от имени администратора
    Затем: cd /d папку установки && python launch.py

  ПРОБЛЕМА: Сеть заблокирована внутри CSCA
  РЕШЕНИЕ:
    Это нормально. Программа работает ОФЛАЙН.
    Интернет во время экзамена НЕ нужен.

  ПРОБЛЕМА: Программа закрывается когда CSCA запускается
  РЕШЕНИЕ:
    Запустите MuraveyChina ДО открытия CSCA.


  9. ПРОБЛЕМЫ С КЕШЕМ
  ────────────────────

  ПРОБЛЕМА: Программа работает неправильно после обновления
  РЕШЕНИЕ:
    Очистите кеш:
    cd /d папку установки
    for /r %d in (__pycache__) do @if exist "%d" rd /s /q "%d"
    del "%APPDATA%\MuraveyChina\config.yaml"
    Перезапустите программу


  10. ПРОБЛЕМЫ С КОДИРОВКОЙ
  ─────────────────────────

  ПРОБЛЕМА: Китайский текст показывается как "???"
  РЕШЕНИЕ:
    Запустите cmd с UTF-8:
    chcp 65001
    Затем: python launch.py


============================================
  ПОЛНЫЙ СБРОС (если ничего не помогает)
============================================

  1. Полностью удалите Python
  2. Удалите папки:
     - папку установки (или где распаковали)
     - %APPDATA%\MuraveyChina\
     - %USERPROFILE%\.muravey-china\
  3. Переустановите Python 3.11 (галочка "Add to PATH"!)
  4. Распакуйте свежий MuraveyChina.zip
  5. Сначала выполните гайд ANTIVIRUS_SETUP
  6. Запустите INSTALL.bat
  7. Активируйте токеном

============================================
