備份與恢複
作為一個本地優先（local-first）的 AI 客户端，Tavern Studio 最大的特色之一是把所有的决定權與隱私數據都保留在您的個人电脑硬盘中。然而，這也意味着我们没有集中的雲端后台来托管您的數據。一旦您的电脑發生系统崩溃、硬盘物理损坏，或者您卸載了软件而未保留應用目錄，您积累的角色卡、世界書以及聊天歷史記錄都将面临丢失风险。
因此，学会如何定期備份以及如何安全地恢複數據，是每位 Tavern Studio 用户的必修课。本篇文档将為您提供數據備份與跨設備遷移指南。
适合誰阅读
- 准備重装电脑系统、更換新电脑，需要将數據遷移的用户。
- 积累了大量角色卡和長篇對話分支記錄，想要保护資產安全的人群。
- 遇到了“恢複備份提示檔案冲突”或“还原后角色卡不顯示”的故障排查者。
你将学会什么
- Tavern Studio 的本機資料存储逻輯及備份所包含的內容。
- 匯出本地備份包（ZIP）的具体操作步骤。
- 恢複備份时的覆盖风险與覆盖方向确认。
- 跨电脑（換設備）遷移角色和對話記錄。
- 排查并修複備份还原失败等异常情况。
備份包含了什么？
當您在 Tavern Studio 中执行“匯出完整備份”时，客户端会在底层将以下保存在本機資料庫和應用目錄中的數據进行打包：
- 角色卡庫：所有的角色卡（包含人設與您修改过的头像立绘）。
- 對話歷史：與每一個角色卡產生过的聊天記錄、候選 Swipes 列表以及平行故事分支树（Branching）。
- 世界書庫：您创建或綁定的所有 World Book 設定包及全部詳細词條。
- 參數預設：您調校的全部生成采樣預設（Preset）和自定義 System Prompt。
- 全局系统配置：您的界面配置、语言选項，以及本地加密存储的 API Key 連接配置（為了安全性，API Key 会以本地机器私钥加密，跨电脑恢複后可能需要重新校验）。
匯出完整備份（Export Backup）
我们建议您在每次软件重大版本更新前，或者定期（如每周）进行一次手動備份：
- 點击螢幕底部 TabBar 最右侧的 Settings（設置） 按钮。如果处于輸入態，可以使用觸摸板双指滑動切換过去。
- 頁面下滑，找到 Data Management（資料管理與维护） 板块。
- 點击 Export Full Backup（匯出完整備份） 按钮。
- 客户端会在后台进行資產打包，并在几秒钟后彈窗提示您选擇保存路径。
- 选擇一個安全的本地盘檔案夹（或选擇保存至您的同步盘如 iCloud、OneDrive 等雲服务檔案夹中）。
- 系统会生成一個類似于
tavern_studio_backup_2026_06_12.zip的压缩包。這就是您的數據快照。
恢複備份與防覆盖警告
恢複具体步骤：
- 进入 Settings（設置） 頁面的 Data Management 选項卡。
- 點击 Import & Restore Backup（匯入并恢複備份） 按钮。
- 在彈出的檔案选擇器中，选中您之前保存的
.zip格式備份包。 - 客户端会彈窗提示覆盖风险，請勾选“我已确认并同意覆盖本機資料”複选框。
- 點击确认。客户端会在后台解压、写入數據庫、重新加載本地資源，并自動重啟或刷新相關的數據。
- 界面重新加載完成后，即可在角色瀑布流列表與世界書列表中看到恢複出来的資產。
換电脑跨設備遷移
當您购买了新电脑，想要将工作流平移时，請按照以下流程操作：
- 在舊电脑上：打開 Tavern Studio，通过設置匯出
.zip備份檔案，并拷贝至新电脑上。 - 在新电脑上：下載并安装對應系统平台的全新 Tavern Studio 客户端。
- 初始化恢複：在新电脑上双击运行客户端，在初始化界面或者直接通过底部的 Settings - Data Management 选項卡，點击恢複刚才的
.zip備份包。 - 設備重綁 API Key：恢複完成后，請前往設置的 API 板块，重新检查您的雲端 API 連接。由于新設備的安全特征可能改變，您需要在此重新验证或填写一次 API Key，确保螢幕底部的連接状態球變為绿色。
常见问题與恢複排查
Q1：為什么匯入備份包时，进度條卡在 50% 并不動，然后报错 "Decompression failed"？
這通常是由于備份包 ZIP 檔案本身损坏或在傳輸过程中被截断造成的。
- 解决办法：請检查備份 ZIP 檔案的物理大小，确认其是否與原檔案一致。如果确认损坏，請重新在原設備上重新生成一份備份包并拷贝。
Q2：我能只恢複某一個角色的聊天歷史，而不覆盖我的整個软件數據吗？
可以。您可以通过“聊天級别匯出”来避開全局覆盖。在特定角色的 Chat 窗口中，點击上方状態欄右侧的對話控制菜單，选擇 Export Chat（匯出聊天記錄） 将單次對話匯出為 JSON。在新电脑上匯入該角色卡后，在此 Chat 界面中选擇 Import Chat（匯入聊天記錄） 读入該 JSON 即可，這不会對其他角色和全局設置產生覆盖破坏。
Q3：恢複數據后，為什么很多角色的头像立绘都變成了灰色或空白？
Tavern Studio 在備份时会包含角色卡圖片的資產块。如果發生头像不顯示，這通常说明在您之前備份时，由于本地磁盘读取權限问题，客户端未能成功将角色卡头像的圖片写入備份包的临时目錄。您可以尝試将原始角色卡 PNG 直接拖回窗口內重新上传头像。