00:00 / 00:00

Persona

设置与更新

设置控制面板 左边一列最下面的那一行,装的是与当前处于哪个 场景 无关的一切:界面语言、主题、托盘图标、音频输出、渲染性能,以及 插件 API。更新和关于对话框位于面板标题栏

自动化不在这里,而是它自己的一行,就排在捕捉下面——见 自动化

这一页分成通用性能存储位置插件 API 四个可折叠的区块,展开或收起的状态会记住。存储位置插件 API 默认收着

舞台窗口的尺寸,以及 直播模式检查器显示 FPS 计数器,都不在这里而在 舞台 那一行的窗口区块下

通用

语言

Persona 内置四种界面语言,在选择器里各自以自己的语言列出

选项效果
跟随系统跟随操作系统的语言
English始终使用英语
简体中文始终使用简体中文
繁體中文始终使用繁体中文
日本語始终使用日语

跟随系统读取操作系统上报的语言标记。中文在繁体变体下解析为繁體中文——zh-Hantzh-TWzh-HKzh-MO,按地区匹配,因为大多数系统上报这些标记时并不带 Hant 子标签——其余情况解析为简体中文。日语匹配自身。其他一切回退到 English

改动立即作用于整个界面,包括托盘菜单,无需重启

主题

控制面板、对话框和菜单的配色,可选跟随系统浅色深色。默认跟随系统,会跟着操作系统的外观切换

它只作用于界面本身。舞台不受影响——那里的画面由 背景灯光特效 决定,不受界面主题影响

面板始终置顶

让控制面板压在舞台和其他窗口之上,于是你可以一边点着舞台摆放场景,一边看着面板。默认关闭。它管的是面板而不是舞台——见 窗口行为

菜单栏图标

这个开关在 Windows 上叫显示托盘图标,在 macOS 和 Linux 上叫显示菜单栏图标,与各平台自己的叫法一致

在 macOS 上这个图标是单色模板图像,会像原生应用一样适应菜单栏——浅色栏上显示深色,深色栏上显示浅色

关掉它能让菜单栏更清爽,也不会因此失去任何入口。开关下面就写着这时候怎么把 控制面板 叫回来:macOS 上按 + , 或走应用菜单,Windows 和 Linux 上点一下舞台再按 Ctrl + ,

音频输出设备

Persona 的声音从这里播出:素材库和自动化播放的 音频文件,以及 Live2D 模型发出的声音——动作音效和 经由插件 API 播放的语音系统默认跟随系统自己的输出,也可以指定某个设备

保存的设备没有连接时,会显示为不可用设备。这时播放音频会报错,而不是悄悄改用默认设备,直到你选一个已连接的设备

发送错误报告

默认开启。报告崩溃和错误,帮助诊断应用问题。报告包含诊断信息和近期应用事件,可能涉及网页图层地址;原生崩溃报告还可能包含内存转储

关掉它就完全不再初始化上报。这项设置在启动时读取,所以改动后会出现重启以完全生效的提示

性能

后台渲染

Persona 现在始终保持后台渲染。操作系统通常会限制被隐藏或遮挡的窗口,这会让形象停止动作——当 OBS 正在采集窗口、而你已经切到别处时,这是你最不想遇到的。Persona 会让渲染循环照常运行,并请求系统不要挂起应用

原先的开关已经移除,这项行为不再需要配置。它不会阻止显示器按系统设置休眠

限制帧率

对两条渲染循环都设上限——2D 舞台和 3D 舞台,所以 VRM 场景及其特效会和其他一切一起被限制。在高刷新率显示器上很有用,限制帧率可减少不必要的 GPU 占用

预设说明
不限制以显示器的刷新率运行,高刷新率下更费
15 fps
30 fps低配置机器用这一档
60 fps默认,适合大多数直播
90 fps

特效质量

设置 3D 视觉特效 所用的抗锯齿方式,可选。越低越快

档位抗锯齿方式
4× MSAA——默认
FXAA,一次全屏的边缘平滑
不做抗锯齿

在所有特效都关闭的场景里它不产生任何开销

渲染分辨率

3D 舞台画在多大的画布上,取 100%85%75%66%50%,默认 100%。它是设备像素比的倍数,实际像素数还取决于显示器的缩放设置

降低渲染分辨率可减少整条 特效链 需要处理的像素,改善帧率。代价是画面清晰度下降,形象边缘和细小图案会更模糊

只作用于舞台绘制的内容,Live2D 模型与 2D 的图片、视频都算在内。2D 的网页是单独的 DOM 图层,不受影响

存储位置

设置、场景和 API 密钥都保存在 ~/.laplace/persona 这一个文件夹里。打开文件夹会在系统的文件管理器里定位到它

备份、迁移和恢复都是对这个文件夹的复制或替换。先退出 Persona——它运行期间会把自己的状态写回去,覆盖刚恢复的文件

文件内容
settings.json应用设置、素材白名单,以及插件目录
scenes.json你的全部 场景
credentials.jsonAPI 密钥,仅本人可读
plugin-storage.json插件通过 API 存下的 数据,仅本人可读
logs/诊断日志,只留在本机

settings.jsonscenes.json 都带有各自的 JSON Schema 链接(设置场景),VS Code 等编辑器可以边写边校验

打开日志定位到同一个文件夹下的 logs/。Persona 始终把错误和警告写进 main.log,无需开启:这个文件从不离开你的电脑,发送错误报告 才是唯一走网络的那条路。反馈问题时请附上它。写满 2 MB 就滚动成一份带时间戳的存档,只保留最近五份

插件 API

设置余下的部分用来启用和配置供其他应用驱动的本地 WebSocket 服务器——端口、局域网访问、API 密钥、插件目录和已连接客户端列表。它有自己的页面:插件 API

首次启动

第一次打开 Persona 时,控制面板上会盖着一个三步的引导:欢迎、要不要 发送错误报告,以及一页收尾。错误报告那一步列出报告里带什么、不带什么,下面的了解更多隐私信息用系统浏览器打开 隐私与安全。在最后一页点完成,这个选择连同「已引导过」的标记一起写进设置

只有首次启动那一次不能用 Esc 或点击别处关掉,所以它一定会被看到一次。之后随时可以从面板标题栏的菜单里再打开一遍,那一条叫新手引导…。重新打开时它就是一个普通对话框,可以直接关掉;每次打开读的都是设置当前的值

从更早的版本升级上来的安装同样会看到它一次——这个标记默认为否,也不会为早于它的设置文件预先置上

关于

面板标题栏的菜单里还有三条:文档网页控制台新手引导…。前两条用系统浏览器打开这份文档和 Web 控制台,最后一条重新打开 首次启动 的那个引导

关于 LAPLACE Persona——位于面板标题栏的菜单、托盘菜单,以及 macOS 上的应用菜单里——显示版本号、按分工列出参与者的制作人员、列出项目要感谢的人的致谢,以及该构建中所有捆绑内容的第三方声明:Live2D Cubism Core、内置模型、VRM 动画与待机动画包及其要求的署名、内置的环境贴图与环境模型、界面字体,还有 口型同步 所用的 wLipSync 库与声音配置。声明之后以 Special Thanks 收尾,这个标题在各种语言下都保持英文

更新

版本号位于面板标题栏的右上角。它同时也是更新的操作入口

Persona 会在启动约十秒后静静检查一次,之后每次你点击版本行时再检查一次。安装包仅在你确认更新后下载

版本行含义
纯文本此安装方式无法自我更新——见下文
仅版本号闲置中。点击可检查更新
转圈图标正在检查或下载
向上箭头有可用更新。点击打开对话框
刷新箭头更新已下载完成,等待安装
警告图标下载失败。点击重试

更新流程

  1. 检查——点击版本行。若已是最新,会有提示告诉你;若不是,更新对话框会打开
  2. 选择——更新开始下载,稍后关闭对话框,跳过此版本让自动检查不再提示该版本。被跳过的版本在你自己点击版本行时仍会出现
  3. 下载——进度显示在对话框里。Persona 依然可用,关闭对话框也不会中断下载
  4. 安装——立即重启会马上应用。否则会在你下次退出时安装

Persona 主动发起两类对外网络请求:更新检查,以及 发送错误报告 开启时的崩溃上报。更新检查发往 downloads.vrp.moe,除了任何文件下载本身都会涉及的信息之外不携带任何身份信息。错误报告可以用那个开关关掉;当前安装程序没有关闭更新检查的设置,要阻止检查只能屏蔽该主机

最后更新于 2026年9月20日

Tech otakus destroy the world