PPTX 批量文档生成引擎

手动批量PPT的工程困境

在测评报告等场景中，把Excel数据逐条填进PPT模板是典型批处理任务。人工复制不仅慢，还容易在图表数值、段落评价等环节出错，难以回归验证。

配置驱动的邮件合并

该技能通过JSON配置把Excel列映射到PPT的三类位置：

• 文本占位符：按run精确替换姓名、分数等短值；
• 段落评价：依据关键词与min_length整段替换长文本；
• 图表数据：先--scan获取shape_index和series_name，再按columns顺序写入数值。

流程分三步：--scan扫描模板图表并生成配置片段；--dry-run校验映射是否命中；正式运行时按key_column逐行生成，并用--start、--count控制断点与分片。脚本始终从原始模板加载，不修改模板本身。

边界与注意点

图表只改指定Series的数值，结构、参考线和图例保持不变；文本为精确run级匹配，不支持正则或模糊替换；段落关键词需在同一run内，min_length建议约为预估段落长度的0.6倍。此外，SmartArt内文本、跨幻灯片引用和母版修改不在支持范围，输出格式以python-pptx能力为限。