research-presentation 用于把论文或研究资料做成听众能理解、核查和讨论的演示文稿,核心是“论文到幻灯片且不丢失证据”:保留原意、采用累积式叙事、确保图表可读、限定论断范围,并交付带备注与渲染质检记录的可编辑幻灯片。它覆盖从来源检查到最终幻灯片质检的流程,但不替代作者的科学判断,不编造结果,也不擅自强化论断。
用途与路由:输入为 PDF、论文或手稿时走完整论文转幻灯片流程,需先阅读 references/paper-extraction.md;输入为研究笔记、表格、图表或实验方案时走证据驱动流程,对无支撑字段做标记而非填补;输入为已有 PPTX 时先检查源幻灯片,再走同样的渲染与质检循环;只有演示简报而无来源文档时跳过提取,但仍创建论断台账、叙事大纲、来源与素材说明及视觉质检;仅要求改样式时先诊断现有幻灯片,保留科学内容与引用。构建前需推断一句话目标:到结束时,[受众]应[理解/决定/讨论],因为[有证据支撑的核心结论]。仅在缺失选择会实质改变幻灯片时提一个阻塞性问题,否则做保守假设并写入运行日志。
不可妥协的约定:证据优先,规划前先读来源,不使用无法追溯到所提供来源或明确引用的图表、数字、表格单元格、引用、机制或局限;论断有界,保留人群、场景、时间范围、比较、不确定性与论断强度,区分作者结论与讲者解读并标明后者;每页一个叙事任务,用结论式标题回应上一页提出的问题;每页内容配一个视觉锚点,用可读的原始图表、有意义的指标或忠实于来源的简单示意图;可读优先于完整,正文起步 12 pt(下限 11 pt),标题 28–32 pt,封面标题 40–56 pt,低于 11 pt 字符不超过全篇 10%,宁可加页或删减也不缩字;处处有来源锚点,每页内容带 Fig. 2、Table 1、§3.2 或 p. 7 等可见锚点,备注包含 [Sources] 块;避免仅栅格化交付,优先原生可编辑的文本、表格、形状和图表,必要时用源图但保持宽高比并提供原始素材或来源映射;交付前渲染每一页最终幻灯片,检查全尺寸页面并运行溢出、覆盖、字体检查,修复重叠、裁剪、换行、拉伸图表和空占位符。
论文转幻灯片流程:一、清点与提取,记录输入文件、目标受众、语言、场合、时长、预期页数、输出格式与可用工具,一次性提取全文,按顺序建立证据台账,含作者陈述的研究问题、空白、假设与贡献,研究设计、数据、样本、基线、参数与分析步骤,每个有意义的数量及其单位、比较、方向与来源指针,每个图表展示内容、读法与关键面板,局限、效度威胁、未定义术语与超出范围的论断,以及区分作者判断与讲者综合的论断。PDF 可用环境中的 PDF 工具或 PyMuPDF 提取;有图表无损提取工具时使用,否则记录降级方式并从渲染页裁剪且不改数据。二、选择演讲契约,按场合定弧线:期刊俱乐部/组会用问题→空白→模型或方法→最强证据→局限→讨论问题;会议报告用问题→贡献→方法→结果→启示;学位答辩用问题→研究计划→方法→逐项贡献证据→局限→未来工作;研讨或教学用动机示例→概念→验证证据→应用→回顾。默认 12 页内容页,12 分钟报告通常 10–14 页,证据无法保持可读时加页。三、构建幽灵大纲,设计前每页写一行,如封面、问题、机制、证据(多页)、验证、边界、综合、讨论,并规定叙事标题、一句话结论、证据锚点、视觉锚点、备注目的与观众下一步行动,删除重复摘要和泛化的“方法/结果”标题。四、选择视觉系统与版式,先读 references/themes.md 和 references/layouts.md,整篇用一个主题,按内容形状选版式,不虚构机构标识、隶属、数据集、图表或缺失图,图不可用时只做基于来源关系的清晰标注的结构重建。五、构建可编辑幻灯片,使用宿主演示流程并保持可复现,将生成源码、提取证据、图表清单与构建日志放在幻灯片旁,源图按原生宽高比使用,短引用放可见页脚,完整 [Sources] 放入备注。六、渲染与审计,把最终 PPTX 渲染为 PDF 及每页 PNG,依赖可用时运行:python scripts/render_slides.py deck.pptx --outdir rendered 和 python scripts/audit_pptx.py deck.pptx --rendered rendered --report qa-report.json,全尺寸检查每页,修复溢出、裁剪、重叠、标题换行、字号过小、图表拉伸模糊过小、缺少来源锚点或备注页码占位符、视觉覆盖不足或大片空白、重复卡片网格等问题,每次实质修复后重新渲染,不得用未检查最新渲染文件的审计声称幻灯片干净。
输出契约:宿主支持时返回主可编辑 .pptx,并附 deck.pptx、deck.pdf、rendered/slide-01.png 等、evidence-ledger.md 或 extraction.md、deck-outline.md、speaker-notes.md(备注无法嵌入时)、source-map.md、qa-report.json 或 qa-report.md、run-log.md。若缺少必要能力,交付可行的安全产物并明确说明未产出内容,绝不把仅截图方案当作可编辑 PPTX。
内置资源包括 references/themes.md(六种学术主题、令牌、框架与标志性构图)、references/layouts.md(主题中立版式配方与密度指南)、references/paper-extraction.md(提取、图表、数量与来源锚点契约)、references/narrative-planning.md(受众、弧线、幽灵大纲与备注指导)、references/qa-contract.md(渲染、溢出、可读性、覆盖与来源检查)、references/rendering.md(跨平台字体、PDF/PNG 渲染与可编辑输出边界)、scripts/render_slides.py(安装 LibreOffice/Poppler 时的薄封装)与 scripts/audit_pptx.py(确定性的结构与渲染文件检查)。