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 格式字串，代理程式可擷取結構化的事件資料（UIDs、標題、日曆、時間戳記），以供記錄、報告或同步至外部系統使用。