---
title: "宏"
description: "世界文件条目文本里能用的每一个宏，从 user 和 char 到随机选取、掷骰、时间和变量值。"
---

<div v-pre>

# 宏

宏是条目内容中的 `{{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}}`）。

</div>
