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

Диагностические инструменты

В Elftia есть полный набор встроенных диагностических инструментов, которые помогают устранять неполадки, собирать логи, управлять кэшем и оптимизировать базу данных. Все диагностические функции находятся на странице Settings → System.

Экспорт диагностической информации​

Export Diagnostics​

Собирает полную диагностическую информацию из среды выполнения Elftia и упаковывает её в файл, которым можно поделиться.

Шаги:

  1. Откройте Settings → System.
  2. В области "Diagnostics & Caches" нажмите кнопку Export Diagnostics.
  3. Система начнёт сбор информации (на кнопке отображается Collecting...).
  4. После завершения сбора выберите место сохранения.

Включённая информация:

СодержимоеОписание
Версия приложенияВерсия Elftia, версия Electron
Операционная системаТип OS, версия, архитектура
Среда выполненияВерсия Node.js, использование памяти, сведения о CPU
Конфигурация провайдеровСписок настроенных провайдеров и их статус (без API Keys)
MCP ServersСписок настроенных MCP servers и статус подключения
Настройки приложенияТекущая конфигурация приложения (очищенная)
Логи выполненияНедавние логи выполнения приложения
Состояние базы данныхРазмер базы данных, статистика таблиц
к сведению

Экспортированная диагностическая информация очищается и не включает API Keys, пароли и другую чувствительную информацию. Вы можете безопасно передавать диагностические файлы технической поддержке или сообществу.

Варианты формата экспорта​

Диагностическая информация поддерживает несколько форматов экспорта:

ФорматОписаниеРекомендуется для
JSONОдин JSON fileБыстрая передача, онлайн-просмотр
ZIPПолный диагностический пакетВключает файлы логов и полную информацию для подробного устранения неполадок

Copy Diagnostics Log​

Копирует диагностические логи напрямую в буфер обмена для быстрой вставки в чат или отзыв о проблеме.

  1. Нажмите кнопку Copy diagnostics log.
  2. Содержимое логов будет скопировано в буфер обмена.
  3. Вставьте его там, где нужно.

Просмотр диагностических логов​

После операций Export Diagnostics или Copy Diagnostics Log диагностические результаты отображаются в области логов ниже на странице зелёным моноширинным шрифтом. Вы можете напрямую просматривать и проверять диагностическую информацию на странице.

Управление кэшем​

Clear Caches​

Очищает локальные данные кэша Elftia, включая кэш списка моделей, кэш поиска и т. д.

Шаги:

  1. Нажмите кнопку Clear Caches (красная опасная кнопка).
  2. Дождитесь завершения очистки (на кнопке отображается Clearing...).
  3. После завершения на странице будет показан результат очистки.

Очищаемое содержимое:

  • Кэш списка моделей (будет получен заново при следующем использовании)
  • Кэш результатов web search
  • Кэш индекса поиска файлов
  • Кэш миниатюр
  • Кэш времени выполнения пула API Key

Содержимое, которое НЕ очищается:

  • История чатов
  • Пользовательские настройки
  • API Keys и конфигурация провайдеров
  • Конфигурация MCP server
  • Настройки темы
подсказка

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

Prune Attachments​

Очищает осиротевшие файлы вложений, не связанные ни с одним сообщением, чтобы освободить место на диске.

Шаги:

  1. Нажмите кнопку Prune attachments.
  2. Система просканирует все файлы вложений и определит осиротевшие файлы, на которые не ссылается ни одно сообщение.
  3. Безопасно удалит осиротевшие файлы.
  4. Покажет результаты очистки (количество удалённых файлов и освобождённое место).
к сведению

Эта операция очищает только файлы вложений, подтверждённые как неиспользуемые, и не повлияет на вложения в обычных чатах.

Обслуживание базы данных​

Размер базы данных​

На странице отображается текущий размер файла базы данных SQLite. По мере роста истории чатов база данных постепенно увеличивается.

Оптимизация VACUUM​

SQLite не освобождает место на диске автоматически после удаления данных. Операция VACUUM перестраивает файл базы данных, чтобы освободить пространство, занятое удалёнными данными.

Шаги:

  1. В области обслуживания базы данных нажмите кнопку VACUUM.
  2. Дождитесь завершения операции (кнопка показывает состояние выполнения).
  3. После завершения отображается результат оптимизации и новый размер базы данных.

Примечания:

  • Операция VACUUM временно создаёт копию базы данных; убедитесь, что на диске достаточно места (примерно 2x размера базы данных).
  • Не закрывайте приложение во время операции.
  • VACUUM для больших баз данных может занять от нескольких секунд до десятков секунд.

Рекомендуемая частота:

  • Обычное использование: один раз в месяц.
  • После массового удаления чатов: рекомендуется выполнить сразу.
  • Необычно большая база данных: возможно, в ней есть удалённое, но не освобождённое пространство; VACUUM может значительно уменьшить размер.

Очистка ресурсов​

Очистка осиротевших ресурсов​

Показывает количество и общий размер осиротевших файлов ресурсов, которые можно безопасно очистить, с возможностью очистки в один клик.

Шаги:

  1. Просмотрите "Cleanable Count" и "Cleanable Size".
  2. Нажмите кнопку Clean Resources, чтобы выполнить очистку.
  3. После завершения будут показаны результаты.

Обнаружение окружения​

Расположено в Settings → General → Environment.

Обнаружение окружения сканирует вашу систему на предмет статуса установки инструментов разработки:

ИнструментОбнаружениеОтображаемая информация
Node.jsnode --versionВерсия, путь установки
Gitgit --versionВерсия, путь установки
ripgreprg --versionВерсия, путь установки
uvuv --versionВерсия, путь установки
uvxuvx --versionВерсия, путь установки

У каждого инструмента есть индикатор состояния:

  • Зелёная точка (установлен): показывает версию и путь установки.
  • Красная точка (не установлен): если поддерживается автоустановка, показывает кнопку "Install".

Автоустановка​

Некоторые инструменты поддерживают установку в один клик прямо в Elftia:

  1. Нажмите кнопку Install рядом с неустановленным инструментом.
  2. Кнопка изменится на "Installing..." и покажет ход установки.
  3. Статус автоматически обновится после завершения установки.

Инструменты, которые сейчас поддерживают автоустановку: ripgrep, uv, uvx.

Node.js и Git нужно вручную скачать и установить с их официальных сайтов.

Диагностика в режиме разработчика​

Включите режим разработчика (продолжайте нажимать на номер версии в Settings → About), чтобы получить дополнительные диагностические возможности:

DevTools​

В режиме разработчика вы можете открывать/закрывать Electron DevTools в Settings → About:

  • Console: просматривайте JavaScript-логи приложения, включая подробные сообщения об ошибках и отладочные логи.
  • Network: просматривайте все сетевые запросы, включая подробные запросы и ответы вызовов LLM API.
  • Elements: проверяйте структуру DOM, чтобы находить проблемы UI.

Использование DevTools для отладки​

  1. Включите режим разработчика.
  2. Нажмите кнопку Open DevTools на странице About.
  3. После открытия окна DevTools переключитесь на вкладку Console.
  4. Наблюдайте за выводом логов; сообщения об ошибках обычно отображаются красным.
  5. При сетевых проблемах переключитесь на вкладку Network и просмотрите неудачные запросы.
подсказка

При сообщении о проблемах сообществу или технической поддержке, помимо файлов диагностического экспорта, очень ценной информацией для устранения неполадок являются логи ошибок в DevTools Console. Вы можете щёлкнуть логи в Console правой кнопкой мыши и выбрать "Save as", чтобы сохранить полные логи.

Другие диагностические функции​

Метрики вложений​

Просматривайте статистику, связанную с вложениями, на вкладке System:

  • Общее количество вложений
  • Дисковое пространство, занимаемое вложениями
  • Количество и размер осиротевших вложений

Метрики кэша​

Просматривайте размер и hit rate различных кэшей:

  • Кэш поиска файлов
  • Кэш списка моделей
  • Кэш миниатюр
  • Кэш дерева файлов

Бюджет времени выполнения​

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

Метрики пагинации базы данных​

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

Диагностический процесс устранения неполадок​

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

  1. Соберите информацию: нажмите Export Diagnostics, чтобы экспортировать диагностическую информацию.
  2. Просмотрите логи: найдите сообщения об ошибках в диагностических логах.
  3. Проверьте окружение: подтвердите статус установки инструментов окружения.
  4. Очистите кэш: выполните Clear Caches, чтобы удалить потенциально устаревший кэш.
  5. Оптимизируйте базу данных: выполните VACUUM, чтобы оптимизировать базу данных.
  6. Перезапустите приложение: перезапустите Elftia, чтобы проверить, решена ли проблема.
  7. Включите DevTools: если шаги выше не помогли, включите режим разработчика и используйте DevTools для углублённой отладки.

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