我把 PPT Master 装进 Codex:一次从 PDF 到可编辑中文 PPT 的真实试用
- 2026-11-09 15:48:23
我把 PPT Master 装进 Codex：一次从 PDF 到可编辑中文 PPT 的真实试用
每次准备组会、文献汇报或教学课件，最耗精力的，往往不只是读懂资料，还有后面的那串操作：拆大纲、找版式、裁图、摆箭头、写讲稿，再反复调整。
这次，我把一个叫 PPT Master 的开源项目装进 Codex，给它一篇论文 PDF，请它做成中文文献周汇报。我的要求很明确：先确认大纲和设计，成稿要能继续编辑，重要的证据边界要留下来。
最后拿到的是一套 18 页 PPTX：16 页汇报正文、2 页备查，带 18 页中文讲稿。
这是一次具体环境、具体资料下的使用记录。配图保留了实际成稿的版式，但姓名、文献主题和未公开研究内容已用占位信息替换。
01｜我为什么想试它
我关心的不是“AI 能不能画出一张好看的幻灯片”，而是拿到文件以后，能不能把一句话改短、把机制箭头移动、把不够严谨的结论改回来。
文献汇报尤其需要这种自由。导师可能追问对照组、样本量、因果证据，也可能要求下一次换一种顺序来讲。如果结果只是一张张铺满页面的图片，后续修改仍然很费劲。
PPT Master 的项目说明将自己定位为由 AI 智能体驱动的演示文稿工作流，目标是生成原生可编辑的 PowerPoint 对象。它由 Hugo He 开发，项目采用 MIT 许可；开源项目免费，并不意味着 AI 模型调用没有成本。项目说明
02｜它怎样和 Codex 配合
可以把我的用法理解成：Codex 负责理解任务、读写文件和执行工具；PPT Master 提供制稿流程、参考规范与导出脚本。
它作为 Skill 安装后，我在对话里明确调用 $ppt-master，再告诉 Codex 资料在哪里、讲给谁听、希望做成什么形式。这次没有在 PowerPoint 里安装一个新按钮，而是在 Codex 里调用了一套制稿工作流。
图 1｜这是根据本次实际步骤绘制的流程示意，不是软件安装界面的截图。
03｜我的安装过程：先装完整技能，再验证依赖
这次本机安装发生在 2026 年 10 月 5 日。安装记录中的技能版本是 v6.6.0，代码固定到当时核对过的一次提交，包含该发布标签之后的主分支更新。因此，下面的试用结果对应这个版本状态，不是对所有未来版本的保证。
我的安装做了四件事：
通过 Codex 的技能安装方式，安装完整的 skills/ppt-master子目录，而不只复制 SKILL.md。为它准备独立 Python 环境。本次使用 Python 3.12.4，把资料转换、图片处理和 PPTX 导出所需依赖放在这个环境中。 增加本机调用提示，让 Codex 使用这套独立解释器运行脚本。 检查技能完整性、依赖导入和主要命令入口。安装记录显示这些检查通过。
这里容易混淆的一点是：安装成功，和做出可用课件，是两次验证。 安装报告当时还写着“未运行 PPTX 生成测试”；后面的文献汇报任务才完成了实际导出和应用打开检查。
如果你也用 Codex，可以把下面这段交给它，要求它按你的操作系统处理安装：
请帮我安装https://github.com/TUANZIDING/ppt-master.git中的 PPT Master Skill。安装完整技能目录，并按项目文档安装 Python 依赖。使用独立环境，记录版本和提交，核对完整性、依赖与导出命令入口。先报告安装验证结果，再用一份公开资料做最小试用；不要覆盖已有技能或课件。
这是一段任务描述，不是已经在所有电脑上测试过的“一键安装命令”。官网入门文档要求 Python 3.10 及以上，并区分技能目录、工作目录与单次项目目录；只安装技能文件后，仍需要安装依赖。官方入门文档
我的安装是技能副本，没有 Git 元数据。后续更新需要核对新版、备份旧技能并重新处理依赖，不能直接在这个技能目录里执行 git pull。
04｜真正开始做 PPT，我先说清楚这几件事
这次我给它的任务是：面向导师的中文文献周汇报，希望采用研究生组会风格，并且先确认方案。
确认后的方向是：16∶9，白底、深蓝标题、青绿重点色；计划约 15 分钟汇报、5 分钟讨论；主要篇幅讲论文证据，最后留出研究启示和导师讨论问题。
我觉得比“帮我做一个漂亮 PPT”更有用的，是这类提示：
使用 $ppt-master，把我提供的 PDF 制作成可编辑中文 PPT，面向导师的文献周汇报。先确认大纲和设计方案。建议约 15 分钟，使用简洁的学术组会风格。中文、数字和证据提示保留为可编辑文本；实验图保留原图，并注明出处。不要把论文结果写成我的实验进展；补充材料没有提供时，明确标注未核验。请附逐页中文讲稿，保存到我指定的目录。
这段提示的重点，是让听众、时间、资料范围和编辑要求一起进入任务。原始 PDF 是素材，大纲和设计方案则决定它最终如何被讲出来。
图 2｜来自本次生成课件的封面版式。个人信息、文献题目及研究主题已替换为占位内容，未改变原来的布局。
05｜试用结果：有帮助，也确实需要返工
这次的成稿没有照搬论文的段落顺序，而是形成了“问题—研究设计—主要证据—机制—局限—讨论”的汇报结构。对我来说，这比把摘要直接拆成几页更接近组会的实际需要。
另一个实用之处是把文字和机制图留在可编辑对象里。下面的示例保留了实际机制页的分支、连线与说明层次，但把具体科研术语改成了占位词。
图 3｜这是由实际生成页面脱敏导出的展示图。公开配图是 PNG；原 PPTX 中的文字、矩形和连线可以继续编辑。图中占位内容不代表任何论文结论。
过程也不是一次导出就结束。实际检查中调整过图表裁剪范围，避免把坐标、标签切掉，也修正过页面对象边界。结构检查能发现一部分问题，图表怎么裁、观众能不能读清，仍需要看实际画面。
最后的核对结果是：
PPTX 共 18 页，其中 16 页正文、2 页备查。 文件含 18 页讲稿，每页都有可编辑文字。 论文实验图以 8 处图片对象呈现，没有把这些图片误写成可编辑数据图。 文件结构及 ZIP 完整性检查通过。 在本机 Keynote 成功打开，抽查了封面、实验图页和机制页。
这次没有做 Microsoft PowerPoint 的实际应用检查，也没有测量完整生成耗时或总费用。因此，我不会把它写成“几分钟完成”“零成本”或“所有软件完全兼容”。
06｜“可编辑”要看具体对象
图 4｜从上到下分别是可编辑对象、保留的图片，以及仍需人工确认的部分。底部列出实测范围。
这一点值得单独说清楚。
这套课件里的中文说明、标题、机制框图和连线，可以继续改。保留下来的论文实验图，仍是图片：可以调整大小和裁剪，但不能直接在 PowerPoint 里改一根柱子的数值、重新计算误差线。
有些对象还位于母版或版式层。如果普通页面中选不到，应进入母版或版式编辑。它们和“整页被压成一张图”不是同一种情况。
本次没有测试自动旁白、复杂对象动画、视频输出，也没有测试数据驱动的原生图表或表格。项目文档列出的功能范围，比我这次验证的范围更大，不能把文档里的能力全部当成我的实测结论。
07｜我会继续用，但这几个边界要守住
第一，学术判断仍由使用者负责。
它可以帮助梳理证据和组织讲法，但“相关”有没有被说成“因果”、细胞结果有没有被扩大到人体、没有提供的补充图有没有被写成已核验，都需要回到原文。导出检查通过，并不代表论文解读已经通过学术审查。
第二，正式汇报前要在自己的演示软件里看一遍。
本机 Keynote 曾提示替换缺少的微软雅黑字体，抽查页面中的中文显示正常。不同电脑的字体和不同软件的效果解释可能有差异，字体、裁剪和换行最好在最终使用环境里确认。官方也提醒，Keynote、WPS 等软件对某些 PowerPoint 动画可能有不同处理。兼容性说明
第三，本地文件处理不等于全程离线。
我这次把项目文件和导出课件保存在本地，但任务仍由 AI 模型驱动。发送给模型的资料，需要按所用服务和机构要求管理；不能因为脚本在电脑上运行，就认为患者数据或未公开研究内容一定不会离开本机。项目自身也将 AI 模型通信与本地处理作了区分。项目说明
这篇公开文章没有附上原始 PDF、原 PPTX、完整对话、系统路径或未公开的研究计划。展示页中的姓名和研究名词也已替换。
08｜如果你也想试，我建议从小任务开始
选一份可以公开使用的材料，先做 5—8 页。告诉它讲给谁、讲多久、哪些内容必须保留。第一次重点看三件事：大纲是否讲得通，原图是否裁得完整，导出的对象是否能改。
对有固定文献汇报、组会或教学课件需求的人，这种方式值得尝试。它比较适合愿意先确认方向、再检查成稿的人；如果期待不读资料、不看输出就直接上台，这次经历并不支持那样使用。
我的实际感受是：它帮我把资料组织和排版的工作推进到了一个能继续修改的版本。接下来能否讲得清楚、经得起追问，依然要靠自己准备。
项目与资料入口
项目：Hugo He / PPT Master — https://github.com/TUANZIDING/ppt-master.git 入门文档：https://github.com/hugohe3/ppt-master/blob/main/docs/getting-started.md 发布版本：https://github.com/hugohe3/ppt-master/releases/tag/v6.6.0
本文根据一次真实安装和制稿记录整理，AI 辅助编辑。涉及界面与能力的描述以本次版本和验证范围为限；配图已脱敏。本文是工具体验分享，不提供医疗诊疗建议。
