Темы
Эта страница объясняет, как работают темы в NeoTavern: что они могут менять, как их устанавливать и переключать и как безопасный режим вас защищает.
Что меняет тема
У темы три уровня:
- Design tokens — цвета, шрифты, отступы, радиусы, тени и длительности анимаций.
- Component skin — вид кнопок, панелей и других элементов управления.
- Shell layout — расположение именованных областей: навигации, браузера персонажей, области просмотра чата, боковых панелей и слоя модальных окон.
Это означает, что темы — полноценные визуальные переработки, а не просто смена цветов. Тема может стилизовать приложение под игровую консоль, визуальную новеллу или мобильный клиент, не меняя никакой логики чата. Переключение темы, скина компонентов или макета оболочки никогда не требует перезапуска.
Встроенные темы
Первый запуск включает набор встроенных тем, среди которых AMOLED, GitHub Dark, Matrix, Nord, Gruvbox, Dracula, Tokyo Night и Catppuccin Mocha. Менеджер тем всегда открывается с этими темами, поэтому стиль можно сменить немедленно.
Установка тем
Пакет темы — файл .sttheme: ZIP с манифестом theme.json и CSS, размером
до 25 МБ. Установите его через менеджер тем:
- Откройте Themes с навигационной панели или вкладку Settings → Themes.
- Установите пакет. Сервер проверяет пути, типы файлов, размеры и манифест до записи чего-либо и отклоняет traversal-пути, симлинки и запрещённый CSS.
- Предпросмотрите тему перед применением. Из предпросмотра можно принять тему, вернуться назад или открыть её настройки.
- Активируйте её. Установка сама по себе никогда не активирует тему.
Обновления установленной темы атомарно заменяют её и сохраняют состояние активации. Если тема не загружается, оболочка автоматически восстанавливает последний рабочий макет.
Пользовательские темы
Темы — это пакеты, а не хаки: тема не получает доступа к вашим чатам,
API-ключам или файловой системе. Theme SDK документирует стабильные хуки —
data-component, data-part, data-role и data-state, — которые
стилизуют темы, и контракт оболочки, определяющий именованные области.
Пользовательский CSS-оверрайд загружается в каскаде последним. О создании
собственных тем см. справочник Theme SDK.
Безопасный режим и восстановление
Безопасный режим отключает все сторонние темы и плагины и доступен до их загрузки, поэтому сломанная тема никогда не сможет заблокировать вам доступ. После цикла сбоев приложение автоматически предлагает безопасный запуск. Встроенное действие Reset interface восстанавливает тему по умолчанию без ручного редактирования файлов, и ни одна тема не может скрыть это действие.
О вкладке General, где находятся параметры активной темы и стиля сообщений, см. Настройки.