研究生偷跑实习、忙着上课和摸鱼，组里方向又不太想投入，但组会论文汇报还得按时交？这个仓库就是为这种场景准备的。

GitHub：https://github.com/moyoo0/paper-to-latex-ppt
求一个免费star🥺

先说背景：论文可以临时看，组会不能临时讲

研究生经常一边实习、上课或做项目，一边还要应付组会论文汇报。导师临时发来一篇 paper，真正需要准备的并不只是摘要，而是一套能顺着讲下去的 PPT：背景、动机、方法、公式、实验、论文原图，以及逐页讲稿。

如果只把论文丢给 AI 让它“生成一份 PPT”，通常又会遇到另一堆问题。

目前直接用 AI 做 PPT，问题在哪里？

我试过一些直接让 AI 生成 PPT 的方式，最大的问题不是内容完全错误，而是最终产物经常“不像一份能拿去汇报的 PPT”。

常见问题包括：

1. 公式显示异常，复杂公式被转成乱码、纯文本，或者干脆消失；
2. 字体、间距和颜色缺少统一风格，页面看起来像自动拼接；
3. 没有论文原图，只有几段泛泛的总结；
4. 页面结构不稳定，有的页文字过密，有的页又空得像草稿；
5. 没有逐页讲稿，上台时还要重新组织语言。

也有一些工具会把内容做成比较适合 AI 生成的 HTML 页面。这类方案在网页展示上很灵活，但组会场景仍然有一个现实问题：讲稿通常没有写入 PowerPoint 备注区。

组会时直接使用 PowerPoint 的演讲者模式，会比一边开网页、一边切换另一份讲稿方便得多。PPT 页面、当前页、下一页和备注区在同一个界面里，才是真正适合临场汇报的工作流。

我做了什么：把论文 PDF 变成能直接讲的 PPT

paper-to-latex-ppt 是一个面向论文组会汇报的 Codex Skill。它的目标不是只做论文摘要，而是把一篇论文 PDF 变成一套完整的交付物：

• LaTeX Beamer 源文件；
• 编译后的 PDF；
• PPTX 文件；
• 逐页中文讲稿；
• 写入 PowerPoint 备注区的最终讲稿版本。

整体流程大致是：

论文 PDF
  -> 提取正文、公式、图片和 caption
  -> 规划组会汇报结构
  -> 生成 LaTeX Beamer
  -> 编译 PDF
  -> 渲染并检查每一页
  -> 修正溢出、过密和公式问题
  -> 导出 PPTX
  -> 生成逐页讲稿
  -> 写入 PowerPoint 备注区

这里使用 LaTeX 生成幻灯片，主要是为了保留公式质量；最后再把 PDF 页面转成 PPTX，方便使用 PowerPoint 的演讲者模式。

效果怎么样？

下面是一次端到端生成的页面效果：

单页示例：

从输入论文到得到一份带备注区讲稿的 PPT，整个流程可以在几分钟内端到端完成，中间不需要人工逐页排版。生成后仍然建议快速检查论文结论、公式含义和实验数字，但最耗时间的“从零开始搭 PPT”已经被自动化了。

安装这个 Skill

最简单的方式，是把 GitHub 地址直接交给 Codex 或其他支持 Agent Skill 的工具：

给我安装下这个 git 链接对应的 skill：
https://github.com/moyoo0/paper-to-latex-ppt.git

如果仓库已经下载到本地，也可以说：

把当前仓库安装成 Codex skill，skill 名称是 paper-to-latex-ppt。

安装运行环境

最推荐的方式不是自己逐项查依赖，而是直接让 AI 根据仓库说明完成安装。

把下面这段话发给 Codex、Claude Code 或其他支持 Agent Skill 的工具：

请安装这个 GitHub 仓库对应的 Skill：
https://github.com/moyoo0/paper-to-latex-ppt.git

请继续检查并安装运行环境：
1. 创建 Python 虚拟环境；
2. 安装 requirements.txt 中的依赖；
3. 检查 latexmk 和 xelatex；
4. 如果缺少 LaTeX，请根据我的操作系统给出安装方案；
5. 运行 scripts/check_environment.py，直到环境检查通过。

AI 可以根据当前操作系统自动判断包管理器、Python 环境、LaTeX 安装位置和 PATH 配置。安装完成后，再输入：

请确认 paper-to-latex-ppt 的环境已经配置完成，并告诉我下一步如何用 paper.pdf 生成带讲稿的 PPTX。

手动安装方式

如果你想自己执行命令，也可以使用下面的备用流程。

创建虚拟环境并安装 Python 依赖：

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt

完整流程需要 pymupdf、python-pptx、pyyaml，以及本地的 latexmk 和 xelatex。

macOS 可以使用 TinyTeX：

curl -fsSL https://yihui.org/tinytex/install-bin-unix.sh | sh
export PATH="$PATH:$HOME/Library/TinyTeX/bin/universal-darwin"

最后检查环境：

.venv/bin/python scripts/check_environment.py

如果看到 Environment looks ready.，就可以开始生成 PPT 了。

怎么使用？

把论文 PDF 放进工作目录，例如：

paper.pdf

然后在 Codex 中输入：

使用 $paper-to-latex-ppt，把 paper.pdf 做成一份中文组会 PPT。
要求 15 页左右。

最终建议优先使用：

final_with_notes.pptx

这个文件已经包含 PPT 页面和备注区讲稿，可以直接用 PowerPoint 演讲者模式打开。

最后

这个项目不能替你真正读懂论文，也不能保证每个实验数字都自动解释正确。但它可以把最耗时间、最容易拖到组会前一晚的部分自动完成：提取论文内容、搭建汇报结构、处理公式和图片、生成 PPT，以及准备逐页讲稿。

如果你也遇到过“明天组会，今晚才开始看论文”，可以试试这个仓库：

GitHub：https://github.com/moyoo0/paper-to-latex-ppt