文档
Powered by

# 支持的宏参数汇总

NativeTavern 支持丰富的宏（Macro）系统，可以在提示词和消息中使用这些特殊标记。

# 📅 基本参数

# 时间日期

宏 说明 示例输出
{{time}} 当前时间 14:30
{{date}} 当前日期 2026年1月19日
{{weekday}} 当前星期 星期日
{{isotime}} ISO时间格式 14:30
{{isodate}} ISO日期格式 2026-01-19
{{time_UTC+8}} 指定时区时间 14:30
{{idle_duration}} 距上次消息时长 5分钟前

# 随机生成

宏 说明 示例输出
{{random:1,3,5}} 随机选择一个 3
{{roll:3d6}} 掷骰子 12

# 👤 聊天角色

宏 说明
{{user}} 用户身份名字
{{char}} 角色名字
{{group}} 群聊所有角色（逗号分隔）
{{charIfNotGroup}} 非群聊时显示角色名
{{groupNotMuted}} 群聊中未禁言的角色

# 📝 角色卡信息

宏 说明
{{charPrompt}} 系统指令 Main Prompt
{{charInstruction}} Post-History Instructions
{{charJailbreak}} 同 charInstruction
{{description}} 角色设定
{{personality}} 角色性格特点
{{scenario}} 场景描述
{{persona}} 用户身份描述
{{mesExamples}} 对话示例（已渲染）
{{mesExamplesRaw}} 对话示例（原文）
{{charVersion}} 角色版本
{{creatorNotes}} 创建者备注

# 💬 聊天消息

宏 说明
{{lastMessage}} 最后一条消息
{{input}} 用户输入消息
{{lastUserMessage}} 最后一条用户消息
{{lastCharMessage}} 最后一条角色消息

# 📐 排版控制

宏 说明
{{newline}} 换行
{{trim}} 移除前后空格和换行
{{noop}} 空操作（不输出）

# 🔧 变量系统

# 设置变量 

{{setvar::<变量名>::<值>}}

支持的值类型：

  • 文字：{{setvar::name::张三}}
  • 数字：{{setvar::count::10}}
  • 列表：{{setvar::items::["a","b","c"]}}

# 读取变量 

{{getvar::<变量名>}}

# 修改变量

宏 说明 示例
{{addvar::变量名::值}} 添加值 列表追加/数字相加/文字拼接
{{incvar::变量名}} 变量 +1 用于计数器
{{decvar::变量名}} 变量 -1 用于倒计时

# 🏷️ 已过时参数（Legacy）

为了兼容旧版角色卡，以下格式仍然支持：

旧格式 对应新格式
<USER> {{user}}
<CHAR> {{char}}
<BOT> {{char}}
<GROUP> {{group}}
<CHARIFNOTGROUP> {{charIfNotGroup}}

# 📖 使用示例

# 在角色描述中使用 

{{char}}是一位神秘的旅者，正在与{{user}}一同探险。
当前时间是{{time}}，{{weekday}}。

# 使用变量记录状态 

{{setvar::好感度::50}}
当前好感度：{{getvar::好感度}}
{{incvar::好感度}}  // 好感度+1

# 掷骰子判定 

{{user}}尝试说服守卫...
掷骰子结果：{{roll:1d20}}

返回帮助中心
../