企业官网建设流程全解析

AI Toolbox 数据备份是这款跨平台（Windows / macOS / Linux）AI 编程助手管理工具内置的数据安全核心能力。它把 SQLite 主数据库、各 CLI 工具的运行时配置、Prompt、Skills 与图片资产统一打包成一个加密或不加密的 zip 文件，并支持本地文件夹、WebDAV 网盘、GitHub / Gitee 仓库三种存储渠道，配合可选的AES-256 加密与自动备份调度，让你换机、误删、重装系统后都能一键找回全部配置。本文面向新手，手把手讲清每一种方案怎么选、怎么配、怎么恢复。

一、AI Toolbox 数据备份到底备份了什么？

很多人以为"备份 = 备份数据库"，这是最大的误区。AI Toolbox 的备份包是一个完整的配置快照，一次打包就包含：

也就是说，恢复后不会出现"数据库里有记录、但本机配置文件缺失"的错位状态——这正是备份比"只导数据库"更可靠的地方。

在"备份范围"里，你可以精细控制打包内容：

• 备份生图图片：是否把图片资产文件写进备份包（体积较大的取舍项）。
• 备份 DB 型 CLI 运行时文件：控制 Codex、Claude、Grok、Gemini、Kimi、ZCode 等工具的本机运行时文件是否进包。关闭后这些文件不打包、不覆盖本机，但其渠道与提示词仍能从数据库重新应用；而 OpenCode、OpenClaw、Pi 等以运行时文件为主数据的工具始终随备份迁移。
• 自定义备份项：把额外的本地文件/目录加入备份，支持指定恢复路径，也支持用正则表达式排除不想要的子目录。
• 文件过滤规则：按"工具 + 路径"排除个别敏感文件（如某个auth.json），备份时排除 = 恢复时跳过，规则一致生效。

这些规则背后的打包与过滤逻辑集中在 tauri/src/settings/backup/generate.rs 与 tauri/src/settings/backup/AGENTS.md 中，可作为进阶阅读。

二、数据备份入口在哪里？一键备份与恢复

进入设置 → 通用设置 → 网络与备份卡片，即可看到"数据备份"区域。它直接展示了当前的存储位置、服务器地址、用户名、上次备份时间，并提供三个核心操作：

• 立即备份：按当前选定的存储渠道，立刻生成并保存一份备份。
• 恢复备份：从本地或远端选择一份备份文件恢复。
• 打开数据目录：直接定位到应用数据存放位置。
• 右上角编辑：打开完整的备份设置弹窗（web/features/settings/components/BackupSettingsModal.tsx），配置存储渠道、加密、范围与自动备份。

整个"立即备份 / 恢复备份"按钮的交互入口在 web/features/settings/pages/GeneralSettingsPage.tsx 中实现。

三、三种存储渠道：如何为 AI Toolbox 选择备份方案

三种渠道共用同一条生成与恢复管线——无论存到哪，备份包结构、加密格式、恢复语义完全一致。区别只是"存到哪里"。

1. 本地备份：最稳妥的起点

最易上手的方案：选择一个本地文件夹（可用"浏览"选择目录），点击"立即备份"即可。

• 文件先写入.part临时文件再重命名，任何失败都不会留下一个看起来完整的损坏备份。
• 适合：单设备用户、有外部硬盘 / 网盘本地挂载目录的用户，或想先建立"备份习惯"的新手。
• 实现入口见 tauri/src/settings/backup/local.rs。

2. WebDAV 网盘备份：把数据同步到自有网盘

如果你自建有 Nextcloud、群晖、AList / OpenList 等支持 WebDAV 的网盘，可把备份直接上传到云端，实现异地备份。

配置项包括：服务器 URL、用户名、密码、远程路径（如/backup）、以及可选的"主机标签"（用于在多台设备间区分备份来源）。保存前可先点击测试连接，确认认证与目录可写后再启用。

• 适合：已有自有网盘、希望备份远离本机磁盘的用户。
• 注意：个别网盘的"下载重定向"策略可能导致恢复时下载受限（列目录、上传正常，唯独下载 403），这属于服务端下载策略问题，非账号密码错误。
• 实现入口见 tauri/src/settings/backup/webdav.rs。

3. GitHub / Gitee 仓库备份：用代码仓库做版本化保险箱

这是最"极客"也最可靠的方案：把每次备份作为独立文件提交到 GitHub 或 Gitee 的私有仓库中，天然获得版本化、可追溯、多设备共享的能力。

• 需填写：平台（GitHub / Gitee）、Owner、仓库名、分支、目录（留空表示仓库根目录）。
• Token 只写不显：保存后界面只提示"已保存 Token"，不会回显内容；跨平台切换时要求重新输入。
• 私有仓库强制校验：每次真实写入前都会先校验仓库确为私有，避免备份意外公开。
• 每次备份生成唯一文件名（含时间戳与随机标识），多设备同秒备份也不会互相覆盖。
• 适合：开发者、多设备用户、希望备份可审计可回溯的用户。
• 实现入口见 tauri/src/settings/backup/repository.rs。

四、可选的 AES-256 备份加密：给敏感配置上锁

备份里可能包含 API Key、OAuth 凭据等敏感信息。AI Toolbox 提供统一作用于所有渠道的备份加密开关：

• 采用AES-256-GCM算法，配合随机 salt 与 nonce，每次加密都使用新的密钥参数。
• 加密密码保存在本机系统凭据库（Windows 凭据管理器 / macOS 钥匙串 / Linux 密钥服务），不进入备份包、日志或前端。
• 加密开启但系统读不到密码时，备份会整体失败而绝不降级为明文上传，安全优先。
• 关闭加密不会重写旧备份，旧文件仍用其创建时的状态。

这样设计既保证了自动备份在重启后仍能读到密码自动执行，又确保密码本身不会随着备份文件被带走。加密实现见 tauri/src/settings/backup/encryption.rs。

五、自动备份：设置一次，后台定期执行

开启自动备份后，你会设置两个参数：

• 备份间隔（天）：每隔多少天自动备份一次，最少 1 天。
• 最大保留数量（个）：远端最多保留几份历史备份，超出自动清理最旧的；设为 0 表示不限制保留数量。

自动备份由一个常驻后台调度器驱动，周期性读取你的设置决定是否执行；成功上传后才会触发保留数量清理。设置页底部会实时显示"自动备份已启用 | 间隔：X 天 | 上次自动备份：时间"，让你随时确认它正在工作。实现见 tauri/src/settings/backup/auto_backup.rs。

六、恢复备份：换机、误删后的数据找回

当需要迁移或找回数据时：

1. 在"数据备份"卡片点击恢复备份，选择本地文件，或从 WebDAV / 仓库列表中选择一份远端备份（列表支持按主机标签筛选、查看加密标识、删除旧备份，见 web/features/settings/components/RemoteBackupRestoreModal.tsx）。
2. 加密备份会先校验密码：若本机凭据库没有密码，界面会弹出一次性输入框，密码仅用于本次解密、不会保存。密码错误会在任何数据写入之前就报错，保证零损坏。
3. 跨设备恢复时，可勾选"不恢复各 CLI 自定义根目录"，用本机默认路径替代备份里的旧路径，避免跨机残留无效目录。
4. 恢复完成后，应用会按需重新应用已启用的渠道与提示词，并重新同步 Skills / MCP，让"库里有记录、文件也在"。

恢复的核心流程（原地覆盖数据库前会先取一份安全快照，失败可回滚）见 tauri/src/settings/backup/restore.rs。

七、备份方案速查清单

八、相关源码与文档路径

想深入了解或二次开发，可从以下入口入手：

• 模块总览与数据源说明：tauri/src/settings/backup/AGENTS.md
• 备份生成管线：tauri/src/settings/backup/generate.rs
• 本地 / WebDAV / 仓库三渠道：tauri/src/settings/backup/mod.rs
• 加密与凭据：tauri/src/settings/backup/encryption.rs
• 自动备份调度：tauri/src/settings/backup/auto_backup.rs
• 备份设置界面：web/features/settings/components/BackupSettingsModal.tsx
• 产品功能总览：README.zh-CN.md

小结：先从一个本地备份建立习惯，再按需叠加WebDAV / 仓库做异地与版本化，最后开启加密与自动备份，就构成了一套完整、可靠又几乎不用操心的 AI Toolbox 数据备份方案。