Gws Workflow Weekly Digest

核心用法

gws-workflow-weekly-digest 是 Google Workspace 效率工具链中的一款轻量级工作流技能，通过单一命令聚合本周日历会议议程与 Gmail 未读邮件统计，生成结构化的周报摘要。

基础命令：

gws workflow +weekly-digest

输出格式可选： JSON（默认）、table、YAML、CSV，便于对接不同下游工具或人工阅读。

显著优点

1. 跨服务整合：单次调用即可打通 Google Calendar 与 Gmail 双服务，无需分别查询
2. 零写操作：明确声明只读（read-only），不修改任何邮件状态或日历事件，风险极低
3. 格式灵活：支持机器友好的 JSON/YAML 与人工可读的 table 格式
4. 命令行原生：契合开发者与运维人员的工作流，易于集成到 shell 脚本或定时任务（cron）

潜在缺点与局限性

• 功能单一：仅提供计数与列表摘要，无法深入邮件内容分析或会议冲突智能检测
• 依赖外部工具：需预装 gws CLI 并配置 Google OAuth 认证
• 权限范围：需授权 Calendar 与 Gmail 读取权限，对隐私敏感用户可能存在顾虑
• 无主动推送：需手动触发或外部调度，不具备实时通知能力

适合人群

• 需要每周向团队或上级汇报工作概览的职场人士
• 偏好命令行效率工具的开发者、产品经理、技术负责人
• 希望建立自动化周报生成 pipeline 的 DevOps/SRE 工程师

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 数据泄露 | 低 | 仅在本地终端输出，不经过第三方服务器 |

| 误操作 | 极低 | 只读设计，无写入权限 |

| 权限滥用 | 中 | 需妥善保管 OAuth token，避免凭证泄露 |

| 服务依赖 | 低 | Google API 可用性影响功能 |

建议结合 gws-shared 的安全配置指引，使用最小权限原则授权，并定期轮换凭证。