备份与恢复
作为一个本地优先（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 直接拖回窗口内重新上传头像。