核心用法
gog-calendar 是基于 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 限频 | 减少并发查询，必要时降速 |