Persona

设置位于 控制面板 左侧导航栏底部，汇集了不依赖具体 场景 的全局配置：界面语言、外观主题、系统托盘/状态栏图标、音频输出、渲染性能以及 插件 API。应用版本更新与关于信息位于面板标题栏。

设置页面分为五个可折叠区块，每个区块都会记住上次的展开或折叠状态：

自动化配置不在本面板中，而是作为独立入口位于捕捉下方（详见 自动化）。

舞台窗口的尺寸以及 直播模式、检查器 和 显示 FPS 计数器 不在此处，而是在 舞台 → 窗口中设置。

通用复制锚点链接

语言复制锚点链接

Persona 内置四种界面语言，在语言选择器中均以其本地原生名称呈现：

跟随系统会读取操作系统上报的语言标识（Language Tag），并据此选择界面语言：

系统通常只上报地区代码，不带 Hant 子标签，因此繁体变体一般按地区代码识别。

语言切换即时全局生效（包括系统托盘菜单），无需重启应用。

主题复制锚点链接

控制面板、系统对话框与弹出菜单的配色方案，支持跟随系统、浅色与深色三种模式。默认设为跟随系统，自动响应操作系统的外观切换。

主题配置仅作用于 UI 控制界面本身。舞台渲染内容完全由 背景、灯光 与 特效 决定，不受应用主题影响。

字体大小复制锚点链接

调整控制面板的基础文字大小，范围 11 – 18 px，默认 12 px。文字、间距与控件尺寸会随之等比缩放，窗口最小宽度与双栏分隔位置也会相应调整；标题栏保持原有尺寸不变。该设置仅作用于控制面板，不影响舞台窗口。

自定义颜色复制锚点链接

拾色器支持保存并管理最多 100 个常用自定义颜色，超出可见范围时色板可滚动浏览。在任意拾色器弹出层中输入或吸取颜色后，点击「保存颜色」按钮（+）即可加入已保存色板；右键单击已保存的色块可随时移除。保存的色板在应用内跨场景共用。

保存时会一并保留颜色的不透明度。带透明度的颜色仅出现在支持不透明度的拾色器中（例如 背景颜色，其色板前另有三个无法移除的内置预设），其余拾色器只列出不透明的颜色。

面板始终置顶复制锚点链接

启用后，控制面板将始终悬浮置顶于舞台视口及其他桌面窗口之上，便于在点击舞台调节场景布局的同时持续观察并操作控制参数。默认处于关闭状态。该选项仅约束控制面板的窗口层级（舞台窗口层级详见 窗口行为）。

菜单栏图标复制锚点链接

该开关在 Windows 上命名为显示托盘图标，在 macOS 和 Linux 上命名为显示菜单栏图标，与各操作系统的原生术语规范保持一致。

在 macOS 上，该图标采用单色模板图像（Template Image），可自适应菜单栏底色：在浅色菜单栏上显示为暗色，在深色菜单栏上显示为亮色。

关闭该选项可保持系统状态栏整洁，且不会丢失功能入口。开关下方提供了快捷唤出控制面板的操作指引：macOS 上可使用快捷键 ⌘ + , 或通过应用主菜单唤出；Windows 与 Linux 上则可点击舞台视口后按下 Ctrl + , 打开 控制面板。

音频输出设备复制锚点链接

指定 Persona 所有音频流的输出声卡设备，包括素材库与自动化流程触发的 音频文件、视频图层声音，以及 Live2D 模型的动作音效与 经由插件 API 播放的语音。选择系统默认将跟随操作系统的全局默认输出设备，亦可手动锁定至指定的独立硬件设备。

若已保存的音频输出设备已断开连接，界面会将其标记为不可用设备。此时播放音频会直接报错提示，而不会自动切回默认设备，直至重新选定可用设备。

发送错误报告复制锚点链接

默认处于启用状态。该机制用于向开发团队上报崩溃日志与运行时未捕获异常，辅助诊断应用稳定性问题。错误报告包含系统诊断参数及近期的应用运行时事件（可能包含网页图层的访问地址）；原生层崩溃报告可能附加内存转储（Memory Dump）。

关闭该开关将彻底禁用上报模块的初始化。该设置仅在应用冷启动时读取，因此修改后界面将提示重启以完全生效。

性能复制锚点链接

调度 GPU 计算资源与渲染流水线，包括设定前台目标帧率上限、后台运行时的节能限制与暂停策略、视口渲染分辨率缩放，以及全屏后期特效的抗锯齿采样级别。详见 性能。

存储位置复制锚点链接

管理 Persona 的本地数据目录结构，包括应用主设置与场景配置文件的存放路径、配置自动轮转备份机制，以及底层运行日志的查看与清理。详见 存储位置。

插件 API复制锚点链接

设置面板底部的插件 API 区块用于启用并配置供外部第三方客户端连接控制的本地 WebSocket 通信服务，涵盖网络端口、局域网访问授权、API 鉴权密钥、插件脚本目录及实时在线客户端会话列表。在 直播模式 开启期间，为防止推流画面意外泄露本地磁盘路径，配置的插件脚本目录路径会自动应用模糊遮罩，仅在鼠标悬停时临时浮现。详细规范与开发指南请参阅专题文档：插件 API。

Cubism Editor复制锚点链接

Cubism Editor 区块用于连接 Live2D Cubism Editor 的外部应用程序集成接口，将舞台上 Live2D 模型的实时参数值流式传入 Editor 中打开的模型，以便在 Editor 的物理窗口中预览真实追踪数据驱动下的物理与变形效果。支持在 Editor 导出模型时自动重载舞台上的对应模型。详见 Cubism Editor 联动。

首次启动复制锚点链接

首次启动 Persona 时，控制面板上将弹出三步式新手引导向导：包含欢迎界面、发送错误报告 授权确认以及完成总结界面。错误报告授权步骤清晰列明了上报数据的字段范围与隐私排除项，点击底部的了解更多隐私信息可在系统浏览器中查阅完整的 隐私与安全 规范。在向导末页点击完成后，系统将把授权决策连同「已完成初始引导」标记同步写入全局配置。

仅在首次启动时，该向导窗口不能通过按 Esc 键或点击外部空白区域关闭，以确保用户阅读并确认关键授权条款。此后随时可在面板标题栏菜单中点击「新手引导…」重新打开向导；再次打开时可随时关闭，且各项控件均会显示当前的配置状态。

从旧版本升级安装时也会弹出一次向导：旧版配置文件若缺少该完成标记，默认视为未完成。

关于复制锚点链接

面板标题栏的功能菜单包含全局入口：文档、网页控制台、检查更新… 与 新手引导…。前两项用于在系统默认浏览器中打开本技术文档及 Web 控制台，最后一项用于重新打开 首次启动 的新手向导。

点击关于 LAPLACE Persona 会打开关于对话框，标题栏菜单、系统托盘菜单和 macOS 应用主菜单中都有这一项。对话框显示当前完整版本号、按职能划分的制作人员名单和项目致谢列表，随后是当前版本捆绑的所有第三方组件的开源许可声明：

• Live2D Cubism Core
• 内置 3D 模型资产
• VRM 动作库及待机动作包的署名
• 内置环境贴图与环境模型
• 界面排版字体
• 口型同步 模块依赖的 wLipSync 算法库与声音特征模型

许可声明末尾以保留英文名称的 Special Thanks 结语致谢。

更新复制锚点链接

「检查更新…」位于控制面板标题栏的功能菜单以及 macOS 应用主菜单中，点击即可随时手动检查最新版本。Persona 也会在启动约 10 秒后在后台自动检查一次版本更新。

当检测到有可用新版本时，控制面板标题栏右上角将显现版本徽标（如 v0.59.0），点击可展开更新详情对话框；未检测到新版本或当前已是最新版本时，标题栏保持净空，不显示版本号徽标。

新版本安装包仅在用户确认更新后才会开始下载。更新徽标的图标状态会随更新阶段实时变化：

更新流程复制锚点链接

1. 检查更新：在功能菜单中选择「检查更新…」。若当前已是最新版本，系统将弹出浮动提示告知；若检测到新发布版本，则自动打开更新对话框（同时标题栏显现新版本徽标）。
2. 选择操作：点击更新开始下载安装包；点击稍后关闭当前对话框；点击跳过此版本可不再弹出该版本的自动更新通知（后续手动通过菜单检查更新仍可查看并升级被跳过的版本）。
3. 后台下载：更新对话框中实时展示下载进度与速度。下载期间 Persona 所有功能均可正常使用，关闭对话框不会中断后台下载任务。
4. 执行安装：下载完成后，点击立即重启即可退出并应用更新；若选择推迟，系统将在下一次正常退出 Persona 时自动完成新版本安装。

Persona 仅主动发起两类出站网络请求：基于 HTTPS 的版本更新检查，以及在开启 发送错误报告 时发起的崩溃诊断上报。更新检查请求统一发往 downloads.vrp.moe 域名，除标准 HTTP 文件请求元数据外不携带任何用户隐私或身份识别标识。错误报告功能可通过设置开关随时彻底关闭；当前安装包未提供关闭更新检查的选项，若需完全阻断检查请求，可通过系统 Hosts 文件或网络防火墙屏蔽该域名。