用途：通过 CalDAV 协议管理日历事件与待办事项，支持 Google Calendar、iCloud、Nextcloud、Fastmail、网易（163/126/yeah.net）及任意标准 CalDAV 服务器。
主要能力：列出日历、按时间范围查询事件、按 UID 获取/更新/删除事件、创建事件；列出与创建/更新/删除待办；查询空闲/忙碌；多账户支持；list-events 与 list-todos 支持增量同步（sync-token、ctag+etag，回退为全量），缓存位于 ~/.config/mail-skills/caldav-cache/，写操作自动失效缓存，可用 --force-refresh 强制全量。
使用方式：运行 bash setup.sh 安装依赖并配置账户；手动运行需先 npm install --production。配置存于 ~/.config/mail-skills/.env（与 imap-smtp-email 共享），无共享配置时回退到技能目录 .env。默认账户用 PROVIDER、USERNAME、PASSWORD、CALDAV_DEFAULT_CALENDAR；自定义服务器设 PROVIDER=custom 并填 CALDAV_SERVER_URL。多账户用大写前缀变量，命令前加 --account <name>。命令示例：node scripts/caldav.js list-calendars；node scripts/caldav.js list-events --start 2026-01-01 --end 2026-12-31；create-event 需 --summary、--start、--end；create-todo 需 --summary，可选 --due、--priority。
适用场景：跨平台日历与任务自动化管理、多账户日程查询、空闲时间查询。
限制与注意：Google 需应用专用密码，网易需授权码，iCloud 需 App-Specific Password；配置文件权限为 600。连接失败需检查服务器 URL 与凭据，认证失败多为密码类型不符，找不到日历需确认服务已启用且 URL 路径正确。具体收费、价格与效果资料暂未提供。