技能介绍

做汇报的人常遇到同一件烦心事：内容明明一样，换成 PDF 就排版错乱，做成 PPT 又完全换了一套配色。更麻烦的是，代码里加的颜色、渐变封面，在浏览器里看得很完美，一导出就白底白字，整页消失。

html-report 只解决这一件事：让报告的呈现与交付可控、视觉一致。它不是分析工具，不会替你决定“讲什么、按什么结构写”，而是一个呈现层。你在上游把事实与素材准备好，它负责把它们变成一份自包含的 HTML，再镜像导出为 PDF 或 PPTX。

核心能力

L0-L3 分层流水线：输入 → 版式 → 生成 → 审核，每层职责明确。缺材料时先做分析，不在本技能里凑内容。
设计令牌同源：HTML 用 :root 变量定义配色，PPT 端用 Python 镜像同一套色值，保证“PPT 像 HTML”。改主题只改一处。
单一自包含产物：输出不依赖 CDN 或外链，图表用内联 SVG，便于预览与归档。
直接导出 PDF / PPT：不再外挂独立导出技能，在确认后由本技能完成。

关键步骤

确认输入材料齐全、事实有来源（L0）；
以模板锁定视觉系统（L1），结构参考仅作灵感不强制；
按蓝图生成 HTML（L2）；
交用户预览，明确停下等确认（L3）；
通过后导出 PDF 或 PPTX。

适用边界与注意点

适合“先出一份美观报告页面，再转 PDF/PPT”的场景，或需要人工审核 + 多格式交付的文档。不适用于纯分析/调研，也不适用于需要复杂交互的 Web 应用——那些属于上游或别的工种。

导出前务必检查：HTML 含 *{-webkit-print-color-adjust:exact;print-color-adjust:exact;}，否则深色封面在 PDF 里会失背景；PDF 使用 Playwright page.pdf(print_background=True)，不要用 Edge --print-to-pdf 当主力；中文源路径先复制为 ASCII 临时名再 urllib.parse.quote 编码；PPT 端除 run.font.name 外，还要写 a:ea 东亚字体，否则中文变方框。