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

Распространённые проблемы

На этой странице собраны наиболее частые проблемы, возникающие при использовании Elftia, и способы их решения. Для каждой проблемы описаны симптомы, возможные причины и конкретные шаги по устранению.

Проблемы с запуском и интерфейсом​

Пустой экран после запуска приложения​

Симптом: После открытия Elftia окно отображает пустой или белый экран без содержимого интерфейса.

Возможные причины:

  • Несовместимость аппаратного ускорения GPU с драйверами видеокарты
  • Сбой процесса рендерера фронтенда
  • Повреждённые файлы установки

Шаги по устранению:

  1. Закройте Elftia и запустите его из командной строки с параметром --disable-gpu, чтобы проверить, связана ли проблема с GPU.
  2. Обновите драйверы видеокарты до последней версии.
  3. Проверьте, не остались ли в системе процессы Elftia. С помощью диспетчера задач завершите все связанные процессы и попробуйте снова.
  4. Если проблема сохраняется, попробуйте переустановить Elftia.

Приложение немедленно падает после запуска​

Симптом: После двойного щелчка для запуска окно мелькает и сразу закрывается.

Возможные причины:

  • Отсутствие системных зависимостей времени выполнения (например, Visual C++ Redistributable)
  • Проблемы с разрешениями на директорию пользовательских данных
  • Конфликты из-за оставшихся данных старой версии

Шаги по устранению:

  1. Windows: Установите последнюю версию Visual C++ Redistributable.
  2. Проверьте, есть ли права на запись в директорию пользовательских данных.
  3. Попробуйте удалить файлы кэша в директории пользовательских данных и перезапустите (данные разговоров не будут потеряны).
  4. Запустите Elftia с правами администратора.

Иероглифы или нечитаемые символы в интерфейсе​

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

Возможные причины:

  • В настройках пользовательского шрифта указан шрифт, не установленный в системе
  • Повреждённые файлы шрифтов

Шаги по устранению:

  1. Откройте Настройки → Внешний вид и очистите поля пользовательского ввода для шрифта UI и шрифта кода.
  2. Если страница настроек недоступна, вручную удалите файл конфигурации темы в директории пользовательских данных.

Проблемы с LLM-провайдерами​

Проверка подключения к провайдеру не прошла — 401​

Симптом: Тест подключения показывает 401 Unauthorized или Invalid API Key.

Возможные причины:

  • Неверно введён API-ключ (лишние пробелы, отсутствующий префикс и т. д.)
  • API-ключ истёк или был отозван
  • Используется API-ключ не того провайдера

Шаги по устранению:

  1. Скопируйте API-ключ заново и убедитесь, что нет лишних пробелов или переносов строк.
  2. Зайдите в консоль провайдера и подтвердите, что ключ всё ещё действителен.
  3. Убедитесь, что API-ключ соответствует нужному провайдеру.

Проверка подключения к провайдеру не прошла — 403​

Симптом: Тест подключения показывает 403 Forbidden.

Возможные причины:

  • Недостаточный баланс на счёте или не привязан способ оплаты
  • API-ключ не имеет достаточных прав (например, ключ только для чтения)
  • IP-адрес заблокирован провайдером

Шаги по устранению:

  1. Проверьте баланс и статус оплаты на аккаунте провайдера.
  2. Убедитесь, что ваш API-ключ имеет разрешение на вызов моделей.
  3. Если используется прокси, попробуйте переключиться на другой узел прокси.

Тайм-аут при проверке подключения к провайдеру​

Симптом: Тест подключения долго не отвечает и в итоге завершается по тайм-ауту.

Возможные причины:

  • Проблемы с сетевым подключением
  • Неправильная настройка прокси
  • Брандмауэр блокирует исходящие запросы

Шаги по устранению:

  1. Проверьте, работает ли ваше сетевое соединение.
  2. Если используется прокси, убедитесь, что он запущен и правильно настроен (см. Использование прокси).
  3. Убедитесь, что брандмауэр разрешает Elftia доступ в интернет.
  4. Попробуйте открыть API-домен провайдера напрямую в браузере (например, api.openai.com), чтобы убедиться в его доступности.

Прерывание потокового ответа​

Симптом: Ответ AI прерывается на середине, и сообщение остаётся незаконченным.

Возможные причины:

  • Нестабильное сетевое соединение, вызывающее прерывание SSE-потока
  • Ответ достиг максимального лимита токенов модели
  • Слишком короткое время ожидания соединения через прокси

Шаги по устранению:

  1. Попробуйте повторно сгенерировать ответ.
  2. Если проблема повторяется, проверьте стабильность сетевого соединения.
  3. Убедитесь, что тайм-аут вашего прокси (если используется) составляет не менее 120 секунд.
  4. Уменьшите значение max_tokens в параметрах модели или разбейте длинный запрос на части.

Проблемы, связанные с агентом​

Агент не может выполнить инструмент​

Симптом: Агент пытается использовать инструмент (например, Bash, Write и т. д.), но получает отказ в доступе.

Возможные причины:

  • GuardianAgent установлен в строгий режим и блокирует операции
  • Режим разрешений установлен в «Только планирование»
  • Операция заблокирована детерминированными правилами брандмауэра выполнения

Шаги по устранению:

  1. Проверьте Настройки → Clawia → Режим GuardianAgent и при необходимости снизьте уровень безопасности.
  2. Проверьте, не установлен ли режим разрешений в «Только планирование».
  3. Просмотрите Журнал аудита, чтобы определить, какой уровень безопасности заблокировал операцию.

Выполнение инструмента агента не удалось — command not found​

Симптом: При выполнении агентом команды Shell отображается command not found.

Возможные причины:

  • Требуемый инструмент командной строки не установлен в системе
  • Переменная окружения PATH не включает путь к инструменту

Шаги по устранению:

  1. Откройте Настройки → Общие → Среда и проверьте статус установки инструмента.
  2. Установите недостающие инструменты (Node.js, Git и т. д.).
  3. Если инструмент установлен, но по-прежнему не найден, возможно, потребуется перезапустить Elftia для обновления переменных окружения.

Проблемы, связанные с MCP​

Сервер MCP не может подключиться — режим stdio​

Симптом: Добавленный MCP-сервер показывает ошибку подключения в режиме stdio (подпроцесс).

Возможные причины:

  • Команда не существует или путь указан неверно
  • Зависимости не установлены (например, пакет Node.js не установлен)
  • Отсутствуют переменные окружения

Шаги по устранению:

  1. Убедитесь, что команду MCP-сервера можно запустить непосредственно в терминале (например, npx -y @modelcontextprotocol/server-filesystem /path).
  2. Проверьте, установлены ли Node.js (node --version) или Python (python --version).
  3. Если MCP-серверу требуются дополнительные переменные окружения (например, API-ключи), убедитесь, что они правильно заданы в поле env конфигурации MCP.
  4. Перезапустите Elftia и повторите попытку.

Сервер MCP не может подключиться — режим SSE/HTTP​

Симптом: Подключение к удалённому MCP-серверу завершается тайм-аутом или отклоняется.

Возможные причины:

  • MCP-сервер не запущен
  • Неверный URL или порт
  • Сеть или брандмауэр блокирует соединение

Шаги по устранению:

  1. Убедитесь, что MCP-сервер запущен и доступен.
  2. Проверьте правильность формата URL (включает префикс http:// или https://).
  3. Если используется прокси, убедитесь, что правила прокси разрешают доступ к адресу MCP-сервера.

Проблемы, связанные с каналами​

Бот канала не отвечает​

Симптом: Отправка сообщения через Discord/Telegram или другие платформы — бот не отвечает.

Возможные причины:

  • Не выполнено условие правила триггера (например, требуется @упоминание, но его не было)
  • Сообщение заблокировано PromptGuardian
  • Канал не запущен или Token настроен неверно
  • Достигнут лимит частоты запросов

Шаги по устранению:

  1. Убедитесь, что сообщение соответствует правилам триггера канала (@упоминание, ключевые слова, префикс и т. д.).
  2. Проверьте режим PromptGuardian и временно установите «Выкл.», чтобы проверить, не является ли это ложным срабатыванием защиты от инъекций.
  3. Убедитесь, что Bot Token канала верен и Bot в сети.
  4. Проверьте журнал аудита на наличие заблокированных сообщений.

Проблемы с генерацией медиаконтента​

Ошибка генерации изображений/видео/музыки​

Симптом: Ошибка при запросе на генерацию медиаконтента.

Возможные причины:

  • Соответствующий провайдер генерации медиа не настроен или недостаточно средств
  • Содержимое запроса отклонено фильтром безопасности провайдера
  • Проблема с сетевым подключением

Шаги по устранению:

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

Проблемы с отображением​

Обои установлены, но текст нечитаем​

Симптом: После установки обоев некоторый текст интерфейса трудно читать из-за высокой прозрачности.

Шаги по устранению:

  1. Увеличьте значение Непрозрачность маски (рекомендуется 70–85).
  2. Увеличьте значение Интенсивность размытия (рекомендуется 8–15).
  3. Если отдельные области по-прежнему нечитаемы, используйте пользовательский CSS для настройки.

Элементы интерфейса не видны в тёмном режиме​

Симптом: В тёмном режиме некоторые границы, разделители или цвета текста слишком светлые и трудно читаемые.

Шаги по устранению:

  1. Попробуйте переключиться на другой акцентный цвет. Некоторые цвета обеспечивают лучший контраст в тёмном режиме.
  2. Проверьте, не влияет ли пользовательский CSS на отображение цветов, и попробуйте очистить пользовательский CSS.
  3. Увеличьте яркость монитора.

Проблемы с производительностью​

Высокое потребление памяти​

Симптом: Потребление памяти Elftia постоянно растёт.

Возможные причины:

  • Открыто слишком много вкладок с разговорами
  • Один разговор содержит большое количество сообщений (сотни и более)
  • Слишком много вложений (особенно изображений)

Шаги по устранению:

  1. Закройте ненужные вкладки с разговорами.
  2. Для очень длинных разговоров рассмотрите возможность начать новый.
  3. Откройте Настройки → Система и выполните Clear Caches, чтобы очистить кэш.
  4. Перезапустите Elftia для освобождения памяти.

Ошибки, связанные с базой данных​

Симптом: Ошибки операций с базой данных или несогласованность данных.

Шаги по устранению:

  1. Откройте Настройки → Система и выполните VACUUM для оптимизации базы данных.
  2. Если проблема сохраняется, экспортируйте диагностическую информацию (Export Diagnostics) для дальнейшего изучения.
  3. В крайнем случае файл базы данных (.db) в директории пользовательских данных можно безопасно создать резервную копию и заменить.

Проблемы, связанные с обновлением​

Нештатное поведение после обновления​

Симптом: Приложение ведёт себя нештатно после обновления до новой версии.

Шаги по устранению:

  1. Откройте Настройки → Система и последовательно выполните Clear Caches и VACUUM.
  2. Перезапустите Elftia.
  3. Если проблема сохраняется, обратитесь к шагам отката в разделе Обновление Elftia.

Если приведённые решения не помогли устранить проблему, воспользуйтесь Инструментами диагностики для сбора подробной информации или обратитесь к разделу Ошибки подключения для получения детальных методов устранения проблем, связанных с сетью.