> ## Documentation Index
> Fetch the complete documentation index at: https://guide.moyostory.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 内容示例、帧与格式提示
> 使用多帧内容示例检查模板，并约束 AI 生成内容的结构。
“内容示例”位于模板工作区左侧。它同时承担两项工作：驱动模板的作品实时预览，并向 AI 展示这个模板接受怎样的多帧内容。
## 内容示例与预设内容的区别
| 内容 | 保存位置 | 玩家是否直接看到 |
| ------------ | ------ | --------------------------------- |
| 模板中的“内容示例” | 模板 | 用于模板预览和 AI 输出样本；AI 页面不会把它当作本次生成结果 |
| 页面节点中的“预设内容” | 某个页面节点 | 玩家进入该节点时直接播放 |
新建预设内容页面节点时，编辑器会用模板当时的内容示例初始化节点内容。页面节点第一次保存后，两份内容各自修改，互不覆盖。
## 一帧包含什么
一帧代表一次完整画面状态。每帧可以放一条或多条指令。例如：
* 一条“台词”指令写入角色、背景、立绘和正文；
* 两条“选项”指令在同一末帧创建两个按钮；
* 一条场景指令与一条音效指令同时改变画面和声音。
点击帧右侧的编辑按钮，选择模板已经注册的指令并填写参数。指令的可用字段来自[指令注册表](/editor/templates/directives)。
## 管理帧
内容示例支持以下操作：
* “创建新帧”在列表末尾添加一帧；
* 拖动帧卡片调整顺序；
* 复制一帧后修改少量字段；
* 删除不再需要的帧；
* 点击帧卡片，让中间预览切换到该帧。
列表中的“第 N 帧”和玩家画面中的帧计数使用同一顺序。
## 设置播放起始位置
“播放起始位置”决定初始化和每次 AI 返回新帧后，预览从哪里开始显示：
| 选项 | 适用情况 |
| ------- | --------------------- |
| 第一帧 | 剧情、对话和需要按顺序阅读的内容 |
| 最后一帧 | 只关注最新消息的聊天或记录界面 |
| 指定第 N 帧 | 前几帧用于准备数据，玩家从后面的帧开始操作 |
这个设置属于模板。使用该模板的页面节点会采用同一播放策略。
## 格式提示怎样影响 AI
格式提示会与指令定义、内容示例一起发送给 AI。它适合说明内容示例无法单独表达的约束：
* 每次生成多少帧；
* 哪些指令只能出现在末帧；
* 角色、叙事视角和节奏要求；
* 哪些参数固定填写某个值；
* AI 应避免代替玩家决定什么。
格式提示不会修改页面代码。画面字段仍需经过指令、触发器规则和 Frame 变量进入页面。
## 保存和影响范围
内容示例、格式提示和播放起始位置都属于模板草稿。修改后，模板标签会出现橙色圆点；点击顶部“保存作品”或选择“保存并关闭”后写入作品。
* 内容示例会立即更新当前模板的作品实时预览，并作为 AI 生成的结构参考。
* 播放起始位置会影响所有使用该模板的页面节点。
* 修改内容示例不会覆盖已经保存到页面节点中的预设内容。
## 编写可用示例
一份可用的内容示例应覆盖模板的主要状态：
* 有角色和无角色的正文帧；
* 会发生变化的背景或立绘；
* 普通阅读帧和带按钮的交互帧；
* AI 需要生成的全部指令类型。
示例只有一帧时，预览无法验证切换帧规则，AI 也缺少多帧节奏参考。多帧模板应提供一组能够完整播放的示例。
MoMo：内容示例负责示范结构。格式提示负责写清帧数、顺序和不能从示例中看出的限制。