Импорт и экспорт данных

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

Типы данных для импорта/экспорта

Тип данных	Формат экспорта	Место экспорта	Способ импорта
Конфигурация LLM-провайдера	JSON	Настройки → Настройки провайдеров	Настройки → Настройки провайдеров
Конфигурация MCP-сервера	JSON	Настройки → MCP	Настройки → MCP
Определение Agent	Markdown (.md)	Страница Agent	Страница Agent
Карточка персонажа	PNG (с метаданными) / JSON	Настройки ролевых игр	Настройки ролевых игр
История чатов	JSON	Контекстное меню боковой панели	Импорт в боковой панели
Конфигурация темы	JSON	Настройки → Внешний вид	Настройки → Внешний вид
Диагностическая информация	JSON / ZIP	Настройки → Система	Импорт не поддерживается

Конфигурация LLM-провайдера

Экспорт настроек провайдера

Настроив несколько LLM-провайдеров, вы можете экспортировать все конфигурации в виде файла JSON для резервного копирования или переноса.

1. Откройте Настройки → Настройки провайдеров.
2. Нажмите кнопку Экспорт над списком провайдеров.
3. Выберите место сохранения; файл будет сохранён в формате JSON.

Экспортированный JSON содержит:

• ID и имя провайдера
• Конфигурацию Base URL
• Статус включения
• Список моделей и конфигурацию параметров

предупреждение

В целях безопасности экспортированная конфигурация не включает API-ключи. После импорта вам потребуется повторно ввести API-ключ каждого провайдера.

Импорт настроек провайдера

1. Откройте Настройки → Настройки провайдеров.
2. Нажмите кнопку Импорт над списком провайдеров.
3. Выберите ранее экспортированный файл JSON.
4. Система покажет предварительный просмотр импорта; подтвердите и примените конфигурацию.
5. Повторно введите API-ключ для каждого провайдера и протестируйте соединение.

Конфигурация MCP-сервера

Экспорт настроек MCP

1. Откройте Настройки → MCP (или страницу MCP в функциональной панели).
2. В списке MCP-серверов найдите функцию экспорта.
3. Конфигурация будет сохранена в формате JSON, содержащем информацию о подключении ко всем MCP-серверам.

Импорт настроек MCP

Elftia поддерживает импорт определений серверов из стандартных конфигурационных JSON-файлов MCP.

1. Откройте страницу управления MCP.
2. Нажмите кнопку Import JSON.
3. Выберите конфигурационный JSON-файл MCP. Пример формата:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/my-mcp-server"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

4. Система разберёт и добавит MCP-серверы, определённые в конфигурации.

подсказка

Elftia совместима с конфигурационными файлами MCP формата Claude Desktop (claude_desktop_config.json) и может импортировать их напрямую.

Определение Agent

Экспорт Agent

Определения Agent хранятся в виде файлов Markdown, которые вы можете напрямую экспортировать:

1. Откройте страницу Agent.
2. Выберите Agent для экспорта.
3. Используйте функцию экспорта, чтобы сохранить определение Agent как файл .md.

Файл Markdown Agent содержит:

• Имя и описание Agent
• Системный промпт
• Конфигурацию разрешений инструментов
• Назначение MCP-сервера
• Другие настройки поведения

Импорт Agent

1. Откройте страницу Agent.
2. Нажмите опцию импорта рядом с кнопкой создания.
3. Выберите файл .md Agent.
4. Система разберёт файл и создаст соответствующий Agent.

Карточка персонажа

Elftia поддерживает стандартные форматы карточек персонажей и совместима с распространёнными спецификациями карточек персонажей сообщества.

Экспорт карточки персонажа

1. В чате ролевой игры откройте панель настроек RP.
2. Найдите функцию экспорта карточки персонажа.
3. Выберите формат экспорта:
   • PNG (рекомендуется): файл изображения с метаданными, встроенными в текстовые чанки PNG. Можно напрямую поделиться как изображением, при этом содержит полную информацию о персонаже.
   • JSON: формат обычного текста, содержащий все данные определения персонажа.

Импорт карточки персонажа

1. В настройках ролевых игр нажмите Импорт карточки персонажа.
2. Выберите файл карточки персонажа в формате PNG или JSON.
3. Система автоматически разберёт информацию о персонаже и заполнит форму.
4. После импорта вы можете изменить настройки персонажа и затем сохранить.

История чатов

Экспорт чата

1. В боковой панели щёлкните правой кнопкой мыши по чату, который хотите экспортировать.
2. Выберите Экспорт.
3. Выберите место сохранения; чат будет сохранён в формате JSON.

Экспортированный чат содержит:

• Все сообщения (сообщения пользователя и ответы AI)
• Информацию о ветвях
• Метки времени сообщений
• Информацию об использованной модели
• Справочную информацию о вложениях

Массовый экспорт

1. В боковой панели войдите в режим массового выбора.
2. Выберите несколько чатов.
3. Используйте функцию экспорта в панели массовых операций, чтобы экспортировать все выбранные чаты сразу.

Импорт чата

1. В боковой панели используйте функцию импорта.
2. Выберите ранее экспортированный JSON-файл чата.
3. Чат будет восстановлен в список сессий.

Конфигурация темы

Экспорт темы

Если вы настроили тему на свой вкус (включая режим темы, акцентный цвет, шрифт, обои, пользовательский CSS), вы можете экспортировать её как файл конфигурации темы.

1. Откройте Настройки → Внешний вид.
2. Найдите область Конфигурация темы.
3. Нажмите кнопку Экспорт темы.
4. Выберите место сохранения; конфигурация будет сохранена в формате JSON.

Экспортируемое содержимое включает:

• Режим темы (светлый/тёмный/системный)
• Настройки акцентного цвета
• Переопределения шрифта
• Конфигурацию обоев (размытие, непрозрачность маски и другие параметры)
• Пользовательский CSS-код

к сведению

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

Импорт темы

1. Откройте Настройки → Внешний вид → Конфигурация темы.
2. Нажмите кнопку Импорт темы.
3. Выберите JSON-файл темы.
4. Система покажет предварительный просмотр различий темы при импорте; подтвердите для применения.

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

Диагностическая информация предназначена для предоставления технической поддержке при устранении неполадок; импорт не поддерживается.

1. Откройте Настройки → Система.
2. Нажмите кнопку Export Diagnostics.
3. Система соберёт информацию о времени выполнения, журналы, конфигурацию и т. д. для создания диагностического файла.
4. Вы можете выбрать экспорт в виде одного файла JSON или полного ZIP-архива.

Подробности см. в разделе Диагностические инструменты.

Примечания

• Безопасность API-ключей: Любая функция экспорта не будет экспортировать конфиденциальные учётные данные, такие как API-ключи. После импорта вам потребуется вводить их вручную повторно.
• Совместимость версий: Экспортированные файлы данных содержат информацию о версии. Файлы, экспортированные более новыми версиями, могут не импортироваться в более старые версии.
• Размер файла: Экспорт чатов с большим количеством ссылок на вложения может создавать большие файлы. Сами файлы вложений не включаются в экспорт.
• Кодировка символов: Все экспортированные файлы используют кодировку UTF-8 для кросс-платформенной совместимости.

---

Если при импорте/экспорте возникают проблемы, см. раздел Распространённые проблемы.