Persona

控制面板与舞台各自作为独立窗口运行。舞台窗口为透明无边框设计，专门用于 OBS 画面采集；控制面板窗口则包含系统标题栏且呈半透明磨砂质感，不会被舞台窗口的采集进程捕获。

控制面板分为左右两栏，没有标签页。左栏依次是场景选择器和 图层 列表，图层列表的最后一行固定为舞台；捕捉、自动化与设置三个入口则固定在左栏底部。右栏显示当前选中项的详细参数。

选中这几项的方式与选中普通图层相同。

窗口复制锚点链接

舞台面板下的首个区块用于配置舞台窗口自身的显示行为与渲染属性（包括窗口尺寸、运行模式以及场景之上的辅助元素叠加）。该区块下的配置属于全局应用设置，切换场景时将保持不变。

模式复制锚点链接

舞台 → 窗口中的模式分段控件用于在编辑、直播与摄影棚之间切换。舞台图层行右侧的更多操作菜单也以单选项提供这三种模式，舞台图标会显示当前所处的模式：

• 编辑：默认模式。舞台呈现完整的变换线框、控制柄与顶部控制条，适合布置场景与调试。
• 直播：直播模式。隐藏舞台上的所有编辑控制柄与线框，确保 OBS 窗口采集仅捕获纯净的虚拟形象与场景画面。
• 摄影棚：摄影棚模式。在控制面板的模式行下方展开相机与录制控制项，用于拍摄高分辨率透明照片或录制视频；点击舞台图层行的相机图标可选中「舞台」并滚动至摄影棚控制项（录制期间图标呈红色）。直播模式与摄影棚模式互斥，进入摄影棚会自动退出直播模式。

窗口大小复制锚点链接

用于直接设定 舞台窗口 的分辨率尺寸。下拉菜单提供了主流直播流媒体画布预设，其中两档竖屏预设适配 TikTok 与 YouTube Shorts：

在自定义大小的宽度与高度输入框中，可输入 100 至 8192 范围内的任意像素值，失焦（离开输入框）时立即生效。当窗口尺寸与上述预设均不匹配时，下拉菜单将显示为自定义；手动拖拽调整舞台窗口边框时，此处数值亦会实时同步更新。

点击输入框旁的保存尺寸按钮，可将当前的自定义尺寸收藏起来，此后它会列在下拉菜单预设下方的已保存的尺寸分组中，便于随时重新选用；内置预设无需保存，按钮在其上不可用。选中已保存的尺寸时，该按钮变为移除尺寸。

此处数值代表逻辑像素（设备无关像素）。在 Retina 高分辨率屏或启用了缩放比例的显示器上，OBS 实际捕获到的物理像素数为该数值乘以当前缩放系数。

首次启动时，舞台窗口以 1920 × 1080 打开；若屏幕可用区域较小，则等比缩小至可用区域的 90% 以内，保持 16:9 比例。舞台窗口的尺寸允许超出当前屏幕物理边界，因此在笔记本等小屏幕设备上选择大分辨率竖屏预设时，窗口依然会完整维持设定的分辨率尺寸。摄影棚模式 进行拍照或录像期间，窗口尺寸控制项会暂时锁定，以免导出中途画面尺寸变化。此外，舞台采用基于基准尺寸（stageReferenceSize）的自适应缩放机制，在任意比例拉伸调整窗口或最大化时，2D 与 3D 内容均能保持严谨的相对排版与对齐。

隐藏舞台窗口复制锚点链接

仅限 Windows 系统。在舞台 → 窗口中开启。

将舞台从桌面上隐藏，同时让 OBS 窗口采集继续获取画面。最小化做不到这一点：窗口最小化后，操作系统会停止合成它的画面，OBS 的窗口采集随之冻结在最后一帧。因此，Persona 在 macOS 与 Linux 上禁用了舞台窗口的常规最小化；在 Windows 上，所有最小化操作都会改为执行隐藏舞台窗口：

• Win + D（显示桌面）、Win + M 与 Win + ↓
• 任务栏图标
• 顶部控制栏的最小化按钮
• 控制面板中的开关

隐藏后，舞台窗口的不透明度为 0，鼠标事件会穿透窗口（WS_EX_TRANSPARENT | WS_EX_LAYERED）；窗口同时处于禁用状态（WS_DISABLED），因此关闭其他窗口或执行显示桌面后，它不会重新获得焦点而意外出现。舞台从桌面上消失，但仍保留任务栏按钮、与控制面板合并分组时的任务栏缩略图，以及 Alt + Tab 列表中的条目，并持续渲染画面，OBS 窗口采集与 摄影棚 拍摄均可照常进行。

以下任一操作都可以恢复显示：

• 点击任务栏上的舞台图标或缩略图
• 在 Alt + Tab 中选中舞台
• 切换控制面板中的开关
• 点击托盘菜单中的舞台窗口

从这些入口关闭舞台窗口也会照常生效。该选项仅在本次会话中有效，重新启动应用后会自动关闭，以免启动时舞台处于隐藏状态。

直播模式复制锚点链接

默认关闭。开启直播模式后，舞台窗口将停止绘制图层选中线框手柄以及 FPS 帧率计数器，确保 OBS 采集画面仅包含纯净的场景内容（若已启用 检查器 则仍会保留）。顶部的 拖拽区把手 仍会在鼠标悬停时显现，方便主播随时调整窗口位置与尺寸。

直播模式仅隐藏叠加在舞台画面上的编辑辅助组件，图层交互本身不受影响：当前选中的图层依然保持选中状态且可正常拖拽，仅隐藏视觉线框。控制面板作为独立窗口运行，本身不会被舞台采集捕获，因此无需额外隐藏。

直播模式下，相关控件会在控制面板中禁用，包括：

• 控制柄模式
• 环境面板中的控制柄开关
• 各光源面板上的指针按钮
• 显示 FPS 计数器（保留当前设定值）

除光源指针按钮外，这些控件都会显示提示，引导你先关闭直播模式；光源面板本身不显示提示，因为其参数仍可正常调整。

为防止推流时泄露本地磁盘路径或私密网页地址，直播模式还会遮挡以下信息：

• 设置中的插件文件夹路径会模糊显示，鼠标悬停时才显现。
• 网页图层的 URL 只显示源站，路径以 /*** 遮挡；详情面板中的复制按钮仍可复制完整 URL。

检查器复制锚点链接

默认关闭。开启后，舞台左上角将叠加显示半透明毛玻璃质感的只读监控面板，顶部标有 LAPLACE Persona 应用名称及版本号。由于该面板直接渲染在舞台画布上，因此会进入 OBS 采集画面；直播模式 不会自动隐藏检查器，且在直播模式开启期间该开关仍支持自由切换。

检查器始终跟随当前场景的 主模型，不受控制面板当前选区影响。其信息区域展示的参数与对应模型的信息区块一致（参见 Live2D 模型信息 与 VRM 模型信息），且处于常开状态。该面板为纯展示用途，不提供模型切换器或动作捕捉配置项。

显示 FPS 计数器复制锚点链接

开启后将在舞台窗口的左下角叠加性能监控组件（避开顶部的拖拽控制条），分别展示两条独立时钟循环的速率：UI 表示主界面与交互循环（包括手势、捕捉驱动与图层位置运算）；GPU 代表舞台画布的实际渲染帧率（覆盖虚拟形象、道具及后期特效）。若某条时钟处于空闲无需重绘状态，对应行将显示为 –。

两项指标均为实时测量值而非预设上限，可用于排查帧率限制是否生效或场景是否存在性能瓶颈。每行数值旁附带时长 24 秒的平滑历史趋势，点击组件可循环切换数据展示模式：

在 直播模式 下，由于舞台会隐藏辅助叠加层，控制面板中的「显示 FPS 计数器」选项会禁用并显示说明，切回「编辑」或「摄影棚」模式后即可重新调整（摄影棚导出的照片与视频会自动排除 FPS 计数器）。

背景复制锚点链接

舞台背景决定场景画面的底色与通透度，支持全透明（用于 OBS Alpha 通道画面叠加采集）、纯色填充、自定图片与视频，以及 3D 全景天空盒（Skybox/HDRI），详见 舞台背景。

窗口行为复制锚点链接

Persona 采用双窗口架构，各窗口独立记忆自身的位置与尺寸规格。若舞台窗口保存时所在的显示器已断开，下次启动时舞台会以保存的尺寸在主显示器中央打开，不会落在屏幕之外；保存的位置仍会保留，显示器重新连接后，只要期间未移动过舞台，舞台便回到原处。

舞台窗口透明、无边框，可自由缩放。它没有系统标题栏，鼠标悬停在顶部 28 px 高的交互区域时，会显示顶部控制栏：

• 左侧：「LAPLACE Persona」应用标识
• 中间：拖拽把手（按住可移动窗口）
• 右侧：最大化/还原按钮；Windows 上另有最小化按钮，点击即触发 隐藏舞台窗口

与系统标题栏一样，双击控制栏即可最大化或还原舞台窗口。在 Windows 上最大化舞台后，窗口无法从边缘缩放，也无法拖拽，居中的把手图标会相应变暗。

控制栏属于窗口本身的交互组件，而非编辑手柄，因此在 直播模式 下悬停时照常显示，方便主播随时移动或最大化窗口。按住鼠标操作舞台内容时划过顶部边缘，会被识别为画布交互手势，不会触发控制栏。如需精确控制画面比例与尺寸，请直接使用 窗口大小 中的预设或手动输入分辨率。

控制面板自带标准标题栏与半透明毛玻璃视窗，当窗口宽度压缩至无法并排排版时将自动转为不透明质感。初始启动尺寸为 760 × 720，最小支持缩放至 360 × 640。点击关闭按钮仅隐藏面板窗口，后台渲染与应用进程将持续运行。

• 双栏之间的分割线支持自由拖拽调整：左栏最小宽度为 260 px，右栏最小宽度为 360 px。调整后的栏宽会自动保存，双击分割线可快速重置为默认的 288 px 宽度。
• 详情页顶部固定显示一条区块索引栏，按页面顺序列出各个可折叠区块；点击即可展开对应区块并滚动至该处，当前正在浏览的区块会高亮显示。页面少于两个区块时不显示该栏。
• 双栏布局下，每个图层与页面各自记忆滚动位置：切换回来时回到上次离开的位置，尚未打开过的页面从顶部开始。
• 窗口较宽时，右栏中的配置项最宽 730 px 并居中排布，避免开关与对应标签相距过远。
• 面板始终置顶：使控制面板常驻浮动于舞台及其他窗口上方，便于边观察面板参数边在舞台交互布景。该选项默认关闭，可在设置中配置（作用对象为控制面板本身而非舞台窗口）。
• 系统托盘/菜单栏图标支持在设置中隐藏，详见 设置与更新。

两个窗口的标题互不相同：舞台窗口的标题始终为「LAPLACE Persona」，控制面板为「控制面板 — LAPLACE Persona」（随界面语言切换）。在 OBS 中使用窗口采集时选择「LAPLACE Persona」即可，采集源不会误抓到控制面板，已保存的采集源也继续匹配舞台窗口。

调整舞台内容位置复制锚点链接

每个图层的位置与缩放均独立于窗口，且各图层间互不干扰。在图层列表中选中对应图层后，支持以下快捷操作：

3D 场景中的模型与物体还支持屏幕空间控制柄，可在平移、旋转与缩放模式间快速切换；详细数值配置及有效范围参见 摆放。

在图层上下文操作菜单中点击重置位置，可恢复图层默认构图；相机面板中的重置相机可对 3D 轨道相机执行相同的回位操作。

所有位置与排版调整均会自动保存，随场景配置一同于下次启动时自动恢复。

控制入口复制锚点链接

应用程序提供多种途径访问常用全局操作：

控制面板标题栏集成了版本号显示、自动更新控件以及应用菜单。面板菜单集中了全局级别的应用控制项：点击新手引导…，可重新唤起 首次启动 引导向导；下方分组提供了常用外部链接，其中文档与 Web 控制台将通过系统默认浏览器打开对应在线文档与 Web 控制台，Discord 可直接加入官方社区。

关闭控制面板只会隐藏界面，不会退出应用，舞台窗口照常渲染。重新打开控制面板的方式：

• 点击系统托盘菜单的第一项控制面板（Windows 上也可直接左键点击托盘图标）
• macOS 上使用应用菜单，或按快捷键 ⌘ + ,
• Windows/Linux 上先点击舞台窗口，再按 Ctrl + ,

托盘菜单第二项舞台窗口用于恢复舞台窗口：若舞台窗口已关闭则重新创建，若处于 隐藏舞台窗口 状态则解除隐藏，并聚焦显示。因此，即使隐藏了托盘图标，也不会丢失控制入口。此外，应用已在运行时再次启动（例如点击程序坞图标、开始菜单快捷方式或执行启动命令），不会创建重复实例，而是将已打开的舞台与控制面板窗口唤起至最前端。

若需在 OBS 采集画面中隐藏编辑辅组件，可开启 直播模式：选中线框手柄与 FPS 计数器将完全停止在舞台上绘制；控制面板本身不属于采集范围，无需额外操作。

当面部或身体 捕捉 正在运行时，退出应用会弹出确认对话框，列出即将中断的捕捉源。该保护机制覆盖所有退出途径（面板菜单、托盘菜单、⌘Q、窗口关闭按钮及 Alt + F4），防止因误触导致直播中断。若当前未运行任何捕捉源，则会直接退出。

舞台窗口上不会弹出任何横幅气泡通知。关键系统事件（例如 插件 API 客户端连接、向窗口拖放文件的解析结果）均通过静默的系统原生通知发送；仅当系统禁用通知权限时，才会改用控制面板内部的横幅提示。这可避免通知内容（如插件局域网地址等私密信息）意外出现在 OBS 采集画面中。