Public Help
Функции

книги знаний

Подробное руководство по созданию, импорту, управлению и связыванию книг знаний с ИИ-персонажами на Public.

Книги знаний (часто называемые Мировая информация) — это отдельные сборники знаний, фактов о событиях, подробностей о фракциях, магических системах и справочных знаний, на которые вы можете ссылаться. ИИ-персонажи. Когда вы общаетесь с персонажем, соответствующие записи из связанной книги знаний динамически извлекаются и вводятся непосредственно в подсказку модели.

В отличие от основной личности персонажа, книга знаний полностью модульна: вы можете связать одну и ту же книгу знаний с несколькими персонажами (например, связать общую книгу знаний Starfall Academy с Мирой, Тобином, профессором Вейлом и лордом Эшгрейвом) или поменять местами книги знаний, не меняя голос персонажа.

Основные понятия

Чтобы получить максимальную отдачу от лорбуков, полезно понять, как они сочетаются с другими инструментами ролевой игры на Public:

  • Личность персонажа — определяет кем является персонаж: его стиль речи, предысторию, причуды и правила поведения.
  • Персонажи чата — определяют кто вы: ваше имя, внешний вид и личность в разговоре. См. Персонажи чата.
  • Книги знаний — определяют мир вокруг вас: исторические события, фракции, локации, заклинания, технологические правила и знания взаимоотношений.

Частные и публичные книги знаний

ВидимостьКто может связать это с персонажемКто может редактировать или удалять его
ЧастныйТолько тыТолько ты (создатель)
PublicЛюбой создатель на Public может связать его при создании или редактировании своих персонажей.Только ты (создатель)

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


Как работает внедрение контекста

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

1. Сканированные текстовые объекты

Механизм контекста проверяет соответствие записей во всем активном контексте разговора:

  • Последнее входящее сообщение пользователя
  • История последних разговоров в чате
  • Прокручивающееся резюме разговора
  • Закрепленные и автоматически извлеченные воспоминания персонажей.
  • Оригинальное приветствие персонажа

2. Типы соответствия записей

Каждая запись в лорбуке имеет одно из двух триггеров поведения:

  • По ключевому слову (constant: false) — Запись определяет список ключевых слов (например, ["emberwing", "house of the phoenix"]). Если какое-либо ключевое слово появляется где-либо в отсканированном тексте разговора (совпадение подстроки без учета регистра), запись срабатывает.
  • Постоянная (constant: true) — Запись всегда включается в каждый обмен сообщениями, полностью игнорируя ключевые слова. Идеально подходит для глобальных базовых сценариев (например, "1204 год, Завеса скрывает Starfall Academy от внешнего мира").

3. Управление приоритетами и бюджетом

Модели имеют ограниченное количество контекстных окон подсказок. Чтобы обеспечить быстроту, согласованность и экономичность реагирования, Public устанавливает бюджет внедрения:

  • Ограничение бюджета на количество символов: до 1800 символов (LOREBOOK_INJECT_MAX_CHARS) содержимого книги знаний можно вводить в каждое сообщение. – Приоритетный порядок. Все совпадающие записи (как постоянные, так и связанные с ключевыми словами) сортируются по Приоритету в порядке убывания (100 раньше 50, прежде чем 0). – Соответствие бюджету. Записи добавляются одна за другой, начиная с самого высокого приоритета, пока не будет достигнут бюджет в 1800 символов. Если запись превышает оставшийся бюджет, она опускается (или добавляется, если это первая запись).

4. Формат блока впрыска

Триггерные записи форматируются в чистый блок и передаются в системную подсказку персонажа:

Relevant world info:
- Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth.
- Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black.
- Dueling spells: Flare blinds an opponent; Binding Thread slows them; Mirror Ward reflects minor curses.

Спецификации и ограничения полей

Метаданные книги знаний

ПолеТипТребуетсяОграничения и описание
nameСтрокаОбязательноМакс. 120 символов. Название мира или сеттинга.
descriptionСтрокаНеобязательноМакс. 500 символов. Краткое описание сеттинга.
visibilityСтрокаНеобязательно"private" (по умолчанию) или "public". Public книги знаний появляются в поиске и открытии.
tagsМассивНеобязательноДо 20 тегов. Теги обрезаны и переведены в нижний регистр.
entriesМассивНеобязательноДо 100 записей в книге знаний.

Метаданные записи

ПолеТипТребуетсяОграничения и описание
contentСтрокаОбязательноМаксимум 1000 символов. Фактический текст мировой информации, введенный в модель.
constantлогическое значениеНеобязательноПо умолчанию false. Если true, эта запись всегда активна при каждом обмене сообщениями.
keysМассивОбязательно, если не постоянноДо 20 клавиш, максимум 64 символа каждая. Триггерные слова или фразы. Игнорируется, если constant: true.
enabledлогическое значениеНеобязательноПо умолчанию true. Выключите, чтобы временно отключить запись, не удаляя ее.
priorityНомерНеобязательноПо умолчанию 0. Более высокие числа вводятся первыми, когда контекстное пространство ограничено (например, 100, 85, 50).

Поддерживаемые форматы JSON

Вы можете импортировать, вставлять и экспортировать книги знаний, используя три стандартизированных формата:

1. Собственная схема книги знаний Public (рекомендуется)

Это собственная схема JSON Public. Он поддерживает все поля напрямую:

{
  "name": "Starfall Academy",
  "description": "Comprehensive lorebook covering Starfall Academy's houses, spells, lore, and magical laws.",
  "visibility": "public",
  "tags": [
    "fantasy",
    "starfall",
    "academy",
    "magic",
    "spells"
  ],
  "entries": [
    {
      "keys": [],
      "content": "Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth. Magic is channeled through focus crystals.",
      "enabled": true,
      "constant": true,
      "priority": 100
    },
    {
      "keys": [
        "emberwing",
        "aria emberwing",
        "house of the phoenix"
      ],
      "content": "Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black. Its common room is at the top of the Ember Tower.",
      "enabled": true,
      "constant": false,
      "priority": 85
    },
    {
      "keys": [
        "focus crystal",
        "crystal lore",
        "crystal vault"
      ],
      "content": "Every student bonds with one focus crystal. Crystals are grown from rare minerals and hold a single element such as flame, tide, or storm. A bond breaks only by choice.",
      "enabled": true,
      "constant": false,
      "priority": 80
    },
    {
      "keys": [
        "flare",
        "binding thread",
        "mirror ward"
      ],
      "content": "Dueling spells: Flare (blinds an opponent), Binding Thread (slows them), and Mirror Ward (creates a shield that reflects minor curses).",
      "enabled": true,
      "constant": false,
      "priority": 75
    }
  ]
}

2. Экспорт информации о SillyTavern World

Импортер автоматически определяет автономный экспорт SillyTavern, в котором entries используется как словарь объектов:

{
  "name": "Starfall World Info",
  "description": "SillyTavern export",
  "entries": {
    "0": {
      "uid": 0,
      "key": ["the veil", "magic"],
      "content": "The Veil hides Starfall Academy from the outside world.",
      "constant": true,
      "disable": false,
      "order": 100
    },
    "1": {
      "uid": 1,
      "key": ["starfall academy", "castle"],
      "content": "Starfall Academy stands on a floating island above the Silver Sea.",
      "constant": false,
      "disable": false,
      "order": 50
    }
  }
}

3. Карта персонажа SillyTavern (character_book)

Вы также можете импортировать карты персонажей (карты спецификаций V2 или V3), которые включают в себя character_book объект:

{
  "spec": "chara_card_v2",
  "spec_version": "2.0",
  "data": {
    "name": "Mira Vale",
    "tags": ["fantasy", "magic"],
    "character_book": {
      "name": "Starfall Library Lore",
      "description": "Magical theory and reference entries",
      "entries": [
        {
          "keys": ["silverkey", "unlocking charm"],
          "content": "The Silverkey charm unlocks standard doors and windows.",
          "enabled": true,
          "constant": false,
          "insertion_order": 10
        }
      ]
    }
  }
}

Создавайте и управляйте книгами знаний

В сети

Перейдите к /lorebooks в браузере или выберите Книги знаний в меню боковой панели.

Создание с нуля

  1. Перейти к /lorebooks/create.
  2. Дайте вашей книге знаний описательное Имя и необязательное Описание/Теги.
  3. Выберите видимость Частный или Public.
  4. Нажмите Добавить запись, чтобы создать правила. Укажите ключевые слова триггера или установите флажок Всегда активен (постоянный).
  5. Нажмите Создать книгу знаний, чтобы сохранить.

Импорт существующих книг знаний

У вас есть два быстрых способа загрузить существующую информацию о мире:

  1. Импортировать файл — нажмите Импортировать файл в верхней панели действий, чтобы загрузить любой файл. .json книга знаний или файл карты персонажа с вашего компьютера.
  2. Вставить JSON — нажмите Вставить JSON, чтобы открыть диалоговое окно анализа: – Нажмите Вставить из буфера обмена, чтобы получить текст JSON, скопированный из другого приложения. – Нажмите Загрузить пример, чтобы просмотреть предварительно заполненный шаблон Starfall Academy. – Нажмите Разобрать и импортировать, чтобы мгновенно заполнить форму.

Экспорт и копирование

  • На любом экране создания, редактирования или подробного описания книги знаний нажмите Копировать JSON.
  • Вся книга знаний преобразуется в стандартизированный формат Public JSON и копируется прямо в буфер обмена.

Привязка к ИИ-персонажу

После создания лорбука:

  1. Открыть /characters/add (или нажмите Редактировать на любом созданном вами персонаже).
  2. Прокрутите список до пункта выбора Книга знаний (необязательно).
  3. Выберите свою книгу знаний или одну из популярных общедоступных книг знаний, созданных сообществом.
  4. Сохраните своего персонажа. Любые последующие чаты с этим персонажем будут автоматически взяты из книги знаний.

Ограничения плана и разблокировка

ПланЛорбуки, которые вы можете создатьЗаписей в лорбуке
Бесплатно3До 100
Базовый10До 100
Автор/ПрофессионалБезлимитныйДо 100

Для создания книги знаний требуется разблокировка книги истории персонажей (на том же уровне развития, что и пользовательские персонажи в чате). См. Подписки и Геймификация.


Рекомендации для авторов

– Используйте описательные, конкретные ключевые слова. Используйте имена и сложные фразы, например ["aria emberwing", "house of the phoenix"] а не обычные короткие слова, такие как ["the", "is", "he"].

  • Зарезервируйте постоянные записи для универсальных правил: Сохранить constant: true записи ограничены 1–2 базовыми правилами (например, текущая временная шкала, основная физика мира), поэтому они не занимают весь бюджет в 1800 символов. – Содержание записей должно быть кратким. Эффектные записи, состоящие из 1–3 понятных предложений, позволяют одновременно разместить несколько релевантных записей в контекстном окне.
  • Используйте оценки приоритета: Дайте фундаментальным знаниям более высокий приоритет (100–80) и незначительные декоративные элементы получают более низкие баллы (40–10), поэтому наиболее критический контекст гарантированно будет внедрен первым.

Часто задаваемые вопросы

Почему моя запись в лоребуке не сработала в чате?

Проверьте следующее:

  1. Установлен ли для записи статус Включен?
  2. Появлялись ли какие-либо точные ключевые слова в недавнем чате или последнем приглашении пользователя? (Совпадения — это совпадения подстрок без учета регистра).
  3. Заполнили ли записи с более высоким приоритетом бюджет в 1800 символов первыми? Попробуйте повысить оценку Приоритета записи.

Могу ли я связать более одной книги знаний с одним персонажем?

В настоящее время каждый персонаж может быть связан с одной книгой знаний одновременно. Если вам нужен контент из нескольких книг знаний, объедините их записи в одну книгу знаний с помощью Вставить JSON или инструментов экспорта.

Что произойдет, если я удалю книгу знаний?

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

Могу ли я редактировать общедоступную книгу знаний, созданную кем-то другим?

Нет. Только оригинальный создатель может редактировать лорбук. Если вы хотите настроить общедоступную книгу знаний, просмотрите ее, нажмите Копировать JSON, создайте новую книгу знаний и вставьте JSON в свою личную копию.

Доступно ли управление мобильной книгой истории?

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


Сопутствующая документация

На этой странице

Основные понятияЧастные и публичные книги знанийКак работает внедрение контекста1. Сканированные текстовые объекты2. Типы соответствия записей3. Управление приоритетами и бюджетом4. Формат блока впрыскаСпецификации и ограничения полейМетаданные книги знанийМетаданные записиПоддерживаемые форматы JSON1. Собственная схема книги знаний Public (рекомендуется)2. Экспорт информации о SillyTavern World3. Карта персонажа SillyTavern (character_book)Создавайте и управляйте книгами знанийВ сетиСоздание с нуляИмпорт существующих книг знанийЭкспорт и копированиеПривязка к ИИ-персонажуОграничения плана и разблокировкаРекомендации для авторовЧасто задаваемые вопросыПочему моя запись в лоребуке не сработала в чате?Могу ли я связать более одной книги знаний с одним персонажем?Что произойдет, если я удалю книгу знаний?Могу ли я редактировать общедоступную книгу знаний, созданную кем-то другим?Доступно ли управление мобильной книгой истории?Сопутствующая документация