备份与同步

推荐方式

• Git — 多设备 / 完整历史 / 团队 best fit
• iCloud / OneDrive — 单人多设备最简单
• Dropbox / Syncthing — 跨平台、无云依赖（Syncthing）
• 冷备份：rclone 推到 S3 / B2 / R2 对象存储
• Time Machine / 文件历史 — 任何方案的基础底盘

Git 同步实践

Git 是写作 Vault 最强的搭档 — 完整历史、可 diff、可 blame、可分支。建议把 Vault 设成一个 Git 仓库，用前面 secure-api-key 推荐的 .gitignore，远端推到自己的 GitHub 私库或 self-host 的 Gitea / Gogs。

常见做法：写完一段就 git add -p 然后 commit，每天 push 一次。这样既有原子的 commit 历史，又不会让远端拖后腿。

• .kition/secrets/ 和 .kition/cache/ 一定要在 .gitignore
• 提交前关掉 Vault — 避免索引和锁文件混进 diff
• 大附件（视频、PDF）建议 Git LFS 或干脆不进 Git
• 多人协作：用分支 + PR，冲突主要在表 schema 上需要手动 merge

# Inside the vault folder
git init
git remote add origin [email protected]:you/my-vault.git

# Track everything except the .gitignore entries above
git add .gitignore Notes Projects Tables Resources
git commit -m "Initial vault"
git push -u origin main

云盘同步 — 选一个

iCloud Drive / OneDrive / Dropbox 都可以把 Vault 在多设备间同步。它们都是"folder-level"的同步，对 Markdown 和 .kitable 文件完全没问题。但 .kition/ 里的索引是热文件 — 同步它意味着 99% 时间在传输无效的 delta。

解决办法是：让云盘同步整个 Vault，但排除 .kition/index/ 和 .kition/cache/。索引会在每台设备上自动重建。

• iCloud Drive：关闭 "Optimize Mac Storage"，避免文件被驱逐
• OneDrive：把 Vault 目录设成 "Always keep on this device"
• Dropbox：Selective Sync 排除 .kition/index/
• Syncthing：完全本地、无第三方，但要自己开端口

冷备份 + rclone

热备份（云盘 / Git）解决"日常找回最近版本"。冷备份解决"账户被锁了 / 整个 GitHub 仓库被误删"。建议每周一次 rclone 推到对象存储 — S3 / Backblaze B2 / Cloudflare R2 都行，B2 / R2 价格便宜得几乎可以忽略。

# Weekly snapshot, run from cron / launchd / Task Scheduler
DATE=$(date +%Y-%m-%d)
rclone copy ~/Documents/Kition r2:vault-backups/$DATE \
  --exclude ".kition/cache/**" \
  --exclude ".kition/index/**" \
  --progress

注意

不要把两份云盘同时挂在同一个 Vault — 容易出冲突文件（document (conflict).md、document (computer-name).md）。选一种主同步方案，其它的作为单向冷备份。Time Machine / Windows 文件历史是任何方案的兜底 — 它们捕捉最近 30 天的瞬时状态，恢复速度比从云端拉回来快得多。

验证你的备份

没验证过的备份不算备份。每个季度做一次恢复演练 — 在一台干净的虚拟机或者别的目录恢复一份 Vault，用 Kition 打开，确认能正常加载文档、表、Agent 历史。

• Markdown 文件能正常打开和渲染
• .kitable 表能查询、计数与字段统计一致（kition table check）
• Agent 历史可以回放
• Provider 配置正确（API Key 需要重新填，Keychain 不跨机器）