宏

宏是条目内容中的 {{placeholder}} 占位符，在运行时被替换。它们适用于所有分区的所有条目类型。

内置宏

身份

宏	替换为
{{char}}	角色名（来自世界设置）
{{user}}	玩家名（感知人设：活跃人设名 → 账户用户名 → "Player"）

人设

宏	替换为
{{persona}}	所有人设字段合并
{{persona_name}}	活跃人设的名称
{{persona_appearance}}	活跃人设的外貌描述
{{persona_personality}}	活跃人设的性格描述
{{persona_backstory}}	活跃人设的背景故事

时间

宏	替换为
{{time}}	当前时间（HH:MM 格式）
{{date}}	当前日期（人类可读格式）
{{weekday}}	当前星期几
{{isodate}}	ISO 8601 日期
{{isotime}}	ISO 8601 时间
{{idle}}	距上次玩家消息的时间（人类可读格式，例如「5 分钟」）

游戏状态

宏	替换为
{{turnCount}}	当前回合数
{{model}}	当前 LLM 模型 ID
{{lastMessage}}	最近一条消息的内容
{{lastUserMessage}}	最近一条玩家消息的内容
{{lastCharMessage}}	最近一条 AI 消息的内容

随机化

宏	替换为
{{random::a::b::c}}	从选项中随机选择（每轮重新随机）
{{pick::a::b::c}}	确定性选择（有种子，在同一轮内稳定）
{{roll::NdS}}	掷骰子结果，例如 {{roll::2d6+1}}

实用工具

宏	替换为
{{// comment}}	被移除（条目中的不可见注释）
{{trim}}	折叠周围的空白字符

变量宏

任何变量 ID 都可以作为宏使用：

{{health}} → "health" 变量的当前值
{{location}} → "location" 变量的当前值
{{inventory}} → "inventory" 变量的 JSON.stringify 结果

如果宏不匹配任何内置名称或变量 ID，它将原样保留（字面值 {{unknown}}）。