# Heige Ppt

> 演讲锻造系统。把每一页 PPT 讲成一句话，把整套 deck 导成一场演出，而不是把要点堆成一面字墙。 专门用于从零设计有气场、有记忆点、一眼不像 AI 做的演示文稿、汇报 deck、路演 pitch、产品 keynote。 适用场景：创业路演、产品发布、年度复盘、方案提案、技术分享、培训课件、述职汇报、招商招生。 核心方法论：一页一句话 / 黄金三秒 / 节奏编排 / 视觉锤 / 反 AI 体检。 当用户要求"做个 PPT""做套幻灯片""做个路演 deck""做个产品发布 keynote""把这份内容做成演示" "做个汇报""做个提案""把这个做成幻灯片""做个演讲稿配图"时，必须使用此 skill。 输出为单文件 HTML 幻灯片：16:9、键盘翻页、可投屏可导出 PDF，可选带演讲者模式（演讲者屏备注 + 观众屏同步），且默认带可编辑层，用户打开就能在浏览器里直接改幻灯片文字、再导出 PDF 或下载独立 HTML。动手前先定调，出货前过反 AI 体检。 需要给客户一份能在 PowerPoint / WPS 里直接改的 .pptx 时，用内置的 html2pptx 转换器把同一份 HTML 设计源转成可编辑 PPTX，一份设计两种格式，不用做两遍。 注意：本 skill 负责"从零设计有气场的演示 deck"；如果是做单张落地页/网页界面，那是 heige-ui 的活； 如果是把现成文档转成静态展示长页，那是 html-beautifier 的活。

- Skill: `heigeai/heige-ppt` (Agent Skill, multi-file: 40 files)
- Install (CLI): `npx get-skill add heigeai/heige-ppt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/heigeai/heige-ppt/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: heigeai (https://skillmd.com/u/heigeai)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/heigeai/heige-ppt

---


# HeiGe-PPT（演讲锻造系统）

PPT 不是写出来的，是讲出来的。

大多数 AI 做出来的 deck，是把要点堆成一面字墙：标题 + 三个 bullet，一页接一页，母版一个调子到底。投到屏幕上，观众一边听你念，一边走神。讲完了，一页都记不住。

HeiGe-PPT 换一种做法：**把每一页讲成一句话，把整套 deck 导成一场演出。** 每一页只有一个观点、一个主角、一个让人记住的瞬间。讲完之后，观众能复述出你的主线，记得住你那几页。

这套方法论的目标只有一个：**让你做出的 deck 有气场、有记忆点、站在台上敢讲、讲完有人记得。**

---

## 招牌内核：导一场演出，不是排一摞幻灯片

做 deck 之前，先想清楚一件事：**观众从第一页到最后一页，你想带他走一段什么样的路、最后让他做一个什么动作？**

排幻灯片的思维问的是「这次汇报要讲哪几块内容」。导演出的思维问的是「主线是什么、高潮在哪、观众走的时候记住了哪一句、要他干什么」。

五道工序，是这套思维的具体落地。每套 deck 都要过一遍。

### 1. 一页一句话（One Sentence per Slide）

每一页只讲**一个**观点，这个观点能用一句话说清楚。

- 一页只有一个主角观点。讲不完的，拆成两页，别挤在一页里。
- 反对「标题 + 三个 bullet + 每个 bullet 两行字」这种字墙。那是发给人看的文档，不是站在台上讲的 deck。
- 一个判断：如果这一页的内容你没法用一句话概括，说明这页没想清楚，回去拆。
- 正文是给你讲的，不是给观众读的。观众读字的时候就不听你讲了。字越少，注意力越在你身上。

> 自检：把每一页的核心观点抄成一句话，连起来读一遍。如果这串句子本身就是一条清楚的主线，deck 的骨架就立住了。

### 2. 黄金三秒（The 3-Second Rule）

每一页投出来，观众扫一眼，**3 秒内**要 get 到这页要说什么。

- 每页有且只有一个视觉主角：一句大字、一个大数字、一张大图、一个对比。其余全部退后。
- 主角要够大、够狠。台下最后一排也能看清，才算合格。投影仪不是显示器，字号要敢往大了上。
- 信息层级靠尺寸和位置拉开，不靠颜色堆。一页里别有三个东西在抢「我最重要」。

### 3. 节奏编排（Deck Pacing）

整套 deck 像一场演出，有起承转合：**开场抓人 → 摆出痛点 → 给出转折 → 论证铺陈 → 推向高潮 → 收束行动**。

- 不要每一页一个调子、一个版式。那是模板套壳，不是演出。
- 不同功能的页面要有不同的视觉重量：封面页立气场，金句页留白给冲击，数据页给密度，过渡页给喘息，收尾页给行动。
- 强页之后给一页轻的，让观众喘口气、消化。连续五页全是密集数据，观众就睡了。
- 收尾要干脆：一个明确的行动号召，或一句记得住的话。别用「谢谢聆听」四个字草草收场。

各类 deck 的节奏模板见 `references/deck-pacing-templates.md`。

### 4. 视觉锤（Visual Hammer）

最关键的几个观点，每个配一个**让人记住的视觉**，把观点像钉子一样砸进观众脑子。

- 可以是：一个超大数字、一张强对比图、一个比喻图形、一条让人倒吸气的趋势线、一句占满整屏的宣言。
- 视觉锤不需要多，整套 deck 有三五个就够。但你最想让人记住的观点，必须有一个。
- 纯文字的页面记不住。能用一个数字、一张图、一个图形说清楚的，就别用一段话。

> 自检：讲完合上电脑，问自己「观众最可能记住哪三页」。答得上来，且那三页正好是你最想传达的，视觉锤就到位了。

### 5. 反 AI 体检（Anti-Slop Check）

出货前，强制过一遍体检，把「AI 味」和「字墙味」扼杀在上台前。

最常见的烂 deck 特征（命中任何一条都要回去改）：
- 标题 + 三个等长 bullet，整套 deck 每页都这个结构
- 母版套壳：每页一样的版式、一样的配色、一样的节奏，从头平铺到尾
- 一页塞两三个观点，没有单页焦点
- 通篇纯文字，没有一个视觉锤，没有一页能被记住
- 字小、行密，台下最后一排看不清
- 用 emoji 当图标撑场面、用「谢谢聆听」草草收尾

完整清单见 `references/anti-slop-checklist.md`。**这一步不是可选的，是交付门槛。**

---

## 使用流程

### 第一步：定调（动手前必做）

写任何代码之前，先和用户对齐三件事。根据平台能力选合适的交互方式：

**问题 1：这套 deck 是什么场景、讲给谁、要他们干什么？**
- 场景：创业路演 / 产品发布 / 年度复盘 / 方案提案 / 技术分享 / 培训课件 / 述职汇报……
- 观众：投资人 / 客户 / 老板 / 同行 / 学员？他们在意什么、最烦什么？
- 行动：讲完你要他们做什么？投钱、签单、点头、记住一个概念？这决定收尾页。

**问题 2：气质方向？**（从 `references/aesthetic-directions.md` 选一个**极端**方向，别选「商务简约」这种正确的废话）
- 凶悍/工业、优雅/高定、克制/极简、科技/未来、张扬/极繁、温暖/人文……

**问题 3：有没有硬约束？**
- 必须包含的内容、品牌色、字体、页数范围、是否要导出 PDF、是否要演讲备注？

如果用户说「你定」，就**自己拍一个大胆的方向**，动手前用一句话告诉他你定了什么，给他喊停的机会。定调一次到位，别反复问。

### 第二步：搭主线（写每页一句话）

定好调，先把内容拆成「一页一句话」的主线：
- 列出每一页的核心观点，每个观点一句话。
- 把这串句子连起来读，确认它本身就是一条清楚、有起伏的主线。
- 这一步是骨架，骨架不对，做得再好看也是散的。

### 第三步：编排节奏，定视觉锤

- 按节奏曲线给每页定功能：哪页封面、哪页痛点、哪页高潮、哪页收尾。
- 标出最关键的三五个观点，给每个想一个视觉锤（大数字 / 对比 / 图形 / 宣言）。

### 第四步：写生产级代码

按 `references/deck-production-spec.md` 的硬规格做，要点：
- **单文件 HTML**，16:9 幻灯片，一次一页，零依赖（除 Google Fonts）。
- **键盘翻页**：← → 和空格翻页，可加页码和进度指示。
- **中文字体必须有系统兜底**（PingFang SC / Microsoft YaHei），Google Fonts 挂了也不崩。
- **可导出 PDF**：每页对应一页，打印友好。
- 字号往大了上，台下最后一排能看清；字体做性格，别用系统默认裸奔。
- **可编辑**：成品默认带上可编辑层（把 `references/editable-layer.md` 里的 script 块贴在 `</body>` 前），用户打开点「编辑」就能在浏览器里直接改幻灯片文字，改完导出 PDF 或下载独立 HTML；放映模式下方向键翻页和打字不打架，工具栏不进 PDF。
- **要拿到现场讲的 deck，加现场演示层**（`references/live-show-layer.md`）：全屏按钮 + F 键、示例截图点击放大（lightbox 打开时接管键盘不翻页）、观众一键复制提示词、现场跳转大按钮。培训课、发布会、带观众动手的分享，这层是标配。
- **一个人对着投影仪讲，加演讲者层**（`references/presenter-mode.md`）：跑一条 `node scripts/inject-presenter.mjs 你的deck.html` 就装上。演讲者屏看备注 + 下一页预览 + 计时，台下屏只显示当前页；带激光笔、圈选、观众屏黑屏/冻结、宫格跳页、排练记录。备注写在 `SPEAKER_NOTES` 里，按 `data-slide-id` 存，重排页面不串页。
- **三层都装时的顺序只能是：可编辑层 → 现场演示层 → 演讲者层。** 现场演示层要把「全屏」挂进可编辑层建的 `.he-toolbar`，得排在它后面；演讲者层启动时就要抓完整的 `.slide` 列表和 `window.__heDeck` 钩子，排最后。装反的后果：现场演示层找不到工具栏会自建一条 `.he-showbar`，页面上多一条悬浮工具条。
- **给 deck 留一个翻页出口**：在翻页脚本里加 `window.__heDeck = { get index(){ return i; }, go: show, slides };`（变量名换成你自己的）。演讲者层靠它精确翻页；没有这行也能用，但预览会比主屏慢一拍。

### 第五步：反 AI 体检 + 试讲复检

出货前强制自检：
1. 过一遍 `references/anti-slop-checklist.md`，命中的全部干掉。
2. 试讲复检：每页能一句话讲清吗？3 秒能看懂吗？主线连贯吗？有几个视觉锤？最后一排看得清吗？
3. 任何一项不过关，回去改，别交。

### 第六步：双格式交付（按接收方选格式，可选）

设计永远走 HTML：HTML 拿得到最好的字体（思源宋体 / 衬线）和最自由的排版，是你做设计、自己投屏、导高清 PDF 的源。

但客户不一定会用浏览器编辑器。**客户要自己改字改价，就再给一份 PPTX**——用内置转换器把同一份 HTML 转成可编辑 PPTX，每个文字都是原生文本框，PowerPoint / WPS 打开就能改。

```bash
npm --prefix scripts install         # 首次：装 pptxgenjs + playwright-core
node scripts/html2pptx.js 你的deck.html 你的deck.pptx
```

转换器在无头 Chromium 里读 deck 的真实渲染几何（位置 / 字号 / 颜色 / 对齐），映射成 PPT 文本框、色块、线条，对任意 HeiGe-PPT deck 通用（读几何，不认版式 class）。

**一条要诚实告诉用户的边界**：SVG 框架图、CSS 渐变 / 纹理这类复杂图形，PPT 原生画不出来，转换器会把它们转成同位置的图片嵌进 PPT（不可在 PPT 里编辑），并在控制台明确提示哪几处。需要在 PPT 里编辑这些图，就用 PowerPoint 形状重画，或保留 HTML 版作为该图的可编辑源。宁可诚实降级，不硬转出一个崩的图。

**选格式的判断**：客户要自己改 → 交 PPTX；你要最高视觉、自己投屏 / 导 PDF → 用 HTML。要稳就两份都给。

---

## 设计资产（references/）

- `aesthetic-directions.md`：气质方向库。每种气质给出色彩 / 字体 / 排版 / 封面 / 视觉锤的具体打法。
- `deck-pacing-templates.md`：节奏曲线模板。路演 / 产品发布 / 复盘 / 提案 / 分享各类 deck 的页面节奏排布。
- `deck-production-spec.md`：单文件 HTML 幻灯片的硬规格（尺寸 / 翻页 / 字体兜底 / 导出 / 性能），照着做不踩坑。
- `anti-slop-checklist.md`：反 AI 体检清单。出货前逐条过。
- `editable-layer.md`：可编辑层。一段拖进 `</body>` 前就生效的 script，让成品在浏览器里直接改幻灯片文字、导出 PDF/HTML，放映翻页和打字不打架、工具栏不进打印。
- `live-show-layer.md`：现场演示层。全屏按钮 + F 键、截图点击放大 lightbox、一键复制提示词、现场跳转按钮，全部不进打印。可与可编辑层共存（自动挂进同一条工具栏）。
- `presenter-mode.md`：演讲者模式。演讲者屏（当前页 + 下一页预览 + 备注 + 计时 + 宫格）与观众屏（只显示页面）分开，带激光笔、圈选、黑屏白屏冻结、排练记录、三通道同步与断线恢复。纯本地、零依赖，用 `Shift+P` 进入。

## 工具（scripts/）

- `html2pptx.js`：双格式交付转换器。把一份 HeiGe-PPT 单文件 HTML deck 转成可编辑 .pptx。零配置、自动探测系统已装的 Chrome / Chromium，跨 mac / Linux / Windows。用法见上方「第六步」。
- `inject-presenter.mjs`：一条命令给 deck 装上演讲者层（补页面身份、插备注骨架、贴运行时），幂等可重跑。
- `validate-presenter-mode.mjs`：静态校验演讲者层装对没有、备注字段齐不齐、总时长有没有超。
- `test/presenter.test.js`：注入器回归测试，CI 会跑（`npm --prefix scripts test`）。
- `test/e2e-presenter.mjs`：演讲者层的浏览器实测，手动跑，要本机 Chrome。

## 成品参考（examples/）

同一套方法论，跨场景、跨气质能产出完全不同的 deck。以下样例均用本方法论现场锻造，可直接打开、键盘翻页：

- `heige-pitch.html`：HeiGe-PPT 自己的产品路演 deck。凶悍/工业气质。
- `product-keynote.html`：AI 产品发布会 keynote。科技/未来气质（赛博霓虹）。
- `darktech-keynote.html`：Agent 编排控制台 HELM 发布会。科技/未来气质（碳黑电绿，当代 AI SaaS）。**装了演讲者层**，12 页备注可直接照着讲。
- `annual-review.html`：团队年度复盘。克制/数据气质。
- `consulting-proposal.html`：给客户的方案提案。优雅/高定气质。
- `campus-talk.html`：一场技术分享演讲。张扬/人文气质。**装了演讲者层**，11 页备注，跨版式验证用这份。

---

## 一句话总结

**别人把要点堆成一摞幻灯片，你把观点导成一场演出。一页一句话，讲完有人记得。**

