make-slides

制作幻灯片

将一篇已接收（或接近完成）的论文转化为会议演讲幻灯片—— Beamer .tex 或 Marp Markdown。以问题为先展开叙事，每张幻灯片只呈现一个 主张，使用论文自身的图，并将幻灯片数量控制在演讲时长允许的范围内。幻灯片是交付成果；按时间安排、逐字撰写的演讲稿和问答演练是独立技能（write-talk-script、 rehearse-qa）。

适用场景

• 论文已被接收，即将进行演讲：制作幻灯片。
• 用户有明确的演讲时长（“12 分钟演讲加 3 分钟问答”、“5 分钟闪电演讲”），需要制作时长合适的幻灯片。
• 现有幻灯片过长、文字过多，或仍沿用论文结构，需要精简成演讲形式。

相关技能：write-talk-script（为幻灯片撰写按时间安排的演讲稿）、 rehearse-qa（模拟严苛或好奇的问答）、make-poster（海报 + 2 分钟／5 分钟推介）、study-exemplars（了解该会议上优秀论文如何 阐述贡献）、verify-citations（核查幻灯片中出现的任何引用）。

输入

• 论文的主 .tex 文件（首选——可从源文件提取图），或 PDF 及图文件。
• 演讲时长和问答时长，由会议的演讲者说明或录用邮件提供。这是该技能无法自行查询的信息：会议资料不会记录演讲时长（每年、各分会场都可能变化）。如果用户不知道，请暂停并询问——参见 references/venue-timing.md。
• 可选：venues/conferences/<id>.yml，用于了解会议信息（名称、分会场、实时网址）。在用户依赖资料中的信息前，请根据实时的 cfp_url／会议网站再次核实。
• 输出格式选择：Beamer（LaTeX 工具链，可原样复用矢量图）或 Marp（Markdown，快速迭代，图必须为 PNG／SVG）。选择指南：references/deck-formats.md。

流程

1. 确认演讲时长，再规划幻灯片数量

与用户确认演讲分钟数和问答分钟数（主动询问；绝不可凭记忆或会议资料断言演讲时长——常见时长安排和核查清单见 references/venue-timing.md）。然后在 仓库根目录运行：

python3 skills/make-slides/scripts/slide_budget.py --minutes <slot> --qa <qa> \
    [--format auto|full|lightning] [--venue-profile venues/conferences/<id>.yml] [--json]

它会给出内容幻灯片的目标数量（每分钟演讲时间约 1 张，硬性上限为 1.25 倍），并按以问题为先的结构分配各部分的时间和幻灯片数量，适用于完整演讲形式（12–20 分钟）或闪电演讲形式（≤ 7 分钟）。将此分配作为故事板骨架。

2. 清点并提取论文中的图

python3 skills/make-slides/scripts/extract_figures.py path/to/main.tex \
    --copy-to talk/assets [--json]

它会跟踪 \input／\include，解析 \graphicspath，并根据正文引用次数为每张图排序——引用最多的图通常是演讲的核心。它还会统计表格环境：表格几乎不会原样放进幻灯片；请将每个表格重新设计为图表或单个重点数字。仅使用 TikZ 绘制的图（没有图形文件）必须重新编译，或从论文 PDF 中截取。

如果幻灯片将使用 Marp，请立即将提取的 PDF 转换为 PNG／SVG（命令见 references/deck-formats.md）；Marp 无法渲染 PDF 图片。

3. 故事板：问题优先，每张幻灯片只表达一个论点

使用 references/narrative-storyboard.md，将论文内容映射到演讲时长预算的各个部分。以下要求不可妥协：

• 问题优先：开场要说明问题为何重要，而不是罗列提纲或按论文的章节顺序展开。这场演讲是为论文做宣传，而不是压缩论文内容。
• 每张幻灯片只表达一个论点：每张幻灯片的标题都必须是一句完整的陈述——即使观众什么都不看，也应该记住的那句话（“LRU 会淘汰突发访问即将再次用到的图块”，而不是“背景”）。用证据（一个图、一组数字）支撑标题；尽量不使用项目符号。
• 幻灯片上的数字和论断必须来自论文或用户，绝不能编造、凑整或外推。幻灯片中展示的任何引用文献都必须先经过 verify-citations。
• 证明、次要消融实验和相关工作细节放到最后一张幻灯片之后的备用幻灯片中；这些内容不占用时长预算。

将故事板写成列表（幻灯片标题论点、支撑视觉内容、演讲时长约为多少秒），并在起草幻灯片之前让用户确认。

4. 起草幻灯片

根据已获批准的故事板，使用 references/deck-formats.md 中的模板制作幻灯片：

• Beamer：使用 aspectratio=169，以论点作为帧标题，通过 \includegraphics 重用论文 PDF，在 \note{} 中添加演讲者备注占位符，并在 \appendix 之后添加备用帧。
• Marp：在 front matter 中使用 marp: true，以论点作为 #/## 标题，仅使用 PNG/SVG 图片，在 `` 注释中添加演讲者备注占位符，并将备用幻灯片标题设为 Backup: ...。

将幻灯片和资源写入论文旁边的 talk/ 目录（或用户指定的位置）；未经确认，绝不覆盖已有的幻灯片文件。

5. 检查、修复，再次检查

python3 skills/make-slides/scripts/deck_lint.py talk/slides.md|slides.tex \
    --minutes <SPEAKING minutes = slot - Q&A> [--strict] [--json]

确定性检查：演讲节奏是否符合时长、内容过多的幻灯片（超过 100 个单词就成了文档，而不是幻灯片）、项目符号是否过多、标题是否笼统而非论点、图片文件是否缺失、Marp 无法渲染的 PDF 图片，以及 Beamer 字体是否过小。修复所有 RISK，并反复运行检查，直到没有 RISK；如果演讲时长不合适，就删减或合并幻灯片来解决，绝不能计划讲快一点。

6. 确认构建成功，再交付

如果工具链可用，则编译幻灯片（Beamer 使用 latexmk -pdf，Marp 使用 Marp CLI；命令见 references/deck-formats.md）；否则明确说明未进行编译。交付幻灯片、图片清单和检查报告，并提醒用户使用 write-talk-script 为讲稿计时，并在演讲前使用 rehearse-qa。提醒用户根据会场的演讲者说明，再次确认演讲时长、会场宽高比以及是否需要预先录制。

输出

• talk/slides.md（Marp）或 talk/slides.tex（Beamer）——根据指定演讲时长，通过 deck_lint.py 检查且无 RISK，包含演讲者备注占位符和备用幻灯片。
• talk/assets/——幻灯片使用的论文图片，由 extract_figures.py 提取（并转换为 Marp 可用格式）。
• 幻灯片时长预算和图片清单，作为记录删减内容及原因的依据。

防护措施

• 绝不为幻灯片编造结果、数字或比较；每张图和每个数字都必须能追溯到论文或用户。尚未确定的结果必须明确标注 [RESULT] 占位符，并在交付说明中指出。
• 绝不伪造幻灯片引用；任何引用都必须经过 verify-citations。
• 绝不凭记忆或根据会场资料断言演讲时长、会场规格或录制规则——演讲者说明和录用邮件才是准确信息；任何未经确认的内容都必须标记为 UNVERIFIED。
• 绝不将其他论文的幻灯片或文本打包或粘贴为模板；范例研究只会通过 study-exemplars 临时进行。
• 绝不代表用户将幻灯片上传或提交到任何地方。