Документация

LiterAI — это продвинутая платформа для создания текстовых ролевых историй совместно с ИИ. Главная особенность проекта — полная конфиденциальность. Все ваши чаты, персонажи, лорбуки и настройки хранятся исключительно локально в вашем браузере (IndexedDB). Платформа работает по принципу BYOK (Bring Your Own Key) — вы сами подключаете любимую нейросеть через API (например, OpenRouter, OpenAI, Anthropic, локальные серверы) и полностью контролируете процесс.

Никто, кроме вас, не имеет доступа к вашим историям. В проекте нет централизованного бэкенда с базой данных. Вся информация (персонажи, ветки диалогов, настройки читмода, ключи API, приватные чаты) сохраняется в памяти вашего браузера. Чтобы не потерять данные при очистке кэша, регулярно используйте функцию «Полный бэкап» в настройках. Бэкап можно перенести на другое устройство.

В проекте есть 3 уникальных режима:

1. Ролевой чат (Roleplay): Классический режим 1 на 1. Вы играете за одного персонажа, ИИ играет за другого. 5 шагов настройки: персонаж ИИ, роль ИИ, ваш персонаж, ваша роль, сцена.

2. Игра за героя (Hero): Вы отыгрываете протагониста, а ИИ берет на себя роль «Рассказчика» (Dungeon Master). ИИ описывает мир, управляет погодой, врагами и всеми NPC, с которыми вы встречаетесь. 3 шага настройки: ваш герой, его роль, сцена.

3. Игра за команду (Team): Масштабный режим, где вы можете добавить в сюжет до 10 персонажей. ИИ выступает Рассказчиком, а вы можете отдавать приказы любому члену команды или наблюдать за их самостоятельным взаимодействием. Включает приватные чаты между персонажами.

Ветвление — это мощная фишка, позволяющая переиграть историю. Если вы хотите посмотреть, «а что было бы, если бы я поступил иначе», нажмите кнопку «Ветвление» на любом сообщении и измените текст. LiterAI создаст новую «Ветвь» (Branch), сохранив оригинальную историю нетронутой. Вы можете переключаться между ветвями в специальном меню под полем ввода. Каждая ветвь имеет свою историю сообщений и может быть удалена отдельно.

Под каждым ответом ИИ есть кнопка с иконкой кубиков (Реролл / Перегенерировать). Нажмите её, и ИИ напишет новый вариант ответа. Все предыдущие версии сохраняются! В заголовке сообщения появятся стрелочки (например, 2/4), с помощью которых вы можете листать все сгенерированные варианты и выбрать лучший. Это работает для всех режимов игры.

Да, абсолютная свобода! Нажмите иконку карандаша под любым сообщением (как вашим, так и ИИ). Вы можете исправить опечатку, дописать действие или полностью изменить реакцию персонажа. Доступны два режима:
— Редактирование: изменяет сообщение и продолжает историю
— Ветвление: создаёт новую ветку с изменённым сообщением
ИИ учтет ваши правки в дальнейшей генерации.

У любой нейросети есть лимит памяти (контекстное окно). Если чат становится слишком длинным, ИИ начинает забывать начало или выдавать ошибки.

В LiterAI встроена умная система «Частей». Нажав кнопку «Суммаризация», ИИ прочитает всю текущую часть истории и создаст её краткий пересказ. Старая часть закрывается (но остается доступной для чтения), и открывается новая часть. В память ИИ передается только сжатый пересказ и несколько последних сообщений. Это экономит токены и позволяет играть бесконечно. Вы можете редактировать саммари предыдущих частей.

Это система помощи игроку. В системном промпте зашито правило предлагать вам 2 варианта развития событий в формате списка. Это помогает, если вы не знаете, что написать дальше. Достаточно нажать на один из предложенных вариантов, и он автоматически отправится в чат. Эту функцию можно отключить в разделе «Настройки → ИИ → Вывод подсказок».

Приватные чаты — это эксклюзивная механика режима «Команда». Вы можете открыть боковую панель и заставить двух персонажей пообщаться наедине (в тайне от остальных).

Самое крутое: когда вы вернетесь в основной чат, ИИ будет знать, о чем персонажи шептались в привате! Их скрытые договоренности, ссоры или секреты автоматически вплетаются в основной сюжет невидимым для других героев образом. Приватные чаты сохраняются вместе с историей и экспортируются при бэкапе.

Внизу экрана вы видите аватарки всех выбранных персонажей и кнопку «Рассказчик».

Нажав на Рассказчика, вы просите ИИ описать события в мире. Нажав на аватарку персонажа, вы заставляете ИИ сгенерировать действие и слова конкретно от лица этого героя. Также вы можете сами написать текст в поле ввода от лица любого персонажа. В приватных чатах есть карусель отправителей — можно выбирать, от имени какого персонажа вести диалог.

Читмод — это ваша панель бога. В ней вы можете ползунками от 0 до 100 настраивать параметры вселенной прямо во время игры.

Например, вы можете повысить «Уровень опасности» до 90%, и на героев тут же нападут. Можете выкрутить «Романтическое напряжение», «Уровень магии» или «Жестокость». Эти параметры динамически добавляются в системный промпт при каждом запросе. Доступны системные пресеты и возможность создавать свои.

Во вкладке «Читмод» вы можете выбрать двух персонажей и создать между ними связь. Затем ползунками настроить их уровень «Любви», «Доверия», «Вражды» или «Преданности». ИИ немедленно изменит их поведение в чате согласно этим скрытым параметрам.

Новое: можно сохранять шаблоны отношений (пресеты) и загружать их. Есть базовые шаблоны: Любовь, Ненависть, Дружба, Соперничество, Подчинение. Можно создавать свои шаблоны и экспортировать/импортировать их.

Лорбук — это энциклопедия вашего мира. Нейросети не могут помнить огромные объемы текста об устройстве вашей вселенной. Лорбук решает эту проблему. Вы создаете записи (например, о древнем мече, городе или расе) и привязываете к ним ключи-триггеры.

Когда в чате упоминается ключевое слово, LiterAI незаметно достает описание из Лорбука и отправляет его ИИ. Так нейросеть «вспоминает» лор ровно в тот момент, когда он нужен. Поддерживаются форматы SillyTavern и простой текст.

Это продвинутая функция. Если персонаж упоминает «Короля», активируется запись о Короле. Если в тексте записи о Короле есть слово «Экскалибур», рекурсивное сканирование автоматически найдет и подтянет запись про меч «Экскалибур», даже если сам меч в чате не упоминался. Это позволяет строить глубокие логические цепочки знаний.

Новая функция! Векторный поиск позволяет ИИ находить записи в Лорбуке по смыслу, даже если точные слова не упоминаются в тексте.

Как работает:
1. Включите «Умный поиск» в настройках Лорбука
2. Настройте URL API эмбеддингов (совместимый с OpenAI)
3. Укажите модель эмбеддингов и API ключ (если нужен)
4. Нажмите «Векторизовать текущий Лорбук»
5. Настройте порог срабатывания (рекомендуется 0.75)

ИИ будет сравнивать смысл сообщений с записями лорбука математически, находя скрытые связи.

Аналитика — это отдельный модуль, который читает вашу историю и выдает подробный отчет о происходящем.

Он показывает:
— Уровень напряжения и фазу сюжета
— Текущую погоду и локацию
— Статистику по персонажам (здоровье, инвентарь, настроение)
— Скрытые мотивы NPC и их «секретные мысли»
— Предсказания вероятных вариантов развития сюжета
— Советы по развитию истории и персонажей
— Временную шкалу событий

В командном режиме аналитика также учитывает секреты из приватных чатов!

Когда вы запускаете Аналитику, ИИ оценивает поведение персонажей (особенно NPC) и генерирует их «Скрытую мысль» — то, что они думают на самом деле, но не говорят вслух. В интерфейсе она скрыта под спойлером, чтобы вы могли подглядеть за истинными мотивами собеседников. Это помогает понять скрытые интриги и готовиться к неожиданным поворотам сюжета.

В меню чата есть кнопка «Карта». При её нажатии ИИ анализирует последние события и сюжет, вычленяет названия локаций (города, леса, подземелья) и пути между ними. Затем строится интерактивный визуальный граф, где вы можете двигать узлы.

Уровни карты:
— Макро: страны, регионы, города
— Средний: улицы, районы, крупные подземелья
— Микро: здания, таверны, замки
— Ультра-микро: конкретные комнаты, залы, коридоры

Карта обновляется по мере вашего продвижения по миру.

1. Откройте боковое меню (шестеренка справа сверху)
2. Перейдите в «Провайдеры» и нажмите «Добавить»
3. Введите URL API (например, https://openrouter.ai/api/v1/chat/completions)
4. Укажите название модели (например, anthropic/claude-3.5-sonnet)
5. Вставьте ваш личный API Key
6. Нажмите «Проверить соединение». Если все верно — провайдер готов к работе!

Можно добавить несколько провайдеров и переключаться между ними. Порядок провайдеров можно менять перетаскиванием.

В разделе «Настройки → ИИ» можно тонко настроить «мозг» нейросети:

— Температура (Temperature 0-2): Чем выше, тем креативнее и безумнее ответы. Чем ниже, тем логичнее, но суше. Оптимально: 0.7-1.0
— Max tokens (1000-64000): Максимальная длина ответа ИИ
— Top P (0-1): Альтернатива температуре, влияет на разнообразие
— Frequency Penalty (0-2): Штраф за частые повторения слов
— Presence Penalty (0-2): Штраф за повторение тем, заставляет переходить к новым идеям

В боковом меню выберите «Дизайн». Вам доступны профессиональные цветовые схемы:
— Default (Velvet/Gold)
— Ocean
— Matrix
— Sunset
— Monochrome
— Light
— Orange Cola
— Retro RPG
— Visual Novel
— Dark Fantasy

Там же можно изменить шрифт, его размер (12-22px), загрузить собственную картинку на задний фон и настроить стиль аватарок в чате (маленькие, крупные, на всю ширину).

Вы можете полностью переопределить внешний вид интерфейса с помощью собственных CSS-стилей!

1. Откройте боковое меню настроек (шестеренка)
2. Перейдите в раздел «Дизайн»
3. В самом низу найдите поле «Пользовательский CSS»
4. Вставьте туда свой код. Изменения применятся мгновенно!

В FAQ есть пример стиля «Киберпанк 2077». Если сломали интерфейс — просто удалите весь текст из поля CSS. На мобильных устройствах нажмите Alt+S (или Alt+Ы) для доступа к настройкам.

Экспорт доступен в нескольких форматах:

1. JSON файл — классический формат сохранения
2. Картинка со стеганографией — история прячется внутри изображения (PNG, JPG, WebP)
3. Полный бэкап — всё сразу (чаты, каталог, настройки, лорбуки)

Новое: Шифрование экспорта!
— Без шифрования (открытый файл)
— Авто-шифрование (ключ внутри, скрывает текст от чтения)
— Пароль (требуется пароль при импорте, без пароля восстановление невозможно)

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

1. Откройте меню «Функции» (или на главном экране выберите «Бэкап»)
2. Нажмите «Сохранить Бэкап» — скачается единый JSON-файл со всем: чаты, каталоги, настройки, лорбуки, API-ключи
3. На новом устройстве откройте «Бэкап» → «Восстановить»
4. Выберите файл бэкапа и подтвердите
5. Приложение перезагрузится с вашими данными

Внимание: восстановление полностью заменяет текущие данные!

Скрипт — это базовые правила для ИИ, определяющие его стиль общения. Откройте модальное окно «Скрипт» во время игры.

Особенности по режимам:
— Ролевой чат: один системный промпт
— Игра за героя: промпт рассказчика
— Команда: три промпта (Вступление, Отрыгрыш персонажа, Продолжение)

Можно выбирать пресеты (Боевик, Юмор, Драма и др.) или писать свои правила. Пользовательские пресеты сохраняются, экспортируются и импортируются. Изменения применяются к текущему чату мгновенно.

Три способа:

1. Создать вручную: в Каталоге нажмите ➕, заполните имя, описание, теги, загрузите аватар (до 2MB)

2. Импорт: LiterAI поддерживает импорт персонажей, сцен и ролей в формате JSON. При импорте чужого сохранения все неизвестные персонажи могут быть добавлены в каталог одним кликом

3. Каталог историй: на странице /stories доступны готовые сценарии с персонажами, которые добавляются при запуске истории

Пользовательские карточки помечаются звездочкой ⭐ и могут быть отредактированы или удалены.

Максимально безопасно:

✓ Все данные хранятся локально в браузере (IndexedDB + localStorage)
✓ Никакой серверной базы данных — разработчики не имеют доступа
✓ API-ключи не передаются третьим сторонам, используются только для запросов к вашему провайдеру
✓ При экспорте API-ключи по умолчанию не сохраняются (опция в полном бэкапе)
✓ Поддержка шифрования экспорта паролем
✓ Стеганография — можно спрятать историю в картинку

Рекомендация: регулярно делайте бэкапы и храните их в надежном месте.

Да! LiterAI полностью адаптирован для мобильных:

✓ Адаптивный дизайн для всех экранов
✓ Сенсорное управление всеми элементами
✓ Оптимизированные меню и модальные окна
✓ Поддержка PWA (можно добавить на домашний экран)
✓ Работает офлайн (после загрузки)
✓ Горизонтальная и портретная ориентация

На мобильных некоторые элементы упрощены: кнопки действий всегда видны, тексты кнопок скрыты, модальные окна занимают больше экрана.

Логирование — инструмент отладки для продвинутых пользователей. В меню «Функции» → «Логирование»:

✓ Просмотр всех запросов к API (запросы, ответы, ошибки)
✓ Фильтрация по типу (request/response/error)
✓ Поиск по содержимому логов
✓ Экспорт логов в JSON
✓ Тайминги запросов (длительность в мс)
✓ HTTP статус коды

Полезно для:
— Отладки проблем с провайдером
— Анализа токенов
— Понимания что отправляется ИИ
— Сообщения об ошибках разработчикам

Можно включить/выключить логирование. Хранится до 100 записей.

Каталог — это библиотека ваших персонажей, ролей и сцен.

Функции:
✓ Поиск по названию
✓ Фильтрация по тегам
✓ Фильтр «Мои» (только созданные вами)
✓ Сортировка по дате создания
✓ Алфавитная навигация (A-Z)
✓ Создание новых карточек с аватарами
✓ Редактирование и удаление
✓ Экспорт/Импорт каталога
✓ Виртуальный скроллинг для тысяч карточек

Карточки с аватарами показывают превью, поддерживают ленивую загрузку. Пользовательские карточки защищены от перезаписи сид-данными.

Да, основные горячие клавиши:

— Enter: Отправить сообщение (в чате)
— Shift+Enter: Перенос строки (в чате)
— Escape: Закрыть модальное окно/меню/лайтбокс
— Alt+S (или Alt+Ы): Открыть настройки (на мобильных)

В поле ввода чата:
— Enter без Shift = отправка
— Shift+Enter = новая строка

Навигация по модальным окнам поддерживается через Tab.

Каталог историй — это коллекция готовых сценариев для быстрого старта!

Каждая история включает:
✓ Готовых персонажей с аватарами
✓ Проработанный сеттинг и лор
✓ Начальный сценарий для ИИ
✓ Настроенные промпты

Фильтры:
— По режиму игры (Чат/Герой/Команда)
— По жанрам (фэнтези, романтика, детектив и др.)
— По тегам
— Только рекомендуемые (Выбор редакции)
— Сортировка (по умолчанию, новые, по алфавиту)

Запуск истории создает новую независимую сессию с новым ID, оригинальный шаблон не изменяется.

В Настройки → Дизайн → «Отображение аватарок в чате»:

1. Маленькие (стандарт): Классические аватарки 32-40px рядом с сообщением

2. Крупные: Увеличенные аватарки 72px с кнопкой увеличения

3. На всю ширину: Кинематографичный режим — аватарка занимает верх сообщения с затемнением, имя поверх картинки, стиль Hero

Клик по аватарке (в режимах Маленькие/Крупные) открывает фото на весь экран (Lightbox). В режиме «На всю ширину» кнопка увеличения в правом верхнем углу картинки.

Memory Book — это автоматизированная база знаний вашей истории. Пока вы играете, специальный ИИ-аналитик в фоне читает чат и создаёт структурированные заметки по категориям: Персонажи, Локации, Квесты, Инвентарь, Отношения, Лор, Таймлайн и Крючки.

Как это работает:

• Вы можете в любой момент открыть Memory Book (кнопка в меню «Функции») и увидеть актуальную выжимку из истории.
• Новые или изменённые факты подсвечиваются. Вы можете вручную редактировать любую запись, ставить «звёзды» важности или «замораживать» блоки, чтобы ИИ их не перезаписывал.
• Самое важное: содержимое Memory Book автоматически добавляется в контекст при каждой генерации ответа. ИИ видит эту «шпаргалку» и никогда не забывает ключевые события, имена или предметы, даже если чат ушёл далеко вперёд.
• Поддерживается векторный поиск — блоки памяти могут находиться по смыслу, а не только по точным словам.

Memory Book полностью сохраняется в файле сессии и при бэкапе.

«Око мира» — это всевидящий экран, отдельный от основного чата. Он позволяет вам задавать вопросы о мире, персонажах или сюжете вне ролевого отыгрыша, получая ответы от ИИ, который видит всю картину целиком.

С его помощью можно:

• Узнать, что сейчас делает конкретный NPC в другой части города («Показать персонажа…»).
• Получить прогноз событий («Что будет, если…»).
• Попросить совет или стратегию («Составь план для…»).
• Просто исследовать мир за пределами поля зрения вашего героя.

Диалог с «Оком» сохраняется в истории, а полученные «видения» и факты автоматически передаются в основной чат как системное напоминание, помогая ИИ-рассказчику учитывать скрытую от героев информацию.

Автоигра позволяет скрипту самостоятельно продолжать историю без вашего участия, выбирая случайные варианты из предложенных нейросетью.

В режимах «Ролевой чат» и «Игра за героя»: Вы задаёте количество сообщений и задержку между ответами. ИИ будет автоматически генерировать продолжения, пока не достигнет лимита или пока вы не остановите процесс.

В режиме «Игра за команду»: Вы создаёте хронологию ходов — указываете, кто должен действовать следующим (Рассказчик или конкретные персонажи). Скрипт будет запускать генерацию действий для выбранных участников по очереди, создавая динамичную сцену без вашего постоянного вмешательства.

Автоигру можно ставить на паузу, продолжать или останавливать в любой момент.

Полный бэкап (Слепок) — это единый файл, который содержит абсолютно все данные вашего приложения:

• Все сохранённые чаты (всех режимов).
• Ваш каталог персонажей, ролей и сцен.
• Все настройки (темы, шрифты, кастомный CSS, фоны).
• Добавленных провайдеров и их API-ключи.
• Загруженные лорбуки и содержимое Memory Book.

В отличие от экспорта одной сессии, бэкап позволяет полностью перенести вашу учётную запись на другое устройство или восстановить всё после переустановки браузера. Найти эту функцию можно в главном меню (кнопка «Бэкап»).

При импорте файла сохранения (JSON или картинки) LiterAI не запускает игру мгновенно, а показывает окно предпросмотра. В нём вы увидите:

• Название истории и её режим.
• Список всех персонажей, участвующих в сюжете, с их аватарами и описаниями.
• Роли и сценарий.

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

Да, в разделе «Провайдеры» вы можете менять их порядок. Для этого используйте стрелки вверх/вниз на карточке провайдера или просто перетащите карточку за значок ⋮⋮.

Зачем это нужно? Активным всегда является только один провайдер (отмечен зелёной точкой). Однако порядок в списке определяет, какой провайдер будет активирован, если вы удалите текущий активный. Также это просто удобный способ организовать коллекцию ваших API-ключей.

Пошаговая диагностика:

1. Проверьте провайдера: Настройки → Провайдеры → «Проверить соединение»
2. Проверьте API ключ: убедитесь что не истек и есть лимиты
3. Проверьте интернет: откройте любой сайт
4. Уменьшите Max Tokens: возможно превышен лимит провайдера
5. Проверьте Логирование: меню Функции → Логирование (покажет точную ошибку API)
6. Попробуйте другую модель: некоторые модели могут быть недоступны
7. Очистите кэш браузера: иногда помогает перезагрузка страницы
8. Проверьте консоль браузера (F12): там могут быть детали ошибок

Частые ошибки:
— 401: неверный API ключ
— 429: превышен лимит запросов
— 500: проблема на стороне провайдера
— Timeout: слишком долгий ответ (120 сек лимит)