Caldav Calendar

• 您希望 AI 代理能够跨主流 CalDAV 提供商（iCloud、Google、Fastmail、Nextcloud）读取、创建或搜索日历事件。
• 您需要在没有 GUI 的 Linux 机器上以脚本化或自动化方式访问日历。
• 您希望获得结构化的事件输出（日期、标题、UID、描述），以便进行下游处理或报告。
• 您需要将新事件推送到远程 CalDAV 服务器，并保持本地存储同步。

• 您不在 Linux 环境中——此技能明确要求 Linux 环境。
• 您需要实时日历流式传输或推送通知；vdirsyncer 是一个基于拉取的同步工具。
• 您需要在完全自动化（非 TTY）的管道中进行交互式、基于 TTY 的事件编辑——khal edit 需要终端。

使用 vdirsyncer 从 iCloud、Google、Fastmail、Nextcloud 或任何标准 CalDAV 服务器同步日历。事件以 .ics 文件的形式存储在本地，支持快速离线访问。

使用 khal list 查看今天的事件、未来 N 天的事件、特定日期范围内的事件，或指定名称的单个日历。支持自然语言简写，如 today（今天）、tomorrow（明天）和 7d（7天）。

使用 khal search 按关键词搜索所有已同步的事件。自定义 --format 字符串可让您精确提取所需字段（标题、日期、UID、地点等）。

使用 khal new 在任意日历上创建定时或全天事件，支持可选的描述信息及目标日历选择。创建完成后，vdirsyncer sync 会将更改推送回远程服务器。

使用 {title}、{start-date}、{uid}、{calendar} 和 {location} 等占位符格式化事件输出，轻松将日历数据传输到其他工具或代理中。

khal 在 ~/.local/share/khal/khal.db 维护一个本地缓存。如果同步后事件显示为过时内容，可以清除缓存，强制从本地 .ics 存储中重新读取数据。

一个代理每天早晨依次运行 vdirsyncer sync 和 khal list today 7d，获取本周的日程事件，并以自然语言的形式为用户进行摘要汇报。

代理以自然语言接收会议请求，使用 khal new 创建事件，并将其同步回 iCloud 或 Nextcloud——无需手动操作日历应用。

智能体在建议空闲时间段或安排新工作之前，使用 khal search 和 khal list 搜索日历中的现有日程安排。

通过使用自定义 --format 格式字符串，代理可提取结构化事件数据（UID、标题、日历、时间戳），用于日志记录、报告生成或与外部系统同步。