by 运行时依赖
安装命令
点击复制技能文档
Codex PPT 概述 本技能创建基于图像的 PPT 演示文稿。每张幻灯片都是使用最佳可用图像后端生成的完整 16:9 图像。图像包含幻灯片标题、关键点和视觉组合。生成的图像然后使用脚本/assemble_ppt.py 组装成一个 .pptx 文件。优先使用内置的图像生成和编辑工具，当它可用时。如果它不可用，或者用户明确请求 API/CLI 模式，则使用此技能的本地回退 CLI 脚本/image_gen.py。
何时使用 使用此技能，当用户要求：
将文章、报告、论文、文档、课程笔记或粗略大纲转换为 PPT。 创建视觉一致的演示文稿。 生成全页图像幻灯片。 产生支持的 outline.md 和 speech.md 文件。 将生成的幻灯片图像组装成 .pptx 文件。 不要使用此技能进行普通的可编辑 PowerPoint 布局，其中每个文本框、图表或形状必须保持单独可编辑。该工作流程优先考虑视觉质量和一致性，而不是可编辑性。
图像生成后端 此技能支持两个图像后端：
内置图像工具，当可用时优先使用。示例工具名称：Codex image_gen；OpenClaw image_generate。 本地 API/CLI 回退，使用脚本/image_gen.py。 后端选择规则： 当可用时，优先使用内置图像工具。在 Codex 中，这通常意味着内置的 image_gen 工具。在 OpenClaw 中，这可能是 image_generate。 仅凭分辨率、质量、长宽比或幻灯片编辑请求，不需要 CLI/API 回退。仅当内置工具不可用、用户明确请求 API/CLI 或第三方 OpenAI 兼容代理，或者请求的功能在内置工具中不可用时，才使用 CLI/API 回退。 在生成第一张图像之前，告知用户计划使用哪个后端，为什么，并要求确认。不要将处于特定代理环境中视为内置图像工具可用的证明。 CLI/API 回退自动加载 ~/.codex-ppt-skill/.env。正常运行 CLI；不要手动解析 .env 或在错误发生之前请求配置。仅在 CLI 报告缺少 OPENAI_API_KEY、身份验证/基础 URL/模型错误或用户明确想要更改 API 设置时，才请求配置。使用 scripts/codex_ppt_runtime.py config --api-key 配置提供的值。 有关详细的回退设置，请在错误发生后阅读 docs/image-model-configuration.md。 CLI/API 回退命令使用共享运行时环境。让 {skill_root} 表示包含此 SKILL.md 的目录。~/.codex-ppt-skill/.venv/bin/python {skill_root}/scripts/image_gen.py generate \ --model gpt-image-2 \ --prompt-file {prompt_file} \ --size 2560x1440 \ --quality medium \ --out {base_dir}/{deck_name}/origin_image/slide_01.png 对于 CLI/API 回退，首先确保依赖项已安装：python3 {skill_root}/scripts/codex_ppt_runtime.py bootstrap 使用共享运行时配置进行实际 API 调用。回退 CLI 自动加载现有配置；仅在 CLI 报告缺少配置、用户明确想要更改 API 密钥、基础 URL 或模型，或者实际 API 调用报告身份验证、权限、基础 URL 或模型可用性失败时，才加载 docs/image-model-configuration.md。 回退 CLI 接受包含 gpt-image- 的模型名称，例如 gpt-image-2 或 openai/gpt-image-2。 回退 CLI 支持： generate：从提示创建一个或多个图像。 edit：编辑一个或多个现有图像，选项包括使用遮罩。 generate-batch：从 JSONL 提示文件生成多个幻灯片图像。 回退 CLI 默认为 2K 16:9 横向输出，2560x1440，因为它保持幻灯片文本清晰，同时保持在 gpt-image-2 像素限制以下。 对于 4K 横向幻灯片，请仅在用户请求 4K、文本密集幻灯片需要更清晰的输出或默认结果模糊时，使用 --size 3840x2160 --quality high。 对于肖像资产，请仅在用户请求肖像输出时使用 --size 2160x3840。 透明背景请求： 内置模式应使用平面色键背景和本地移除，当适当时。 CLI/API 回退也应更喜欢色键生成加上 scripts/remove_chroma_key.py 用于简单的不透明主题。 gpt-image-2 不支持 --background transparent。如果用户需要真正的模型本地透明度，请在切换到 --model gpt-image-1.5 --background transparent --output-format png 之前询问。
工作流程
- 了解源内容
- 计划幻灯片大纲