iCloud 同步具体同步哪些数据 不同步哪些
同步数据完整清单
以下数据通过 iCloud 自动双向同步：
✅ 会同步的
| 数据项 | 说明 |
|---|---|
| 文件源列表 | 你添加的所有云盘/SMB/NAS/影视服务器连接配置 |
| 文件源启用状态 | 哪些文件源当前是启用/禁用状态 |
| 媒体库分类 | 电影/电视剧/其他的分类和刮削数据 |
| 海报和剧照 | 从 TMDB 下载的影片封面图片 |
| 影片简介和演员 | TMDB 的文字信息 |
| 观看进度 | 每部视频看到了多少、上次停止的时间点 |
| 已观看标记 | 电影/电视剧的已观看/未观看状态 |
| 继续观看 | 继续观看类目里的视频列表 |
| 播放列表 | 所有自定义播放列表及其包含的影片 |
| 收藏夹 | 所有收藏的影片 |
| 影视服务器 | Plex/Emby/Jellyfin 等连接配置 |
❌ 不会同步的
| 数据项 | 原因 |
|---|---|
| 视频文件本身 | 视频文件存在各自的存储位置（本地/云盘/NAS），不复制到 iCloud |
| 本地下载的离线视频 | 只存在下载它的那个设备上 |
| 截图和 GIF | 保存在设备相册，不通过 iCloud 同步（除非你打开了相册 iCloud 同步） |
| VIP 状态 | VIP 通过 App Store 内购记录识别，不是 VidHub 数据 |
| 个人设置（部分） | 播放设置、外观、快捷键等偏好通常不同步 |
典型同步场景
场景一：iPhone 添加文件源 → Mac 自动出现
- iPhone VidHub 添加了阿里云盘和群晖 SMB 两个文件源
- iCloud 同步 → 几秒钟后 Mac VidHub 的文件源也多出这两个
- Mac 上点击进入这两个文件源 → 已经刮削好的海报墙直接展示
场景二：Mac 标记已观看 → iPhone 同步
- Mac 上看完了《星际穿越》，点击标记已观看
- iPhone 打开 VidHub → 媒体库中这部电影已经从"继续观看"移到"已观看"
- 同时 Mac 上看到的 iPhone 的下一集电视剧进度也同步过来
场景三：iPad 创建播放列表 → iPhone 可以使用
- iPad 上创建了"科幻片"播放列表，加入了 10 部电影
- iPhone VidHub 里自动出现这个播放列表和那 10 部电影
- 可以在任何设备上编辑播放列表，下次打开另一台设备时同步
文件源同步的特别说明
云盘类（阿里云盘/百度网盘等）
云盘 OAuth 授权令牌会同步到所有设备——一次授权，全端可用。不需要每台设备都重新走 OAuth 流程。
但如果云盘令牌过期需要重新授权，在任意一台设备上重新授权后，其他设备会自动刷新。
SMB/WebDAV/NAS 类
连接配置（IP、端口、用户名、密码）会同步。但要注意：
- 如果 NAS 在家庭局域网，手机用 4G 网络时可能连不上——这是网络环境问题，不是同步问题
- 内网 IP 和公网域名：文件源里存的是你当时填写的地址，如果填的是内网 IP（如
192.168.1.100），只有在同一局域网才能访问
影视服务器类（Emby/Jellyfin）
服务器地址、端口、用户名、密码会同步。全设备共享同一套影视服务器连接。
媒体库数据的意义
媒体库刮削数据同步带来的最大好处是：
- 不需要每个设备都重新刮削 — 一次刮削全端享用
- 海报墙完全一致 — iPhone/Mac/Apple TV 上看到的是一模一样的海报墙
- 节省时间和流量 — 刮削过程需要下载大量图片和数据，全端同步避免重复下载
为什么不同步视频文件
- 视频文件通常很大（GB 级别），iCloud 云盘不适合作为视频存储
- 视频应该存在云盘、NAS、本地存储等专门的位置
- iCloud 在这里只同步元数据（文件在哪、叫什么、是什么电影），不同步文件本身
同步与 iCloud 空间
媒体库元数据和海报占用的空间大小：
- 100 部电影的刮削数据 + 海报 → 约 50-200MB
- 1000 部电影 → 约 500MB-2GB
建议 iCloud 至少保留 1-2GB 空间给 VidHub 同步使用。