Справочник настроек
Эта страница представляет собой полный справочник по всем настройкам Elftia, доступным пользователю. Настройки сгруппированы по вкладкам и соответствуют странице настроек в приложении.
Общие настройки
Находятся в разделе Settings → General.
Язык
| Настройка | Варианты | По умолчанию | Описание |
|---|---|---|---|
| Язык интерфейса | Simplified Chinese / English / 日本語 | Следовать системе | Язык отображения интерфейса приложения |
Изменения языка вступают в силу сразу и не требуют перезапуска.
Прокси
| Настройка | Варианты | По умолчанию | Описание |
|---|---|---|---|
| Режим прокси | System Proxy / Custom Proxy / No Proxy | System Proxy | Метод прокси, используемый для сетевых запросов |
| URL пользовательского прокси | Текстовое поле | Пусто | Действует только в режиме "Custom Proxy" |
Подробнее см. в разделе Использование прокси.
Запуск
| Настройка | Тип | По умолчанию | Описание |
|---|---|---|---|
| Автозапуск | Переключатель | Выкл. | Автоматически запускать Elftia при старте операционной системы |
| Сворачивать при запуске | Переключатель | Выкл. | После автозапуска сворачивать приложение в трей вместо показа окна |
Трей
| Настройка | Тип | По умолчанию | Описание |
|---|---|---|---|
| Сворачивать в трей | Переключатель | Выкл. | При закрытии окна сворачивать приложение в системный трей вместо выхода из него |
Уведомления
| Настройка | Тип | По умолчанию | Описание |
|---|---|---|---|
| Уведомления рабочего стола | Переключатель | Вкл. | Показывать системные уведомления при поступлении новых сообщений |
| Звук уведомлений | Переключатель | Вкл. | Воспроизводить звук уведомления при поступлении оповещений |
Инструменты окружения
Показывает состояние инструментов разработки, установленных в системе. Раздел находится в нижней части страницы общих настроек.
| Инструмент | Назначение | Можно установить автоматически |
|---|---|---|
| Node.js | Среда выполнения MCP server | Нет |
| Git | Контроль версий | Нет |
| ripgrep (rg) | Быстрый поиск файлов | Да |
| uv | Менеджер пакетов Python | Да |
| uvx | Средство запуска инструментов Python | Да |
Инструменты, помеченные как доступные для автоматической установки, можно установить автоматически, нажав кнопку "Install".
Настройки внешнего вида
Находятся в разделе Settings → Appearance. Подробные объяснения см. в разделе Темы и внешний вид.
| Настройка | Тип | По умолчанию | Описание |
|---|---|---|---|
| Режим темы | Light / Dark / Follow System | Follow System | Цветовая схема интерфейса |
| Акцентный цвет | Выбор цвета | Предустановленный синий | Цвет темы для кнопок, ссылок и других элементов |
| Шрифт UI | Текстовое поле | Inter | Шрифт для текста интерфейса |
| Шрифт кода | Текстовое поле | JetBrains Mono | Моноширинный шрифт для блоков кода |
| Обои (светлый режим) | Загрузка изображения / URL | Нет | Фоновые обои для светлого режима |
| Обои (тёмный режим) | Загрузка изображения / URL | Нет | Фоновые обои для тёмного режима |
| Сила размытия | Ползунок 0-30 | 6 | Величина размытия по Гауссу для обоев |
| Непрозрачность маски | Ползунок 0-100 | 70 | Непрозрачность слоя маски обоев |
| Отключать обои в компактном окне | Переключатель | Вкл. | Автоматически отключать обои, когда окно маленькое |
| Пользовательский CSS | Редактор CSS | Пусто | Внедрить пользовательские стили |
| Разрешить удалённые ресурсы | Переключатель | Выкл. | Разрешить загрузку удалённых изображений и шрифтов |
| Белый список удалённых доменов | Список | Список по умолчанию | Домены, которым разрешено загружать ресурсы |
Настройки провайдеров
Находятся в разделе Settings → Provider Settings. Подробные объяснения см. в разделе Настройка LLM Provider.
Каждый провайдер можно настроить с помощью следующих параметров:
| Настройка | Тип | Описание |
|---|---|---|
| API Key | Поле пароля | API key провайдера |
| Base URL | Текстовое поле | Адрес API endpoint (поддерживаются пользовательские endpoint) |
| Включён | Переключатель | Нужно ли активировать этого провайдера |
| Пул API Key | Управление несколькими ключами | Настройка нескольких API Keys для балансировки нагрузки |
Пул API Key
Каждый провайдер поддерживает настройку нескольких API Keys, а система автоматически выбирает между ними с помощью взвешенного round-robin:
| Настройка | Тип | Описание |
|---|---|---|
| Список ключей | Список | Несколько записей API Key |
| Вес | Число | Вес выбора для каждого ключа |
| Включён/отключён | Переключатель | Статус включения отдельных ключей |
Когда ключ сталкивается с ошибками 429 (rate limit) или 529 (overload), система автоматически переключается на другой доступный ключ и задаёт для неудачного ключа период охлаждения (экспоненциальная задержка от 60 секунд до 15 минут).
Модели по умолчанию
Находятся в разделе Settings → Default Models.
| Настройка | Назначение | Описание |
|---|---|---|
| Общий чат | Модель по умолчанию для повседневных разговоров | Автоматически выбирается при создании нового разговора |
| Длинный контекст | Модель для обработки длинных документов | Автоматически переключается, когда контекст превышает порог |
| Web Search | Модель для суммаризации результатов поиска | Используется при включении web search |
| Image Generation | Модель генерации изображений | Используется при создании изображений |
| Фоновые задачи | Модель для фоновой обработки | Используется для генерации названий разговоров, сводок и т. п. |
Для каждой категории можно выбрать модель из доступных моделей всех включённых провайдеров.
Настройки Agent (Clawia)
Находятся в разделе Settings → Clawia (вкладка настройки Agent).
Agent Engine
| Настройка | Варианты | По умолчанию | Описание |
|---|---|---|---|
| Agent Backend | Claude SDK / TinyElf / CLI | Claude SDK | Движок выполнения Agent |
- Claude SDK: использует Anthropic Agent SDK с наиболее полной функциональностью.
- TinyElf: встроенный лёгковесный движок Agent, поддерживающий любого LLM provider.
- CLI: вызывает внешние инструменты Agent через командную строку (Claude Code CLI, Codex CLI и т. п.).
Настройки CLI Backend (только режим CLI)
| Настройка | Тип | По умолчанию | Описание |
|---|---|---|---|
| CLI Tool | Выбор | Claude Code | Используемый CLI backend |
| Тайм-аут | Число (секунды) | 300 | Максимальная длительность одного выполнения |
| Режим PTY | Переключатель | Выкл. | Использовать псевдотерминал для выполнения |
| Столбцы PTY | Число | 120 | Ширина PTY terminal |
| Строки PTY | Число | 40 | Высота PTY terminal |
Версия prompt
| Настройка | Варианты | По умолчанию | Описание |
|---|---|---|---|
| Версия prompt | V1 / V2 / V3 / V4 | V4 | Метод построения system prompts |
- V1: предустановка SDK + простое добавление (время, workspace, memory, channels)
- V2: полностью настраиваемые system prompts (PromptBuilder)
- V3: V2 + 5-слойная структура (bootstrap, onboarding, memory, channels, dynamic)
- V4: предустановка SDK + bootstrap file + soul/memory/onboarding/channels/scheduling
V4 — рекомендуемая версия по умолчанию, объединяющая оптимизации SDK с настройкой под проект. Большинству пользователей не нужно менять этот параметр.
Настройки безопасности
| Настройка | Варианты | По умолчанию | Описание |
|---|---|---|---|
| Режим GuardianAgent | Off / Monitor / Guard / Strict | Off | Уровень проверки безопасности AI |
Подробнее см. в разделе Настройки безопасности.
Режим сессии
| Настройка | Варианты | По умолчанию | Описание |
|---|---|---|---|
| Режим сессии по умолчанию | Continue / New | Continue | Поведение по умолчанию при открытии приложения |
- Continue: восстановить предыдущую сессию разговора при открытии приложения.
- New: создавать новую сессию разговора при каждом открытии приложения.
Режим разработчика
| Настройка | Тип | По умолчанию | Описание |
|---|---|---|---|
| Режим разработчика | Переключатель | Выкл. | Если включено, предоставляет доступ к DevTools и дополнительной отладочной информации |
Режим разработчика нужно активировать в Settings → About с помощью специального действия (непрерывно нажимать на номер версии). После активации переключатель Developer Mode появится на вкладке Clawia.
Настройки Web Search
Находятся в разделе Settings → Web Search. Подробные объяснения см. в разделе Функция Web Search.
| Настройка | Тип | Описание |
|---|---|---|
| Search Provider | Выбор | Выберите провайдера web search engine |
| Стратегия организации | Выбор | Метод организации результатов поиска |
| Настройки сжатия | Варианты | Уровень сжатия содержимого результатов поиска |
| Чёрный список доменов | Список | Не получать результаты поиска с этих доменов |
Системные настройки
Находятся в разделе Settings → System.
Диагностические инструменты
| Действие | Описание |
|---|---|
| Экспорт диагностики | Экспорт диагностической информации (логи, конфигурация, среда выполнения) |
| Очистить кэши | Очистить данные локального кэша |
| Скопировать диагностический лог | Скопировать диагностические логи в буфер обмена |
| Удалить лишние вложения | Очистить несвязанные файлы вложений |
Обслуживание базы данных
| Действие | Описание |
|---|---|
| Размер базы данных | Показать текущий размер файла базы данных SQLite |
| VACUUM | Выполнить оптимизацию сжатия базы данных и освободить пространство, занятое удалёнными данными |
Очистка ресурсов
| Действие | Описание |
|---|---|
| Очищаемые элементы | Показать количество и размер осиротевших ресурсов, которые можно безопасно удалить |
| Очистить ресурсы | Выполнить очистку ресурсов |
Импорт и миграция данных
| Действие | Описание |
|---|---|
| Импорт legacy JSONL | Синхронизировать ~/.claude/projects/*.jsonl с базой данных для быстрых постраничных запросов |
| Генерация миниатюр | Пакетно сгенерировать миниатюры для существующих изображений, чтобы ускорить загрузку списков и галерей |
| Миграция хранилища вложений | Перенести старые вложения media:// в content-addressable хранилище resource://, удалить дубликаты и сэкономить место |
Экспериментальные функции
Некоторые новые функции, проходящие тестирование, можно включать и отключать в этом разделе. Экспериментальные функции могут быть нестабильными и рекомендуются только опытным пользователям:
| Функция | Описание |
|---|---|
| Новая файловая система | Потоковый поиск, интеграция ripgrep и механизм автоматического fallback |
| Оптимизированное дерево файлов | Улучшенный рендеринг дерева и инкрементальные обновления |
Если возникнут проблемы, их можно отключить в любой момент, чтобы вернуться к стабильной версии.
:::info Design Studio включена по умолчанию
Design Studio включена по умолчанию начиная с версии 0.1.7 и больше не находится в Experimental Features. Теперь панель навигации напрямую показывает пункт 🎨 Design Studio. Единственное оставшееся требование — текущий движок LLM provider должен поддерживать Design adapter (движок api его не поддерживает). Подробнее см. в разделе Design Studio.
:::
О приложении
Находится в разделе Settings → About.
| Информация | Описание |
|---|---|
| Версия | Текущая версия Elftia |
| Проверить обновления | Вручную проверить, доступна ли новая версия |
| Режим разработчика | Включается непрерывным нажатием на номер версии |
| DevTools | Открыть/закрыть Electron DevTools в режиме разработчика |
| Статус аккаунта | Статус входа и информация о membership |
Подробные объяснения настроек, связанных с безопасностью, см. далее в разделе Настройки безопасности.