SparkCode 演示文稿

这个技能解决什么问题

传统 PPT 生成流程里，最头疼的不是缺内容，而是把版面设计、配图和文字排版揉在一起时反复返工：代码拼出来的幻灯片版式僵硬，图表位置不对，换一页风格就跳了。而「先画背景、再往上贴文字」的做法，要么文字溢出边界，要么字体跟背景打架。

SparkCode PPT 换了条路线：每一页幻灯片直接生成为一张完整图片，标题、正文、图表、插画、背景和装饰元素全部在同一次调用中由 gpt-image-2 一次画好。代码不参与页面内容的任何构建或修补，只负责调用接口、检查文件、把验收通过的整页图片放进 .pptx。

核心能力与工作流程

技能把常见场景的默认值直接定好：

• 页数：6 页，比例：16:9，语言：简体中文
• 模型：gpt-image-2，默认接口 https://sparkcode.top/v1
• 请求尺寸：1792x1024，但仍需检查上游实际返回的像素
• 视觉风格：暖白背景、海军蓝与科技蓝主色、克制的橙红点缀、蓝图线稿插画、圆角信息卡片、深蓝底部结论条
• 叙事顺序：封面 → 背景或问题 → 核心场景 → 解决方案 → 价值闭环 → 行动计划

工作流程分六个阶段：

1. 提取并保护内容。把材料分为三类：必须原样保留的事实、数字和引文；可以改写压缩以适应版面的内容；以及缺乏依据、需省略或转成中性问题的部分。处理参考图时只提取色板、构图和插画语言，不复制图中文字与数据。
2. 规划整套演示文稿。生成图片前先制定页面计划，为每页定义职责、标题、核心观点和 3–6 个内容模块。版式选择参考 references/page-patterns.md。
3. 建立统一风格锚点。编写一段全局风格描述，每页提示词逐字重复，保证整套页面视觉一致。模板参考 references/prompt-template.md。
4. 按顺序逐页生成。一次只生成一页。仅当本地代理导致「连接被拒绝」时才用 --direct 直连；HTTP 503 时用相同提示词重试一次，仍失败则等待上游恢复，不擅自切换服务商。
5. 检查每一页。逐页验证图片有效性、16:9 比例、文字准确性、中文可读性、信息密度、风格一致性，以及是否含水印或占位文字。不合格页面通过修正提示词重新生成，而不是用代码修补。
6. 验收后组装。所有页面通过检查后，运行 scripts/assemble_ppt.py 把整页图片全屏放入 .pptx，不添加其他内容。

适用边界与注意点

• 交付的 不是可编辑 PPT。每页只包含一张完整图片，文字无法在 PowerPoint 中直接选中修改；要改内容只能重新生图。
• 图片模型对文字渲染有固有限制，长段落和小字号中文仍可能出现错字、乱码或伪文字，检查与重试只能缓解，无法彻底消除。
• 不得虚构事实。用户提供的数据和结论必须原样保留，没有依据的内容要么省略，要么改写成中性问题。
• 凭据安全：令牌只在交互式终端通过隐藏输入配置，不回显、不写入源码或交付文件。
• 生成前先运行 python scripts/configure.py status 确认配置状态，未配置时按 references/onboarding.md 引导获取令牌。