Persona 的官方 Elgato Stream Deck 插件，把 插件 API 接到一排实体按键上：切换模型、激活场景、触发热键、运行自动化、开关表情、播放动作，以及在舞台上移动和缩放形象
它和 Web 控制台 走的是同一套 API，在桌面应用中开启 API 并创建密钥后即可连接
前置条件
| 需要 | 说明 |
|---|---|
| Stream Deck | 7.1 或更高版本，macOS 12+ 或 Windows 10+ |
| LAPLACE Persona | 正在运行，并且 插件 API 已开启 |
| API 密钥 | 在 设置 → 插件 API 里创建一把 |
安装
在页面上点安装，剩下的交给 Stream Deck 应用；在 Stream Deck 应用内置的 Marketplace 里搜索 LAPLACE Persona 也一样。装好之后，Stream Deck 应用右侧的动作列表里会多出 LAPLACE Persona 这一类
连接
把任意一个动作拖到按键上，右侧属性面板的底部有两个字段：
| 字段 | 填什么 |
|---|---|
| Persona Address | 留空即 127.0.0.1:25034。也接受 主机、主机:端口，或一整条 ws:// URL |
| API Key | 你在 Persona 里创建的那把密钥的令牌 |
所有动作共用这两个连接设置，只需填写一次
连上之后，Persona 的 已连接的客户端 里会出现一行 Elgato Stream Deck，开发者是 LAPLACE
要控制另一台机器上的
Persona，得先在那台机器上打开允许局域网访问，再把地址填成它的
主机:端口。连接走的是明文 ws://——Persona 自己不做
TLS——所以在不可信的网络上请在它前面加一层 TLS 代理，然后把代理那条完整的
wss:// URL 填进地址栏
动作
除激活场景和运行自动化之外，其余动作都作用于当前场景的 主模型
| 动作 | 作用 |
|---|---|
| 切换模型 | 把主形象换成选定的模型。场景里一个模型都没有时，它会直接添加一个 |
| 激活场景 | 应用某个已保存的 场景 |
| 触发热键 | 运行当前模型的某个 快捷键。和 VTube Studio 一样，热键属于模型 |
| 运行自动化 | 触发某条 自动化——执行其中的全部操作，无需绑定键盘组合键 |
| 切换表情 | 开关当前模型的某个 表情 |
| 播放动作 | 播放当前模型的某段 动作。这段动作正在播时再按一次，它就停下 |
| 移动模型 | 朝一个方向微移形象。按住持续移动 |
| 缩放模型 | 放大或缩小形象。按住持续缩放 |
| 重置变换 | 把这个形象的位置、缩放和旋转恢复原状 |
模型、场景、热键、自动化、表情和动作这几个下拉框，内容会从正在运行的 Persona 实时获取。属性面板开着时，自动化列表还会跟着你的改动即时更新，暂停的自动化显示为灰色。没连上时下拉框里是一行说明原因的提示，而不是一片空白
运行自动化是把一整套舞台改动放到一个按键上最省事的方式：在 Persona 里把这条自动化建好、不给它绑任何组合键，剩下的交给 Stream Deck
移动与缩放
这两个动作各自可以配置步进。按住不放会在约三分之一秒后开始自动重复，之后每 100 毫秒走一步；中途出错就停下来，并让按键闪一次警告
| 动作 | 参数 |
|---|---|
| 移动模型 | 方向（上、下、左、右）、2D Step（像素）和 3D Step（世界单位） |
| 缩放模型 | 方向（放大、缩小）和 Factor，默认 1.1 |
两个步进值分别对应 Live2D 的屏幕空间和 VRM 的世界空间，所以同一个按键在两种格式上都合用。缩放会被限制在面板本身的范围内，持续按住也不会超出缩放范围。小于 1 的 Factor 一律按这个比例缩小，此时方向不起作用
按键
按键的图案是 Persona 的标志加上这个动作的图标，动作名跟随 Stream Deck 应用自己的语言。你给按键设了标题，标题会画在图案之上；换成自定义图片，整张图就都由你决定
动作成功会闪一次对勾，失败闪一次警告图标并在插件日志里记一行。按住期间不闪对勾，免得每一步都闪一下
插件目前提供英文与简体中文两种界面语言，跟随 Stream Deck 应用的语言设置。属性面板里的字段名暂时只有英文
最后更新于 2026年9月19日