Перейти к основному содержимому

Устранение неполадок

На этой странице в формате «вопрос — ответ» собраны решения частых проблем установки и запуска. Если вашей проблемы здесь нет, соберите относящиеся к делу строки логов и откройте issue в репозитории GitHub.

Почему приложение сообщает, что порт уже занят?​

Локальный backend по умолчанию слушает 127.0.0.1:8000. Если этот порт занят другой программой, sidecar не может запуститься. Закройте программу, занимающую порт, или запустите сервер с другим портом, задав переменную окружения NEOTA_PORT. Сообщение об ошибке в приложении содержит номер порта и сведения, необходимые для устранения конфликта.

Backend-sidecar не запускается​

Десктопное приложение запускает свой backend как встроенный sidecar на Node.js. Если он не запускается, окно приложения показывает ошибку соединения. Проверьте следующее:

  • Возможно, уже запущен другой экземпляр NeoTavern, удерживающий порт.
  • Каталог данных может быть недоступен для записи в текущем расположении.
  • Антивирус или брандмауэр может блокировать встроенный рантайм Node.

После устранения причины перезапустите приложение. Если приложение входит в цикл сбоев, оно предлагает запуск в безопасном режиме, который отключает сторонние плагины и темы до их загрузки, — воспользуйтесь им для восстановления.

База данных заблокирована​

NeoTavern использует SQLite с режимом WAL и таймаутом ожидания, поэтому кратковременный конкурентный доступ ожидаем и обрабатывается. Постоянная ошибка «database is locked» обычно означает, что второй экземпляр приложения открыл тот же каталог данных или всё ещё выполняется операция резервного копирования или импорта. Закройте дублирующиеся экземпляры и дождитесь завершения длительных операций, прежде чем повторять попытку.

Как очистить кэши?​

Кэши находятся в data/cache/ и полностью пересоздаваемы: миниатюры, данные токенизаторов и загрузки зависимостей плагинов. Очистка кэша никогда не удаляет ваши оригиналы, которые хранятся отдельно в data/files/. Используйте элементы обслуживания в Settings → Data для очистки кэшей и пересборки индекса полнотекстового поиска. Оба действия перед выполнением подтверждают количество и размер того, что будет удалено.

Где находятся логи?​

Логи записываются в data/logs/server.log и ротируются при 10 МБ. Файл лога редактируется: секреты, API-ключи и содержимое пользовательских сообщений никогда не логируются. Вывод консоли сохраняется рядом с файлом. Сообщая об ошибке, включайте соответствующие строки логов и trace ID, показанный в деталях ошибки.

Как вернуться к рабочему интерфейсу?​

Используйте безопасный режим: он доступен до загрузки сторонних тем и плагинов и отключает их. После сломанной темы или плагина безопасный режим восстанавливает встроенный интерфейс без ручного редактирования файлов. Подробности см. в разделах Темы и Расширения.

Почему кнопка отправки неактивна?​

Кнопка неактивна только при наличии конкретной причины, которая объясняется рядом с ней, — чаще всего это отсутствие активного провайдера или выбранного персонажа. Подключите провайдера в AI Settings или выберите персонажа — и кнопка станет доступной. См. Быстрый старт.