PptxGenJS 幻灯片制作

解决代码生成幻灯片的视觉失控问题

用代码生成幻灯片最常遇到的痛点是「不可控」。在 HTML/Markdown 里，文本会自动换行，颜色有默认值兜底。但在幻灯片引擎里，一切都得精确指定：如果坐标算错，元素就会重叠；如果忘了处理 hex 颜色格式，编译直接报错；如果没给标题预留足够空间，文字会被截断。

slide-making-skill 解决的就是这个问题。它基于 PptxGenJS 封装了一套严格的生成规范，让 AI 生成的 JS 脚本能稳定输出排版工整的原生 .pptx 文件，而不是靠运气去试错。

核心机制与关键步骤

该技能的工作流围绕「主题驱动」和「自动化校验」展开。

• 单例主题对象（Theme Contract）：整个 PPT 的视觉风格由一个固定的 theme 对象控制，包含 primary、secondary、accent、light 和 bg 五个键。这强制 AI 严格使用调色板，不允许随意修改色值或引入渐变，确保生成的幻灯片风格统一。
• 版式与字体硬性约束：定义了 10" × 5.625" 的 LAYOUT_16x9 画布。中文默认 Microsoft YaHei，英文默认 Arial。特别规定了正文和图注绝对不加粗，只保留标题的视觉权重。
• 代码安全规避：明确规定了常见的 API 陷阱，例如 createSlide() 中绝对不能使用 async/await，hex 颜色前缀不能带 #，透明度不能编码进色值。
• 闭环 QA 校验：这是最关键的一环。生成 .pptx 后，需使用 python -m markitdown 提取文本进行审查，强制 AI 以「找 bug」的视角检查内容完整性、占位符残留和排版错误，直到完成至少一轮完整的修复验证循环。

适用边界与注意点

这个技能是高度结构化的，适合需要批量生成风格统一、内容准确的汇报文档、数据图表或说明书。但它不适合追求复杂动效或高自由度视觉设计的创意场景——技能明确禁止了动画和转场，且只允许纯色填充。

此外，生成的 JS 脚本仅作为参考代码，不会自动执行安装或运行。你需要在本地准备好 PptxGenJS 的运行环境。