技能介绍

先说清楚要解决的问题

用 python-pptx 从零写脚本生成 PPT,表面上是几行循环的事,实际坑集中在三处:版式靠手写——每个文本框的坐标、字号、颜色都要自己算,改一次配色等于全文替换;文本会溢出——中文长文本不设 word_wrap = True 就被截断,手写建页与版式函数混用还会出现“页数翻倍”这种隐蔽 bug;流程是断裂的——脚本跑通不等于 PPT 能看,越界、重叠、占位符残留都得逐页检查。这个 skill 刻意不加载 ppt-implement,两者混用会反复弹出 5173 预览服务器的黑窗口。

技能如何工作

输入模式先行判断。 用户给资料(PDF/Word/转写稿)走资料→PPT 模式;给已有 PPTX 且要求保持格式,走扩充模式(复用原 deck 样式常量、set_shape_text 保格式改文字、XML 重排页序),而不是从零重造;只给主题才走常规生成。

需求对齐再动手。 主题、行业、页数(默认 10 页)、风格、配色(6 套通用 + 化工安全)、语言、用途逐项确认;用户不确定时按场景推荐 2-3 套候选,而不是丢一张配色表让人自己选。骨架用“叙事弧”搭:钩子 → 定调 → 主体 → 转折 → 收束。

内容缺口主动检索。 输入太薄时联网补真实数据和案例,禁止编造,无来源数据标注“估算”。

版式函数统一收口。 14 种版式(封面、大数字、时间轴、对比、表格、事件链、原生图表等)内部自带建页,调用它们的页面函数不得再手写 slide(prs)。生成后先跑越界检测脚本,再导出 PNG 逐页检查,做一轮 fix-and-verify 才交付。演讲者备注与逐页口播的演讲稿 MD 同步产出。