Persona

在圖層清單中選取自訂模型後，可以在模型設定的版本區塊中為模型檔案儲存版本，隨時比較任意兩個版本、單獨還原個別檔案、整體切換回舊版本，或將某個版本匯出為 ZIP。在用 Cubism Editor 重新匯出、調整物理或修改參數繫結前先存一個版本，改壞了也能隨時退回。

版本歷史按模型個別開啟，預設關閉。內建模型 與從素材庫下載的目錄模型由官方發布管理，因此沒有版本區塊。

保留版本複製錨點連結

開啟版本區塊中的保留版本開關後，Persona 會立即儲存第一個版本（清單中顯示為「開始記錄歷史」）。若模型檔案不在本機磁碟上則無法開啟；對於 Persona 無法正常讀取的資料夾（例如 Windows 的 \\server\share UNC 網路共用路徑，或 macOS / Linux 上名稱包含反斜線的資料夾），也會拒絕開啟，避免產生空版本。

關閉開關只會暫停記錄，已儲存的版本仍會保留（區塊中顯示為已保留的歷史紀錄）；重新開啟後，期間的改動會顯示為 未儲存的變更。

歷史紀錄一列會顯示已佔用的磁碟空間，選單中提供顯示歷史紀錄資料夾與刪除歷史紀錄…。選擇後者會將該模型的全部歷史版本移至垃圾桶（Windows 為資源回收筒）並關閉版本歷史，模型本身的檔案不受影響。

版本包含哪些檔案複製錨點連結

版本只收錄模型資料夾內的一般模型檔案。放在匯出檔案旁的 PSD、.cmo3 等專案原始檔不屬於模型，指向資料夾外部的路徑參照與符號連結也不會納入。每個版本都會儲存完整檔案（包括 moc3 與貼圖），即使重新匯出出錯也能完整退回；未改動的檔案會在版本間共用儲存空間，不會重複佔用容量。

儲存版本複製錨點連結

版本僅在手動操作時儲存，不會定時或自動觸發。當磁碟上的檔案與目前版本不一致時，區塊中會出現未儲存的變更一列，點擊儲存版本…即可儲存。對話框會自動預填名稱（如「版本 3」），備註為選填；同一模型下的版本名稱不能重複（不區分大小寫）。

未儲存的變更複製錨點連結

未儲存的變更會顯示目前有多少個檔案與已儲存版本不同。點擊標題或在選單中選擇顯示變更…可查看具體差異；選擇捨棄變更…會將檔案恢復為目前版本並重新載入模型，此操作無法復原。

• 在 Persona 內所做的修改（如 參數繫結、快速鍵、模型整體移動、表情編輯器、錄製或編輯的動作 等）會立即計入未儲存變更。
• 在 VTube Studio、文字編輯器或 Cubism Editor 等外部工具中修改檔案後，切回 Persona 的任意視窗時即會重新偵測。
• 開關表情不會計為檔案變更。觸發表情快速鍵雖然會更新 .vtube.json 或 .persona.json 中記錄目前啟用表情的欄位，但版本歷史會自動忽略這部分變化；切換版本或還原檔案時，目前開啟的表情狀態也會保持不變。

版本清單複製錨點連結

版本按日期分組（「今天」「昨天」或具體日期），由新到舊排列，每次載入 50 個，點擊顯示更早的版本可繼續查看。

• 未命名的版本會根據儲存方式顯示為「開始記錄歷史」「已儲存的版本」或「未儲存變更的備份」；由其他 Git 工具建立的提交則直接顯示提交訊息。
• 已命名的版本會以粗體顯示並附帶書籤圖示，備註顯示在標題下方。
• 目前徽章表示目前磁碟檔案所基於的版本，即使檔案之後做過修改，該標記也不會改變。

每個版本的選單提供顯示變更…、與磁碟上的檔案比較…、切換到此版本…、為此版本命名…（已命名時為重新命名…與移除名稱）以及匯出為 ZIP…。

Persona 不會覆寫、壓縮或單獨刪除某個歷史版本，也不會改寫提交歷史；如需清理空間，可透過刪除歷史紀錄…將整份歷史紀錄一併移除。

比較版本複製錨點連結

點擊清單中的版本（或選擇顯示變更…）會開啟比較版本對話框，展示該版本相對於上一版本的改動。透過從與到下拉選單可以任選兩個版本，或選擇磁碟上的檔案進行比較。

• 左側檔案樹會列出有差異的檔案，並標示新增、變更或刪除；開啟顯示未變更的檔案可一併顯示其餘檔案。拖曳檔案樹右側邊緣可調整欄寬。
• 文字檔支援以合併或分欄檢視展示逐詞差異（最大 4 MiB）；圖片支援並排或滑動比較（最大 32 MiB）；其他格式及超出大小上限的檔案僅比較檔案大小。
• 若設定檔僅在目前開啟的表情狀態上有差異，會視為未變更。

還原檔案複製錨點連結

當比較的其中一側為磁碟上的檔案時，勾選檔案並點擊還原所選檔案…，即可將這些檔案恢復為另一側版本的內容，並立即重新載入模型。還原後的檔案在正式儲存前仍屬於未儲存變更，因此臨時換回舊版物理檔案測試效果時，不會額外產生新版本。若所選檔案本身包含未儲存的變更，Persona 會先詢問要儲存還是不儲存。

切換版本複製錨點連結

切換到此版本…會將模型的全部檔案替換為該版本的內容並重新載入模型。若目前存在未儲存的變更，Persona 會先提示確認：

切換版本不會產生新的歷史項目，目標版本會直接變為目前版本，因此來回切換比較不會讓版本清單變長。

• 目標版本中不存在的多餘檔案會移至垃圾桶，不會直接永久刪除；若無法移至垃圾桶，切換會直接中止，不會改動任何檔案。
• 只要有任一檔案無法寫入（例如被設為唯讀），整個切換操作都會取消，所有檔案保持原樣。
• 同一資料夾下由其他已加入模型載入的檔案不會被移除。

匯出為 ZIP複製錨點連結

匯出為 ZIP…會將指定版本的檔案打包到以模型命名的資料夾中，檔案修改時間設為該版本的儲存時間。匯出的壓縮檔僅包含模型檔案，不包含歷史紀錄。模型資料夾內的目錄連結不會保留；如果模型透過目錄連結載入貼圖，解壓縮後需要重新建立連結。

歷史紀錄存放位置複製錨點連結

每個模型的歷史紀錄都存放在 設定資料夾 下的 history/<模型 ID>/ 中，不會在模型資料夾裡建立 .git 資料夾。無論你是將模型打包交給客戶、放在雲端硬碟同步資料夾中，還是模型資料夾本身就在你自己的 Git 存放庫裡，都不會受到干擾。

歷史紀錄採用標準 Git 存放庫格式，由 Persona 內建的 Git 實作直接讀寫，不需要安裝 Git，也可以隨時用任意 Git 工具查看：

git --git-dir ~/.laplace/persona/history/<模型 ID> log

• Persona 不會執行推送、擷取或複製，也不會發起任何網路請求。你可以自行使用 Git 將存放庫推送到遠端；由於歷史紀錄從不改寫，推送出去的提交始終可以安全保留。
• 提交作者固定為 LAPLACE Persona（電子郵件為空），不會讀取系統帳號名稱，避免在提交紀錄中暴露真實姓名。如需修改，可在該存放庫的 Git 設定中單獨設定 user.name。
• 已命名的版本以附註標籤（annotated tag）形式儲存，可在各類 Git 工具中直接作為標籤查看。
• 如果其他 Git 工具讓存放庫停留在未完成的操作狀態（例如存在已暫存檔案、合併或重定基底尚未結束、處於未簽出分支狀態），Persona 會給出警告，並暫停儲存與切換操作，直到你在外部 Git 工具中完成或復原該操作。

移動或重新加入模型複製錨點連結

• 模型資料夾移動位置後，點擊重新定位…重新指定路徑，原有的版本歷史會自動保留。
• 透過從素材庫中移除將模型移出 素材庫 後，如果再次匯入同一資料夾下的同一個模型，雖然會分配新的模型 ID，但在開啟保留版本時，Persona 會自動找回並接管先前的歷史紀錄，不會從頭建立。

外掛 API 與 MCP複製錨點連結

透過 外掛 API 可以開啟或關閉版本歷史，執行版本清單查詢、儲存、命名、比較、切換及單一檔案還原，並可在歷史紀錄變更時接收事件通知。與介面操作一致，當切換版本或還原檔案會覆寫未儲存變更時，呼叫端必須明確指定是先儲存還是直接捨棄。MCP 伺服器 提供了 list_versions、save_version 與 switch_version 工具：AI 助理在修改模型前可以先儲存一個版本，切換版本前若遇到未儲存的變更會先向你確認處理方式；但版本歷史只能由你在介面中手動開啟，AI 助理無法代為開啟。