「显示 UI」块在剧情运行到指定位置时打开一个界面。它可以用于系统菜单、小游戏、剧情交互面板和常驻 HUD。
插入与选择
在空白旁白块按 Tab，选择「显示界面」。点击卡片上的空态区域，会打开「选择要显示的界面」窗口。
选择器左侧有三类来源：
| 来源 | 内容 | 适用场景 |
|---|
| 系统槽位 | 标题、对话工具栏、存读档、设置、历史和鉴赏等 | 推荐用于系统菜单，会跟随项目绑定 |
| 可视化界面 | 项目 ui/ 目录中已有的界面文档 | 直接打开一份项目级可视化 UI |
| 扩展列表 | 已启用扩展导出的程序 UI | React 界面、小游戏和自定义浮层 |
打开标题、存读档、设置、历史或鉴赏时，优先选择「系统槽位」。以后在「项目设置 → 游戏系统」中替换绑定，剧本不需要修改。对话工具栏通常会随对话自动打开，不需要在剧本中重复显示。
玩家输入和剧情选项也是系统插槽，但通常由输入流程和分支 Block 自动调用，并需要专用 payload。不要把它们当作普通菜单手动打开；外观可在个性化中修改。 扩展树中创建的 ui/*.json 属于对应扩展。它们可以绑定系统插槽、由可视化界面的点击动作打开，或通过 ctx.visualUI 打开。当前「显示 UI」选择器中的「可视化界面」分组只枚举项目级 ui/ 文档。
卡片快捷设置
选择目标后，卡片会显示三个常用设置：
| 设置 | 说明 |
|---|
| 层级 | 底 / 顶 / 顶+ |
| 快进行为 | 快进时跳过，或仍然打开 |
| 模态 | 是否暂停剧本，等待界面关闭 |
- 关闭：界面打开后，剧本继续执行。适合 HUD、状态条和背景装饰。
- 开启：剧本暂停，直到玩家操作或程序关闭这个界面。适合菜单、弹窗和小游戏。
模态 UI 在快进和读档追赶过程中一律跳过，避免剧情被一个等待交互的界面卡住。
| 层级 | 用途 |
|---|
| 底 | 背景装饰，不抢占主要交互 |
| 顶 | 普通浮层 |
| 顶+ | 覆盖其他 UI 并独占焦点 |
快进行为
- 跳过：快进或读档追赶时不打开。临时菜单和剧情交互推荐使用。
- 仍打开：即使快进也打开。只适合需要持续存在的非模态 HUD。
| 参数 | 默认值 | 说明 |
|---|
| 尺寸 | (100%, 100%) | UI 容器宽高 |
| 位置 | (0, 0) | 容器在画布中的位置 |
| 可交互 | 默认开启 | 可强制开启或禁用鼠标事件 |
- 像素：
100、200px；
- 百分比：
50%；
- 关键词：
center、left、top、bottom；
- 偏移：
center+50、50%-20。
例如，80% 大小的居中面板：
尺寸：(80%, 80%)
位置：(center, center)
运行与关闭
- 非模态 UI 会保持显示，直到自己关闭或遇到「隐藏界面」块；
- 模态 UI 关闭后，剧本从显示块之后继续；
- 系统槽位会在打开时解析当前绑定；
- 目标扩展停用、程序构建失败或 UI 不存在时，普通界面无法打开。
隐藏界面
在空白旁白块按 Tab，选择「隐藏界面」，再选择与显示时相同的目标。
隐藏块没有层级和模态设置。它适合收起剧情中某段时间显示的 HUD。系统菜单和弹窗通常由自己的关闭按钮处理，不需要额外放隐藏块。
常驻状态 HUD 的常见组合是：非模态 + 顶层 + 快进时仍打开。结束展示时再插入对应的「隐藏界面」。
