Cherry Studio 备份与数据恢复实操：换电脑、重装系统前该做什么

Cherry Studio 备份与数据恢复实操：换电脑、重装系统前该做什么

【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio

新电脑装好 Cherry Studio，打开一看，几百条对话记录没了；或者系统重装完，连之前调好的偏好设置都找不回来。这类场景里，平时有没有做过 Cherry Studio 备份、备份放在哪里，直接决定了数据能不能找回。本文按"数据存在哪 → 备份放哪 → 手动和自动备份怎么做 → 恢复与迁移 → 日常维护与排障"的顺序讲一遍，读完后你能独立完成一次 Cherry Studio 数据恢复，也知道自动备份该怎么配。

📍 打开数据设置，先看数据存在哪

Cherry Studio 的本地数据分散在三处，备份时会一起打包：

• IndexedDB 数据库：所有对话历史、消息正文都写在这里，是最怕丢的部分；
• Local Storage：你的偏好设置、界面和模型相关配置存在这里；
• Data 目录：应用配置、插件等文件。

打包和恢复的实际逻辑在 LegacyBackupManager.ts 里，自动备份的调度则交给 AutoBackupService.ts。另外有一个容易忽略的细节：应用启动时会检查恢复标记文件。如果上次恢复因重启或断电没跑完，这次启动会把未完成的恢复步骤接着做完，而不是要求你手动处理。

🗂 备份放哪，按你的设备情况挑

四种落地方式（本地、WebDAV、S3、坚果云）不建议逐个研究，按使用场景对号入座就行：

• 只用一台电脑：选本地备份。指定一个外部目录即可，配置最少，注意别把目录指到应用自己的数据目录里；
• 多台设备要同步：选 WebDAV 或坚果云。WebDAV 适合有自建服务器或已有网盘 WebDAV 端点的用户，坚果云则免去搭服务器的步骤，直接授权即可用，两者配置里都有同步间隔、保留数量和跳过备份文件等选项；
• 团队或企业统一存储：选 S3。支持 Amazon S3 及兼容协议的对象存储，填 endpoint、region、bucket 和密钥即可，方便集中管理和统一保留策略。

四种方式都在设置 → 数据里配置，对应页面见 DataSettings.tsx。

🖱 手动备份一次，再打开自动备份

手动备份：进入设置 → 数据 → 本地备份，指定目录后点击备份按钮，可以自定义备份文件名，生成一个压缩好的备份包。云端三种方式（WebDAV、S3、坚果云）在各自页面上也有手动同步入口。

自动备份在 LocalBackupSettings.tsx 及对应云备份页面里配置，核心是三个参数：

• 同步间隔：以分钟为单位，设为 0 表示关闭自动同步；
• 最大保留数量：保留最新 N 份，超出的旧备份会被自动清理；
• 是否跳过备份文件本身：适合备份目录和数据来源目录有重叠的情况。

本地目录有两点校验要注意：目录必须在应用数据目录和安装目录之外，且需要写权限。云端方式在 AutoBackupService.ts 中按各自的间隔独立调度，某一次失败会按指数退避重试，连续失败后界面会给出通知。

🔁 从备份恢复数据，顺便完成换电脑迁移

恢复步骤：设置 → 数据，在对应备份方式下选择备份文件并执行恢复。恢复前引擎会做两类校验：一是版本兼容性检查，确认备份包记录的版本和当前应用匹配；二是完整性校验，包括压缩包安全断言（zipSafety.ts），避免异常内容被解压到数据目录。

换电脑迁移 Cherry Studio 数据：旧机器先做一次云端备份（WebDAV/S3/坚果云），新设备装好应用后，在对应页面选"从备份恢复"，选到那个备份包，恢复完成后所有对话和配置都会回来。如果上次恢复被打断，启动时的恢复标记机制会自动续跑。

备份包自带一段元数据，恢复时主要看这里的版本信息：

{ "version": 6, "timestamp": 1678888888888, "appName": "Cherry Studio", "appVersion": "2.0.0", "platform": "darwin", "arch": "arm64" }

🧹 管理备份列表，处理备份失败与恢复不一致

备份列表管理：本地备份的列表由 LocalBackupManager.tsx 提供，可以看每份备份的文件名、大小和修改时间，按时间排序，多选后批量删除旧备份。云端的 WebdavBackupManager.tsx 和 S3BackupManager.tsx 提供同样的查看与删除能力。配合最大保留数量，系统会自动清理过期备份，避免占满磁盘。

常见问题的排查顺序：

• 备份失败：本地方式依次查磁盘空间、目录写权限、目录是否位于应用目录内；云端方式查网络连通性和账号权限。失败原因会写入日志，也可以在设置页的同步状态里看到最近一次错误信息；
• 自动备份反复失败：它最多重试 4 次，最终失败会弹通知，先手动备份一次确认参数没问题，再调大同步间隔观察；
• 恢复后数据不一致：核对备份包元数据里的 appVersion，尽量用相同或更新的应用版本做恢复；跨平台（如 macOS 到 Windows）恢复时留意平台差异；
• 迁移后 API Key 等凭证需要重新填写，属于预期行为，恢复不会替你处理登录态。

最后两句话：把自动备份间隔和保留数量先配上，再隔段时间亲手做一次"备份 → 恢复"演练，比出事后补救有用得多。后续版本还规划了增量备份、端到端加密和跨平台同步，这些能力落地后，上面这套流程会进一步简化。

【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio