iCalendar Sync

核心用法

iCloud Calendar Sync Skill 提供完整的日历事件CRUD能力，通过CalDAV协议与iCloud服务器通信。主要功能包括：

• 日历列表查询：list 命令枚举可访问日历
• 事件读取：get 支持按日历名、时间范围（--days）过滤
• 事件创建：create 接收JSON格式事件数据，需指定dtstart/dtend时区
• 事件更新：update 支持三种模式——单实例（single）、全部实例（all）、此日期及未来（future），通过--recurrence-id处理重复事件
• 事件删除：delete 通过UID定位

认证方式优先级：OS密钥环 → 环境变量（ICLOUD_USERNAME/ICLOUD_APP_PASSWORD）→ YAML配置文件（0600权限）。针对无GUI环境提供--non-interactive标志，支持Docker/Kubernetes Secrets注入。

显著优点

1. 安全架构完善：强制使用Apple应用专用密码（非主密码），支持macOS Keychain/Windows Credential Manager/Linux Secret Service三级密钥环，SSL/TLS强制验证，日志自动脱敏凭证
2. 自动化友好：原生支持CI/CD、Docker、Kubernetes场景，提供明确的凭证注入链路和权限控制（YAML模式0600）
3. 重复事件精细控制：三种更新模式覆盖复杂日程管理需求，支持recurrence-id精准定位例外实例
4. 故障降级能力：macOS原生桥接模式（--provider macos-native）通过AppleScript调用Calendar.app，绕过CalDAV直接认证限制

潜在缺点与局限性

• Apple生态依赖：iCloud服务可用性受网络及Apple服务器状态制约，中国大陆等地区可能存在连接稳定性问题
• 速率限制：60秒10次调用上限可能限制高频同步场景
• 无双向冲突解决：文档未提及本地与云端事件冲突时的合并策略，可能存在数据覆盖风险
• GUI密钥环阻塞：部分macOS后台代理场景下钥匙串访问会弹出交互式提示，需显式切换文件存储模式

适合人群

• 需要将iCloud日历集成至自动化工作流（如智能家居、定时报告生成）的技术用户
• 跨平台开发团队寻求标准化日历数据同步方案
• 隐私敏感用户倾向本地凭证存储而非云端OAuth

常规风险

• 凭证泄露：YAML文件模式若权限配置错误（非0600）或容器Secret挂载不当，存在凭证暴露风险
• CalDAV协议限制：Apple可能随时调整CalDAV端点或认证策略，导致技能失效
• 时区处理：JSON输入需严格ISO 8601格式含时区偏移，省略时区可能导致日程漂移

核心用法

iCloud Calendar Sync Skill 实现本地系统与 Apple iCloud 日历的双向同步，支持事件查询、创建、更新及删除操作。用户需通过 Apple ID 生成应用专用密码，凭据优先存储于系统密钥环（macOS Keychain / Windows Credential Manager / Linux Secret Service API）。

关键命令：

• setup：交互式配置凭据，支持 --non-interactive 模式供 CI/CD 使用
• list：列出可访问日历，支持 --provider macos-native 桥接模式
• get：获取指定时间范围内的事件
• create/update/delete：完整 CRUD 操作，支持递归事件的单实例/全部/未来实例三种更新模式

自动化友好： 支持环境变量 (ICLOUD_USERNAME, ICLOUD_APP_PASSWORD)、Docker Secrets、Kubernetes Secrets 等多种无头部署方案。

显著优点

1. 安全架构完善：强制应用专用密码（非主 Apple ID 密码），杜绝主凭据泄露风险；OS 密钥环原生集成，避免明文存储
2. 多层凭据降级：密钥环 → 环境变量 → YAML 配置文件（强制 0600 权限），适配从桌面到容器的全场景
3. 企业级部署支持：原生支持 Docker/K8s Secrets，提供 --debug-http 诊断与自定义 User-Agent
4. 递归事件精确处理：支持 --mode single/all/future 三种更新粒度，避免误操作整组事件
5. 纯文档型设计：Skill 本身无可执行代码，功能委托外部模块，降低注入攻击面

潜在缺点与局限性

1. 外部依赖未审计：核心功能依赖 icalendar_sync Python 模块，其安全性不在认证范围内，存在供应链风险
2. 网络环境敏感：必须连通 caldav.icloud.com:443，企业防火墙/VPN 环境需额外代理配置
3. 文件存储回退风险：密钥环不可用时允许文件存储，依赖用户正确设置权限，配置失误可能导致明文泄露
4. T3 来源可信度：社区个人维护项目，无企业背书，生产环境建议额外代码审计
5. 速率限制严格：10 次/60 秒，高频同步场景需自行实现队列缓冲

适合人群

• Apple 生态深度用户：需在 Linux/Windows 服务器或自动化脚本中管理 iCloud 日历
• DevOps/平台工程师：构建跨平台日历同步管道，集成 CI/CD 通知、值班排班系统
• 隐私敏感用户：偏好 OS 级密钥环而非云密码管理器的场景
• 非 macOS 自动化场景：Docker 容器、远程服务器等无法直接运行 Calendar.app 的环境

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 凭据泄露 | 用户误用 `--storage file` 且权限设置不当 | 强制密钥环，定期轮换应用专用密码 |

| 供应链攻击 | `icalendar_sync` 模块被投毒 | 锁定版本，PyPI 官方源安装，定期审计 |

| 网络中间人 | 企业代理或恶意热点拦截 | TLS 1.2+ 强制验证，证书 pinning |

| 操作误删 | 递归事件更新范围选择错误 | 生产环境先用 `--mode single` 测试 |

| 账号锁定 | 频繁请求触发 Apple 风控 | 遵守 10/60s 速率限制，实现指数退避 |

总结：该 Skill 在日历同步类工具中安全设计领先，适合技术用户构建自动化工作流，但需关注外部依赖维护与网络环境配置。