# 宏（替换标签）

规范地址：https://xstavern.com/wiki/usage/characters/macros/
原文：https://sillytaverncn.net/usage/characters/macros/
核对日期：2026-11-03
授权迁移，保留作者、上游许可与出处。

宏（替换标签）



# 宏（替换标签）

!!! 注意
此列表可能不完整或已过时。在任何 SillyTavern 聊天中使用 `/help macros` 斜杠命令来获取您的实例中可用的宏列表。
!!!

宏可以在角色描述、作者注释、世界信息和许多其他地方使用，并在生成回应时替换为相应的值。它们可以用于在提示词中插入动态内容，如用户名称、角色描述或当前时间。宏用双大括号括起来，例如 `{{user}}`，通常不区分大小写。**请注意，目前不支持宏嵌套。**

注意：某些扩展可能还会添加特定于上下文的特殊宏，这些宏只在某些区域有效（即扩展提示词的特殊占位符）。除非该宏不绑定到特定功能，否则这里不会记录这些宏。

## 通用宏

| 宏 | 描述 |
|-------|-------------|
| `{{pipe}}` | 仅用于斜杠命令批处理。替换为前一个命令的返回结果。 |
| `{{newline}}` | 插入换行符。 |
| `{{trim}}` | 修剪此宏周围的换行符。 |
| `{{noop}}` | 无操作，只是一个空字符串。 |
| `{{user}}` 或 `<USER>` | 用户名称。 |
| `{{charPrompt}}` | 角色的主提示词覆盖。 |
| `{{charJailbreak}}` | 角色的历史后指令提示词覆盖。 |
| `{{group}}` 或 `{{charIfNotGroup}}` | 群组成员名称的逗号分隔列表，或单人聊天中的角色名称。 |
| `{{groupNotMuted}}` | 与 `{{group}}` 相同但不包括已静音的成员。 |
| `{{char}}` 或 `<BOT>` | 角色名称。 |
| `{{description}}` | 角色描述。 |
| `{{scenario}}` | 角色场景或聊天场景覆盖（如果已设置）。 |
| `{{personality}}` | 角色个性。 |
| `{{persona}}` | 用户的个性描述。 |
| `{{mesExamples}}` | 角色的对话示例（未更改和未分割）。 |
| `{{char_version}}` | 角色的版本号。 |
| `{{model}}` | 当前选择的 API 的文本生成模型名称。**可能不准确！** |
| `{{lastMessageId}}` | 最后一条聊天消息的 ID。 |
| `{{lastMessage}}` | 最后一条聊天消息的文本。 |
| `{{firstIncludedMessageId}}` | 上下文中包含的第一条消息的 ID。需要在当前会话中至少运行一次生成。 |
| `{{lastCharMessage}}` | 角色发送的最后一条聊天消息。 |
| `{{lastUserMessage}}` | 用户发送的最后一条聊天消息。 |
| `{{currentSwipeId}}` | 当前显示的最后一条消息滑动的基于 1 的 ID。 |
| `{{lastSwipeId}}` | 最后一条聊天消息的滑动次数。 |
| `{{lastGenerationType}}` | 最后一个排队的生成请求的类型。值：normal（正常）、impersonate（扮演）、regenerate（重新生成）、quiet（静默）、swipe（滑动）、continue（继续）。 |
| `{{original}}` | 可以在提示词覆盖字段中使用，以包含系统设置中的默认提示词。仅适用于聊天补全 API 和指令模式。 |
| `{{time}}` | 当前系统时间。 |
| `{{time_UTC+X}}` 或 `{{time_UTC-X}}` | 指定 UTC 偏移（时区）的当前时间，例如对于 UTC+02:00 使用 `{{time_UTC+2}}`。 |
| <code>{{timeDiff::(time1)::(time2)}}</code> | time1 和 time2 之间的时间差。接受时间和日期宏。 |
| `{{date}}` | 当前系统日期。 |
| `{{input}}` | 用户输入栏的内容。 |
| `{{weekday}}` | 当前星期几。 |
| `{{isotime}}` | 当前 ISO 时间（24 小时制）。 |
| `{{isodate}}` | 当前 ISO 日期（YYYY-MM-DD）。 |
| `{{datetimeformat ...}}` | 指定格式的当前日期/时间（例如 `{{datetimeformat DD.MM.YYYY HH:mm}}`）。 |
| `{{idle_duration}}` | 插入自上次发送用户消息以来的时间范围的人性化字符串（示例：4 小时，1 天）。 |
| `{{random:(args)}}` | 从列表中返回一个随机项（例如 `{{random:1,2,3,4}}` 将随机返回 4 个数字中的 1 个）。 |
| `{{random::arg1::arg2}}` | random 的替代语法，支持其参数中的逗号。 |
| `{{pick::(args)}}` | random 的替代方案，但如果源字符串保持不变，则在当前聊天的后续评估中选择的参数是稳定的。 |
| `{{roll:(formula)}}` | 使用 D&D 骰子语法生成随机值：XdY+Z（例如 `{{roll:d6}}` 生成 1-6 的值）。 |
| `{{bias "text here"}}` | 为 AI 设置行为偏差，直到下一个用户输入。文本周围需要引号。 |
| `{{// (note)}}` | 允许留下将被替换为空内容的注释。AI 不可见。 |
| `{{banned "text here"}}` | 动态将引号中的文本添加到 Text Generation WebUI 后端的禁用词序列中。对其他后端无效。需要引号。 |
| `{{reverse:(content)}}` | 反转宏的内容。 |

## 指令模式和上下文模板宏

（在高级格式设置中启用）

| 宏 | 描述 |
|-------|-------------|
| `{{exampleSeparator}}` | 上下文模板示例对话分隔符。 |
| `{{chatStart}}` | 上下文模板聊天开始行。 |
| `{{instructSystemPrompt}}` | 指令系统提示词。 |
| `{{instructSystemPromptPrefix}}` | 系统提示词前缀序列。 |
| `{{instructSystemPromptSuffix}}` | 系统提示词后缀序列。 |
| `{{instructUserPrefix}}` | 用户消息前缀序列。 |
| `{{instructAssistantPrefix}}` | 助手消息前缀序列。 |
| `{{instructSystemPrefix}}` | 系统消息前缀序列。 |
| `{{instructUserSuffix}}` | 用户消息后缀序列。 |
| `{{instructAssistantSuffix}}` | 助手消息后缀序列。 |
| `{{instructSystemSuffix}}` | 系统消息后缀序列。 |
| `{{instructFirstAssistantPrefix}}` | 助手第一个输出序列。 |
| `{{instructLastAssistantPrefix}}` | 助手最后一个输出序列。 |
| `{{instructFirstUserPrefix}}` | 指令用户第一个输入序列。 |
| `{{instructLastUserPrefix}}` | 指令用户最后一个输入序列。 |
| `{{instructSystemInstructionPrefix}}` | 系统指令前缀序列。 |
| `{{instructUserFiller}}` | 用户填充消息文本。 |
| `{{instructStop}}` | 指令停止序列。 |
| `{{maxPrompt}}` | 提示词的最大 token 数（上下文长度减去回应长度）。 |
| `{{systemPrompt}}` | 系统提示词内容，如果允许且可用，包括角色提示词覆盖。 |
| `{{defaultSystemPrompt}}` | 系统提示词内容（不包括角色提示词覆盖）。 |

## 聊天变量宏

- 本地变量 = 仅在当前聊天中唯一
- 全局变量 = 在任何角色的任何聊天中都有效

| 宏 | 描述 |
|-------|-------------|
| `{{getvar::name}}` | 替换为本地变量"name"的值。 |
| `{{setvar::name::value}}` | 替换为空字符串，将本地变量"name"设置为"value"。 |
| `{{addvar::name::increment}}` | 替换为空字符串，将数值"increment"添加到本地变量"name"。 |
| `{{incvar::name}}` | 替换为变量"name"的值加 1 的结果。 |
| `{{decvar::name}}` | 替换为变量"name"的值减 1 的结果。 |
| `{{getglobalvar::name}}` | 替换为全局变量"name"的值。 |
| `{{setglobalvar::name::value}}` | 替换为空字符串，将全局变量"name"设置为"value"。 |
| `{{addglobalvar::name::value}}` | 替换为空字符串，将数值"increment"添加到全局变量"name"。 |
| `{{incglobalvar::name}}` | 替换为全局变量"name"的值加 1 的结果。 |
| `{{decglobalvar::name}}` | 替换为全局变量"name"的值减 1 的结果。 |
| `{{var::name}}` | 替换为作用域变量"name"的值（仅限 STscript）。 |
| `{{var::name::index}}` | 替换为作用域变量"name"中索引处的值（用于 STscript 中的数组/对象）。 |

## 扩展特定宏

由扩展添加，仅在特定条件下工作。

| 宏 | 描述 |
|-------|-------------|
| `{{summary}}` | 替换为当前聊天会话的摘要（如果可用）。 |

许可与致谢：https://xstavern.com/wiki/licensecredits/