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 填進位址欄
動作
除 Activate Scene 與 Run Automation 之外，其餘動作都作用於目前場景的 主模型
| 動作 | 作用 |
|---|---|
| Switch Model | 把主形象換成選定的模型。場景裡一個模型都沒有時，它會直接加入一個 |
| Activate Scene | 套用某個已儲存的 場景 |
| Trigger Hotkey | 執行目前模型的某個 快速鍵。和 VTube Studio 一樣，快速鍵屬於模型 |
| Run Automation | 觸發某條 自動化——執行其中的全部操作，無需綁定鍵盤組合鍵 |
| Toggle Expression | 開關目前模型的某個 表情 |
| Play Motion | 播放目前模型的某段 動作。這段動作正在播時再按一次，它就停下 |
| Move Model | 朝一個方向微移形象。按住持續移動 |
| Scale Model | 放大或縮小形象。按住持續縮放 |
| Reset Transform | 把這個形象的位置、縮放與旋轉恢復原狀 |
模型、場景、快速鍵、自動化、表情與動作這幾個下拉選單，內容會從正在執行的 Persona 即時取得。屬性面板開著時，自動化清單還會跟著你的變更即時更新，暫停的自動化以灰色顯示。沒連上時下拉選單裡是一列說明原因的提示，而不是一片空白
Run Automation 是把一整套舞台改動放到一個按鍵上最省事的方式：在 Persona 裡把這條自動化建好、不給它綁任何組合鍵，剩下的交給 Stream Deck
移動與縮放
這兩個動作各自可以設定步進。按住不放會在約三分之一秒後開始自動重複，之後每 100 毫秒走一步；中途出錯就停下來，並讓按鍵閃一次警告
| 動作 | 參數 |
|---|---|
| Move Model | 方向（上、下、左、右）、2D Step（像素）與 3D Step（世界單位） |
| Scale Model | 方向（放大、縮小）與 Factor，預設 1.1 |
兩個步進值分別對應 Live2D 的螢幕空間與 VRM 的世界空間，所以同一個按鍵在兩種格式上都合用。縮放會被限制在面板本身的範圍內，持續按住也不會超出縮放範圍。小於 1 的 Factor 一律按這個比例縮小，此時方向不起作用
按鍵
按鍵的圖案是 Persona 的標誌加上這個動作的圖示，動作名稱跟隨 Stream Deck 應用程式自己的語言。你給按鍵設了標題，標題會畫在圖案之上；換成自訂圖片，整張圖就都由你決定
動作成功會閃一次勾號，失敗閃一次警告圖示並在外掛記錄裡寫一行。按住期間不閃勾號，免得每一步都閃一下
外掛目前提供英文與簡體中文兩種介面語言，跟隨 Stream Deck 應用程式的語言設定——繁體中文環境下會顯示英文，所以上表列的是英文動作名稱。屬性面板裡的欄位名稱暫時也只有英文
最後更新於 2026年9月19日