核心用法
gws calendar +agenda 是 Google Workspace CLI 工具集的日程查询子命令，用于以只读方式检索用户关联的所有 Google Calendar 中的即将发生事件。该技能通过 OAuth 2.0 认证与 Google Calendar API 交互，支持灵活的筛选条件与输出格式控制。
功能特性
| 能力 | 说明 |
|------|------|
| 多日历聚合 | 默认查询全部授权日历，无需逐个切换 |
| 时间范围筛选 | `--today`/`--tomorrow`/`--week`/`--days N` 四种粒度 |
| 单日历过滤 | `--calendar` 支持名称或 ID 精确筛选 |
| 时区覆盖 | `--timezone` 允许 IANA 格式时区覆盖，便于跨时区协作 |
显著优点
1. 零风险只读设计：明确声明 read-only 属性，不执行任何创建、修改、删除操作，从根本上杜绝误操作导致日程丢失
2. 命令行效率：适合开发者、运维人员快速 check 日程而无需打开浏览器或移动端应用
3. 与脚本/工作流集成：可配合 cron、CI/CD 或自动化工具实现定时日程提醒、会议冲突检测等场景
4. 符合 POSIX 风格：Unix 用户熟悉的 flag 设计，支持管道与重定向
潜在局限
- 依赖外部认证：需预配置
gws-shared的 OAuth 凭据，首次使用门槛较高 - 无离线能力：完全依赖 Google API 可用性，网络中断即不可用
- 功能边界明确：仅为查看工具，如需创建会议需使用
gws-calendar其他子命令 - 时区易错点：
--timezone需严格使用 IANA 标识符（如America/New_York），常见缩写如 EST 不被支持
适合人群
- 重度终端用户、开发者、SRE/DevOps 工程师
- 需要将日程数据融入自动化脚本的技术团队
- 偏好键盘驱动工作流、减少上下文切换的效率追求者
常规风险提示
| 风险类别 | 说明 | 缓解措施 |
|----------|------|----------|
| OAuth 令牌泄露 | `gws-shared` 存储的凭据若权限过宽可能被滥用 | 确保使用最小权限 Calendar read-only scope |
| 敏感信息泄露 | 会议标题、参会者邮箱可能包含机密信息 | 避免在共享环境/日志中打印完整输出 |
| API 配额耗尽 | 高频自动化调用可能触发 Google 速率限制 | 实施缓存策略，合理设置调用间隔 |
版本信息
- 当前版本：0.22.0
- 所属生态：OpenClaw
gws工具链