scholar-slides 用于把研究论文（或研究主题）转化为保真优先的学术幻灯片。其优先级与普通演示工具相反：来源真实性高于美化，证据高于说服，可编辑性高于炫酷效果。公式、表格、数字、图表和引用保持为真实的文本/矢量，可追溯到原文，不由图像模型栅格化，也不允许虚构。设计依据见 docs/，构建计划见 IMPLEMENTATION_PLAN.md。
技术栈：渲染后端为 reveal.js + KaTeX，输出矢量 PDF（Playwright）与可编辑 PPTX（做一致性校验）；默认幻灯片类型为组会/期刊俱乐部，阅读优先、高密度；引用以 Zotero 优先，Crossref/arXiv/DOI 兜底；双语，默认英文。
不可妥协的完整性闸门始终开启：不得虚构数字、引用或图表，一切须可追溯到来源摘要；数学、表格、引用保持矢量/文本；复用真实图表（按 bbox 裁剪并标注 Figure N [cite]），概念示意图仅在标注“重绘，非来自原文”时允许重画；无法解决的内容输出 [MISSING: …] / [UNVERIFIED: …] 占位符而非静默填充；每个复用资产必须带来源。
流程为 7 个阶段、3 个人工检查点：输入 → 1 摄取/摘要 → [CKPT-1] → 2 幻灯片类型 → 3 大纲 → [CKPT-2] → 4 逐页规格 → 5 渲染 → 6 自审（QA）→ [CKPT-3] → 7 导出。第 1 阶段可运行 scripts/prepare_source.py <pdf|arXiv id|arXiv URL> 生成摘要输入包（含文本、图表清单与 bbox、裁剪图表），再据此合成类型化论文摘要，经用户确认。随后选择类型与受众、时间预算，重排为讲述顺序并配行动式标题，确认故事线。逐页规格为每页一个自包含磁盘文件。渲染按 references 下数学、图表表格、引用、图表绘制、设计系统、导出等文档操作。QA 阶段做完整性扫描、静态校验、渲染截图、叙事与时长检查，并以 6 维评分写入美学报告，对任一维度 ≤2 或总分 <18 的页面返工。检查点 3 做真实性人工签字。导出为矢量 PDF、演讲者备注与可编辑 PPTX，并用 scripts/verify_pptx_parity.py 验证保真。
脚本依赖：Python 通过 ./.venv/bin/python 运行，依赖见 requirements.txt；Node 通过 node 运行，依赖见 package.json，需 npm install 与 npx playwright install chromium。测试用 ./.venv/bin/python -m pytest 和 node --test tests/*.test.mjs。当前未实现 Beamer 导出、扫描版 PDF 的 OCR、草稿幻灯片摄取；答辩/会议类型仅为文档指导，无专用代码。幻灯片须经 CKPT-3 人工真实性签字后才算完成。