SuperAPI AI 工具集

google_slides

办公与效率

查看项目

更新于 10-26 18:14

技能介绍

用途:本技能用于管理 Google Slides 演示文稿,唯一实现路径是内置的 Google Workspace CLI(hatch_gws_cli)。它可读取、创建和编辑用户自己的演示文稿。

主要能力:

  • 连接管理:通过 hatch_gws_cli slides status 查看连接状态与 connect_url,通过 slides disconnect 断开连接并获取 disconnect_url。
  • Schema 查询:使用 hatch_gws_cli schema slides.presentations.get / create / batchUpdate 查阅当前 CLI 的接口约定。
  • 演示文稿操作:调用 presentations get 读取指定演示文稿;presentations create 创建空白演示文稿;presentations batchUpdate 执行批量更新请求(如新增幻灯片)。

使用方式:通过 exec 运行 hatch_gws_cli slides <resource> <method> [flags]。首次使用时先执行 status;若显示不可用,应告知用户该设备不支持,不要提供替代集成方案或索要凭据;若为 not_connected 且带有 connect_url,则以 Markdown 链接形式提供连接入口并等待用户完成连接。创建演示内容的推荐流程是:先用 artifacts 工具在 ~/workspace/your_files/<artifact-slug>/ 下生成 .pptx 文件,再用 presentations create 创建空白演示文稿,然后用 drive files update 上传该 .pptx 并让 Drive 在原地转换为 Google Slides;上传路径必须是主目录内的绝对路径。完成后用 presentations.get 回读并核对页数。修改时编辑 artifact 后重新上传到同一演示文稿 ID;上传会替换全部幻灯片,因此需先回读已发布版本,若有变动应告知用户并等待确认。

操作规则:不熟悉的方法先用 schema 核对参数;编辑共享演示文稿前应确认;演示文稿 ID、页面对象 ID 和元素 ID 视为不透明字符串;修改前先用 presentations.get 了解当前结构;对用户只说明可见结果,不主动暴露原始 API 标识符和内部响应字段。

适用场景:适合创建和读取个人演示文稿、基于本地 .pptx 生成幻灯片文件并放入 Google Slides 等任务。

限制:生成的幻灯片本质是图片,文本无法在 Slides 中编辑;上传会覆盖全部幻灯片并丢弃 Google 端此前的编辑;相对路径和 /tmp 路径不可用。身份验证由包装器的 status 和 disconnect 子命令处理,不应手写凭据文件或运行原始 gws auth 命令。