Persona

參數繫結編輯器用於設定輸入校正、輸入源與混合權重、輸入/輸出範圍以及自訂回應曲線，控制追蹤資料如何驅動 Cubism 模型的各個參數。

Persona 預設優先讀取模型自帶的 .vtube.json 設定檔，因此在 VTube Studio 中調校好的模型可以直接沿用原有的參數映射。你可以在參數繫結編輯器中繼續微調和擴充這些映射；所有變更都單獨儲存在模型同級目錄下的專屬設定檔中，不會改動原始的 .vtube.json。

開啟編輯器複製錨點連結

在圖層清單中選取 Live2D 圖層，展開其檢視面板底部的參數（預設摺疊）。

本頁主要介紹 Live2D 的追蹤參數繫結。VRM 虛擬形象 的臉部追蹤直接驅動預設表情形態與人形骨骼；外部遊戲手把與控制器則透過虛擬繫結目標進行映射。

每個輸入源在面板中顯示為一張獨立的卡片，卡片下方列出其驅動的目標參數；點擊任意參數列即可在卡片內部直接展開完整的繫結詳細資訊與回應曲線編輯器。篩選條件、卡片摺疊狀態、目前展開的繫結及校正列會在目前工作階段中依模型實例自動記憶。

輸入卡片與工具列複製錨點連結

頂部的工具列提供快速搜尋、篩選與批次操作：

• 搜尋輸入和參數：可同時比對輸入標籤、原始 ID、繫結自訂名稱以及目標參數名稱與 ID。
• 顯示的輸入：在使用中與全部輸入之間切換。使用中是模型已有繫結時的預設檢視，只顯示被繫結讀取的輸入；全部輸入顯示所有可用輸入源。
• 輸入類別：依類別篩選卡片，可檢視全部類別，或單獨檢視頭部、眼睛、眉毛、嘴巴、手部、滑鼠、時間、隨機、52 個原始 ARKit 通道的完美同步，以及已連線控制器設定檔的專屬輸入分組。
• 新增繫結：從完整輸入詞彙表中挑選任意輸入源，將其卡片固定顯示在使用中檢視中並直接開啟參數選擇器。
• 全部校正：同時錄製並校正所有使用中、正在接收資料的輸入（詳見下文 輸入校正）。
• 重設校正：一次性清除目前模型上所有輸入的校正（作為單步可復原操作）。
• 全部收合 / 全部展開：一鍵收合或展開清單中的所有輸入卡片。

手部輸入源來自攝影機的手勢追蹤，詳見 攝影機追蹤；嘴巴分組中還包含由麥克風音訊驅動的 Voice* 輸入源，詳見 口型同步。

每張輸入卡片的頂部顯示：

• 輸入的在地化標籤與原始 ID
• 即時數值與數值條
• 校正按鈕（已校正的輸入還會顯示已校正標記與範圍刻度；隨機輸入卡片則顯示觸發設定按鈕）
• +（新增參數）按鈕

卡片下方透過垂直導軌連接該輸入驅動的參數列。每列顯示：

• 左側的回應曲線縮圖與即時取樣點，無需展開即可看到曲線形態
• 繫結名稱與原始參數 ID
• 輸入範圍 → 輸出範圍 摘要與平滑係數
• 參數的即時輸出值

原始 ID 與 .vtube.json、.cdi3.json 及 外掛 API 中的寫法一致，可直接選取複製。

參數列與參數選擇器中可能包含以下狀態標記：

若某個輸入作為次要項目被合算進其他主輸入名下的繫結中，卡片底部會顯示同時加入標籤與可點擊的跳轉標籤，點擊即可直接定位並展開對應繫結。

點擊卡片右上角的 +（新增參數）或工具列的新增繫結可開啟參數選擇器。參數名稱與其所屬分組直接讀取自模型的 .cdi3.json 檔案；若模型未包含該檔案，清單將為空（由於缺乏中繼資料，無法取得參數的人類可讀名稱）。

已被其他繫結佔用的參數不會被停用。清單中會清晰標註目前驅動該參數的規則名稱（取代 ⋯），選取它會將對應繫結遷移至目前輸入，而非建立重複規則，避免兩條繫結同時向同一參數寫入造成衝突。參數原有的映射設定（輸出範圍、平滑係數、回應曲線以及自訂名稱）均會完整保留，僅替換輸入源及其輸入範圍。

滑鼠與時間輸入複製錨點連結

滑鼠與時間分組無需攝影機：

滑鼠輸入的 ID 沿用 VTube Studio 的命名。滑鼠輸入獨立於臉部追蹤與追蹤總開關，即使關閉攝影機，也能驅動眼睛視線、頭部角度或桌寵爪子。目前只提供游標位置；滑鼠按鍵不作為繫結輸入，但可用作 快速鍵 的觸發鍵。

時間輸入讀取執行 Persona 的桌面電腦的本機掛鐘時間，即使透過 Web 主控台編輯也是如此。例如 06:00 時，Time24h 為 0.25，Time12h 為 0.5。繫結計算保留秒的小數部分，運動更平滑；介面的即時讀數則截斷至整數秒，靜止時數值保持穩定，只在正午或午夜回捲。

時間每渲染一個畫格取樣一次，由 Live2D 與 VRM 虛擬形象共享；即使關閉臉部追蹤或中斷攝影機連線，時間也會持續驅動繫結。將參數繫結至時間輸入時（包括將現有繫結遷移至時間），其平滑係數會自動歸零（smoothing: 0），否則 平滑 會在午夜或正午回捲時產生倒退回掃。首尾端點相符的曲線可以避免週期邊界處的跳變。

對於同時混合臉部追蹤與時間輸入的繫結，臉部追蹤遺失後的表現由 追蹤遺失時 決定：回到待機（idle）會淡出臉部追蹤部分、過渡到僅由時間驅動的結果；保持最後姿勢（hold）則保留臉部追蹤的最後姿態，時鐘照常推進。

隨機脈衝輸入複製錨點連結

隨機分組提供八個獨立的自動觸發輸入：隨機脈衝 1 至 隨機脈衝 8（ID 為 RandomPulse1 – RandomPulse8，量程 0..1）。每個脈衝平時靜止在 0，並依各自設定的時間表隨機觸發升至 1 再回落，無需攝影機，也不受臉部追蹤開關或連線狀態影響，適合驅動耳朵輕抖、尾巴擺動、眨眼或配飾閃爍等隨機小動作。

點擊任意隨機脈衝卡片上的觸發設定即可展開時間設定列（單位均為秒，每次觸發都會重新隨機抽取等待與持續時間，點擊重設可恢復預設值）：

若某次抽中的持續時間短於淡入與淡出之和，兩段過渡會依比例縮短。預設的觸發設定與 VTube Studio 的自動眨眼完全一致。

僅由隨機脈衝驅動的繫結以疊加方式運作，因此可以與一般繫結共用同一個輸出參數：

• 在參數選擇器中，已被其他繫結驅動的參數會標為加入 ⋯（而非取代 ⋯）。例如，ParamEyeLOpen 可以繼續由 EyeOpenLeft 驅動，同時疊加一條 RandomPulse1 繫結在每次脈衝觸發時閉眼。
• 脈衝觸發期間，參數從目前值平滑拉向繫結輸出範圍的觸發端（outRange[1]，或回應曲線移動的目標端）；兩次觸發之間不寫入參數，保持原有驅動結果不變（若脈衝繫結的靜止輸出值與參數預設值不同，則在沒有其他繫結驅動該參數時維持該靜止值）。
• 在隨機脈衝上新建繫結時，預設輸出範圍會從參數的預設值指向遠端（對於預設值為 1 的 0..2 參數則設為 1 → 0），且平滑預設為 0（升降過渡已由脈衝自身的淡入與淡出控制）。
• 在組合輸入中，隨機脈衝繫結只能疊加其他隨機脈衝輸入，不能與一般追蹤輸入混用。

輸入校正複製錨點連結

校正用於調整你實際的表情或動作幅度如何映射到該輸入的原生量程，在任何繫結讀取該輸入之前生效。點擊輸入卡片上的校正按鈕即可展開校正列；時間與隨機輸入不支援校正。

校正位於繫結之前，因此同一虛擬形象上的所有繫結都會共享校正後的訊號，透過外掛 API 注入的輸入與 VRM 控制器繫結也是如此。

校正列提供以下控制項：

• 下限與上限：你實際能達到的最小與最大幅度，映射到該輸入原生量程的兩端。FaceAngleZ（頭部傾斜）的校正映射至 ±30°，與其他頭部角度及模型常用的 ±30° 繫結區間保持一致。
• 靜止位置：自然放鬆時輸入所處的位置，映射到原生量程的中點，因此即使兩側活動幅度不對稱，放鬆時也能準確置中。只有靜止在量程中點的輸入才提供靜止位置滑桿與數值框：有符號輸入（如頭部角度、眼球視線、控制器搖桿），以及 MouthSmile、VoiceFrequencyPlusMouthSmile。
• 鏡像：在帶有靜止位置的輸入上，讓下限與上限始終以靜止位置為中心對稱；此時拖曳靜止位置會整體平移有效區間。

如果不想手動拖曳，也可以錄製實際幅度：

1. 點擊卡片上的錄製（或工具列上的全部校正）。
2. 從靜止狀態開始：首畫格讀數會設為靜止位置。
3. 向兩端做出最大幅度的表情或動作，下限與上限會自動擴展。
4. 完成後點擊停止。

錄製期間變化幅度不足量程 2% 的輸入將保持原樣。點擊卡片上的重設可清除該輸入的校正；點擊工具列上的重設校正可一次性清除目前模型所有輸入的校正。

校正採用分段線性映射，超出校正下限或上限的輸入會依斜率繼續外推。最終參數輸出是否截斷，由各條繫結自身的限制在範圍內開關決定。

繫結詳細資訊複製錨點連結

點擊輸入卡片下的任意參數列，即可在卡片內直接展開該繫結的完整設定面板。面板頂部顯示輸入及其驅動的參數，兩者均附有原始 ID。

• 變更參數：點擊頂部的參數，即可將這條繫結改接到另一個參數。輸入源、輸入範圍、平滑係數、曲線形狀與自訂名稱均保持不變，僅輸出範圍會依新參數的原生量程更新。若所選參數已由其他繫結驅動，目前的繫結會取代它。
• 移除：移除這條繫結。
• 名稱：為繫結重新命名。按 Esc 可放棄未儲存的重新命名；清空名稱則還原顯示參數自身的名稱。

若繫結的參數 ID 在目前模型中不存在，項目將反白標記為缺失，提示該繫結目前不會生效（常見於切換模型後）。

輸入與權重複製錨點連結

組合輸入清單展示了彙總至該繫結的所有輸入源（點擊新增輸入可疊加更多輸入），每個輸入源均帶有獨立的乘法權重 ×。多路輸入經過加權求和後，再統一送入後續的映射管線。權重數值在輸入框失去焦點時自動確認並同步儲存至磁碟。

若某個輸入在目前影格缺失有效資料，將自動按 0 計算；僅當所有輸入源均無資料時，該繫結才會被暫時跳過。這一機制使得諸如 blink × −0.8 + wide × 0.8 形式的多訊號複合驅動得以穩定運作，公式中的常數偏移量可直接由輸入範圍吸收。

清單中的第一個輸入源決定了該繫結歸屬的主輸入卡片。刪除第一個輸入會自動將其順延歸屬至下一個輸入源名下；當僅剩最後一個輸入源時不可刪除。

平滑複製錨點連結

平滑係數取值範圍為 0–100，支援滑桿調節或直接輸入數值。底層採用隨速度自適應的 1€（One Euro）濾波器，而非固定強度的平滑：快速運動時緊密跟隨、幾乎沒有延遲，靜止時則能有效抑制抖動與雜訊。

將參數繫結至時間輸入（Time24h 或 Time12h）時，系統會自動將平滑係數重設為 0，避免時鐘在正午或午夜回捲時產生倒退回掃。

回應曲線複製錨點連結

每條繫結都有一張統一的二維回應曲線畫布，以繫結的實際單位同時呈現輸入與輸出範圍、三次貝茲傳遞曲線以及即時訊號讀數。橫軸為組合輸入的原生量程，縱軸為目標參數的原生量程。若輸出範圍超出參數本身的量程，超出部分會以陰影標示，因為 Cubism 會在該處截斷參數。畫布上的動態取樣點即時反映目前輸入與輸出在曲線上的映射位置。

範圍複製錨點連結

曲線的首尾兩個端點即是該繫結的輸入與輸出範圍。你可以直接在畫布上沿橫軸（輸入）或縱軸（輸出）自由拖曳首尾端點，也可以在畫布下方的輸入（起點 → 終點）與輸出（起點 → 終點）數值框中直接輸入精確數值。

透過調整輸入範圍可以精準控制表情的靈敏度與觸發臨界值。例如，將 MouthSmile 的 0.2–0.8 映射至 −1..1，當臉部追蹤輸入達到 0.8 時參數即可達到最大輸出。點擊曲線工具列的反轉按鈕（或將輸出起點與終點數值對調）即可快速反轉映射方向。

新建繫結時，預設輸入範圍會自動調整為該輸入源的原生量程，而非固定設為 0..1：例如頭部旋轉角度以度為單位，ARKit 通道為 0..1，其餘輸入依各自量程調整。

畫布下方的限制在範圍內開關（對應 .persona.json 中的 clampOutput）決定輸入超出輸入範圍時的表現：

• 開啟時，輸出停在輸出範圍的兩端。
• 關閉時，沒有塑形曲線的繫結（例如新建的繫結，或已用恢復直線重設的繫結）會線性外推，直至參數本身的物理上下限；用節點或預設塑形過的曲線則保持端點值。

你新增的繫結預設開啟此開關。從 .vtube.json 匯入的繫結沿用 VTube Studio 本身的截斷設定；儲存時省略 clampOutput 的繫結視為關閉。

向量鋼筆手勢複製錨點連結

曲線畫布採用類似向量鋼筆工具的互動邏輯，支援平滑點與尖角節點的精準調節：

• 新增節點：點擊曲線任意位置即可插入新節點。在彎曲的曲線段上，新節點會落在曲線上，曲線形狀保持不變。
• 移動節點：拖曳節點調整位置，節點自身的控制點會隨之一同平移，保持原有進出角度；首尾兩端點可同時在橫軸與縱軸方向移動以直接調整輸入與輸出範圍。
• 調整曲率：拖曳方形控制點調節曲線弧度。在平滑節點上，對側控制點會共線對稱旋轉並保持原有長度，確保曲線兩端平滑連貫。
• 斷開控制點（尖角）：按住 Alt（macOS 上為 Option）拖曳方形控制點，可單獨調整該控制點的角度與長度，從而在節點處折出尖角。
• 切換平滑/尖角：按住 Alt/Option 點擊中間節點，可在尖角與平滑狀態之間快速切換。尖角會將控制點收縮至節點本身；平滑則會朝兩側相鄰節點展開對稱控制點。
• 刪除節點：按右鍵點擊中間節點即可將其移除；曲線始終保留首尾兩個範圍端點。

選取某個中間節點後，可在畫布下方的 X/Y 數值框中以座標軸的實際單位輸入精確座標。相較於滑鼠拖曳，直接輸入數值能更精準地設定平直死區與觸發臨界值。

鏡像、預設與快捷操作複製錨點連結

曲線畫布頂部的工具列提供以下輔助功能：

• 鏡像：以繫結範圍的中心點為基準強制保持點對稱。編輯任意一側的節點、控制點或階躍模式時，對側會自動鏡像更新。範圍置中且曲線對稱的有符號輸入繫結在展開時會自動開啟鏡像。
• 預設：用經典傳遞函數形狀取代目前輸入/輸出端點之間的整條曲線，包括線性、階梯、反向階梯、貝茲、緩入、緩出、S 曲線、臨界值或多級階梯。
• 反轉：一鍵對調輸出範圍的起點與終點。
• 恢復直線：移除所有中間節點，將目前輸入/輸出端點之間的曲線還原為線性直線。

物理演算複製錨點連結

系統會解析模型的 .physics3.json 物理設定檔，並在編輯器中明確標明各參數與物理系統的關聯狀態：

• 驅動物理：物理系統將該參數作為輸入源。為該參數設定追蹤繫結是標準做法，許多模型正是透過將頭部旋轉映射至此類參數來間接驅動頭髮或飾品的物理擺動。
• 物理：物理演算引擎在運作時會直接計算並寫入該參數。若同時為其繫結臉部追蹤驅動，兩者將在運作中產生競爭與衝突，面板中會以紅字顯著預警。

即時數值與手動調整複製錨點連結

在追蹤系統運作期間，輸入卡片上的數值條、參數列縮圖以及展開後的回應曲線取樣點均會即時跟隨追蹤輸入同步變動。

參數列與繫結詳細資訊中還會顯示參數在模型上的最終值，即疊加動作、表情與物理演算之後的結果。若該數值與曲線上的取樣點不一致，表示還有其他動作或物理演算在同時寫入這個參數。

直接在輸入卡片的數值條上拖曳，可將該輸入固定在一個測試值上，無需攝影機即可擺出姿勢、調校回應曲線。放開滑鼠即可交回即時追蹤控制。若編輯器不再維持這個值（視窗被關閉或重新載入，或拖曳未正常放開），它會在約 1 秒後自動失效，模型不會被卡住。

復原與重做複製錨點連結

支援使用快速鍵 Cmd/Ctrl + Z 執行復原，使用 Cmd/Ctrl + Shift + Z 執行重做。

單次拖曳調整記為一步獨立的歷史記錄。輸入校正、曲線修改、範圍調整、權重變動、增刪輸入源以及增刪繫結規則均統一記錄在同一條操作歷史中。該歷史僅作用於參數面板；當焦點位於其他區域時，同一快速鍵會執行全域舞台的復原與重做。

儲存在哪裡複製錨點連結

所有參數繫結與輸入校正變更均會寫入模型同級目錄下的 <model>.persona.json 檔案中，與 記住表情 共用同一個附屬設定檔。自訂參數繫結與輸入校正不會寫回 .vtube.json，因為該格式本身不支援儲存自訂回應曲線、多輸入加權參數與輸入校正。

在 <model>.persona.json 中，繫結清單（bindings）、輸入校正（calibration）與隨機脈衝觸發設定（randomPulses）作為三個相互獨立的頂層欄位分別儲存：

• 繫結設定讀取優先順序：<model>.persona.json 中的 bindings → .vtube.json → 內建預設設定。一旦附屬檔案中儲存了 bindings，Persona 就只使用這份繫結清單，不會與 .vtube.json 合併。此後在 VTube Studio 中所做的映射變更不再影響 Persona 中的該模型，面板頂部也會提示這一點。
• 僅校正或調整脈衝不覆寫繫結：如果你只對繫結來自 .vtube.json 的模型進行了 輸入校正 或修改了 隨機脈衝觸發設定，Persona 只會向 <model>.persona.json 寫入 calibration 或 randomPulses 欄位，不會複製 bindings。模型繼續使用 .vtube.json 中的繫結。

從 .vtube.json 匯入複製錨點連結

首次讀取模型時，Persona 會完整匯入其 .vtube.json 中的 ParameterSettings 清單，包括模型作者為每條繫結設定的自訂名稱。該名稱支援隨時修改並儲存至附屬檔案中；清空自訂名稱則自動退回顯示參數自身的名稱。若 .vtube.json 中某條參數未指定輸入源但開啟了 UseBlinking: true（VTube Studio 中借用自動眨眼觸發隨機動作的做法），匯入時會自動映射為 RandomPulse1，輸出範圍為 [OutputRangeUpper, 0]。

輸入名稱經過三階段解析：優先比對 VTube Studio 官方輸入名稱表，其次比對原始 ARKit 標準 Blendshape 命名，最後相容 VBridger 將 Left/Right 縮寫為 L/R 的命名規範。因此遵循 VBridger 規範繫結的模型均可正確識別，如 EyeSquintL、MouthDimpleR 與 MouthUpperUpL 等均能準確映射，不會遺失項目。

VBridger 特有的幾項複合參數在匯入時不會作為單一輸入處理，而是依據 VBridger 官方預設公式，自動展開為對應基礎輸入的加權求和，正負號與權重配比均與 VBridger 完全一致。