Skip to content
Back to search

thesis-defense-pptx-skill

Codex / Claude Skill for editable thesis-defense PPTX from PDF or LaTeX while preserving a PowerPoint template. 从论文 PDF / LaTeX 生成可编辑答辩 PPTX,并保留指定 PPT 模板风格。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zouchenzhen-thesis-defense-pptx-skill/badge.svg)](/listings/zouchenzhen-thesis-defense-pptx-skill)

HTML

<a href="/listings/zouchenzhen-thesis-defense-pptx-skill"><img src="/api/listings/zouchenzhen-thesis-defense-pptx-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 257 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Thesis Defense PPTX Skill
  2. 一个用于生成本科/研究生毕业论文答辩 PPT 的 Codex/Agent Skill。它面向需要严格复用本地 PowerPoint 模板的场景,能够从本地论文 PDF/LaTeX 项目和指定 `.pptx` 模板出发,生成可编辑的正式答辩 PPTX,并执行逐页导出、版式检查和文字溢出检查。
  3. [English README](README.en.md)
  4. ![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)
  5. ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)
  6. ![Python](https://img.shields.io/badge/python-3.10%2B-3776AB.svg)
  7. ![Skill](https://img.shields.io/badge/skill-Codex%20%2F%20Agent-orange.svg)
  8. ![Output](https://img.shields.io/badge/output-PPTX-D24726.svg)
  9. [![Available on CodeGuilds](https://img.shields.io/badge/Available_on-CodeGuilds-6366f1)](https://codeguilds.dev/packages/thesis-defense-pptx-skill)
  10. ---
  11. ## 一分钟看效果
  12. 仓库自带最小可跑示例 [`examples/minimal_markdown/`](examples/minimal_markdown/),在仓库根目录跑:
  13. ```bash
  14. python examples/minimal_markdown/run_example.py
  15. ```
  16. 脚本会现场生成模板、可编辑 PPTX、dump 结构、scan 旧词,并输出 PPT 总览图。
  17. 下面四张参考图来自一份**真实的郑州大学开题/答辩 PowerPoint 模板**,但画面不是
  18. 模板原页截图,而是 `thesis.md` 示例内容被生成进模板后的 `final.pptx` 渲染结果:
  19. ![生成示例 slides 1-4 总览](examples/minimal_markdown/expected/generated_overview_01.png)
  20. ![生成示例 slides 5-8 总览](examples/minimal_markdown/expected/generated_overview_02.png)
  21. ![封面细节](examples/minimal_markdown/expected/detail_slide_01.png)
  22. ![方法页细节](examples/minimal_markdown/expected/detail_slide_06.png)
  23. > 这些图通过 `--template` 指定本地真实模板生成:
  24. >
  25. > ```bash
  26. > python examples/minimal_markdown/run_example.py \
  27. > --template <你的本地模板.pptx> \
  28. > --detail-slides "1,6"
  29. > ```
  30. >
  31. > `--template` 模式会调用 `build_deck.py --real-template`:不清空真实模板里的
  32. > 复杂 shape,而是在模板页面上覆盖 `thesis.md` 生成的示例内容,输出真正可编辑
  33. > 的 `final.pptx`。README 图片来自 PowerPoint COM 对这个生成后 deck 的真实
  34. > 渲染;每页右上角的 `Generated from thesis.md` 标记用于避免和模板原页截图混淆。
  35. > 该示例不依赖 Microsoft PowerPoint,因此 macOS / Linux / Windows 都能跑通。
  36. > 真实交付仍建议在 Windows + PowerPoint 下走 COM 导出和文字溢出检查。
  37. ## 可下载模板
  38. 仓库现在提供一个之前使用过的郑州大学中期答辩空白模板:
  39. - [zhengzhou-university-midterm-blank-template.pptx](examples/templates/zhengzhou-university-midterm-blank-template.pptx)
  40. 这个文件适合作为 `--template` 输入测试模板保真流程。学校模板、校徽、字体和其他素材的使用授权仍需使用者自行确认;正式提交前建议优先使用所在学院或学校发布的最新版模板。
  41. ## 功能
  42. - 从本地论文 PDF/LaTeX 项目中提取论文内容和候选图表。
  43. - 尽量保留已有 PowerPoint 模板的封面、字体、字号、配色、导航、卡片样式和页面比例。
  44. - 输出真实可编辑的 `.pptx` 文件,而不是图片型幻灯片。
  45. - 使用 PowerPoint COM 导出逐页 PNG,便于视觉检查。
  46. - 生成整套 PPT 的总览图,快速发现版式问题。
  47. - 使用真实 PowerPoint 渲染结果检查文字框溢出风险。
  48. - 检查旧模板文字、占位词、TODO 等残留内容。
  49. ## 为什么需要这个 Skill
  50. 很多 AI PPT 工具擅长从文档重新设计一套新风格 PPT。但毕业论文答辩经常有相反的需求:学校或学院已经给了 `.pptx` 模板,封面、校徽、郑大红配色、顶部导航、卡片式正文、字体大小都不希望被改掉,只需要把论文内容转成适合答辩展示的表达。
  51. 本 Skill 针对的正是这种“严格套用现成模板”的工作流:
  52. - 把用户提供的 `.pptx` 模板作为视觉基准。
  53. - 优先复制模板中的原生页面,再替换内容。
  54. - 尽量保持封面、章节页、导航条、卡片样式、字体字号、颜色和页面比例。
  55. - 将论文段落转写为正式、简洁、适合答辩讲述的页面内容。
  56. - 使用真实 PowerPoint 导出结果做逐页检查,而不是只检查文件能否生成。
  57. ## 与 `ppt-master` 的对比
  58. [`ppt-master`](https://github.com/hugohe3/ppt-master) 是一个优秀的开源项目,主打从 PDF、Word、Markdown、网页等资料生成原生可编辑 PPTX。它更适合从资料出发重新生成一套 AI 设计的可编辑 PPT。
  59. 本 Skill 的目标更窄:生成毕业论文答辩 PPT,并尽量严格沿用用户已有的 PowerPoint 模板。
  60. | 维度 | `ppt-master` | `thesis-defense-pptx` |
  61. |---|---|---|
  62. | 核心目标 | 从资料生成原生可编辑 PPTX | 在保留现有模板的基础上生成答辩 PPTX |
  63. | 适用场景 | 新建 AI 设计风格 PPT、文档转 PPT、可编辑 SVG/DrawingML 流程 | 本科/研究生答辩、学院模板、实验室模板、品牌学术汇报 |
  64. | 模板处理 | 可以参考或创建模板,但整体偏生成式设计 | 直接复制用户原始 PPTX 模板页并在其上替换内容 |
  65. | 对既有模板的还原度 | 取决于模板导入和生成效果 | 作为最高优先级处理 |
  66. | 输出形态 | 可编辑 PPTX | 可编辑 PPTX |
  67. | 质量检查 | SVG/project 检查和导出流程 | PowerPoint 导出 PNG、总览图检查、文字溢出检查、旧模板词扫描 |
  68. 如果你想从资料生成一套全新的可编辑 PPT,`ppt-master` 更合适;如果你已经有学校模板,并且要求“封面、配色、导航、卡片风格都别乱改”,本 Skill 更合适。
  69. ## 工作原理
  70. 本 Skill 采用保守的本地生成流程:
  71. 1. 读取论文 PDF、LaTeX 项目和可选旧版答辩 PPT。
  72. 2. 提取研究背景、问题定义、方法设计、实验设置、实验结果、结论和候选图表。
  73. 3. 分析用户提供的 `.pptx` 模板,包括封面、目录、章节页、导航、字体、字号、颜色、卡片和间距。
  74. 4. 在可用时使用 PowerPoint COM 复制模板原生页面,生成稳定的 PPT 骨架。
  75. 5. 用可编辑的 PowerPoint 文本框、图片、表格和图形替换内容。
  76. 6. 导出逐页 PNG,生成整套 PPT 的总览图。
  77. 7. 检查文字溢出、旧模板词残留、图片缺失、导航错误和明显视觉问题。
  78. 8. 根据检查结果继续修复,直到达到交付标准。
  79. ## 版权与 `ppt-master` 关系说明
  80. 本仓库不是 `ppt-master` 的 fork,不内置 `ppt-master`,也没有复制 `ppt-master` 的源代码。当前实现是围绕 PowerPoint COM、`python-pptx`、Pillow 和 PDF/文本提取工具编写的一组独立脚本。
  81. README 中引用 `ppt-master` 是为了说明相关开源项目和适用场景差异。若未来版本直接复用 `ppt-master` 的代码,应按照其 MIT License 明确保留对应源码文件和版权/许可声明。
  82. 使用者需要自行确认其论文文本、实验图、学校模板、校徽、字体和第三方素材具备合法使用权限。仓库中的历史空白模板仅作为示例资源提供,不代表学校或学院官方发布版本。
  83. ## 仓库结构
  84. ```text
  85. skills/
  86. └── thesis-defense-pptx/
  87. ├── SKILL.md
  88. ├── agents/
  89. │ └── openai.yaml
  90. ├── references/
  91. │ └── pptx_quality_gate.md
  92. └── scripts/
  93. ├── clone_template_deck.ps1
  94. ├── dump_pptx_content.py
  95. ├── export_pptx_png.ps1
  96. ├── extract_thesis_context.py
  97. ├── inspect_pptx_overflow.ps1
  98. ├── make_contact_sheet.py
  99. ├── pptx_template_tools.py
  100. └── scan_pptx_text.py
  101. ```
  102. ## 环境要求
  103. - 推荐在 Windows 上使用。
  104. - 如果需要完整质量检查,需要安装 Microsoft PowerPoint。
  105. - Python 3.10 或更高版本。
  106. - Python 依赖:
  107. - `python-pptx`
  108. - `Pillow`
  109. - `PyMuPDF` 或 `pypdf`
  110. 安装依赖:
  111. ```powershell
  112. python -m pip install python-pptx Pillow PyMuPDF pypdf
  113. ```
  114. ## 当前输入支持范围
  115. 当前内置提取脚本主要支持 PDF 文本提取、LaTeX `.tex` 章节提取和候选图表扫描。Word `.docx` 提取尚未实现。Markdown 和纯文本文件可以由 Agent 在需要时手动读取参考,但 `extract_thesis_context.py` 目前还不会把它们解析成结构化论文上下文。
  116. ## 本地安装
  117. 将 Skill 复制到 Codex skills 目录:
  118. ```powershell
  119. Copy-Item -Recurse -Force `
  120. .\skills\thesis-defense-pptx `
  121. "$env:USERPROFILE\.codex\skills\thesis-defense-pptx"
  122. ```
  123. 然后新开一个 Codex 会话,直接提出生成答辩 PPT 的需求,或明确说明:
  124. ```text
  125. 使用 thesis-defense-pptx skill。
  126. ```
  127. ## 推荐流程
  128. 1. 从论文 PDF/LaTeX 项目中提取研究背景、方法、实验和结论。
  129. 2. 分析用户提供的 PowerPoint 模板。
  130. 3. 使用 PowerPoint COM 复制模板原生页面,生成 PPT 骨架。
  131. 4. 将论文内容转写为答辩口径,填入可编辑文本框、表格和图表。
  132. 5. 导出每页 PNG。
  133. 6. 生成总览图并进行视觉检查。
  134. 7. 检查文字溢出和旧模板词残留。
  135. 8. 根据检查结果反复修复,直到通过质量门槛。
  136. ## 常用命令
  137. 提取论文上下文:
  138. ```powershell
  139. python .\skills\thesis-defense-pptx\scripts\extract_thesis_context.py `
  140. --input "D:\path\to\thesis-project" `
  141. --output "D:\path\to\thesis_context.md"
  142. ```
  143. 导出整套 PPT 的形状/文本/表格/图片清单(推荐在做任何内容替换前先跑一次,把精确字符串复制到替换字典里):
  144. ```powershell
  145. python .\skills\thesis-defense-pptx\scripts\dump_pptx_content.py `
  146. --pptx "D:\path\to\skeleton.pptx" `
  147. --output "D:\path\to\dump.md"
  148. ```
  149. 可以加 `--slide 4,8,9` 只 dump 指定页,便于迭代调试。
  150. 导出 PPTX 为逐页 PNG:
  151. ```powershell
  152. powershell -NoProfile -ExecutionPolicy Bypass `
  153. -File .\skills\thesis-defense-pptx\scripts\export_pptx_png.ps1 `
  154. -Pptx "D:\path\to\deck.pptx" `
  155. -OutDir "D:\path\to\visual_check" `
  156. -Width 1600 -Height 900
  157. ```
  158. 检查文字溢出:
  159. ```powershell
  160. powershell -NoProfile -ExecutionPolicy Bypass `
  161. -File .\skills\thesis-defense-pptx\scripts\inspect_pptx_overflow.ps1 `
  162. -Pptx "D:\path\to\deck.pptx" `
  163. -Tolerance 40
  164. ```
  165. 生成总览图:
  166. ```powershell
  167. python .\skills\thesis-defense-pptx\scripts\make_contact_sheet.py `
  168. --input "D:\path\to\visual_check" `
  169. --output "D:\path\to\contact_sheet.png"
  170. ```
  171. ## 说明
  172. 除 `examples/templates/` 中提供的历史空白模板示例外,本 Skill 不内置固定 PPT 模板。它的目标是尽量复用用户提供的模板,而不是强行套用通用设计风格。
  173. ## 许可证
  174. 本项目采用 [Apache License 2.0](LICENSE) 开源许可。
  175. Apache-2.0 允许使用、修改、分发、私有使用和商业使用,但需要遵守许可证条款。
  176. 项目的商业化方向不是限制核心 skill 的使用,而是围绕服务、定制模板适配、托管流程、企业支持、模板包和自愿赞助来实现可持续发展。详见 [COMMERCIAL.md](COMMERCIAL.md)。
  177. ## 社区
  178. [LINUX DO — 中文开发者社区](https://linux.do/)
  179. ## Star History
  180. 如果有用的话,给个 ⭐ 吧!
  181. [![Star History Chart](https://api.star-history.com/svg?repos=zouchenzhen/thesis-defense-pptx-skill&type=Date)](https://star-history.com/#zouchenzhen/thesis-defense-pptx-skill&Date)
  182. 本项目认可并感谢 LINUX DO 社区在中文开发者开源交流、项目分享和技术讨论中的价值。除非社区另有明确说明,此处仅为社区致谢和链接,不代表官方背书。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.