00:00 / 00:00

Persona

表情編輯器

點擊表情面板頂部的新增表情,即可在模型同級目錄下建立新的 .exp3.json 表情檔案。各表情按鈕右側的下拉選單提供了編輯…與複製…操作;對於散落在目錄中未被主模型宣告鎖定的獨立檔案,還額外支援重新命名…與刪除…。

表情編輯器為 Live2D 模型專屬功能。檔案儲存後將即時在表情面板中呈現,不需要重新載入模型。

編輯器

編輯器對話框左側為該表情檔案本身的全局屬性設定,右側清單則列出目前模型支援的所有參數及其控制列。

控制項作用
名稱表情檔案名稱,副檔名固定顯示在輸入框右側。編輯現有表情檔案時名稱鎖定不可修改;如需改名請使用重新命名…
淡入、淡出寫入表情檔案的過渡時間(0 至 5 秒);若檔案中未明確指定,則按 Cubism 標準預設值 1 秒處理
獨奏預設開啟。在編輯目前表情期間,暫時靜音舞台上其餘所有生效中的表情
顯示物理模擬將物理演算驅動的參數一併展示在右側清單中,預設關閉
已開啟項置頂將目前已啟用的參數列優先排列在清單頂部
篩選參數支援按參數名稱或參數 ID 即時過濾清單;右側顯示參數總數與已啟用數量
快速鍵詳見 快速鍵
擷取姿勢詳見 擷取姿勢
還原放棄本次開啟編輯器以來的所未儲存變更,還原為檔案原始內容

各參數列左側的開關用於決定該參數是否包含在表情檔案中;開啟後將展開混合模式下拉選單與數值調整滑桿。列中清晰標明參數所屬群組與其 ID,受物理演算驅動的參數會附帶物理模擬標籤提示。

點擊儲存將變更寫回檔案;點擊取消則結束編輯——當存在未儲存的變更時,取消按鈕會顯示為醒目的顏色以防誤觸。

快速鍵

透過快速鍵設定區可以直接為目前表情繫結觸發按鍵,無需跳轉即可一步完成建立表情與按鍵繫結的設定。點擊新增快速鍵可建立一條新繫結,標題右側的輸入框用於錄製組合鍵,其錄製互動與 虛擬形象快速鍵 中的設定快速鍵…完全一致。

控制項作用
按住時生效表情僅在組合鍵處於按住狀態時生效,放開按鍵後自動退出
淡入淡出時間該快速鍵觸發時的淡入淡出時長;選取預設則遵循表情檔案自身的淡入與淡出設定
自動關閉時間表情啟用後自動關閉的延時;選取永不則保持開啟狀態直到手動切換

上述設定項目即為該快速鍵的 播放方式,與自動化清單中對應項目的設定選單保持一致。當淡入淡出時間設為具體數值(非預設)時,凡透過該快速鍵切換表情,均會優先使用該時間取代檔案自身的淡入與淡出;而透過介面按鈕、外掛 API 或自動化任務觸發時,仍嚴格遵循表情檔案自身的淡入淡出設定。

此處僅展示並編輯繫結至該表情檔案的第一條快速鍵。若該檔案關聯了多條快速鍵,介面下方會提示繫結的總數量,並引導你前往 自動化 進行管理——背景生效、刪除快速鍵以及管理該表情的其他按鍵均在該模組中進行。新增或複製出的表情檔案初始狀態下不包含任何快速鍵。

快速鍵設定在點擊儲存時與表情檔案同步寫入,且排在檔案儲存之後(以最終儲存的檔案名稱為繫結基準)。系統僅寫入在此次編輯中被實際修改的欄位,因此在對話框開啟期間透過自動化或外掛 API 修改的繫結不會被意外覆蓋;若在此期間某條快速鍵已被外部刪除,系統不會將其重新加回,此時編輯器會提示快速鍵未能儲存,而表情檔案本身仍會正常儲存。

混合模式

模式儲存格式滑桿調整範圍
新增相對參數預設值的相對增量。多個表情同時生效時線性累加(新建立列的預設模式)參數自身的有效取值範圍
覆寫絕對數值。多個表情同時生效時,後生效的表情具有更高優先順序參數自身的有效取值範圍
正片疊底乘法倍率係數。多個表情同時生效時連續相乘-3 至 3(與 VTube Studio 保持一致)

滑桿上顯示的數值始終為參數的最終綜合結果,即便是「新增」模式亦會在介面上換算為絕對值進行直觀展示,寫入檔案時再自動反算為相對增量。

切換參數列的混合模式時,系統會獨立記錄每種模式下的數值,切回之前的模式不會遺失已調校的資料。

預覽

在編輯器開啟期間,右側清單中的參數調整會直接即時反映在舞台模型上。預覽管線置於所有輸入驅動之後,因此即便該參數目前正被臉部追蹤即時控制,所做的數值調整依然清晰可見(與 VTube Studio 表情編輯器的預覽機制一致)。

目前正在編輯的表情自身在此期間會自動暫時靜音:它保持原有的啟用標記與淡入淡出進度,但暫停輸出自身原有的數值影響,從而避免預覽數值與舊數值發生疊加重複。獨奏開關則會同步靜音舞台上其餘所有生效中的表情;若關閉獨奏,正在編輯的參數將直接疊加在其他活躍表情之上,呈現儲存後的最終綜合效果。

暫時靜音不同於關閉表情。在編輯器開啟期間,透過快速鍵、自動化 或 外掛 API 對舞台表情的切換與儲存依然正常運作,關閉編輯器後亦無需執行額外的狀態還原。

受物理演算驅動的參數不參與即時預覽,在實際執行時由物理演算引擎直接接管計算;開啟顯示物理模擬僅用於允許對其數值進行設定與儲存。

擷取姿勢

擷取姿勢可一鍵抓取模型目前影格的全部參數狀態(包含臉部追蹤、動作播放與待機動畫的綜合結果),並將所有偏離預設值的參數自動啟用為「新增」模式的參數列。

若目前全部參數均處於預設數值狀態,點擊該按鈕將提示沒有可擷取的內容,且不會新增任何參數列。

儲存到哪裡

新增或複製產生的表情檔案預設儲存在模型根目錄下(即 VTube Studio 通用的表情儲存路徑);若清單中已有同名表情檔案,則儲存至該檔案的同級目錄。編輯現有表情檔案時,始終直接寫回原檔案路徑。

檔案儲存後將即刻反映在介面中:新檔案會作為新項目新增至表情面板,編輯的檔案則原地更新。若被修改的表情目前正處於生效狀態,新數值將立即無縫呈現,無需再次淡入。

系統禁止與清單中已有的任何表情檔案同名(快速鍵與 記住表情 均嚴格依據檔案名稱進行繫結)。若目標路徑已存在同名物理檔案,系統將彈出對話框提示「取代現有檔案?」進行二次確認。

重新命名與刪除

僅未被 .model3.json 宣告的獨立表情檔案支援重新命名或刪除操作;在模型主設定檔中宣告的內建模情受保護不可變更(Persona 不會修改模型的原始設定檔)。內建模情仍支援編輯…或複製…,複製產生的新檔案即為獨立表情檔案。

重新命名…:在磁碟上重新命名表情檔案,同時自動同步更新繫結在該檔案上的 虛擬形象快速鍵 以及 記住表情 中的記錄項目。目前處於生效狀態的表情將無縫維持開啟狀態。

刪除…:將表情檔案移至系統垃圾桶,並同步解除繫結在其上的所有快速鍵,確認對話框中會明確提示受影響的快速鍵數量。

重新命名與刪除操作均遵循交易安全性:系統會優先更新快速鍵與記住的表情設定,最後再操作磁碟檔案。若附屬設定檔寫入失敗(如唯讀或格式損毀),整個操作將自動中止,原始檔案保持原封不動。

檔案相容性

Persona 具有完善的檔案相容性保證:表情檔案中原有的全部設定均會被完整保留,包括淡入淡出時長、未啟用的參數項目,以及非標準擴充欄位(例如 VTube Studio 的 IsModelCustomizationExpression)。在寫回檔案時均會予以保留,避免了 VTube Studio 寫入時丟棄未知欄位的問題。

若同一個參數包含多條相同模式的設定項目,在編輯器中會自動合併為單列展示:新增模式執行累加、正片疊底模式執行累乘、覆寫模式取末尾最終值,完全貼合執行階段算繪的合成演算法。因此每列即代表該參數的完整效果,關閉該列即可完整移除對應參數的影響。

若檔案中包含目前模型未定義的未知參數(常見於跨模型通用的表情檔案),Persona 會予以原樣寫回保留,並在清單底部標明無法顯示的項目數量。若同一個參數混合設定了多種不同模式,其餘模式的設定區段將保留在底層邏輯中,僅在該參數列處於開啟狀態時參與播放與寫回。

最後更新於 2026年10月11日

Tech otakus destroy the world