SparkCode PPT
将每一页幻灯片直接生成为一张完整图片，图片中同时包含文字、图表、插画、背景和装饰元素。不得使用代码搭建幻灯片内容。
初始化
首次调用接口前，运行 python scripts/configure.py status。
若输出 configured=no，读取 references/onboarding.md，指导用户获取令牌；随后在交互式终端运行 python scripts/configure.py configure，通过隐藏输入填写令牌。不得回显密钥，不得把密钥写入源码、提示词或交付文件。
默认使用 gpt-image-2 和 https://sparkcode.top/v1。配置时允许用户指定其他模型或 OpenAI 兼容基础地址。
硬性规则
- 使用
gpt-image-2直接生成每一页完整、全出血的 PPT 图片。 - 在同一次图片调用中生成标题、正文、图表、卡片、图标、插画和装饰元素。
- 不得先生成背景，再使用其他工具添加文字。
- 不得使用 Python、SVG、HTML、Canvas、Matplotlib、PIL、PowerPoint 形状或文本框创建或修补页面内容。
- 代码只可用于调用接口、检查文件，以及把通过验收的整页图片全屏放入
.pptx。 - 页面不合格时必须通过
gpt-image-2重新生成，不得用代码修补文字或图形。 - 用户提供的事实、数字、标签、引文和结论必须原样保留。不得虚构案例、指标、结果或无依据的商业结论。
- 不得将最终演示文稿描述为“可编辑”。每页幻灯片只包含一张完整图片。
默认设置
用户未指定时，使用以下设置：
- 页数：6 页
- 比例：16:9
- 语言：简体中文
- 受众：行业业务人员与一线管理者
- 内容深度：中等偏详细
- 模型：
gpt-image-2 - 请求尺寸：
1792x1024；由于上游通道可能返回不同尺寸，必须检查实际像素 - 风格：暖白背景、海军蓝与科技蓝、克制的橙红点缀、蓝图线稿插画、信息丰富的圆角卡片、深蓝色底部结论条
- 叙事顺序：封面 → 背景或问题 → 核心场景 → 解决方案或路径 → 价值闭环 → 行动计划
在安全范围内推断默认设置并继续执行。只有在缺少关键事实、必需参考资料，或某项选择会实质改变结果时，才提出一个简短问题。
工作流程
1. 提取并保护内容
识别主题、行业、目的、受众、页数、来源事实、必须保留的原文、参考图片、目标风格、输出目录，以及是否需要 .pptx。
将内容分为：
- 必须原样保留：不得改写
- 可以改写：为适应幻灯片阅读进行压缩
- 缺乏依据：省略，或改写成中性问题；不得自行补充事实
用户提供参考图时，先进行视觉检查，只提取可迁移的色板、构图、插画语言、卡片几何形状、标题层级、留白和信息密度。不得复制参考图中的文字、数据、标志或主题内容。
2. 规划整套演示文稿
生成图片前先制定精简的页面计划。为每一页定义页面职责、标题、一句话核心观点、3–6 个内容模块、视觉表现方式和底部结论。选择版式时读取 references/page-patterns.md。
不得强行套用默认叙事顺序。封面保持简洁，内容页应有实质信息，但不得为了塞入内容而把文字缩得难以阅读。
3. 建立统一风格锚点
编写一段可复用的全局风格锚点，包含比例、色板、背景质感、标题层级、字体观感、图标与插画风格、卡片形状、图表语言、底部结论条、信息密度、间距和可读性规则。
每页提示词必须逐字重复同一段风格锚点。编写提示词前读取 references/prompt-template.md。将页面计划、风格锚点和各页完整提示词保存到用户的输出目录，不得保存到本技能目录中。
4. 按顺序逐页生成
每次只生成一页：
python <skill-dir>\scripts\generate_page.py --prompt-file <page-prompt.txt> --output <01-title.png>
只有在失效的本地代理导致“连接被拒绝”时才使用 --direct。不得擅自更换模型、请求尺寸、内容或风格。接口返回 HTTP 503 时，使用相同页面和提示词重试一次；若仍然失败，说明上游服务异常并等待恢复，不得切换服务商。
5. 检查每一页
打开并逐页检查输出图片：
- 图片有效、文件非空，比例约为 16:9
- 页面标题、必须保留的文字和数据准确
- 简体中文清晰可读，没有明显错字、乱码、伪文字或重复文字
- 输出的是完整页面，而不是装饰性背景图
- 内容模块信息充分，没有意外的大块空白
- 图表和插画能够支持内容，且不遮挡文字
- 色板、层级、卡片、图标、插画风格、信息密度和底部结论条在整套页面中保持一致
- 不含水印、签名、意外品牌标识或占位文字
只重新生成不合格的页面，并在修正提示词中明确写出观察到的问题与所需改动。未进行视觉检查时，不得声称文字准确。
6. 验收后再组装
用户要求 PowerPoint 且所有页面通过检查后，运行：
python <skill-dir>\scripts\assemble_ppt.py --output <deck.pptx> <01.png> <02.png> <03.png>
脚本必须在每张 16:9 幻灯片上全屏放置一张完整图片，不得添加其他内容。
7. 交付
交付按顺序排列的图片目录、可选的 .pptx 和简短页面目录。说明哪些页面进行了重试或重新生成、图片的实际尺寸，以及仍然存在的图片模型文字限制。
资源
- 接口说明与故障排查
- 首次密钥配置
- 完整页面提示词模板
- 页面结构库
scripts/configure.py：安全地配置、检查或清除本地凭据scripts/generate_page.py：调用 OpenAI 兼容的images/generations接口scripts/assemble_ppt.py：不添加其他内容，将验收通过的整页图片组装成 PPT
