技能介绍

为什么程序化生成 PPT 容易翻车

用代码写演示文稿时，常见痛点不是“画不出页面”，而是样式漂移、主题不一致和手动拼装 XML 极易出错。直接操作 XML 往往能改模板，但信息结构与视觉层级稍不注意就会错位；从零生成时，又常遇到排版细节难控。

核心能力与工作流

该技能围绕三条路径展开：读取分析、模板编辑与从零创建。

读取与分析：使用 python -m markitdown 快速抽取现有 .pptx 的文本内容，便于先梳理结构再修改。
模板编辑：通过 editing.md 中的 XML 工作流与格式规则处理模板，而非盲改样式。
从零创建：基于 PptxGenJS 走结构化流程：先调研需求与受众，再选色板、字体和视觉风格（Sharp、Soft、Rounded、Pill），随后把每页归类到 5 种页型之一并规划布局，避免版式重复。
工程化输出：每个页面是独立 JS 文件，导出同步函数 createSlide(pres, theme)，最终由 compile.js 合并生成 .pptx。
设计约束：统一画布 10" x 5.625"，颜色使用不带 # 的六位 hex，中文字体为 Microsoft YaHei，英文为 Arial，并强制通过 theme 对象注入颜色键（如 primary、secondary、bg）。
质量闭环：pitfalls.md 与 QA 流程覆盖常见 API 陷阱，非封面页还需在右下角放置页码标识，位置固定为 x: 9.3", y: 5.1"。

适用边界与注意点

该技能聚焦“生成与编辑”本身，依赖需自行准备，例如 pip install "markitdown[pptx]" 和 npm install -g pptxgenjs。涉及图标时，可选安装 react-icons、react、react-dom、sharp。它不会自动安装依赖或修改系统权限；发送、发布、部署等外部写入动作必须先确认目标与影响。命令和代码默认只作参考，执行前需明确授权并确认作用范围。