findscripter python-pptx 幻灯片生成
何时使用
用户想要一段直接可运行的 Python 脚本，用 python-pptx 自动生成 .pptx 演示文稿（标题、目录、要点、总结俱全），常见于 demo、教学、内部简报场景。
不该用的边界：
- 要读取/编辑已有
.pptx（解析、改样式、抽内容）—— 不是本技能职责。 - 只要精细排版/视觉设计（自定义坐标、母版、动画）—— python-pptx 能力有限，别硬凑不存在的 API。
- 产物不是幻灯片而是 Word/文档 —— 改用文档类技能（见互见）。
步骤 / 指令
- 收集简报：确认主题、受众、语气、目标页数。缺失项就取保守默认值（如 5～6 页），并在脚本注释里写明所选默认。
- 先列叙事骨架，再写代码。标准弧：① 标题页 → ② 目录/背景 → ③ 核心论点（教学或业务）→ ④ 总结/下一步。页数贴合受众，砍掉凑数页，通常压到 4～8 页。
- 生成完整脚本，必须做到：
from pptx import Presentation（注意包名导入是pptx，pip 装的是python-pptx）；- 创建 deck、选用内置版式（layout）；
- 写真实标题与要点，不留占位符；
- 用清晰文件名显式
prs.save("output.pptx")； - 保存后
print一句成功提示。
- 保证可运行：输出一个完整 Python 代码块，装好
python-pptx即可跑。禁止伪代码、占位符、缺失 import 或需要用户自行补全的残片。
示例
安装：pip install python-pptx
最小可运行骨架：
from pptx import Presentation
from pptx.util import Pt
prs = Presentation()
# 1. 标题页（layout 0 = Title Slide）
slide = prs.slides.add_slide(prs.slide_layouts[0])
slide.shapes.title.text = "机器学习入门"
slide.placeholders[1].text = "面向高中课堂 · 5 页速览"
# 2. 内容页（layout 1 = Title and Content）
def add_bullets(title, bullets):
s = prs.slides.add_slide(prs.slide_layouts[1])
s.shapes.title.text = title
body = s.placeholders[1].text_frame
body.text = bullets[0]
for b in bullets[1:]:
p = body.add_paragraph()
p.text = b
add_bullets("什么是机器学习", ["从数据中学习规律", "无需逐条硬编码规则", "预测 / 分类 / 聚类"])
add_bullets("核心概念", ["特征与标签", "训练集与测试集", "过拟合与泛化"])
add_bullets("常见例子", ["垃圾邮件识别", "图片分类", "推荐系统"])
add_bullets("小结", ["数据驱动 ≠ 魔法", "好数据胜过复杂模型", "下一步：动手跑一个小例子"])
prs.save("ml_intro.pptx")
print("已生成 ml_intro.pptx")
需求示例：
- 「5 页机器学习基础，面向高中课堂」→ 标题页 / 概览 / 核心概念 / 例子 / 回顾。
- 「7 页给销售管理层讲 Q2 管道风险与缓解」→ 高管口吻标题 + 精炼要点 + 末页建议。
注意事项
- 优先用内置 layout（
slide_layouts[0]/[1]…），除非用户明确要自定义定位。 - 写受众适配的真实要点，不要占位文字；标题简短，层级清晰。
- 别堆页数：超出受众需要的就压缩到最重要的 4～8 页（除非用户明确要长版）。
- 必收尾：每个脚本都要以
prs.save(...)+ 成功 print 结束，别忘存盘。 - 安全：只在你掌控的环境（如本地 venv）装
python-pptx；在共享机上选安全输出路径，避免无确认覆盖已有文件；含敏感/专有内容时不要写进公开示例和示例文件名。 - 不要臆造 python-pptx 不支持的样式 API；拿不准就先核实其能力边界。
互见
- related：
markdown-to-docx—— 当产物应是 Word 文档而非幻灯片时改用它。 - combines_with：
docs-architect—— 先用它规划内容/叙事结构，再交本技能生成 deck。
采编自 sickn33/antigravity-awesome-skills（MIT）。