用途:通过 gws CLI 调用 Google Slides API 创建、更新和优化演示文稿,并附带较强的设计规范,使成品看起来经过刻意设计而非自动生成。
前提条件:gws CLI 需在 $PATH 中并完成认证。可用 which gws 检查是否安装;用 gws auth login -s slides,drive 进行带 Slides 与 Drive 权限的 OAuth 登录;用 gws slides --help 验证 Slides API 可访问。若从未运行过 gws auth setup,需先运行一次以创建 Cloud 项目并启用 API。注意 gws 会在 JSON 输出前向 stdout 打印 Using keyring backend: keyring,程序化解析时应跳过首行(如 tail -n +2)。
主要能力:创建演示文稿、获取演示文稿、通过 batchUpdate 批量构建幻灯片。常用命令包括 gws slides presentations create --json '{"title": "My Deck"}'、gws slides presentations get --params '{"presentationId": "ID"}'、gws slides presentations batchUpdate --params '{"presentationId": "ID"}' --json '{"requests": [...]}',以及用 gws schema slides.<resource>.<method> 查看参数与类型。
主题系统:每个演示文稿使用一个 YAML 主题文件,固定字体、颜色和可选 logo/wordmark。查找顺序为当前目录的 .gws-slides-theme.yaml,再到 ~/.gws-slides-theme.yaml。找到则静默使用;找不到则先进行主题访谈。主题包含 name、font(family、fallback、mono)、logo(path、placement、height)和 colors(background、surface、text_primary、text_secondary、accent_primary、accent_secondary、accent_warm、accent_neutral、divider、dark_bg、dark_text、dark_accent)。用户拒绝主题时使用内置 Default 主题。
设计原则:单一字体家族、多字重;每页最多三种颜色;正文左对齐;标题 6–7 词;至少 40% 留白;使用安全区与舒适区;10 种标准布局并交替节奏。
工作流程:先规划大纲并请用户确认,再创建演示文稿并保存 presentationId,然后以每批 3–5 页通过 batchUpdate 构建,最后做质量检查。构建时始终使用 BLANK 布局手动搭建,颜色与字体全部取自主题,使用伪项目符号(Unicode 字形加制表符与悬挂缩进)而非 createParagraphBullets,图表先生成高 DPI PNG 再经 Drive 上传插入,对象 ID 采用 slide_001 等命名。
质量检查:用 presentations get 逐页检查字体、颜色、项目符号、间距、重叠、内容与布局,并用 gws slides presentations pages getThumbnail 下载缩略图做视觉验证,发现问题用修正性 batchUpdate 修复。
限制与避免事项:不要使用 Google 预定义布局;不要用原生 createParagraphBullets;避免段落式文字、居中正文、缩小字号硬塞、项目符号页加装饰条、渐变、重复对象 ID;不要跳过质量检查。SVG 需先转 PNG,因为 Slides API 只接受位图。参考文件 references/api-patterns.md 与 references/layouts.md 提供 JSON 模式与布局细节。