核心用法
gws workflow +weekly-digest 是一款面向 Google Workspace 用户的生产力工具，旨在自动化生成每周工作摘要。用户只需执行单一命令，即可获取本周日历会议概览与 Gmail 未读邮件数量的综合统计，支持 JSON、Table、YAML、CSV 四种输出格式，便于集成到自动化脚本或人工阅读。
显著优点
- 效率提升：将原本需要手动切换 Calendar 与 Gmail 的操作压缩为一条 CLI 命令
- 数据安全：明确声明为只读操作，不会修改或删除任何邮件、日历事件
- 格式灵活：原生支持结构化数据格式（JSON/YAML/CSV），适合开发者和自动化场景
- 生态集成：属于 gws 工作流套件，可与
gws-shared的全局认证体系无缝衔接
潜在局限
- 功能单一：仅提供会议列表与未读计数，不包含邮件主题预览、会议详情或智能优先级排序
- 依赖外部工具：必须预先安装
gws二进制文件并完成 OAuth 认证 - 权限要求：需要同时授权 Calendar 与 Gmail 读取权限，隐私敏感用户可能顾虑
- 无离线能力：完全依赖 Google API，网络中断时无法使用
适合人群
- 需要定期向团队汇报工作负载的工程师/项目经理
- 习惯命令行工作流、追求自动化周报生成的效率用户
- 希望将周数据导入 Notion/Airtable 等系统的极客用户
常规风险
- OAuth 令牌泄露：若
gws-shared配置不当，Google 访问令牌可能被本地明文存储 - Scope 过度授权：工具请求的权限范围可能大于实际功能所需（如可读取所有邮件内容，但仅返回计数）
- API 配额消耗：频繁调用可能触及 Google Workspace API 的每日限额