核心用法
本 Skill 提供 Apple iCloud 四大核心服务的命令行访问能力，采用双轨认证体系：
| 服务 | 工具 | 认证方式 |
|------|------|----------|
| 照片、iCloud Drive、查找设备 | pyicloud | 主密码 + 双重认证 |
| 日历 (CalDAV) | caldav / icloud_calendar.py | 应用专用密码 |
照片管理：支持浏览相册、下载单张或批量同步（配合 icloudpd），可处理中国大陆区域的 cn 域名。
iCloud Drive：完整的文件浏览、目录导航、下载能力，支持流式读取大文件。
查找设备：实时获取所有 Apple 设备的 GPS 位置，支持播放声音、启用丢失模式等远程操作。
日历服务：通过 CalDAV 协议直接读写 iCloud 日历，支持创建时间段事件、全天事件、搜索和删除，可与 vdirsyncer + khal 组合构建本地化日历工作流。
显著优点
- 生态深度整合：一站式覆盖 Apple 核心云服务，无需多端切换
- 自动化友好：纯命令行/Python API，易于脚本化、定时任务集成
- 家庭场景创新：文档提供「家庭看板」「回家雷达」「票务托管」「状态墙」四个高阶场景，将日历转化为家庭信息共享中枢
- 中国大陆适配：明确标注
china_mainland=True、环境变量icloud_china、高德地图 GCJ-02 坐标系等本土化配置
潜在缺点与局限性
- 认证复杂性：pyicloud 与 CalDAV 需不同凭证（主密码 vs 应用专用密码），用户易混淆
- 2FA 交互阻塞：pyicloud 的短信/设备验证码需人工输入，难以无人值守
- 会话过期：Find My 定位会话会过期，守护进程需处理重新认证
- 备忘录缺失：Apple Notes 无公开 API，无法同步
- 依赖第三方库：pyicloud 非官方 SDK，存在 API 变更风险
适合人群
- Apple 生态重度用户，希望跨平台（Linux/macOS）管理 iCloud 数据
- 家庭共享场景：需要「家庭看板」协调日程、状态的成员
- 自动化爱好者：构建个人工作流（如自动备份照片、定时同步日历）
- 开发者：需要程序化访问 iCloud 服务的脚本编写者
常规风险
- 凭证泄露：主密码和应用专用密码需妥善保管，建议配合密码管理器
- 位置隐私：「状态墙」「回家雷达」等功能持续上报 GPS，需征得家庭成员同意
- API 稳定性：非官方逆向工程，Apple 可能随时封禁或变更接口
- 2FA 锁定：频繁请求可能导致账号临时锁定，建议合理设置轮询间隔（文档建议 15 分钟/通勤时 1 分钟）