google-slides

Google Slides 是一个用于创建、编辑和管理 Google Slides 演示文稿的技能，通过 OAuth 认证访问 Google Slides API。

用途

该技能面向需要通过命令行或脚本自动化操作 Google Slides 演示文稿的用户，可用于批量创建演示文稿、读取幻灯片内容、添加或删除幻灯片、插入文本和图片，以及导出为 PDF 或 PowerPoint 文件。

主要能力

技能提供 slides_operations.py 脚本，支持以下操作：

• 列出演示文稿：list
• 搜索演示文稿：list --query "关键词"
• 获取演示文稿信息：info <presentation_id>
• 创建演示文稿：create "标题"
• 读取幻灯片内容：read <presentation_id> --slide 1
• 添加空白幻灯片：add-slide <presentation_id>
• 添加指定布局幻灯片：add-slide <presentation_id> --layout title_body
• 删除幻灯片：delete-slide <presentation_id> <slide_id>
• 添加文本框：add-text <presentation_id> <slide_id> "文本" --x 100 --y 100
• 添加图片：add-image <presentation_id> <slide_id> "图片URL"
• 复制演示文稿：duplicate <presentation_id> "副本标题"
• 导出为 PDF：export <presentation_id> ./output.pdf --format pdf
• 导出为 PowerPoint：export <presentation_id> ./output.pptx --format pptx

支持的幻灯片布局包括：blank（空白）、title（标题）、title_body（标题和正文）、title_two_columns（标题和两列）、title_only（仅标题）、section（章节标题）、big_number（大数字展示）、caption（仅说明文字）。

文本框和图片使用点（pt）定位，--x 和 --y 表示距左上角的位置，--width 和 --height 表示尺寸。标准幻灯片约为 720 x 540 点。

使用方式

使用前必须先运行预检脚本检查认证状态：

python3 00-system/skills/google/google-master/scripts/google_auth.py --check --service slides

退出码含义：0 表示可直接使用；1 表示需要登录，运行 --login；2 表示缺少凭据或依赖，需参考 setup-guide.md。

首次设置步骤：

1. 安装依赖：pip install google-auth google-auth-oauthlib google-api-python-client
2. 在 Google Cloud Console 创建 OAuth 凭据（启用 Google Slides API，选择“桌面应用”）
3. 在 Nexus 根目录的 .env 文件中添加： GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=your-client-secret GOOGLE_PROJECT_ID=your-project-id
4. 运行登录：python3 00-system/skills/google/google-master/scripts/google_auth.py --login

演示文稿 ID 可从 URL 中获取：https://docs.google.com/presentation/d/[PRESENTATION_ID]/edit

适用场景

适用于需要以编程方式批量创建或管理 Google Slides 演示文稿的场景，例如自动生成月度报告、导出演示文稿用于邮件分享或进一步编辑。

限制

使用该技能需要配置 Google Cloud OAuth 凭据并完成认证。关于错误处理，可参考 ../google-master/references/error-handling.md。其他限制暂未提供。