可视化界面可以显示变量和扩展数据、写入变量、绑定游戏设置并执行点击动作。
界面状态与条件显示
界面状态用于记录当前 UI 内部的临时交互，例如当前步骤、详情是否展开或选择了哪一类内容。它只属于当前打开的界面，不进入游戏存档。
在界面文档设置中新增状态，并配置名称、类型和默认值。元素的「显示条件」可以组合判断：
- 界面状态；
- 剧情变量；
- 扩展数据；
- 已绑定的游戏设置。
条件支持相等、不等、大小比较以及布尔判断。多个条件可以组合为全部满足或任一满足。
修改状态和值
按钮动作可以设置、翻转、增减或循环切换界面状态与可写数据。例如：
- 点击「下一步」把步骤从
1 增加到 2；
- 点击折叠标题翻转布尔状态；
- 点击分类按钮循环切换当前筛选值；
- 修改剧情变量后，让另一个元素的显示条件立即重新计算。
只影响当前界面的交互使用界面状态；读档后仍需保留的数据使用剧情变量或扩展存档。
在文字中显示变量
文字内容使用双花括号插入变量：
欢迎回来，{{playerName}}
好感度：{{affection}}
变量名需要和项目里的变量完全一致。变量不存在时，界面无法显示预期内容。
让玩家写入变量
「输入对话框」智能组件可以把结果写入一个可写变量，并支持：
- 字符串、数字和布尔类型；
- 必填校验；
- 最大长度；
- 数值步进；
- 按 Esc 取消。
普通「输入框」适合临时输入或配合程序控制，本身不会自动写入剧情变量。需要无代码的数据录入时，请使用输入对话框。
绑定游戏设置
下拉、开关、滑块和勾选框可以绑定引擎设置。玩家调整控件后，值会自动保存。
- 主音量
- 背景音乐音量
- 音效音量
- 语音音量
- 文字速度
- 自动播放速度
开关与勾选框
绑定设置后，不需要再为控件配置扩展方法。制作自定义设置页时，可以直接用这些控件替换默认布局。
显示扩展数据列表
「数据列表」读取扩展存档中的数组。数据源格式为：
例如：
对应的存档字段必须是数组。列表可以设置：
- 卡片或行布局；
- 标题、副标题和图片对应的字段名；
- 列数、行数和间距；
- 空列表文案；
- 分页展示。
它适合背包、任务、角色图鉴等重复数据。如果需要计算、筛选或组合复杂数据，可以在扩展程序里处理后，再用程序控制可视化界面更新元素。
点击动作
文字、图片和按钮可以配置点击动作。动作在预览和玩家端执行，设计画布中不会触发。
界面与流程
| 动作 | 说明 |
|---|
| 关闭当前界面 | 关闭当前可视化 UI；模态界面关闭后剧本继续 |
| 打开另一个界面 | 打开项目或扩展中的另一份可视化 UI |
| 开始新游戏 | 从项目入口开始 |
| 继续最近存档 | 读取最近一次可继续的进度 |
| 返回标题 | 打开当前项目绑定的标题界面 |
| 退出游戏 | 关闭桌面版游戏 |
阅读控制
| 动作 | 说明 |
|---|
| 进入跳过模式 | 开始按项目设置的「全部 / 已读」规则跳过对白 |
| 进入自动模式 | 开始自动推进对白 |
| 隐藏对话框 | 临时隐藏对话框；玩家再次点击游戏画面后恢复 |
系统界面
| 动作 | 说明 |
|---|
| 打开存档 / 读档 | 打开当前绑定的存档或读档界面 |
| 打开设置 | 打开当前绑定的设置界面 |
| 打开历史记录 | 打开当前绑定的历史界面 |
| 打开鉴赏 | 打开当前绑定的鉴赏界面 |
存档与设置
| 动作 | 说明 |
|---|
| 快速保存 / 快速读取 | 操作快速存档 |
| 保存 / 读取指定槽位 | 对固定槽位执行存读档 |
| 重置设置 | 恢复游戏设置默认值 |
扩展方法
选择扩展方法后，可以附带 JSON 参数。参数结构必须符合扩展方法声明的 Schema。
「重置设置」「读取存档」和「退出游戏」会立即影响玩家当前状态。正式使用前请在预览和打包版本中验证按钮位置、确认流程与参数。
系统插槽还是直接界面
打开标题、存读档、设置、历史和鉴赏时，优先使用对应的系统动作。系统动作会跟随项目当前绑定；以后替换界面，不需要逐个修改按钮。
只有在明确要打开某一份具体界面时，才使用「打开另一个界面」。系统绑定的完整说明见默认游戏壳和系统插槽。 
