Ролевые игры
Elftia включает встроенную систему ролевых игр (RP), совместимую с SillyTavern, позволяющую создавать и импортировать карточки персонажей, строить настройки мироздания и вести захватывающие ролевые разговоры с AI. Поддерживаются форматы TavernCard V2/V3, базы знаний World Info, групповые чаты с несколькими персонажами, замена текста с помощью регулярных выражений и листы спрайтов эмоций.
Сценарии использования
- Создавайте виртуальных персонажей и ведите с ними захватывающие разговоры
- Импортируйте карточки персонажей из SillyTavern или сайтов обмена карточками (PNG со встроенными метаданными)
- Создавайте настройки мироздания (World Info), чтобы AI автоматически ссылался на нужные знания в зависимости от контекста разговора
- Настраивайте сценарии группового чата с несколькими персонажами и их взаимодействиями
- Используйте сценарии регулярных выражений для автоматической замены или изменения выходного текста
- Настраивайте листы спрайтов эмоций для персонажей, динамически меняющих выражение в зависимости от эмоций
Карточки персонажей
Карточки персонажей — основа ролевых игр, определяющая личность AI-персонажа, его историю и поведенческие паттерны.
Форматы карточек
Elftia поддерживает несколько форматов карточек персонажей:
| Формат | Идентификатор | Описание |
|---|---|---|
| TavernCard V2 | v2 | Стандартный формат SillyTavern с JSON-метаданными, закодированными в Base64, встроенными в PNG-изображения |
| TavernCard V3 | v3 | Расширенная версия V2 с дополнительными полями, такими как Assets и дата создания |
| CharX | charx | Расширенный формат карточек персонажей |
| BYAF | byaf | Формат Build Your AI Friend |
| JSON | json | Формат данных персонажа в чистом JSON |
| Ручное создание | manual | Персонажи, созданные вручную в Elftia |
Поля карточки
Каждая карточка персонажа содержит следующие поля:
| Поле | Описание | Обязательное |
|---|---|---|
| Имя (name) | Имя персонажа | Да |
| Описание (description) | Подробное описание персонажа, включая внешность, личность и историю | Да |
| Характер (personality) | Черты характера персонажа | Нет |
| Сценарий (scenario) | Описание места действия разговора | Нет |
| Первое сообщение (first_mes) | Вступительная реплика персонажа | Нет |
| Примеры диалогов (mes_example) | Примеры стиля диалога персонажа | Нет |
| Системный промпт (system_prompt) | Специфичный для персонажа системный промпт | Нет |
| Инструкции после истории (post_history_instructions) | Инструкции, вставляемые после истории сообщений | Нет |
| Альтернативные приветствия (alternate_greetings) | Несколько вариантов вступительных реплик | Нет |
| Заметки создателя (creator_notes) | Заметки о создании карточки персонажа | Нет |
| Теги (tags) | Теги классификации | Нет |
| Аватар персонажа (avatar) | Изображение аватара персонажа | Нет |
Создание карточек персонажей
Шаги
- Откройте страницу управления карточками персонажей
- Нажмите кнопку Создать персонажа
- Заполните информацию о персонаже (имя, описание, характер и т. д.)
- (Необязательно) Загрузите аватар персонажа
- (Необязательно) Напишите примеры диалогов
- (Необязательно) Задайте системный промпт
- Сохраните карточку персонажа
Импорт карточек персонажей
Elftia поддерживает импорт карточек персонажей из PNG-файлов. Многие сайты обмена карточками персонажей предоставляют PNG-изображения со встроенными данными персонажа.
Импорт из PNG
- Нажмите Импорт в управлении карточками персонажей
- Выберите PNG-файл, содержащий данные персонажа
- Система автоматически разберёт JSON-метаданные, встроенные в PNG
- Просмотрите информацию о персонаже
- Подтвердите импорт
:::info Формат метаданных PNG
- Формат V2: Данные хранятся в чанке
tEXtPNG с ключевым словомchara, содержимое — JSON, закодированный в Base64 - Формат V3: Ключевое слово —
ccv3, содержит более богатые метаданные :::
Импорт из JSON
Вы также можете напрямую импортировать файлы данных персонажей в формате JSON.
Экспорт карточек персонажей
Карточки персонажей можно экспортировать в виде PNG-файлов (со встроенными метаданными) или JSON-файлов для удобного обмена и резервного копирования.
Экспорт в PNG
- Выберите карточку персонажа для экспорта
- Нажмите кнопку Экспорт
- Выберите Формат PNG
- Система встраивает данные персонажа в аватар PNG
- Сохраните экспортированный PNG-файл
Экспортированный PNG-файл можно напрямую импортировать в SillyTavern или другие совместимые приложения.
Использование персонажей в разговорах
Шаги
- Откройте панель настроек вашей сессии чата
- Разверните раздел настроек Ролевые игры
- Выберите карточку персонажа в Выборе персонажа
- Настройте параметры RP (см. таблицу конфигурации ниже)
- Начните чат
Параметры конфигурации RP
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
| Карточка персонажа (characterCardId) | Выбор используемого персонажа | Нет |
| Имя пользователя (userName) | Ваше имя в RP | User |
| Персона пользователя (userPersona) | История вашего персонажа | Нет |
| Заметка автора (authorsNote) | Скрытые инструкции, вставляемые в контекст разговора | Нет |
| Глубина заметки автора (authorsNoteDepth) | Позиция вставки заметки (расстояние от последнего сообщения) | 4 |
| Префикс ответа (replyPrefix) | Префикс, автоматически добавляемый перед ответом AI | Нет |
| Быстрые ответы (quickReplies) | Предустановленные кнопки быстрых ответов | Нет |
| Шаблон контекста (contextTemplateId) | Пользовательский порядок сборки промпта | Нет |
| Суммаризация (summarizationEnabled) | Включить суммаризацию разговора (сжатие длинных разговоров) | Нет |
World Info
World Info — это система базы знаний для ролевых игр, хранящая записи о мире. Когда в разговоре находятся ключевые слова, соответствующие записи World Info автоматически внедряются в контекст AI.
Основные понятия
| Понятие | Описание |
|---|---|
| Книга (Book) | Контейнер для World Info, может содержать несколько записей |
| Запись (Entry) | Единый элемент знаний с ключевыми словами-триггерами и содержимым |
| Ключи (Keys) | Список ключевых слов, запускающих запись |
| Глубина сканирования (Scan Depth) | Сколько последних сообщений сканировать на совпадение ключевых слов |
| Бюджет токенов (Token Budget) | Максимальное количество токенов, которое может занять World Info |
| Рекурсивное сканирование (Recursive Scanning) | Продолжать ли сканировать ключевые слова внутри содержимого запущенных записей |
Создание World Info
- Откройте страницу управления World Info
- Создайте Книгу
- Добавьте Записи в книгу
- Задайте ключевые слова-триггеры и содержимое для каждой записи
Конфигурация записи
| Поле | Описание |
|---|---|
| Ключевые слова (keys) | Список ключевых слов, запускающих данную запись |
| Содержимое (content) | Содержимое знаний записи |
| Включена (enabled) | Включена ли данная запись |
| Порядок вставки (insertion_order) | Приоритетная сортировка при срабатывании нескольких записей |
| Учёт регистра (case_sensitive) | Учитывать ли регистр при поиске ключевых слов |
| Избирательное совпадение (selective) | Должны ли совпадать оба — первичное и вторичное — ключевые слова |
| Вторичные ключи (secondary_keys) | Вторичные ключевые слова для избирательного совпадения |
| Константа (constant) | Всегда ли включать в контекст |
| Позиция (position) | Место вставки в контексте |
| Глубина (depth) | Пользовательская глубина вставки |
| Вероятность (probability) | Вероятность срабатывания (0–100%) |
| Совпадение целых слов (match_whole_words) | Совпадать ли только с полными словами |
Настройки сканирования World Info
| Настройка | Описание | По умолчанию |
|---|---|---|
| Глубина сканирования | Сколько последних сообщений сканировать | 10 |
| Бюджет токенов | Максимальное количество токенов для использования | 2048 |
| Рекурсивное сканирование | Продолжать поиск совпадений внутри запущенного содержимого | Нет |
Использование World Info
- Выберите одну или несколько книг в панели настроек RP
- Настройте параметры сканирования
- Система автоматически сканирует и внедряет подходящие записи во время разговора
Встроенная книга знаний персонажа
Карточки персонажей могут содержать встроенную книгу персонажа (Character Book), которая автоматически создаёт соответствующую базу знаний World Info при импорте.
Групповой чат
Режим группового чата позволяет нескольким персонажам одновременно участвовать в разговорах, имитируя многостороннее взаимодействие.
Шаги
- Создайте конфигурацию группового чата
- Добавьте участвующих персонажей (карточки персонажей)
- Выберите конфигурацию группового чата в настройках RP
- Начните разговор в групповом чате
Поведение
- В каждом раунде разговора система определяет, какой персонаж отвечает, на основе конфигурации
- Личность и настройки каждого персонажа остаются независимыми
- Поддерживается ручное указание следующего персонажа для ответа
Сценарии регулярных выражений
Сценарии регулярных выражений позволяют использовать регулярные выражения для автоматической замены и изменения входных или выходных данных AI.
Сценарии использования
- Автоматическое форматирование выходных данных AI
- Замена определённых текстовых паттернов
- Добавление или удаление специфических тегов
Настройка
В разделе Сценарии регулярных выражений панели настроек RP:
- Добавьте новое правило регулярного выражения
- Введите совпадающее регулярное выражение
- Введите текст замены
- Выберите место применения (ввод / вывод)
- Включите правило
Листы спрайтов эмоций
Функция листов спрайтов эмоций позволяет персонажам динамически менять отображаемые выражения в зависимости от эмоций, выраженных в разговоре.
Настройка
- Подготовьте набор изображений выражений для персонажа (например, счастливый, грустный, злой и т. д.)
- Загрузите набор изображений выражений в настройках персонажа
- Присвойте каждому изображению соответствующие теги эмоций
- AI будет автоматически определять эмоциональный тон в ответах и переключать выражения
Совместимость с SillyTavern
Система ролевых игр Elftia высоко совместима с SillyTavern:
| Функция | Совместимость |
|---|---|
| Импорт/экспорт TavernCard V2 | Полная совместимость |
| Импорт/экспорт TavernCard V3 | Полная совместимость |
| Character Book | Полная совместимость |
| Формат World Info | Полная совместимость |
| Метаданные, встроенные в PNG | Полная совместимость |
| Сценарии регулярных выражений | Совместимо |
| Листы спрайтов эмоций | Совместимо |
Вы можете напрямую использовать карточки персонажей и World Info, экспортированные из SillyTavern, без преобразования формата.
Частые вопросы
| Вопрос | Решение |
|---|---|
| Импорт PNG не удаётся | Убедитесь, что PNG-файл содержит корректные данные персонажа (ключевое слово chara или ccv3 в чанке tEXt) |
| Персонаж не отвечает так, как задумано | Проверьте, достаточно ли подробны описание персонажа и системный промпт; добавьте больше примеров диалогов |
| Записи World Info не срабатывают | Убедитесь в правильности написания ключевых слов, проверьте, достаточна ли глубина сканирования |
| World Info превышает бюджет токенов | Уменьшите количество константных записей или увеличьте бюджет токенов |
| Персонажи группового чата путаются | Убедитесь, что описание каждого персонажа достаточно уникально, избегайте пересечения личностей |
| Выражения не переключаются | Убедитесь, что изображения выражений правильно загружены и помечены тегами эмоций |
| Другие приложения не распознают после экспорта | Убедитесь, что формат экспорта совместим с целевым приложением (V2 имеет наибольшую совместимость) |
| Заметка автора не работает | Проверьте настройку глубины заметки автора, убедитесь, что глубина не превышает текущее количество сообщений |
Связанные ссылки
- Чат — Использование ролевых игр в чате
- LLM-провайдеры — Настройка AI-моделей для RP
- Промпты — Настройка шаблонов промптов