Persona

通过网页控制台在浏览器中控制运行中的桌面应用。控制台的外观和连接偏好保存在当前浏览器中。

连接复制锚点链接

1. 在桌面应用中打开「设置 → 插件 API」，启用 API 并创建密钥。
2. 打开 persona-console.laplace.live。
3. 输入桌面主机、API 端口和密钥后连接。同一台电脑使用 127.0.0.1，默认端口为 25034。

连接局域网中的另一台电脑时，在桌面端启用「允许局域网访问」。HTTPS 控制台不能连接远程未加密的 ws:// 端点：请通过 HTTP 提供控制台，或使用 TLS 代理并启用「使用 TLS (wss://)」。Persona 内置 API 不提供 TLS 终止。服务设置和密钥管理见 插件 API。

浏览器偏好复制锚点链接

「设置 → 网页控制台」中的「语言」和「主题」仅影响当前浏览器，不会改变桌面应用的外观。「自动连接」会在打开控制台时复用完整的已保存连接。

连接页面的「保存 API 密钥」决定是否将密钥存入浏览器本地存储。关闭后，当前连接只在内存中保留密钥，重新加载页面后需要再次输入。主动断开后不会立即自动重连；已撤销的密钥需要更换。

「通用」和「性能」区域修改的是已连接桌面应用的设置。控制台各区域的展开状态及面板宽度则由浏览器单独保存。

可控制的内容复制锚点链接

控制台提供场景、图层、模型、捕捉、特效及已保存自动化的控制。选择图层后可编辑它支持的属性。虚拟形象快捷键按模型分组，各组可独立折叠。详情页顶部的区块索引栏可快速跳转至页面中的各个区块。

• 大纲视图：与桌面端一致，「舞台」作为固定行常驻于图层列表底部，点击可快速打开场景属性并清除图层选区；在具备 object-pin-depth 能力的主机上，钉选到 Live2D 模型的 2D 图片、视频或网页支持深度滑块调节（未声明该能力的主机不显示深度滑块与图钉标记；网页图层不再包含前置/后置图层开关）。
• 场景预设：在具备 scene-presets 能力的主机上，大纲视图顶部列出当前场景的 场景预设，支持应用、新建、更新为当前布局、设置转场、重命名与删除，与桌面端一致。
• 文本图层：需要主机声明 object-text 能力（兼容旧版 text-objects）。
  • 素材库中的「文本」标签页和字体选择列表仅在支持该能力的主机上显示。字体列表通过 fonts.list 读取桌面主机上已安装的字体，而非浏览器字体。
  • 在控制台中调整文本内容、排版与外观时，改动通过 object.setContent 实时提交至桌面端。桌面端将其视为原地编辑，并在操作暂停时记录一步撤销。
• 视频图层：需要主机声明 object-video-sound 能力（兼容旧版 video-sound）。
  • 选中视频图层后可调节「循环」开关、「静音」按钮与「音量」滑块，改动通过 object.setContent 原地提交。旧版主机每次调节都会替换场景并清空历史记录，因此不显示这一区域。
  • 控制台无法直接控制桌面舞台上正在播放的媒体元素，因此没有播放/暂停与进度条拖拽控件，已保存的暂停状态保持不变。
• 色度键（去背）：依赖宿主客户端声明的 object-chroma-key 能力。选中图片、视频或网页图层时呈现色度键控制区块，支持启用色度键、选取抠像颜色、调节相似度、平滑度与溢色抑制。未声明该能力的主机不展示该区块，防止提交后被旧版宿主丢弃。
• 模型整体移动：在具备 model-movement 能力的主机上，选中的 Live2D 模型支持调节水平、垂直与深度位移滑块（范围 −50 – 50）；在具备 model-movement-pivot 能力的主机上，支持设置「前后缩放中心」或在舞台上点击模型拾取，使模型在靠近或远离摄像头时围绕指定中心缩放。
• 隐私保护：当桌面端处于直播模式时，网页图层 URL 自动以源站加 /*** 掩码脱敏（可通过一键复制按钮获取完整真实 URL，且输入框支持直接粘贴替换新地址）。
• 本地资源：模型和素材文件位于桌面电脑上。素材库列出已登记的素材；登记路径需要位于允许的插件文件夹中，并非通过浏览器上传文件。

自动化编辑、快捷键录制、API 密钥管理、系统文件对话框、舞台操作柄和应用更新仍在桌面应用中完成。