核心用法
gws calendar +agenda 是一个 Google Calendar 的只读查询工具，用于快速获取跨日历的 upcoming 事件。基础命令 gws calendar +agenda 返回默认时间范围内的所有日历事件；通过 --today、--tomorrow、--week 或 --days N 可精确筛选时间窗口；--calendar 参数支持按名称或 ID 过滤特定日历；--timezone 允许覆盖账户默认时区（IANA 格式）。
显著优点
- 只读安全：明确声明永不修改事件，操作风险极低
- 多日历聚合：一次性查询所有授权日历，无需切换
- 灵活筛选：时间维度（今天/明天/本周/自定义天数）与日历维度双重过滤
- 时区适配：支持 IANA 时区覆盖，便于跨时区协作
潜在局限
- 依赖
gwsCLI 工具及 Google OAuth 认证，需预先完成授权配置 - 作为查询工具，无法创建/编辑/删除事件
- 输出格式受
gws全局配置影响，复杂日程可能可读性受限 - 需参考
gws-shared获取完整的认证与全局参数说明
适合人群
- 需快速概览多日历日程的开发者/技术用户
- 偏好命令行效率、已熟悉
gws生态的用户 - 需要跨时区查询日程的远程工作者
常规风险
- OAuth 凭证管理：需确保
gws的 token 存储安全，避免泄露 - 只读误用：虽为只读，但仍需注意在共享终端中避免敏感日程信息泄露
- 依赖维护：
gws版本迭代可能导致参数变更，建议锁定版本或关注更新