wiki-ingest: 4 Agent Use Cases (autonomous PM, content factory, product factory, knowledge base RAG) - 2026-04-15 evening batch

wiki/syntheses/GOG-CLI工具.md

@@ -0,0 +1,70 @@
+---
+title: GOG CLI 工具
+type: synthesis
+tags: [Google Workspace, CLI工具, Gmail, Calendar, Drive]
+sources: []
+last_updated: 2026-04-15
+---
+
+## 概述
+GOG CLI（Google Workspace CLI）是由 steipete 开发的 macOS/Linux 命令行工具，通过 OAuth 为 Gmail、Google Calendar、Google Drive、Google Contacts、Google Sheets、Google Docs 提供命令行接口。
+
+## 支持的 Google 服务
+
+| 服务 | 支持功能 |
+|------|---------|
+| **Gmail** | 搜索（threads/messages）、发送（普通/HTML/回复）、草稿创建与发送 |
+| **Calendar** | 列表、创建、更新事件，支持颜色标记（11色） |
+| **Drive** | 文件搜索 |
+| **Contacts** | 联系人列表 |
+| **Sheets** | 读取、更新、追加、清除、元数据查询 |
+| **Docs** | 导出（txt）、读取内容（cat） |
+
+## 认证方式
+1. 通过 `gog auth credentials /path/to/client_secret.json` 配置 OAuth 客户端
+2. 通过 `gog auth add <email> --services gmail,calendar,drive,contacts,docs,sheets` 授权所需服务
+3. 支持多账户：`--account <email>` 参数切换
+
+## 核心命令示例
+
+### Gmail
+```bash
+gog gmail search 'newer_than:7d' --max 10
+gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com
+gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt
+```
+
+### Calendar
+```bash
+gog calendar events <calendarId> --from <iso> --to <iso>
+gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7
+gog calendar update <calendarId> <eventId> --summary "New Title"
+gog calendar colors  # 查看可用颜色
+```
+
+### Sheets
+```bash
+gog sheets get <sheetId> "Tab!A1:D10" --json
+gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]'
+gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]'
+```
+
+### Docs
+```bash
+gog docs export <docId> --format txt --out /tmp/doc.txt
+gog docs cat <docId>
+```
+
+## 环境变量
+- `GOG_ACCOUNT=you@gmail.com` — 避免每次重复 `--account` 参数
+
+## 注意事项
+- 发送邮件或创建事件前需二次确认
+- Sheets 值传递推荐使用 `--values-json`
+- `--body` 参数不解析 `\n`，多行内容需用 `--body-file`
+- Docs 不支持原地编辑，需通过 Docs API 客户端实现
+
+## 安装
+```bash
+brew install steipete/tap/gogcli
+```