用途:对幻灯片做一次彻底的视觉布局审计,适用于 Quarto(.qmd)与 Beamer(.tex)两种讲稿。
主要能力:逐页检查五类问题——OVERFLOW(内容超出边界)、FONT CONSISTENCY(内联字号覆盖、字号不一致)、BOX FATIGUE(单页 3 个以上彩色框,INV-7 只允许两个,以及框类型误用)、SPACING(缺少负边距、缺少 fig-align)、LAYOUT(缺少过渡、缺少框定句、语义色)。结果按幻灯片组织,给出严重程度与建议。
使用方式:读取 $ARGUMENTS 指定的幻灯片文件。Quarto 文件先执行 quarto render Quarto/$ARGUMENTS,再运行 "${SLIDE_QA_PYTHON:-python3}" scripts/slide-qa.py Quarto/<deck>.html;该脚本用无头 Chrome 渲染全部片段,输出 quality_reports/audits/slide-qa/<deck>/report.md,含每页超出四边的像素、问题元素、被滚动元素隐藏的内容,以及每页截图,并报告图片损坏或本地文件路径缺失、大小写错误(在 GitHub Pages 上会失效)。若脚本退出码 2(通常是缺 Playwright,脚本会打印一次性的 venv 安装与需设置的 SLIDE_QA_PYTHON 行),说明原因,回退到读取密集页的渲染 HTML 和用户提供的截图,并列出建议用户目视检查的页面。Beamer 文件先编译(见 /compile-latex),检查日志中的 overfull hbox 警告,并读取含图表或密集内容的 PDF 页面。
间距优先原则:先用负边距减少垂直间距,合并列表,把显示公式改为行内,缩小图片/SVG,最后才降字号,且绝不低于 0.85em。
限制:资料未提供具体的严重程度分级标准细节、报告字段完整定义、支持的 Quarto/Beamer 版本范围与性能数据。