前言¶
做培訓課件的人常遇到兩類麻煩：一類是 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」「可雙擊打開/手機預覽/投屏的演示頁」。
核心功能¶
- 先方案後動手：配色、大綱、佈局類型確認後再開始寫代碼，避免一次生成幾十頁後返工。
- 佈局模板化：內置 11 種佈局，按內容類型選模板，而不是每次從零排版。
- 每次只做 2 頁：分批生成，便於逐頁檢查和修改。
- 單文件交付：一個 HTML 走天下，手機、投屏通用，不依賴額外資源。
- 講師工具內置：章節跳轉、計時器、全屏、翻頁動畫、必講/可跳標記。
- 可編輯版增強：改字、改字色、調色、字體字號、插圖、導出 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 的差異）官方資料未逐一說明，建議以官方頁面爲準，不要按第三方教程自行拼接命令。
典型用法¶
- 給觸發詞和內容：例如「把這套培訓大綱整成 PPT，配色用深藍 + 米白」。
- 確認方案：Skill 先給出配色、大綱、佈局類型，確認後再動手。
- 分批生成：每次 2 頁，生成後可逐頁檢查。
- 使用講師工具：在演示頁內使用章節跳轉、計時器、全屏、翻頁動畫，用必講/可跳標記區分重點頁與可跳過的補充頁。
- 按需導出：需要紙質版時運行
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
