الماكرو (CBS)

الماكروهات رموز بأقواس معقوفة مزدوجة تُوسَّع وقت الطلب. تعمل في حقول الشخصيات ومدخلات كتب المعرفة والإعدادات المسبقة والتحيات ونصّ الدردشة، وتتداخل.

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

تُفصل الوسائط بنقطتين رأسيتين مزدوجتين. والماكروهات المجهولة تُوسَّع إلى لا شيء بدل أن تخطئ، فلا يكسر خطأ مطبعي طلبًا أبدًا.

الأقواس المفردة ليست ماكروهات. فالزوج الواحد يصل إلى النموذج كنصّ حرفي ويظهر في الردود، وهذا السبب المعتاد للأقواس الشاردة. مطابق لـ SillyTavern وRisuAI وJanitorAI، فتعمل بطاقاتها دون تغيير.

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

الماكرو random يختار وسيطًا جديدًا مع كلّ توسيع. وpick يقوم باختيار يبقى ثابتًا طوال المحادثة. وroll يرمي النرد بترميز d.

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

الرميات والقيم العشوائية مبذورة لكلّ دور: فإعادة التوليد تعيد استخدام القيم نفسها، والتمرير لا يعيد رمي النرد.

متغيّرات الدردشة تبقى لكلّ فرع محادثة. والمتغيّرات العامّة تبقى عبر كلّ الدردشات. اضبطها في أي نصّ يقبل الماكرو أو من سكربتات المشغّلات.

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

التخزين المحصور بالفرع يعني أنّ التمرير إلى فرع آخر يستعيد حالة متغيّرات ذلك الفرع. ولا تتسرّب القيم بين الأشقّاء أبدًا.

الكتل تغلّف المحتوى. فـ if يعرض جسمه حين يتحقّق الشرط. وeach يكرّر على المصفوفات مع استبدال الخانات. وwhen يضيف فروع else على أساس الأسطر.

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

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

الكتلتان pure وescape تحميان الأقواس الحرفية من التوسيع. وأي وسم إغلاق يغلق أعمق كتلة مفتوحة.

ماكروهات التعليق تختفي قبل أن يراها النموذج، فتصلح للملاحظات داخل حقول البطاقة. استخدم كتل pure لعرض صيغة الماكرو حرفيًا.

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