Директивы @@ в лорбуке: управление записями изнутри
Строки @@ в начале текста записи управляют её поведением: принудительное включение, позиция в промпте, глубина, роль, привязка к приветствию. Полный справочник с примерами.
- Автор
- 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.
Что дальше
- Лорбук персонажа: факты, которые включаются по ключам — база, без которой директивы не нужны.
- Ключи лорбука: как писать триггеры, которые срабатывают — живые ключи и вторичные условия.
- Все поля карточки персонажа — где в карточке живёт лорбук.
Директивы — уровень «продвинутый автор». Если вы только начинаете, начните с конструктора: он соберёт лорбук без единой директивы — и это будет работать.