宏
实验性宏引擎
实验性宏引擎支持嵌套、稳定的替换顺序以及其他改进。新安装的 SillyTavern 默认启用此功能。已有安装可在用户设置 > 聊天/消息处理 > 实验性宏引擎中启用。
宏是动态占位符，在处理文本时会被替换为实际值。它们广泛用于 SillyTavern 的提示词、角色卡、世界信息、快速回复等功能中。
查找可用宏
SillyTavern 为所有可用宏提供了内置文档：
- 斜杠命令：在聊天输入框中输入
/? macros，可显示所有已注册宏及其描述的列表。 - 自动补全：详情请参阅下方的
宏自动补全 。
宏自动补全
宏自动补全会在你输入时提供可用宏的建议。它适用于 SillyTavern 中所有支持宏的文本字段。
输入 {{ 即可开始宏的自动补全，显示可用宏及其参数、可能的
默认情况下自动补全出现的位置：
- 聊天用户输入框
- 扩展编辑器（全屏文本编辑，通过文本字段旁的"展开"按钮打开）
- 提示词管理器编辑器
在其他字段中触发自动补全：
- 在任何支持宏的文本字段中按 Ctrl+Space 打开自动补全弹出窗口
- 启用设置 → 自动补全设置 → 在所有宏字段中显示，使自动补全在所有宏字段中自动出现
基本语法
宏用双花括号括起来：
{{macroName}}宏名称不区分大小写。{{User}}、{{USER}} 和 {{user}} 均解析为同一个宏。
示例：
{{user}} // 返回当前用户/人设名称
{{char}} // 返回当前角色名称
{{time}} // 返回当前时间
{{date}} // 返回当前日期参数
许多宏接受参数以自定义其行为。
空格分隔符
对于只有一个参数的宏，可以用空格将宏名与其参数分开：
{{macroName argument}}示例：
{{getvar myVariable}}
{{roll 1d20}}
{{reverse Hello World}}双冒号分隔符
使用 :: 分隔多个参数：
{{macroName::arg1::arg2::arg3}}示例：
{{setvar::myVariable::Hello World}}
{{random::red::green::blue}}
{{roll::2d6+3}}空格和 :: 都是推荐的宏参数语法。
单冒号分隔符（旧版）
单个 : 也可以引入参数，但此语法被视为旧版语法，不推荐用于新内容：
{{macroName:argument}}示例：
{{roll:1d20}}宏定义中的空白字符
宏名称、分隔符和参数之间的空白字符会被忽略。这使得格式更易读：
{{ macroName :: arg1 :: arg2 }}
{{ setvar :: myVariable :: some value }}
{{ if :: condition }}以上所有写法均等同于不含额外空格的紧凑形式。
嵌套宏
宏可以嵌套在其他宏内部。内层宏先被解析：
{{getvar::{{char}}_mood}}这会先解析 {{char}}（例如解析为"Alice"），然后解析 {{getvar::Alice_mood}}。
更多示例：
{{setvar::greeting::Hello, {{user}}!}}设置一个包含用户名称的变量内容。
{{if {{getvar::showDetails}}}}Details here{{/if}}条件本身是一个检索变量值的宏。
作用域宏
任何接受至少一个参数的宏都支持作用域语法。开闭标签之间的内容将成为该宏的最后一个参数。
作用域语法
可以将最后一个参数放置在开闭标签之间，而不是内联写出：
{{macroName argument}}
scoped content here
{{/macroName}}闭合标签在宏名前使用 / 标志：{{/macroName}}。
这等同于：
{{macroName::argument::scoped content here}}示例
设置包含多行内容的变量：
{{ setvar backstory }}
This character was born in a small village
and grew up to become a renowned scholar.
{{ /setvar }}对作用域内容使用 reverse：
{{ reverse }}
Hello World
{{ /reverse }}返回结果为"dlroW olleH"。
内容修剪
默认情况下，作用域内容会自动修剪：
- 移除首尾空白字符
- 统一的缩进会被去除（第一个非空行的缩进从所有行中移除）
这允许干净的格式：
{{ if condition }}
# Heading
Some content here
{{ /if }}结果为 # Heading\nSome content here（不含前导空格）。
若要保留所有空白字符（包括首尾换行符），请使用 # 标志。详情请参阅
条件宏
{{if}} 宏根据值是 truthy 还是 falsy 来有条件地渲染内容。
简单条件
{{ if description }}
# Character Description
{{ description }}
{{ /if }}仅当 description 返回非空值时才显示标题和描述。
条件可以是：
- 宏名称（如不需要参数则自动解析）
- 来自嵌套宏的任何值，如
{{getvar::flag}} - 变量简写，如
.myFlag或$globalFlag（参见变量简写 ） - 任何文本（将根据其内容隐式解析为 truthy 或 falsy）
Falsy 值：空字符串、false、0、off、no。
在条件中使用变量简写
变量简写提供了一种在条件中检查变量值的简洁方式：
{{ if .isEnabled }}
Feature is enabled.
{{ /if }}
{{ if !$globalDisabled }}
Not globally disabled.
{{ /if }}有关简写符号的更多详情，请参阅
反转条件
在条件前加 ! 以反转它：
{{ if !personality }}
No personality defined for this character.
{{ /if }}If/Else 分支
在 {{if}} 块内使用 {{else}} 定义替代分支：
{{ if personality }}
{{ personality }}
{{ else }}
No personality defined.
{{ /if }}另一个示例：
{{ if {{getvar::details-block}} }}
# Details Block
{{ getvar::details-block }}
{{ else }}
No details currently exist.
{{ /if }}宏标志
标志是放置在开花括号与宏名之间的特殊符号字符，用于修改宏的行为。
语法
{{!macroName}}
{{#macroName}}标志可以组合使用：
{{!?macroName}}标志与宏名之间允许有空白字符：
{{ / macroName }}
{{ # macroName }}已实现的标志
计划中的标志（尚未实现）
类标志的前缀运算符
变量简写语法使用前缀运算符（. 和 $），其行为类似于标志，但本身并非标志。
详情请参阅
保留空白字符标志
当你需要保留作用域内容中的所有空白字符（包括首尾换行符和缩进）时，使用 # 标志：
{{ # setvar code }}
function hello() {
return "world";
}
{{ /setvar }}不使用 # 时，内容会被修剪和去除缩进。使用 # 时，所有空白字符都会完全按照书写内容保留——包括开标签后和闭标签前的换行符。
注释
使用注释宏添加不会出现在输出中的注解：
{{// This is a comment and will be removed}}对于多行注释，使用作用域语法：
{{ // }}
This entire block is a comment.
It can span multiple lines.
{{ /// }}转义宏
若要显示字面花括号而不进行宏解析，请用反斜杠转义：
\{\{notAMacro\}\}输出结果为纯文本 {{notAMacro}}。
变量简写
变量简写为常见变量操作提供了简洁语法。使用 . 表示局部变量，使用 $ 表示全局变量。
变量简写前缀
这些前缀运算符必须紧接在变量名之前，位于任何可选出现的
变量名
变量名遵循与宏标识符相同的规则：以字母开头，后跟字母、数字、下划线或连字符。最后一个字符不允许是下划线或连字符。
{{.my-var}} // 有效
{{.my_var}} // 有效
{{.myVar123}} // 有效如果你的变量标识符不符合标准规则，必须使用完整的变量宏语法（例如 {{getvar::my§var----}}），或重命名/移动你的变量值。
值中的嵌套宏
变量值可以包含嵌套宏：
{{.greeting = Hello, {{user}}!}}解析后保存 Hello, User! 到变量中。（假设 {{user}} 的名称为"User"）
空白字符处理
运算符周围允许有空白字符：
{{ .myvar = spaced value }}
{{ .counter ++ }}变量简写运算符
以下运算符可与变量简写配合使用。每个运算符遵循 {{.varName operator value}} 或 {{$varName operator value}} 的模式。
获取变量
使用简单前缀检索变量值：
{{.myvar}} // 获取局部变量"myvar"
{{$myvar}} // 获取全局变量"myvar"等同于 {{getvar::myvar}} 和 {{getglobalvar::myvar}}。
设置变量
使用 = 运算符设置变量值：
{{ .myvar = Hello World }} // 设置局部变量
{{ $myvar = Some value }} // 设置全局变量等同于 {{setvar::myvar::Hello World}} 和 {{setglobalvar::myvar::Hello World}}。返回空字符串。
递增
使用 ++ 将数值变量递增 1：
{{.counter++}} // 递增局部变量，返回新值
{{$counter++}} // 递增全局变量，返回新值等同于 {{incvar counter}} 和 {{incglobalvar counter}}。返回递增后的新值。
递减
使用 -- 将数值变量递减 1：
{{.counter--}} // 递减局部变量，返回新值
{{$counter--}} // 递减全局变量，返回新值等同于 {{decvar counter}} 和 {{decglobalvar counter}}。返回递减后的新值。
加法
使用 += 向变量添加数值：
{{.score += 10}} // 向局部变量加 10
{{$total += 5}} // 向全局变量加 5等同于 {{addvar::score::10}} 和 {{addglobalvar::total::5}}。返回空字符串。
加法运算符也支持向现有字符串变量追加字符串（当两者均非数字时）：
{{.myvar += {{noop}} | Second block}} // 当变量原值为"Content"时，解析结果为"Content | Second block"。
// 使用 `{{noop}}` 可以添加否则会被自动修剪的空白字符。减法
使用 -= 从变量中减去数值：
{{.health -= 10}} // 从局部变量中减去 10
{{$points -= 5}} // 从全局变量中减去 5等同于 {{addvar::score::10}} 和 {{addglobalvar::total::5}}，但使用负数/反转数值。返回空字符串。
如果值不是有效数字，则记录警告且变量保持不变。
逻辑或
当变量为 falsy（空字符串、0、false）时，使用 || 提供回退值：
{{.name || Anonymous}} // 如果 .name 为空或 falsy，返回"Anonymous"
{{$setting || default}} // 如果 $setting 为 falsy，返回"default"若变量为 truthy 则返回变量值，否则返回回退值。回退值仅在需要时才求值（惰性求值）。
空值合并
仅当变量不存在时，使用 ?? 提供回退值：
{{.name ?? Guest}} // 仅当 .name 未定义时返回"Guest"
{{$config ?? default}} // 仅当 $config 不存在时返回"default"与 || 不同，只要变量存在，即使其值为 falsy（空字符串、0、false）也会返回变量值。回退值仅在需要时才求值（惰性求值）。
逻辑或赋值
当变量当前为 falsy 时，使用 ||= 将其设置为某值：
{{.name ||= Anonymous}} // 如果 .name 为 falsy，设置并返回"Anonymous"
{{$count ||= 0}} // 如果 $count 为 falsy，设置并返回"0"若变量已为 truthy，则返回当前值且不修改。返回最终值（原有值或新设值）。
空值合并赋值
仅当变量不存在时，使用 ??= 将其设置为某值：
{{.name ??= Guest}} // 仅当 .name 未定义时设置并返回"Guest"
{{$config ??= default}} // 仅当 $config 不存在时设置并返回"default"与 ||= 不同，若变量已存在则保留 falsy 值（空字符串、0、false）。返回最终值（原有值或新设值）。
等于
使用 == 将变量值与另一个值进行比较：
{{.status == active}} // 如果 .status 等于"active"返回"true"，否则返回"false"
{{$mode == dark}} // 如果 $mode 等于"dark"返回"true"，否则返回"false"执行字符串比较并返回字面字符串 "true" 或 "false"。
将不存在的变量、null 变量和空变量视为相同。
在 {{if}} 条件中非常有用：
{{if {{.status == active}} }}Active mode{{/if}}不等于
使用 != 比较变量值与另一个值是否不相等：
{{.status != inactive}} // 如果 .status 不是"inactive"返回"true"，否则返回"false"
{{$mode != light}} // 如果 $mode 不是"light"返回"true"，否则返回"false"执行字符串比较，值不同时返回 "true"，值相等时返回 "false"。
将不存在的变量、null 变量和空变量视为相同。
在 {{if}} 条件中非常有用：
{{if {{.status != disabled}} }}Feature enabled{{/if}}大于
使用 > 检查变量的数值是否大于另一个值：
{{.score > 50}} // 如果 .score 大于 50 返回"true"
{{$level > 5}} // 如果 $level 大于 5 返回"true"执行数值比较并返回字面字符串 "true" 或 "false"。
在 {{if}} 条件中非常有用：
{{if {{.score > 100}} }}High score!{{/if}}大于或等于
使用 >= 检查变量的数值是否大于或等于另一个值：
{{.level >= 10}} // 如果 .level 至少为 10 返回"true"
{{$points >= 100}} // 如果 $points 为 100 或更多返回"true"执行数值比较并返回字面字符串 "true" 或 "false"。
在 {{if}} 条件中非常有用：
{{if {{$level >= 10}} }}Unlocked advanced features{{/if}}小于
使用 < 检查变量的数值是否小于另一个值：
{{.health < 20}} // 如果 .health 低于 20 返回"true"
{{$timer < 0}} // 如果 $timer 为负数返回"true"执行数值比较并返回字面字符串 "true" 或 "false"。
在 {{if}} 条件中非常有用：
{{if {{.health < 20}} }}Low health warning!{{/if}}小于或等于
使用 <= 检查变量的数值是否小于或等于另一个值：
{{.health <= 0}} // 如果 .health 为 0 或更低返回"true"
{{$attempts <= 3}} // 如果 $attempts 为 3 或更少返回"true"执行数值比较并返回字面字符串 "true" 或 "false"。
在 {{if}} 条件中非常有用：
{{if {{.health <= 0}} }}Game over{{/if}}旧版语法
为向后兼容，仍支持尖括号标记：
这些标记在处理过程中会自动转换为等效宏。
注意： 不推荐使用旧版语法。新内容请改用等效的
{{macro}}语法。
常用宏分类
使用 /? macros 获取完整的可用宏列表及其详细描述。