Google Slides

基础操作使用 gog CLI 工具，高级编辑（例如通过 Slides API 添加或修改幻灯片内容）则使用 scripts/slides.py。

身份验证检查

执行任何 Slides 操作前，请先确认身份验证已正常生效：

gog slides info  --account david@hml.tech

若命令失败，请重新完成身份验证：gog auth add david@hml.tech --services gmail,calendar,drive,docs,sheets,contacts,tasks,people

核心命令（通过 gog）

# 创建一个新的空白演示文稿
gog slides create "My Presentation" --account david@hml.tech --json

# 获取演示文稿信息（幻灯片数量、标题等）
gog slides info  --account david@hml.tech --json

# 导出为 PDF
gog slides export  --format pdf --out /tmp/deck.pdf --account david@hml.tech

# 导出为 PPTX
gog slides export  --format pptx --out /tmp/deck.pptx --account david@hml.tech

# 复制一份演示文稿（例如用于模板复用）
gog slides copy  "Copy Title" --account david@hml.tech --json

添加/编辑幻灯片内容（通过 scripts/slides.py）

如需添加纯文本幻灯片、执行批量更新或读取完整内容，请使用 scripts/slides.py。

# 添加一张含标题与项目符号正文的幻灯片
python3 scripts/slides.py add-slide  
  --title "Slide Title" 
  --body "• Bullet point onen• Bullet point two"

# 在指定位置插入幻灯片（索引从 0 开始）
python3 scripts/slides.py add-slide  --title "Intro" --insert-at 0

# 从 JSON 文件运行任意批量更新请求
python3 scripts/slides.py batch  requests.json

# 通过脚本导出
python3 scripts/slides.py export  --format pdf --out /tmp/deck.pdf

# 列出所有评论及其锚点位置（例如所在幻灯片编号）
python3 scripts/slides.py list-comments 

# 解决某条评论，并可选附带回复消息
python3 scripts/slides.py resolve-comment   --reply "Fixed!"

从零构建一套演示文稿

典型工作流程如下：

1. 创建演示文稿：gog slides create "Title" --json → 获取 presentationId
2. 逐张添加幻灯片，使用 scripts/slides.py add-slide
3. 对于富媒体内容（如图片、图形、格式化文本），将批量请求编写为 JSON 文件，再运行 scripts/slides.py batch
4. 导出：gog slides export --format pdf --out /tmp/deck.pdf

有关复杂批量请求（含图片、图形、文本格式等）的示例，请参阅 references/batch_requests.md。

获取 Presentation ID

从 Google Slides 网址中提取： https://docs.google.com/presentation/d/****/edit

注意事项

• gog slides 底层调用 Drive API（无需单独申请 Slides 权限范围）
• scripts/slides.py 直接调用 Google Slides API，依赖有效的 gog 身份验证令牌
• 可在环境变量中设置 GOG_ACCOUNT=david@hml.tech，从而省略所有命令中的 --account 参数