CalDAV Calendar (vdirsyncer + khal)

CalDAV Calendar (vdirsyncer + khal) 是什么

把 iCloud、Google、Fastmail、Nextcloud 等 CalDAV 日历同步到本地 ICS，再通过命令行读取和写入。

适用场景

适合终端查今日或未来事件、全文搜索、脚本化创建日程和维护自托管日历。

核心能力与工作机制

清单覆盖同步、日期范围、格式化输出、创建、交互编辑、删除、缓存和各服务端配置示例。

执行流程

配置 vdirsyncer 的远端与本地存储以及 khal 日历路径，执行 discover 和 sync；每次查询或写入前同步，修改后再次同步并检查服务端。

输入与输出

需要 CalDAV 服务 URL、账号凭据、日历集合、事件标题、时间、地点与描述。输出事件列表或 ICS 变更；写操作可创建、编辑和删除远端日历事件。

依赖、账号与权限

仅支持 Linux，依赖 vdirsyncer、khal、配置目录和 CalDAV 网络访问；交互编辑需要 TTY 或 tmux。

副作用、限制与风险

凭据和日程敏感，时区或同步冲突可能导致错误时间和覆盖；删除会同步到服务端。会缓存远端日历到本地并把本地变更上传到账号。

不适用边界

不处理未配置服务的专有 API 功能，也不应在未确认时区和目标日历时批量写入。

失败处理与验收

先检查 discover、凭据、证书、时区和同步日志；冲突时保留 ICS 副本后再选择版本。在本地和服务端双向核对事件 UID、标题、起止时间、时区与目标日历。

适合谁使用

适合 Linux 用户、自托管日历用户和命令行自动化开发者。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.1 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. CalDAV Calendar (vdirsyncer + khal) 主要解决什么问题？

把 iCloud、Google、Fastmail、Nextcloud 等 CalDAV 日历同步到本地 ICS，再通过命令行读取和写入。适合终端查今日或未来事件、全文搜索、脚本化创建日程和维护自托管日历。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要 CalDAV 服务 URL、账号凭据、日历集合、事件标题、时间、地点与描述。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

配置 vdirsyncer 的远端与本地存储以及 khal 日历路径，执行 discover 和 sync；每次查询或写入前同步，修改后再次同步并检查服务端。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

仅支持 Linux，依赖 vdirsyncer、khal、配置目录和 CalDAV 网络访问；交互编辑需要 TTY 或 tmux。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会缓存远端日历到本地并把本地变更上传到账号。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不处理未配置服务的专有 API 功能，也不应在未确认时区和目标日历时批量写入。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

先检查 discover、凭据、证书、时区和同步日志；冲突时保留 ICS 副本后再选择版本。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

在本地和服务端双向核对事件 UID、标题、起止时间、时区与目标日历。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。