HTML幻灯片转PDF讲义

为什么要把 HTML 幻灯片转成 PDF

Reveal.js、Remark、WebSlides 这类基于浏览器的演示文稿，本质上是一套带交互逻辑的网页。你拿到手的通常只有一个 HTML 文件加若干资源，直接发给同事审阅，对方要么在浏览器里跟着点，要么对着滚动截图猜内容。对于需要评审、归档或作为附件分发的流程，这种动态形态并不稳定：换台机器可能样式错乱，隔半年再打开，依赖可能都失效了。

它做了什么

技能的核心是调用 DeckTape，把已有的 HTML 幻灯片作为输入，在无头浏览器环境里完整渲染，再导出两类产物：

• 整本 PDF 讲义：按幻灯片顺序排版，适合打印与归档，内容与在线演示保持一致；
• 逐页截图：每页一张图，适合需要逐页标注、嵌入工单或消息的场景。

流程上大致是：准备 Node.js 与 Chrome/Chromium（或直接用官方 Docker 镜像）→ 用 DeckTape 打开 deck → 等待渲染完成 → 输出 PDF 或截图。对 Agent 工作流来说，它把“打开浏览器看幻灯片”这个手动步骤固化成了可调用的动作，产出物可以直接进入评审队列或归档目录。

适用边界

需要留意的是，该技能没有从上游提取到经过验证的安装与使用说明，用于敏感流程前建议先通读源项目。另外，它处理的是已存在的 HTML deck，不负责从零生成幻灯片；渲染效果取决于原 deck 的写法，复杂动画在静态 PDF 中可能无法体现。