Thesis Defense PPTX Skill

一个用于生成本科/研究生毕业论文答辩 PPT 的 Codex/Agent Skill。它面向需要严格复用本地 PowerPoint 模板的场景，能够从本地论文 PDF/LaTeX 项目和指定 .pptx 模板出发，生成可编辑的正式答辩 PPTX，并执行逐页导出、版式检查和文字溢出检查。

English README

一分钟看效果

仓库自带最小可跑示例 examples/minimal_markdown/，在仓库根目录跑：

python examples/minimal_markdown/run_example.py

脚本会现场生成模板、可编辑 PPTX、dump 结构、scan 旧词，并输出 PPT 总览图。下面四张参考图来自一份真实的郑州大学开题/答辩 PowerPoint 模板，但画面不是模板原页截图，而是 thesis.md 示例内容被生成进模板后的 final.pptx 渲染结果：

生成示例 slides 1-4 总览

生成示例 slides 5-8 总览

封面细节

方法页细节

这些图通过 --template 指定本地真实模板生成：
python examples/minimal_markdown/run_example.py \
    --template <你的本地模板.pptx> \
    --detail-slides "1,6"
--template 模式会调用 build_deck.py --real-template：不清空真实模板里的复杂 shape，而是在模板页面上覆盖 thesis.md 生成的示例内容，输出真正可编辑的 final.pptx。README 图片来自 PowerPoint COM 对这个生成后 deck 的真实渲染；每页右上角的 Generated from thesis.md 标记用于避免和模板原页截图混淆。

该示例不依赖 Microsoft PowerPoint，因此 macOS / Linux / Windows 都能跑通。真实交付仍建议在 Windows + PowerPoint 下走 COM 导出和文字溢出检查。

功能

从本地论文 PDF/LaTeX 项目中提取论文内容和候选图表。
尽量保留已有 PowerPoint 模板的封面、字体、字号、配色、导航、卡片样式和页面比例。
输出真实可编辑的 .pptx 文件，而不是图片型幻灯片。
使用 PowerPoint COM 导出逐页 PNG，便于视觉检查。
生成整套 PPT 的总览图，快速发现版式问题。
使用真实 PowerPoint 渲染结果检查文字框溢出风险。
检查旧模板文字、占位词、TODO 等残留内容。

为什么需要这个 Skill

很多 AI PPT 工具擅长从文档重新设计一套新风格 PPT。但毕业论文答辩经常有相反的需求：学校或学院已经给了 .pptx 模板，封面、校徽、郑大红配色、顶部导航、卡片式正文、字体大小都不希望被改掉，只需要把论文内容转成适合答辩展示的表达。

本 Skill 针对的正是这种“严格套用现成模板”的工作流：

把用户提供的 .pptx 模板作为视觉基准。
优先复制模板中的原生页面，再替换内容。
尽量保持封面、章节页、导航条、卡片样式、字体字号、颜色和页面比例。
将论文段落转写为正式、简洁、适合答辩讲述的页面内容。
使用真实 PowerPoint 导出结果做逐页检查，而不是只检查文件能否生成。

与 `ppt-master` 的对比

ppt-master 是一个优秀的开源项目，主打从 PDF、Word、Markdown、网页等资料生成原生可编辑 PPTX。它更适合从资料出发重新生成一套 AI 设计的可编辑 PPT。

本 Skill 的目标更窄：生成毕业论文答辩 PPT，并尽量严格沿用用户已有的 PowerPoint 模板。

维度	`ppt-master`	`thesis-defense-pptx`
核心目标	从资料生成原生可编辑 PPTX	在保留现有模板的基础上生成答辩 PPTX
适用场景	新建 AI 设计风格 PPT、文档转 PPT、可编辑 SVG/DrawingML 流程	本科/研究生答辩、学院模板、实验室模板、品牌学术汇报
模板处理	可以参考或创建模板，但整体偏生成式设计	直接复制用户原始 PPTX 模板页并在其上替换内容
对既有模板的还原度	取决于模板导入和生成效果	作为最高优先级处理
输出形态	可编辑 PPTX	可编辑 PPTX
质量检查	SVG/project 检查和导出流程	PowerPoint 导出 PNG、总览图检查、文字溢出检查、旧模板词扫描