Makra (CBS)

Makra to tokeny w podwójnych nawiasach klamrowych, rozwijane w chwili żądania. Działają w polach postaci, wpisach lorebooków, presetach, powitaniach i tekście czatu, i można je zagnieżdżać.

{{char}} smiles at {{user}}.
{{random::sunny::rainy::foggy}}
{{calc::1+2*3}}

Argumenty rozdziela się podwójnym dwukropkiem. Nieznane makra rozwijają się do pustki zamiast zgłaszać błąd, więc literówka nigdy nie psuje żądania.

Pojedyncze nawiasy klamrowe nie są makrami. Jedna para dociera do modelu jako zwykły tekst i pojawia się w odpowiedziach, co zwykle tłumaczy błąkające się klamry. Zgodne z SillyTavern, RisuAI i JanitorAI, więc ich karty działają bez zmian.

{{user}}   expands to your persona name
{user}     stays literal text

random wybiera jeden argument od nowa przy każdym rozwinięciu. pick dokonuje wyboru, który zostaje stały dla całej rozmowy. roll rzuca kostkami w notacji d.

{{random::a::b::c}}   {{pick::a::b::c}}   {{roll::d20}}

Rzuty i losowania mają ziarno ustalone na turę: ponowne wygenerowanie używa tych samych wartości, więc przewijanie nie przerzuca kostek.

Zmienne czatu trwają w obrębie gałęzi rozmowy. Zmienne globalne trwają we wszystkich czatach. Ustawiaj je w dowolnym tekście obsługującym makra albo ze skryptów wyzwalanych zdarzeniami.

{{setvar::mood::happy}}
{{getvar::mood}}
{{setglobalvar::visits::1}}

Zasięg gałęzi oznacza, że przejście na inną gałąź przywraca stan zmiennych tej gałęzi. Rodzeństwo nigdy nie przecieka wartościami do siebie nawzajem.

Bloki opakowują treść. if renderuje swoje wnętrze, gdy warunek jest prawdziwy. each iteruje po tablicach z podstawianiem slotów. when dokłada gałęzie else oparte na liniach.

{{#if {{equal::{{getvar::mood}}::happy}}}}
{{char}} is in a great mood.
{{/if}}

{{#each {{array::red::green::blue}} item}}
Color: {{slot::item}}
{{/each}}

pure i escape chronią dosłowne klamry przed rozwinięciem. Dowolny znacznik zamykający zamyka najgłębiej otwarty blok.

Makra komentarzy znikają, zanim zobaczy je model, więc nadają się na notatki w polach karty. Użyj bloków pure, aby pokazać składnię makra dosłownie.

{{// note to self, never sent to the model}}
{{#pure}}{{char}} stays literal here{{/pure}}