> ## 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 生成 |
| 页面节点“作品实时预览” | 本节点预设内容或模板内容示例、所选规则组 | 该节点的画面、多帧内容和规则组 | 完整入口、跨节点 State 和真实 AI 生成 |
| 顶部“运行预览” | 已保存的完整作品和玩家存档 | 开始入口、页面跳转、AI 生成、跨页面变量和连续游玩 | 未保存的编辑器草稿 |
运行预览按钮只在作品没有未保存修改时出现。先点击“保存作品”。
## 使用调试面板
模板或页面节点右上角可以在“编辑”和“调试”之间切换。
调试面板分为两部分：
* “当前变量”显示全局状态 `state` 和当前帧数据 `frame`；
* “规则执行记录”显示指令解析、变量更新、跳转、AI 请求和错误。
点击预览中的按钮后，先查看是否出现对应规则记录，再展开记录检查动作和变量值。点击“清空”可以移除本次查看中的旧记录。
## 按现象选择检查位置
| 现象 | 先检查 | 再检查 |
| ------------- | --------------------- | --------------------- |
| 文字、背景或立绘为空 | 调试面板中的 Frame 变量 | 指令参数、解析指令规则和媒体绑定 |
| 点击按钮没有记录 | Element Selector 是否匹配 | 页面代码中的类名或属性 |
| 规则执行了但没有跳转 | “跳转界面”目标 | 流程蓝图连线与目标页面节点 |
| 跳转后内容模式不对 | 目标页面节点的内容模式 | 目标节点预设内容或上下文 |
| AI 没有使用某条设定 | 页面节点上下文 | 世界设定条件与顺序 |
| AI 返回的帧结构不对 | 模板格式提示 | 内容示例是否覆盖需要的指令和末帧结构 |
| 模板预览正常，运行预览异常 | 保存状态和节点规则组 | 运行预览中的实际入口、State 和跳转链 |
## 检查规则的顺序
1. 在模板或页面节点预览中触发一次操作。
2. 查看“规则执行记录”是否出现规则名称。
3. 查看动作是否按顺序执行。
4. 在“当前变量”确认 State 或 Frame 值。
5. 涉及跨页面或 AI 时，保存后改用运行预览。
一次只修改一处，再重新触发同一个操作。这样可以确认哪项修改改变了结果。
## 检查 AI 生成
AI 每次生成的具体文字和帧数可能变化。调试时检查稳定要求：
* 是否进入了正确的 AI 页面节点；
* 第一帧是否回应玩家刚才的操作；
* 指令和参数是否符合模板注册表；
* 世界设定和 State 是否进入本节点上下文；
* 最后一帧是否提供后续交互；
* 点击新选项后是否触发下一次生成。
模板和页面节点的作品实时预览使用内容示例，不会发出真实生成请求。AI 问题需要在运行预览中复现。
## 页面不断变大或出现滚动条
检查页面代码的根容器：
* 使用 `width: 100%` 和 `height: 100%`；
* 设置 `box-sizing: border-box`；
* 明确 `overflow`；
* 避免根容器使用 `100vh` 后再叠加会增加总高度的内外边距。
完整尺寸要求见[页面代码与作品实时预览](/editor/templates/page-code)。
MoMo：先看有没有规则记录。没有记录，检查选择器；有记录，再检查动作和变量。