前言¶

做培训课件的人常遇到两类麻烦：一类是 PPT 文件在教室电脑、手机、投屏上表现不一致；另一类是 AI 一次产出一整份几十页的 HTML，配色、大纲、布局都没确认，改起来比手写还慢。Mo HTML PPT 针对的就是这两件事——它把「先定方案再写代码」做成流程，把常见布局做成模板，最后只交付一个 HTML 文件。

下面介绍这个 Skill 的定位、能力和使用边界。版本号与功能点均来自官方页面（截至 v1.6.0），未做延伸。

这是什么¶

Mo HTML PPT 是一个社区 Skill，坐标 @user_57b302d0/mo-html-ppt，发布者 user_57b302d0，分类 office-efficiency，无需 API Key。它解决的问题是：用 AI 生成单文件 HTML PPT 课件时，把配色、大纲、布局、讲师工具、可编辑性一次性对齐，产出物是一个能双击打开、能投屏、能在手机上预览的 HTML。

它面向企业培训、课程、汇报、演讲场景，触发词包括「做 HTML PPT」「生成课件/幻灯片/演示页」「把 XX 整成 PPT」「按 XX 配色做 PPT」「网页版 PPT」「可双击打开/手机预览/投屏的演示页」。

核心功能¶

1. 先方案后动手：配色、大纲、布局类型确认后再开始写代码，避免一次生成几十页后返工。
2. 布局模板化：内置 11 种布局，按内容类型选模板，而不是每次从零排版。
3. 每次只做 2 页：分批生成，便于逐页检查和修改。
4. 单文件交付：一个 HTML 走天下，手机、投屏通用，不依赖额外资源。
5. 讲师工具内置：章节跳转、计时器、全屏、翻页动画、必讲/可跳标记。
6. 可编辑版增强：改字、改字色、调色、字体字号、插图、导出 PDF。

版本演进¶

• v1.3.0：新增 scripts/gen_pdf.py，一键 1:1 PDF 导出。内置 Chromium 导出时几类常见坑（渐变不渲染、类冲突、不居中、越界）的防坑处理，并用 pymupdf 自动校验。模板层补充 @media print 纯色兜底，修复 .gold、.q 的白框问题。
• v1.4.0：新增「线上录播课 PPT 规范」，要求去掉时长标注、页码、讲师必讲/快讲徽章；新增 playwright 逐页溢出检测法，比较 scrollHeight 与 clientHeight。
• v1.5.0：新增「课件配套 Prompt 速查手册」方法：从 HTML 提取 pre-box 中的 Prompt → 组装手册 → 同步到腾讯文档。MDX 规则为：代码块用 Callout 承载，行内强调用 Mark bold，创建后 read 验证无 Unsupported。
• v1.6.0：线上录播课规范新增第 4 条硬规则「场景编号按模块内计数」——每门课的场景从 ① 开始，禁止全系列连续编号；常见坑补充 replace_all 链式误伤。

安装与启用¶

官方页面未列出独立的安装命令，该 Skill 以通用 SKILL.md 格式提供，坐标为 @user_57b302d0/mo-html-ppt。在支持 SkillHub 的客户端中通过坐标引用后，用自然语言触发，例如「按这套配色做一份 PPT」或「把这份大纲整成 HTML PPT」。

具体安装方式（Cursor / Codex CLI / Claude Code 的差异）官方资料未逐一说明，建议以官方页面为准，不要按第三方教程自行拼接命令。

典型用法¶

1. 给触发词和内容：例如「把这套培训大纲整成 PPT，配色用深蓝 + 米白」。
2. 确认方案：Skill 先给出配色、大纲、布局类型，确认后再动手。
3. 分批生成：每次 2 页，生成后可逐页检查。
4. 使用讲师工具：在演示页内使用章节跳转、计时器、全屏、翻页动画，用必讲/可跳标记区分重点页与可跳过的补充页。
5. 按需导出：需要纸质版时运行 python scripts/gen_pdf.py 导出 1:1 PDF，脚本会用 pymupdf 校验结果。

适用场景与注意¶

适合：企业培训、课程、汇报、演讲，尤其是需要一份文件在教室电脑、手机、投屏间通用的场景；以及录播课需要「去讲师痕迹」的课件。

注意：
- 线上录播课规范要求去时长标注、去页码、去讲师必讲/快讲徽章，场景编号按模块内从 ① 开始，不是全系列连续编号。
- 溢出检测依赖 playwright 的 scrollHeight 与 clientHeight 比较，环境里需要可用的 playwright。
- PDF 导出依赖 scripts/gen_pdf.py 与 pymupdf；Chromium 的渐变、类冲突、居中、越界等坑已内置处理，但不同 Chromium 版本仍可能有差异。
- 同步腾讯文档的 MDX 规则需要遵守：代码块用 Callout，行内强调用 Mark bold，创建后 read 验证无 Unsupported。
- 官方页面未提供安装命令与各客户端差异，使用前以官方页面为准。

结尾¶

Mo HTML PPT 的价值在于把「先方案后动手、布局模板化、每次只做 2 页、单文件交付」这几条规则固化进 Skill，让 AI 生成的课件在配色、布局、讲师工具、可编辑性上保持一致。它不追求一次产出几十页的炫技，而是让一份 HTML 能直接上课、投屏、改字、导出 PDF。

官方地址：https://api.skillhub.cn/user_57b302d0/mo-html-ppt