核心用法
gws-workflow 是基于 Google Workspace API 的命令行工作流编排工具,通过 gws workflow <resource> <method> 模式实现跨服务自动化。内置 5 个即用型 Helper 命令:
- +standup-report:聚合当日会议与待办任务,生成站会摘要
- +meeting-prep:自动提取会议议程、参会人及相关文档
- +email-to-task:将 Gmail 邮件转换为 Google Tasks 条目
- +weekly-digest:汇总本周会议与未读邮件统计
- +file-announce:在 Chat 空间公告 Drive 文件
用户可通过 gws schema workflow.<resource>.<method> 预查 API 参数,再用 --params 或 --json 传参执行。
显著优点
1. 原生集成:深度对接 Google Calendar、Gmail、Tasks、Drive、Chat 五大服务,无需额外 OAuth 配置
2. 场景闭环:从「会前准备→会中记录→会后跟进→周报总结」形成完整工作流
3. CLI 友好:类 Unix 命令设计,支持管道组合与脚本集成,适合开发者与运维人群
4. 可扩展:基于 gws 框架,可通过 generate-skills 自定义子技能
潜在缺点与局限性
- 生态绑定:完全依赖 Google Workspace,无法兼容 Microsoft 365 或企业私有部署
- 权限敏感:需 Calendar/Gmail/Tasks 等高敏感 scope,企业 IT 策略可能拦截
- 离线失效:纯云端 API 调用,无本地缓存机制
- 版本碎片化:v0.22.3 为早期版本,API 稳定性与向后兼容性待观察
适合人群
- 重度 Google Workspace 用户(日均邮件>50、会议>3场)
- 技术型产品经理、工程经理、远程协作团队负责人
- 追求「Inbox Zero」与自动化办公的效率极客
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | 邮件/日历内容经 CLI 传输,需确保终端环境安全 |
| OAuth 令牌 | 长期凭证存储于本地,建议配合 `gws-shared` 的安全规则使用 |
| 误操作 | `--json` 批量参数无二次确认,建议先用 `schema` 验证 |
| API 限流 | 高频调用可能触发 Google Workspace 配额限制 |