Persona

场景 维护着一份有序图层清单，位于控制面板左侧列的图层面板。虚拟形象模型与各类多媒体对象均整合在此统一清单中：无论是 Live2D / VRM 模型、弹幕机图片、循环播放的视频背景，还是 3D 舞台道具，均作为独立图层项按统一的 Z 轴次序进行层叠渲染。后期特效 则作为专有条目，归类于图层列表顶部的场景效果分组中；舞台固定置于图层列表最底部，用于切换至舞台属性与清空图层选区。

列表遵循图层面板的通用规范，最顶层的行对应绘制在舞台最前端。拖拽条目左侧的拖拽控制柄即可垂直重排层级次序。

使用指南复制锚点链接

• 素材库
• 位置与空间
• 钉住图层
• 网页图层
• 文本图层
• 图层特效

图层控制项复制锚点链接

点击在访达中显示（Windows 上显示为在资源管理器中显示）可在系统文件管理器中快速定位该图层的物理文件。网页、文本与采集图层不对应本地物理文件，因而上下文菜单中不会包含该选项。

点击图层行可选中该图层，并在右侧详情区域展开对应的参数配置区块。再次点击当前选中行（或按下 Esc 键）可收起这些配置区块。

特效图层复制锚点链接

全局 后期特效 同样显示在图层面板中，位于图层列表顶部的场景效果分组下。只有场景实际启用的特效才会显示对应行，未启用的特效不占位置。若当前未添加任何特效，该分组会自动隐藏。

可从素材库的场景效果分类中添加特效。已添加到场景的特效会标注为已添加，无法再次选择。浏览时，该分类仅在专属标签页下列出，避免大量内置特效挤占「全部」视图；在顶部搜索框中检索时，「全部」视图同样会显示匹配的特效。

场景特效作用于场景中的全部图层，2D 图像、视频、网页与文本同样适用。仅当场景完全为空时，该分类才会被禁用并显示原因提示。详见 特效链启用条件。

特效图层行外观与常规图层一致，但交互逻辑存在差异：

列表中的排序严格对应 特效链渲染管线，最终生效的后处理通道位于最顶层。

点击特效行可在详情区展开场景效果 · 名称面板，调节该特效的全部着色器参数。特效行具备独立的选中上下文，因此选中特效不会激活舞台上的空间变换控制柄，亦不会干扰画面的拖拽缩放操作。

点击从场景中移除只会将该特效移出当前场景的渲染链，已调整的参数仍会保留，下次重新添加时会自动恢复；若需恢复初始设置，请点击重置为默认值。

文件缺失复制锚点链接

若图层引用的模型或媒体文件在磁盘上被移动、重命名或删除，图层行会显示警告图标。选中该图层后，详情区将以未找到文件提示取代原有设置，并列出原文件名与所在文件夹，提供以下处理方式：

• 重新定位…：打开文件选择对话框（默认定位至原文件夹最近的现存上级目录），重新指定文件位置。模型需选择同一格式（Live2D 或 VRM）的有效模型文件。重新定位模型后，所有场景中引用它的图层、快捷键与自动化均会随之更新；重新定位媒体文件则仅重新关联当前图层，并保留其原有设置。内置素材与目录下载内容不提供此选项。
• 下载：若缺失的模型属于 Persona 官方目录提供的 下载内容（例如已删除下载文件夹的目录模型，或由旧版应用内置迁入目录的示例模型），提示框会提供下载按钮并展示下载进度；下载完成后，所有引用该模型 ID 的图层会自动恢复关联。
• 从场景中移除：直接移除该图层。

Persona 不会实时监视文件变动，而是在任一应用窗口获得焦点时重新检查：文件被移走后会标记为缺失，移回原处后标记自动消失。素材库中对应的条目同样会显示文件缺失标记，详见 素材库。

替换图层复制锚点链接

点击图层行的操作菜单中的替换…，将重新唤起素材库面板进行原地替换而非新增图层，顶部标题栏会标明当前正在替换的目标。

素材库的筛选范围会自动限定为该图层所属的类型：模型图层只能替换为其他模型（Live2D 与 VRM 通用），物体图层只能替换为其他多媒体源（包含网页）。图层在渲染管线中的层叠次序、空间变换坐标以及主模型星标均会完整保留。

替换模型时会播放场景配置的 显示与隐藏 过渡动画，详见 替换模型。

主模型复制锚点链接

场景中同时只能有一个模型设为主模型（带有星标）。调用 插件 API 接口时若未指定目标模型，默认会作用于主模型；自动化规则中的主模型同样指向它。

点击图层操作菜单中的设为主模型即可转移星标。非模型物体没有可驱动的模型参数，不能设为主模型。虚拟形象快捷键 不受主模型限制：场景中的每个模型均拥有独立的快捷键配置并正常响应，主模型仅在列表中置顶排列。自动化中的虚拟形象动作可以单独指定目标图层，因而对场景中的任意虚拟形象均能生效。

面部追踪 独立于主模型设置。每个虚拟形象均可绑定至独立的捕捉输入源，因此支持通过三部手机分别独立驱动三个模型，与主模型归属无关。

其它物体设置复制锚点链接

视频图层支持独立的回放控制、循环与音频播放。选中视频图层可在右侧视频分组中进行配置：

• 回放：提供播放 / 暂停切换按钮与视频进度条（拖拽滑块快进快退，拖拽时舞台画面实时呈现对应关键帧，支持方向键微调 1 秒、按住 Shift 或翻页键步进 10 秒；播放时实时显示当前进度与总时长，如 00:12 / 01:30）。暂停状态（paused）会在重启应用、切换场景、撤销重做或通过 API 调整时完整保持。
• 循环：播放到达末尾时自动从头开始循环播放（默认开启）。
• 音量：提供静音切换按钮与音量滑块（0 – 100%，静音状态下仍可自由预设音量数值）。视频声音通过配置的 音频输出设备 播放，并可被 摄影棚模式 的舞台音频录制捕获；若配置的输出设备暂时不可用，视频将保持静音而非降级至系统默认设备。

图片、视频与网页图层均支持色度键（Chroma Key，用于去除纯色背景）：

• 启用色度键：像绿幕一样将指定颜色变为透明（默认关闭）。
• 抠像颜色：设置要变为透明的目标颜色（默认为纯绿色 #00ff00）。
• 相似度：扩大变为透明的颜色范围（1 – 1000，默认为 400）。
• 平滑度：柔化透明区域与可见区域之间的边缘（1 – 1000，默认为 80）。
• 溢色抑制：消除边缘残留的背景色（1 – 1000，默认为 100）。

色度键基于 OBS Studio 的色度容差算法实现，计算 BT.709 色度距离而不受亮度明暗影响，因此同一颜色的阴影与高光都能干净去除。

若导入的 3D 物体自身嵌入了光源数据，这些光源将自动收录于控制面板的灯光行中，分组命名规范为内置于 [物体名称]。你可在此对其进行独立开关或调光，完全不会影响场景自有的灯光体系。