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

Данные и резервные копии

Эта страница объясняет, где хранятся ваши данные, что содержит каталог данных и как экспортировать, импортировать и резервировать библиотеку.

Каталог данных​

Все пользовательские данные хранятся в одном каталоге данных, создаваемом при первом запуске. Его точное расположение показано в Settings → Data; вы можете указать серверу другое расположение через переменную окружения NEOTA_DATA_DIR. Структура:

  • app.db — база данных SQLite: персонажи, чаты, сообщения, лорбуки, записи памяти, персоны, пресеты и настройки. Она работает в режиме WAL с включёнными внешними ключами и полнотекстовым поиском по персонажам, чатам и сообщениям.
  • files/ — исходные пользовательские файлы: аватары, фоны, вложения, аудио и сгенерированные изображения. Это никогда не производные данные.
  • cache/ — пересоздаваемые данные: миниатюры, данные токенизаторов и загрузки плагинов. Очистка кэша никогда не затрагивает ваши оригиналы.
  • backups/ — архивы резервных копий, которые вы создаёте из интерфейса.
  • logs/ — редактируемые серверные логи.
  • plugins/ и themes/ — установленные пакеты, каждый из которых ограничен собственным каталогом.

Что хранится​

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

Экспорт и импорт​

  • Карточки персонажей экспортируются как PNG или JSON, а чаты — как архивы, которые можно хранить или переносить на другую машину. См. Персонажи.
  • Миграция из SillyTavern находится в Settings → Data: выберите ZIP полной резервной копии данных, и приложение сначала проведёт анализ только на чтение, который сообщает объекты, вложенные записи, повреждения, размер и конфликты по каждой категории — персонажи, чаты, персоны, лорбуки и пресеты. Ничего не записывается, пока вы не изучите отчёт и не подтвердите. Затем вы выбираете категории и одну явную политику конфликтов (сохранить существующее, создать копии, безопасно объединить или заменить из архива). Секреты, плагины, темы и неподдерживаемые категории перечисляются как пропущенные, а повторный импорт никогда не создаёт дубликатов.

Резервные копии​

Резервные копии создаются и восстанавливаются полностью из интерфейса в Settings → Data:

  • Создать копию можно в любой момент; создание не блокирует чтение данных.
  • Экран резервных копий показывает дату, размер, версию схемы, источник и состояние.
  • Восстановление запрашивает подтверждение, сначала создаёт защитную копию текущего состояния и сообщает, что после этого приложение нужно перезапустить.
  • Восстановление сообщается как успешное только после проверки целостности; при сбое приложение предлагает автоматический возврат к защитной копии.

Перед любой опасной миграцией схемы приложение самостоятельно создаёт резервную копию. В сочетании с базой WAL это означает, что у обновления или восстановления всегда есть заведомо рабочий откат. См. Обновление.