Persona

Persona 官方 Elgato Stream Deck 插件将 插件 API 映射至实体按键，支持一键切换模型、激活场景、应用场景预设、触发快捷键、执行自动化流程、开关表情与动作、设置动态文本，以及在舞台上微调虚拟形象的位置与缩放。

插件与 Web 控制台 基于相同的 API 构建。在桌面应用中开启 API 功能并创建密钥后即可直接连接。

前提条件复制锚点链接

安装复制锚点链接

点击上方安装按钮即可通过 Stream Deck 应用自动安装；也可以在 Stream Deck 内置的 Marketplace 中搜索「LAPLACE Persona」安装。安装完成后，Stream Deck 动作列表中会新增 LAPLACE Persona 分类。

连接配置复制锚点链接

将任意 Persona 动作拖放到按键上，在右侧属性面板底部配置连接参数：

上述两个连接参数为全局配置，在任意动作中填写一次即可作用于所有按键动作。

建立连接后，Persona 的 已连接的客户端 列表中会显示 Elgato Stream Deck（开发者：LAPLACE）。

动作列表复制锚点链接

除激活场景、应用预设、执行自动化以及作用于选定文本图层的设置文本外，其余动作默认作用于当前场景的 主模型；触发热键动作则直接作用于选定快捷键所属的模型。

模型、场景、预设、快捷键、自动化、表情与动作等下拉选项均实时从运行中的 Persona 获取（预设列表取自当前场景）。属性面板打开期间，自动化列表会随配置修改实时更新，已暂停的自动化以灰色显示。若尚未连接，下拉列表会显示当前连接状态或错误说明，而非空白列表。

移动与缩放复制锚点链接

移动与缩放动作均支持自定义步长。长按按键会在约 300 毫秒后开始连续触发（之后每 100 毫秒执行一次）；若执行出错，连续步进会立即停止并在按键上显示警告图标。

2D 与 3D 步长分别对应 Live2D（屏幕像素空间）与 VRM（世界坐标空间），因此单个按键动作可同时适用于两种格式的模型。缩放范围受应用内置的安全界限限制，长按不会超出允许的缩放范围。若 Factor 小于 1，无论方向如何都会按该比例缩小。

按键显示与反馈复制锚点链接

按键图标由 Persona 图标与对应动作图标组合而成，动作名称随 Stream Deck 客户端的语言环境自动显示。自定义按键标题会显示在默认图标上方；若设置了自定义图像，则会完全替换默认图标。

操作执行成功时按键会短暂显示勾选标记，失败时显示警告图标并记录至插件日志。长按连续触发期间不显示成功标记，以免画面频繁闪烁。