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

В 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.js	node --version	Версия, путь установки
Git	git --version	Версия, путь установки
ripgrep	rg --version	Версия, путь установки
uv	uv --version	Версия, путь установки
uvx	uvx --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 для углублённой отладки.

---

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