用途:通过 hatch_gws_cli(内置的 Google Workspace CLI,为唯一实现路径)管理用户的 Google Slides 演示文稿,支持读取、创建和编辑。
主要能力:连接管理(status、disconnect);演示文稿操作,包括 presentations.get、presentations.create、presentations.batchUpdate;不熟悉的接口可先用 schema 查看当前 CLI 契约,再用 --params 与 --json 调用。
使用方式:连接流程为先运行 hatch_gws_cli slides status;若返回 unavailable 则告知用户本设备不可用,不提供替代集成方案;若为 not_connected 且带 connect_url,则用返回链接以指定 Markdown 形式引导连接,等待用户重连后再操作。断开用 hatch_gws_cli slides disconnect,并按返回的 disconnect_url 给出断链。构建演示文稿时不要用 create 加逐元素 batchUpdate 拼装,而应先用 artifacts 工具生成 .pptx(位于 ~/workspace/your_files/<artifact-slug>/),再用 create 铸造空白文稿,通过 drive files update 上传该文件(路径须为绝对路径且在 home 目录内,相对路径与 /tmp 会失败),由 Drive 就地转换为 Slides。完成后须用 get 读回并核对页数;修订时修改制品并重新上传同一文稿 ID,上传会覆盖全部幻灯片并丢弃此前在 Google 中的编辑,因此须先读回发布版本,如已变化应说明并等待确认。
限制:认证由封装器的 status 和 disconnect 子命令处理,不可手写凭据文件或运行原始 gws auth;演示文稿、页面与元素 ID 视为不透明字符串;编辑共享演示文稿前需确认;面向用户的文本不得暴露原始 API 标识符或内部响应字段,除非用户要求或用于排障。幻灯片为图片,文字无法在 Slides 中编辑。