pptx-html-fidelity-audit

用途：对由 HTML 幻灯片（通常为含 <section class="slide"> 的单文件 deck）经 python-pptx 导出的 PPTX 做保真度审计，找出并修复版式与内容漂移。需同时具备源 HTML 与导出的 PPTX 两个文件，缺一则不适用。 主要能力：定位常见漂移——页脚溢出、内容越过画布（16:9 下 7.5"）、<em> 斜体丢失、hero 页未垂直居中、文本框外框侵入、标签与配色样式回退。给出严重度分级（🔴 裁切/不可见/越界必改，🟠 层级受损应改，🟡 斜体/字体/颜色偏移本次修，🟢 细微间距记录不阻塞），并归纳 2–3 个系统性根因。 使用方式：五步流程——1) 运行 scripts/extract_pptx.py <path-to.pptx> > pptx_dump.json 提取每个形状的位置、尺寸与逐 run 字体信息；2) 遍历 HTML 幻灯片结构并映射到 PPTX 索引；3) 产出审计表（Slide/Issue/Severity）与根因说明；4) 按页脚栏+光标流纪律重导出，关键常量包括 CANVAS_W=Inches(13.333)、CANVAS_H=Inches(7.5)、MARGIN_X=Inches(0.6)、MARGIN_TOP=Inches(0.5)、CONTENT_MAX_Y=Inches(6.70)、FOOTER_TOP=Inches(6.85)，内容块经 Cursor.take(h) 依次下移并在越界时抛 OverflowError，hero 页用预算居中而非 MARGIN_TOP；斜体通过 add_run(..., italic=True) 显式保留；5) 运行 scripts/verify_layout.py <path-to.pptx> 校验，零违规方可交付。附带 references/layout-discipline.md、font-discipline.md、audit-table-template.md。 适用场景：修复已知或怀疑的 HTML→PPTX 版式漂移，并可纳入 CI（校验脚本违规时返回非零退出码）。 限制：依赖几何校验而非视觉 diff，无法发现位置正确但字形渲染错误的情况，需回退到人工截图复核；斜体仅适用于本身有斜体传统的文字（拉丁、西里尔、希腊），CJK 等强制斜体会产生机械变形；多列仪表盘、图片、图表及字体回退等问题需查阅对应参考资料。其他细节暂未提供。