Лорбук6 минут чтения

Директивы @@ в лорбуке: управление записями изнутри

Строки @@ в начале текста записи управляют её поведением: принудительное включение, позиция в промпте, глубина, роль, привязка к приветствию. Полный справочник с примерами.

Автор
Scenly
Опубликовано

TL;DR

  • Директивы — это строки вида @@имя значение в начале текста записи. Они управляют поведением записи, а модель их не видит.
  • @@activate включает запись всегда, @@dont_activate — выключает даже при совпадении ключей.
  • @@depth и @@role вставляют запись прямо в историю чата — как реплику нужной роли на нужной глубине.
  • @@activate_only_after и @@activate_only_every включают запись по счётчику реплик персонажа.
  • Неизвестные директивы игнорируются без ошибки — карточка не ломается.

Как пишутся директивы

Директивы — это первые строки текста записи. Каждая — отдельная строка вида @@имя или @@имя значение. После директив идёт пустая строка, а дальше — сам текст записи.

@@position personality
@@depth 1
@@role system

Персонаж никогда не говорит о своём брате. При упоминании — меняет тему.

Правила синтаксиса:

  • две собаки (@@) — стандартная директива. Три (@@@) — тоже работают, разницы нет;
  • имя — латиницей, без пробелов. Значение — после пробела;
  • несколько директив — по одной на строке, друг под другом;
  • всё после пустой строки — текст записи. Он и попадёт в промпт;
  • неизвестное имя — игнорируется, строка удаляется из текста. Карточка остаётся валидной.

Директивы — инструмент из «продвинутой» категории: для большинства записей они не нужны. Но для точной настройки поведения — незаменимы.


Включение и выключение

@@activate — запись включается всегда, как постоянная. Отличие от галочки «постоянная запись»: директива живёт в тексте и переносится с карточкой в другие сервисы, а галочка — настройка конкретной площадки.

@@activate

Действие происходит в городе, где магия запрещена законом.

@@dont_activate — запись не включается никогда, даже если ключи совпали. Способ «заморозить» запись, не удаляя её: черновик, запасной вариант, отключённая ветка сюжета.

@@dont_activate

Черновик: реакция на пожар в лаборатории. Пока не готова.

Если в записи есть и @@activate, и @@dont_activate — побеждает @@activate: включение сильнее выключения.


Позиция в промпте

@@position — куда именно вставить текст записи относительно полей карточки.

ЗначениеКуда попадёт текст
before_charПеред текстом персонажа (до имени и описания)
after_charПосле описания, перед характером
personalityПрямо внутрь блока характера
scenarioПрямо внутрь блока сценария
before_descПеред описанием
after_descПосле описания
@@position personality

В стрессовых ситуациях характер персонажа ломается: маска даёт трещину.

Нюанс: значения personality, scenario, before_desc, after_desc сработают, только если соответствующее поле карточки непустое. Если характера нет — вставка в «характер» откатится к обычному поведению.

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


Вставка в историю: depth и role

Самая мощная пара директив. @@depth N вставляет текст записи не в блок карточки, а прямо в историю чата — на N сообщений от конца. @@role задаёт, чьей репликой она будет.

@@depth 1
@@role system

(Тихий голос из динамика: «Не верь ему».)

Значения @@role:

  • system — системная вставка (по умолчанию). Модель видит её как служебный текст;
  • user — вставка выглядит как сообщение собеседника;
  • assistant — вставка выглядит как реплика персонажа.

Зачем это нужно:

  • свежесть. Запись на глубине 1 стоит сразу перед ответом — модель не может её «не заметить». Это способ протолкнуть важное в длинном чате;
  • сценические эффекты. Вставка от user или assistant читается как часть диалога — шёпот, голос из динамика, воспоминание;
  • напоминания. Правило формата на глубине 0–1 работает надёжнее, чем в системном промпте, который «далеко».

Глубина считается от конца истории: @@depth 0 — в самом конце, @@depth 1 — перед последним сообщением, @@depth 3 — за три сообщения до конца.


Счётчики: after и every

Эти директивы привязывают включение записи к ходу диалога — по числу реплик персонажа.

@@activate_only_after N — запись начинает срабатывать только после N реплик персонажа.

@@activate_only_after 5

Персонаж начинает проявлять ревность: переспрашивает, где был собеседник.

До пятой реплики запись спит — персонаж «ещё не дошёл» до этой стадии. После — работает по своим ключам.

@@activate_only_every N — запись срабатывает только когда число реплик персонажа кратно N.

@@activate_only_every 3

Персонаж вспоминает о долге и напоминает о нём.

Запись включится на 3-й, 6-й, 9-й реплике — периодически, а не постоянно.

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


Привязка к приветствию

@@is_greeting N — запись работает только когда чат начался с приветствия номер N.

@@is_greeting 1

В этой версии начала персонаж уже знает секрет собеседника.

Нумерация: 0 — первое сообщение, 1 — первое альтернативное, 2 — второе и так далее.

Это инструмент для карточек с несколькими приветствиями-сценариями: каждое приветствие может тянуть за собой свой набор записей. Ветка «они уже знакомы» получает свои факты, ветка «первая встреча» — свои.

Без директивы запись работает при любом приветствии.


Тонкая настройка срабатывания

@@scan_depth N — своя глубина просмотра для этой записи, вместо общей по книге. Запись о «давнем событии» может смотреть на 10 сообщений назад, когда книга в целом смотрит на 4.

@@scan_depth 10

Персонаж помнит обещание, данное в начале разговора, и ждёт его выполнения.

@@exclude_keys — список слов-исключений: если они есть в окне просмотра, запись не сработает, даже при совпадении ключей.

@@exclude_keys шутка, розыгрыш

Персонаж всерьёз реагирует на упоминание увольнения.

Шутка про увольнение не включит запись — а серьёзный разговор включит.

@@additional_keys — дополнительная группа ключей. Можно указать несколько раз; запись сработает, только если каждая группа нашлась в окне. Это «вторичные ключи на стероидах»: не одно условие, а несколько независимых.

@@additional_keys ночь
@@additional_keys один

Персонаж боится оставаться один в тёмное время.

Сработает только на «ночь» и «один» одновременно.

@@ignore_on_max_context — когда контекст переполнен и платформа урезает лишнее, такая запись выкидывается первой. Способ пометить «приятное, но не критичное»: украшения, атмосферные детали.


Отключение полей карточки

@@disable_ui_prompt — убирает из промпта одно из полей карточки, когда запись сработала.

@@disable_ui_prompt system_prompt

(Запись заменяет стиль речи на «панический» — авторский system_prompt мешает.)

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


Шпаргалка

ДирективаЧто делает
@@activateВключить запись всегда
@@dont_activateВыключить запись полностью
@@position XКуда вставить: before_char, after_char, personality, scenario, before_desc, after_desc
@@depth NВставить в историю чата на глубине N
@@role XРоль вставки: system, user, assistant
@@activate_only_after NСрабатывать после N реплик персонажа
@@activate_only_every NСрабатывать на каждой N-й реплике
@@is_greeting NРаботать только с приветствием номер N
@@scan_depth NСвоя глубина просмотра для записи
@@exclude_keys a, bНе срабатывать при наличии слов-исключений
@@additional_keys a, bДополнительная обязательная группа ключей
@@ignore_on_max_contextВыкидываться первой при переполнении контекста
@@disable_ui_prompt XСкрыть поле карточки при срабатывании

Частые вопросы

Обязательно ли учить директивы? Нет. Обычные записи с ключами покрывают 90% задач. Директивы — для точной настройки, когда обычных средств мало.

Директивы видит модель? Нет. Они вычищаются из текста перед отправкой. Модель видит только текст записи после директив.

Что будет с директивами при экспорте в другой сервис? В JSON и CHARX они останутся в тексте записи — это часть формата. В PNG карточка лежит в двух копиях: полная V3 с директивами и упрощённая V2, из которой директивы вычищены — старый формат их не понимает. Другой сервис может не понять директивы и показать как обычный текст. Учитывайте при переносе.

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

Директива не сработала — что проверить? Синтаксис: две собаки, латинское имя, значение через пробел, директива — в первых строках записи. И помните: неизвестные имена молча игнорируются.

@@depth 0 и @@depth 1 — в чём разница? @@depth 0 — вставка в самом конце истории, после последнего сообщения. @@depth 1 — перед последним сообщением. Для «напоминаний перед ответом» обычно берут 0 или 1.


Что дальше

  1. Лорбук персонажа: факты, которые включаются по ключам — база, без которой директивы не нужны.
  2. Ключи лорбука: как писать триггеры, которые срабатывают — живые ключи и вторичные условия.
  3. Все поля карточки персонажа — где в карточке живёт лорбук.

Директивы — уровень «продвинутый автор». Если вы только начинаете, начните с конструктора: он соберёт лорбук без единой директивы — и это будет работать.