lit-report-ppt

文献汇报 PPT

一句话：给一篇论文 PDF，默认一次出三份产物 —— 一份能上台讲的中文组会汇报 PPT、一份对着每页念的 Word 讲稿、一份双色的答辩预测问题与答案 HTML。不用单独多说一句，走这个 skill 就三份一起交。

前两份同源于一个 content.json，所以幻灯片上写的和嘴里讲的不会打架。第三份（答辩预测问答）另用一份 qa.json，同样从这篇论文里来。版式和设计参数是从一份真实的组会汇报稿逐形状量出来的实测值，不是凭感觉设的。

不依赖任何特定 AI 平台 —— 底下就是几个普通 Python 脚本，有 shell 能跑 python 的地方就能用。答辩问答那份是纯 HTML，双击就能在浏览器里看。

答辩预测问答的硬要求（和你给的成品一致）：十题左右、每题都有答案；问题蓝、答案绿；只要「问题 + 直接答案」两栏，不加考察内容、不写解析；答案 ≤30 字（字母/符号/化学式不限），言简意赅；提问要覆盖「为什么选这个来做 / 国内外哪里做得多 / 能否换成别的做、进而勾出它们的性质」；排版整齐。详见 SKILL.md「答辩预测问答」一节。

---

它能做到什么

组会文献汇报的流程是固定的：封面 → 论文首页截图 → 摘要精读 → 实验条件 → 合成方法 → 一张张主图配图注 → 结论 → 致谢。每次都要重做一遍，真正费时间的不是排版，是「图注写全」和「别把化学式上下角标打错」。

这个仓库把这两件事变成脚本：

| 你担心的 | 它怎么处理 |

|---|---|

| 图注偷懒，写「如图所示」 | 图注少于 40 字、缺子图交代 → 自检直接报错 |

| 图注太长，塞不进版面 | 按实际行数算，放不下就开续页，续页仍带同一张图 |

| 图注太短，图被压小 | 短注走底栏满宽排法，长注才走右栏 |

| 化学式上下角标 | 写 Cr^{3+}、Cs_{2}NaInCl_{6}，脚本转成真上下标 |

| 元素跑出画面被切 | 逐页扫描出界、重叠、字体缺失、字号越级 |

| 讲稿像念论文 | 讲稿按「一张图两三句、学术但不堆术语」的口径写 |

| 答辩被问到答不上来 | 默认再出一份双色问答 HTML：十题左右、每题都配答案，问题蓝、答案绿，只给一句 ≤30 字的直接答案，不加考察内容 |

一篇论文进，三份产物一起出（默认）。 答辩预测问答是第三份，和 PPT、讲稿用同一套论文材料，但单独一份 qa.json、单独一步渲染，不碰前面两个产物。它只出 HTML（双色表格），不出纯文本。除非你明确说「这次不要问答」，否则三份必须一起交。

---

长什么样

下面这些是从同一篇 Mo³⁺ 掺杂钙钛矿论文做出来的成品截图，人名统一换成了 XX。封面和致谢上的校徽、两行校名是默认值（南阳师范学院物理与电子工程学院），自用要换成自己的 —— 具体改哪三处见下面「改成你自己的学校」。

PPT（挑 5 张典型页）

| | |

|---|---|

| | |

| 封面：标题 + 汇报人 / 时间 | 摘要页：五条要点，纯文字版式 |

| | |

| 短图注走底栏满宽：图 + 底栏一行注 | 长图注走右栏：图缩到左侧，注单独一列 |

| | |

| 结论页：四条并列 | |

源文件也给了：examples/示例.pptx（13 页）和 examples/示例讲稿.docx（5 页）就是上面截图的那两份，直接打开能改文字、换图、调版式，不用从零跑一遍脚本。想按自己的论文重做一份，还是走下面「用」的四步。

> 图里的人名是 XX、时间是 2026年11月11日，都是 --presenter / --date 传进去的占位值，跑一遍换成自己的即可。校徽和校名是默认值，自用要换（见「改成你自己的学校」）。论文图来自 Wiley 期刊，这里只作版式示例。

Word 讲稿（全文 5 页，缩到和上面 PPT 截图一样大）

讲稿按页写，一页 PPT 一段话，末尾带各页目标秒数与合计。它和 PPT 同源于一个 content.json，所以不会讲串。五页全留，但缩成两列缩略图放在这一节末尾，点开看大图 —— 竖页直接铺开一张占一屏，太占地方。

| | |

|---|---|

| | |

| 讲稿 P1 | 讲稿 P2 |

| | |

| 讲稿 P3 | 讲稿 P4 |

| | |

| 讲稿 P5 | |

答辩预测问答（双色 HTML，12 题）

问题蓝、答案绿，斑马纹表格，每题只给一句 ≤30 字的直接答案，没有考察点、没有解析。双击 examples/答辩预测问题.html 就能在浏览器里看，examples/qa.json 是可改的源数据。

> 这份 HTML 的颜色、表格宽度、字号、上下角标和空行都是 build_qa.py 照着成品逐字排的，改样式常量就会和它对不上。

---

安装

pip install -r requirements.txt

就这四个依赖：python-pptx、python-docx、Pillow、pymupdf（pypdf 兜底）。

手动用这一套不需要 git、不需要 Node、不需要 Office。

> 如果你是 DSH 用户、想从插件市场装（dsh plugin add AshenSeeker/lit-report-ppt）：仓库里多带了一个 package.json + cordis.patch.yml + lib/index.js，那是给 DSH 宿主注册这个 skill 用的登记表，跑在宿主侧、需要 Node 22+。它不碰出稿脚本 —— 出稿还是上面那四个 Python 依赖，跟手动装法一模一样。

---

用

四步走

# 1. 抽正文、摘要、图注
python scripts/extract_paper.py paper.pdf -o work/