预览与调试

编辑器提供不同范围的预览。先选择能覆盖当前问题的范围，可以减少无关检查。

​

三种预览

运行预览按钮只在作品没有未保存修改时出现。先点击“保存作品”。

​

使用调试面板

模板或页面节点右上角可以在“编辑”和“调试”之间切换。 调试面板分为两部分：

• “当前变量”显示全局状态 state 和当前帧数据 frame；
• “规则执行记录”显示指令解析、变量更新、跳转、AI 请求和错误。

点击预览中的按钮后，先查看是否出现对应规则记录，再展开记录检查动作和变量值。点击“清空”可以移除本次查看中的旧记录。

​

按现象选择检查位置

​

检查规则的顺序

1. 在模板或页面节点预览中触发一次操作。
2. 查看“规则执行记录”是否出现规则名称。
3. 查看动作是否按顺序执行。
4. 在“当前变量”确认 State 或 Frame 值。
5. 涉及跨页面或 AI 时，保存后改用运行预览。

一次只修改一处，再重新触发同一个操作。这样可以确认哪项修改改变了结果。

​

检查 AI 生成

AI 每次生成的具体文字和帧数可能变化。调试时检查稳定要求：

• 是否进入了正确的 AI 页面节点；
• 第一帧是否回应玩家刚才的操作；
• 指令和参数是否符合模板注册表；
• 世界设定和 State 是否进入本节点上下文；
• 最后一帧是否提供后续交互；
• 点击新选项后是否触发下一次生成。

模板和页面节点的作品实时预览使用内容示例，不会发出真实生成请求。AI 问题需要在运行预览中复现。

​

页面不断变大或出现滚动条

检查页面代码的根容器：

• 使用 width: 100% 和 height: 100%；
• 设置 box-sizing: border-box；
• 明确 overflow；
• 避免根容器使用 100vh 后再叠加会增加总高度的内外边距。

完整尺寸要求见页面代码与作品实时预览。