OneDrive / iCloud Drive 同步
原理
OneDrive 和 iCloud Drive 的同步方式和 Git/S3/WebDAV 完全不同——它利用这些云盘服务自带的文件夹同步能力。配置后，你把 NoteGen 的工作区直接放在 OneDrive/iCloud 的同步文件夹里，云盘负责把文件同步到各设备。
这不是 NoteGen 自己在同步，而是你让 NoteGen 的数据落在云盘同步范围内。
OneDrive 配置
桌面端（Windows/macOS/Linux）
- 确保 OneDrive 客户端已安装并登录
- 让 NoteGen 的工作区指向 OneDrive 同步文件夹内的某个子目录
- 比如 Windows：
C:\Users\<你>\OneDrive\NoteGen - 切换工作区后，NoteGen 的所有 .md 文件会自动被 OneDrive 同步
优势
- 配置最简单——只需要选对工作区位置
- OneDrive 自带版本历史（文件右键 → 版本历史）
- 移动端访问方便（OneDrive 官方 App）
注意
- OneDrive 同步是文件级别的，可能有秒级延迟
- 同时在多台设备编辑同一个文件可能产生 OneDrive 版本冲突（不常见，但注意）
- 工作区路径不能太深或包含特殊字符
iCloud Drive 配置
macOS 桌面端
和 OneDrive 类似——让 NoteGen 工作区指向 iCloud Drive 同步文件夹：
~/Library/Mobile Documents/com~apple~CloudDocs/NoteGen/- 或者 Finder 里 iCloud Drive 下手动建文件夹
iOS 端：迁移到 NoteGen 的 iCloud 容器
iOS 上有一个更优雅的方式——把工作区迁移到 NoteGen 自己的 iCloud Drive 容器：
- iOS NoteGen 设置 → 同步配置 → 选择 iCloud Drive
- 按提示执行迁移
- NoteGen 会把当前工作区复制到 iCloud Drive 的 NoteGen 容器
- 之后 Markdown 文件由 Apple iCloud 在设备间自动同步
为什么这比手动放 iCloud Drive 好
- 不需要你手动管理文件夹路径
- NoteGen 的数据和你其他 iCloud 文件夹隔离
- 容器删除会连同数据一起清理，方便彻底移除
iCloud Drive 同步注意
- 使用 iCloud Drive 前需要登录 Apple 账户并开启 iCloud Drive
- NoteGen 不会获得 Apple 账户密码，也不会通过 NoteGen 服务器中转 iCloud 文件
- iCloud 中的数据由你的 Apple 账户管理，可以在"文件"App 中查看和删除
- 遵循 Apple 的 iCloud 条款和隐私政策
云盘 vs Git 同步
| 维度 | 云盘（OneDrive/iCloud） | Git |
|---|---|---|
| 配置难度 | 最简单（选文件夹就行） | 需要 Git 账户和 Token |
| 版本历史 | 云盘自带 | 每次同步一个 commit |
| 冲突处理 | 云盘版本冲突 | Git merge |
| 结构化数据 | 只同步工作区文件 | 同步记录/标签/画布等 |
| 移动端 | 访问方便 | 需要 Git 客户端 |
| 免费额度 | OneDrive/iCloud 有 | GitHub/Gitee 无限制 |
何时用云盘
- 不想折腾 Git，就想用云盘文件夹
- 主要需求是"多设备能看到同样的 .md 文件"
- 移动端访问多、桌面端操作少
如果需要同步结构化数据（记录、标签、画布），云盘方式覆盖不到——这些数据需要 Git/S3/WebDAV 方式同步。