通过 gogcli 跨日历聚合日程与关键词搜索，支持智能过滤与写入确认，Token 高效输出。
说明：
## 核心用法
**gog-calendar** 是基于 [gogcli](https://github.com/steipete/gogcli) 的 Google Calendar 技能，提供跨日历的日程查询与事件搜索能力。
### 主要功能
| 场景 | 命令模式 | 输出格式 |
|——|———|———|
| 日程查看（今天/本周/自定义范围） | `gog calendar events –all –from X –to Y` | `–plain` 默认，节省 Token |
| 跨日历关键词搜索 | 遍历所有日历 + 聚合结果 | `–json` 用于结构化处理 |
| 日历列表 | `gog calendar calendars` | `–json` 获取元数据用于过滤 |
### 显著优点
– **跨日历聚合**：自动查询所有日历并合并结果，避免遗漏多账户/多日历场景
– **Token 效率**：默认 `–plain` 纯文本输出，仅在需要结构化数据时用 `–json`
– **智能过滤**：自动排除节假日等噪音日历（支持用户自定义排除列表）
– **写入安全**：任何创建/更新/删除操作前必须显式确认
– **自动化友好**：`–no-input` 标志支持无人值守场景
### 潜在局限
– 关键词搜索需**逐日历迭代查询**，非原生全量搜索，性能取决于日历数量
– 默认搜索窗口为**未来 6 个月**，超期事件需显式扩展范围
– 依赖 gogcli 二进制，需单独安装（Homebrew: `steipete/tap/gogcli`）
– 对 Google Calendar API 限频敏感，大量日历时可能触发速率限制
### 适合人群
– 多日历管理者（工作/个人/共享日历）
– 需要程序化日历查询的开发者/自动化用户
– 注重 Token 成本的大模型 Agent 场景
### 常规风险
| 风险 | 缓解措施 |
|—–|———|
| 误删/误改事件 | 写入前强制二次确认 |
| 搜索遗漏（节假日过滤过度） | 显式报告过滤的日历名称 |
| 时区歧义 | 使用 ISO 8601 格式或明确时区 |
| API 限频 | 减少并发查询，必要时降速 |
