用途:codeck 的 @export 通道,负责把已组装的 HTML 幻灯片导出为 PDF/PPTX,并执行导出质检。用户面向的导出请求应通过 /codeck 进入,本模块本身不直接作为用户入口。
主要能力:导出 PDF(Playwright 打印实现所见即所得)、导出 PPTX(优先用 LibreOffice,失败时回退为逐页截图再用 PptxGenJS 嵌入);对 PDF/PPTX 做导出后 QA,包括页数完整、背景渲染、字体显示、元素重叠、文字溢出、间距、对比度等,并与 HTML 原稿比对。
使用方式:先确认已存在组装好的 HTML(./-r.html),否则先运行 /codeck 生成或重建。之后认领工单、确定格式。用户指定“PDF/print/save as PDF”导出 PDF,“PPTX/PowerPoint/slides file”导出 PPTX,“all/both”两者都导;仅说“export”时创建非阻塞决策,默认按 PDF 导出并记录到 MEMORY.md。HTML 只作为预览与源文件,不作为导出选项。发现需改源码的导出缺陷时,不直接改源文件,而是在 threads 中登记并移交给 @design 或 @review。
限制:不得编辑 deck.md、DESIGN.md、custom.css、slides.html、speech.md;仅可写入最终 PDF/PPTX、导出 QA 记录及 roles/tasks/channel 等指定文件。QA 需至少一轮“修复—验证”循环后才可宣布完成。具体安装与运行依赖 Playwright、LibreOffice(soffice)、PptxGenJS、pdftoppm 等,相关路径与脚本由环境变量解析。