HeiGe-PPT

HeiGe-PPT

演讲锻造系统 | Forge the talk, don't pile up slides

PPT 不是写的，是讲的。

这是什么 • 方法论 • 样例画廊 • 快速开始 • 使用指南

这是什么 What is this

让 AI 做出有气场、有记忆点、敢拿上台讲的演示 deck。

你肯定见过那种 PPT：标题加三个 bullet，一页接一页，母版一个调子到底。投到屏幕上，观众一边听你念一边走神。讲完了，一页都记不住。因为 AI 只是把要点堆成一面字墙。

HeiGe-PPT 不这么干。它把每一页讲成一句话，把整套 deck 导成一场演出：每页只有一个观点、一个主角、一个让人记住的瞬间。讲完之后，观众能复述出你的主线。

它不是又一个模板套壳，而是一套从真实场景里磨出来的方法论：

• ✅ 五道锻造工序，每套 deck 都要过一遍
• ✅ 六种极端气质，每种都给到能直接上手的打法
• ✅ 反 AI 体检清单，把字墙味摁死在上台前
• ✅ 生产铁律内置：16:9、键盘翻页、中文不崩、能导出 PDF
• ✅ 打开就能改：成品自带可编辑层，点「编辑」在浏览器里直接改幻灯片文字，再导出 PDF 或下载独立 HTML，放映翻页和打字不打架
• ✅ 六套跨场景样例，同一套方法论，做出完全不同的 deck
• ✅ 零依赖单文件，到处都能用

适用场景：创业路演、产品发布、年度复盘、方案提案、技术分享、培训课件、述职汇报、招商招生。

支持平台：Claude Code、Cursor、Windsurf、Cline、Aider、OpenClaw、Hermes、ChatGPT、Claude.ai 等。

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

为什么需要它 Why this matters

核心方法论 五道锻造工序

做 deck 之前先想清楚：观众从第一页到最后一页，你想带他走一段什么样的路、最后让他做什么动作？排幻灯片的思维问「要讲哪几块」，导演出的思维问「主线是什么、高潮在哪、走的时候记住哪一句」。

🗣 01 一页一句话 One Sentence per Slide

每页只讲一个观点，能用一句话说清。讲不完的拆成两页，别挤成字墙。

⏱ 02 黄金三秒 The 3-Second Rule

每页投出来，观众扫一眼 3 秒 get 到重点。一页一个视觉主角，字号往大了上，最后一排看得清。

🎬 03 节奏编排 Deck Pacing

整套像一场演出：开场抓人 → 痛点 → 转折 → 论证 → 高潮 → 收束行动。封面、金句、数据、过渡、收尾各有版式，别一个母版到尾。

🔨 04 视觉锤 Visual Hammer

关键观点配一个让人记住的视觉，像钉子砸进脑子。大数字、强对比、一句占满屏的宣言。整套三五个就够，但必须有。

🔍 05 反 AI 体检 Anti-Slop Check

出货前强制过一遍：还是标题加三 bullet 吗？母版套壳吗？有没有一页能被记住？命中任何一条都回去改。这是交付门槛。

完整方法论与使用流程见 SKILL.md。

样例画廊 Gallery

同一套方法论，六种场景气质，做出六套完全不同的 deck。每套都是现场锻造的零依赖单文件，16:9、键盘 ← → 翻页、Cmd+P 默认横版导出 PDF。点开任意预览图即可看在线 Demo。

也可以本地预览：

git clone https://github.com/HeiGeAi/HeiGe-PPT.git
cd HeiGe-PPT && python3 -m http.server 8755
# 浏览器打开 http://localhost:8755/examples/

翻页：← → 或 空格；回首页 Home，到末页 End；Cmd/Ctrl + P 导出每页一张的 PDF。

导出可编辑 PPTX（给客户改）

HTML 是你做设计、自己投屏、导高清 PDF 的源。客户要自己改字改价，再给一份 PPTX：

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

转换器读 deck 的真实渲染几何，转成 PowerPoint / WPS 能直接编辑的原生文本框、色块、线条，对任意 HeiGe-PPT deck 通用，自动用系统已装的 Chrome / Chromium。SVG 框架图这类复杂图形 PPT 画不出来，会转成图片嵌入并在控制台提示。要自己改 → 给 PPTX；要最高视觉 → 用 HTML；要稳 → 两份都给。

快速开始 Quick Start

方法 1：支持 Skill 系统的平台（推荐）

适用于 Claude Code、Cursor、Windsurf、Cline：

git clone https://github.com/HeiGeAi/HeiGe-PPT.git ~/.claude/skills/heige-ppt

然后直接说：

用 HeiGe-PPT 做套创业路演 deck，气质凶悍一点
把这份内容做成产品发布 keynote
帮我做个年度复盘，数据要能讲

方法 2：作为 System Prompt 使用

适用于 ChatGPT、Claude.ai、Aider、OpenClaw、Hermes：

1. 下载本仓库的 SKILL.md
2. 将内容粘贴到 AI 助手的 system prompt 或自定义指令中
3. 直接对话使用，无需特殊命令

使用指南 Usage Guide

HeiGe-PPT 会带你走完整个锻造流程：

1. 定调：先确认这套 deck 是什么场景、讲给谁、要他们干什么，再挑一个气质方向。
2. 搭主线：把内容拆成「一页一句话」，连起来读，确认是一条清楚的主线。
3. 编排节奏定视觉锤：按节奏曲线给每页定功能，标出最关键的三五个观点配视觉锤。
4. 写生产级代码：16:9 单文件、键盘翻页、中文带字体兜底、可导出 PDF，字号往大了上。
5. 反 AI 体检：出货前过一遍体检清单，字墙味全部干掉，敢拿上台才交付。

场景示例

做一套创业路演

用 HeiGe-PPT 给我做一套 SaaS 创业路演 deck，给投资人看，气质要硬

把文档变成能讲的 deck

这份方案太长了，用 HeiGe-PPT 帮我做成一套能上台讲的提案

指定气质方向

用 HeiGe-PPT 做个产品发布 keynote，走科技未来风

平台兼容性 Platform Compatibility

HeiGe-PPT 本质是一套让 AI 把 deck 讲清楚、做漂亮的方法论，不绑定任何工具的文件系统或插件能力。只要这个 AI 能写代码，它就能用 HeiGe-PPT。 平台之间的差别只有两点：怎么装，以及输出怎么拿到。

输出是单文件 HTML 幻灯片，浏览器打开即可投屏，Cmd+P 导出 PDF，不依赖任何运行时。

提示：深度打法都在 references/ 里。支持 skill 的平台会按需自动读取；纯贴 prompt 的平台，把 SKILL.md 和 references/ 一起贴上，方法论最完整。

项目结构 Project Structure

HeiGe-PPT/
├── SKILL.md                        # Skill 主文件：方法论 + 使用流程
├── references/                     # 设计资产
│   ├── aesthetic-directions.md     # 六种气质方向库（每种给到具体打法）
│   ├── deck-pacing-templates.md    # 五类 deck 的节奏曲线模板
│   ├── deck-production-spec.md     # 单文件幻灯片硬规格（生产铁律）
│   ├── anti-slop-checklist.md      # 反 AI 体检清单（交付门槛）
│   ├── editable-layer.md           # 可编辑层（浏览器里直接改幻灯片文字 + 导出的 drop-in 代码）
│   └── live-show-layer.md          # 现场演示层（全屏 / 截图点击放大 / 一键复制提示词的 drop-in 代码）
├── examples/                       # 同一套方法论 × 六种场景气质
│   ├── heige-pitch.html            # 凶悍/工业 · 产品路演
│   ├── product-keynote.html        # 科技/未来 · 发布会 keynote（赛博霓虹）
│   ├── darktech-keynote.html       # 科技/未来 · 暗色 AI（碳黑电绿 · HELM）
│   ├── annual-review.html          # 克制/数据 · 年度复盘
│   ├── consulting-proposal.html    # 优雅/高定 · 方案提案
│   └── campus-talk.html            # 张扬/人文 · 技术分享
├── scripts/                        # 双格式交付转换器
│   ├── html2pptx.js                # HTML deck → 可编辑 PPTX（读渲染几何映射成原生文本框）
│   ├── package.json
│   └── README.md
├── assets/
│   └── previews/                   # README 用的样例预览图（WebP）
├── LICENSE
├── CHANGELOG.md
└── README.md

版本历史 Version History

完整记录见 CHANGELOG.md。

v1.4.2 (2026-09-13)

• 🔧 转换器保真修复一组：分割线边框四边取 max（border-bottom 不再变色/消失）、rgba alpha 保留（不再全转不透明）、opacity:0 祖先链内容不再漏进 PPT、内联 run 字号不再被压平、文本框 clamp 到页面边界、去重误杀改完整文本判重并 warn 可观测
• 🛡 新增 --offline 离线模式：拦截不可信 deck 的一切非 file:// 网络请求
• ✅ 每条修复带最小 fixture 回归测试；CI 的 npm audit 调到 critical 级别恢复信号意义

v1.4.1 (2026-07-09)

• 🛠 全仓库审查加固：可编辑层自动保存不再把 contenteditable 写进 localStorage、下载 HTML 剥掉演示层覆盖物、编辑态点击不再误翻页
• 🎤 现场演示层：lightbox 打开拦住全部翻页键、F/P 热键加修饰键守卫、复制失败如实提示
• 📤 转换器：深色 deck 背景色回退链 slide→stage→body、Google Fonts 挂起不再拖满超时、带小图标容器不丢底色、SVG 截图失败留占位框提示

v1.4.0 (2026-07-02)

• 🎤 现场演示层 references/live-show-layer.md：全屏按钮 + F 键、示例截图点击放大 lightbox（打开时接管键盘不翻页）、观众一键复制提示词（带「已复制」反馈）、现场跳转大按钮；与可编辑层共存，自动挂进同一条工具栏。来自一次 105 页线下培训 deck 的真实交付沉淀
• 🖨 生产规格根治 vh/vw 打印崩版：.slide 设 container-type:size，页内 vh→cqh / vw→cqw，屏幕表现不变、打印跟随 slide 实际尺寸；带真实截图的 deck 压图后 base64 内嵌保持单文件

v1.3.0 (2026-06-25)

• ✨ 强化「科技 / 未来」气质方向：在赛博霓虹之外补一套当代 AI SaaS 配方（碳黑电绿 / 深空电青 / 冰蓝，单色克制 + 网格辉光，对标 Linear / Vercel / Runway），并讲清和赛博霓虹的区别
• 🎞 新增碳黑电绿样例 darktech-keynote.html：虚构 Agent 编排控制台 HELM 发布会，12 页，签名时刻是巨数字 8× 与流程链，全脱敏
• 🔒 守生产铁律：辉光只用 box-shadow / radial-gradient 不碰 backdrop-filter；零宽字符用 ​ 转义；中文字体系统兜底

v1.2.0 (2026-06-20)

• 📤 双格式交付：内置 scripts/html2pptx.js 转换器，把同一份 HTML deck 转成可编辑 PPTX，客户拿 PowerPoint / WPS 就能改字改价，一份设计两种格式
• 🧭 通用转换：在无头 Chromium 里读 deck 的真实渲染几何，映射成 PPT 原生文本框 / 色块 / 线条，对任意 HeiGe-PPT deck 都成立；自动探测系统浏览器，跨 mac / Linux / Windows
• 🪧 复杂图形（SVG 框架图 / CSS 渐变）转成同位置图片嵌入并明确提示，诚实降级不硬转

v1.1.2 (2026-06-10)

• 🧰 编辑工具栏从左下角挪到右下角页码上方，不再遮挡每套 deck 左下角的品牌标
• 🧹 示例提案去真实实体关联：虚构客户改名「雾屿优选」、联系邮箱改用 .example 保留域、加「本案例纯属虚构」声明；示例 CTA 外链全部改为占位链接
• 📦 安装命令改为 git clone 直接落到 ~/.claude/skills/heige-ppt，目录名与 skill name 一致

v1.1.1 (2026-06-08)

• 🖨 修复导出 PDF 默认竖版的问题：deck 是 16:9 横版，现在 Cmd+P / 编辑层「导出 PDF」默认就是横版，每页一张，不再被塞进竖纸里溢出
• 🎞 五套样例打印底部留白都用各自底色填满（混色 deck 的深色页用 box-shadow 补齐），无白边

v1.1.0 (2026-06-08)

• ✏️ 可编辑层：每套 deck 打开就能在浏览器里直接改幻灯片文字（点左下角「编辑」），改完导出 PDF 或下载带改动的独立 HTML，改动自动存本地、刷新不丢
• 🎬 放映模式下编辑和方向键翻页不打架（照搬 reveal.js 焦点判断）；工具栏不进 PDF
• 🧩 做成一段 drop-in 代码（references/editable-layer.md），贴进 </body> 前即生效，deck 和简历共用；五套样例全部带上

v1.0.0 (2026-05-31)

• 🎉 首次发布
• 🗣 原创方法论「导一场演出」，五道锻造工序：一页一句话 / 黄金三秒 / 节奏编排 / 视觉锤 / 反 AI 体检
• 📐 六种气质方向库 + 五类节奏模板 + 单文件幻灯片生产铁律 + 反 AI 体检清单
• 🎞 五套跨场景样例，16:9 键盘翻页、中文字体兜底、可导出 PDF，全部零依赖单文件

许可证 License

MIT License，详见 LICENSE 文件。

联系方式 Contact

• Author: Blake 黑哥
• WeChat: 488137
• GitHub: @HeiGeAi

如果这个项目对你有帮助，请给个 ⭐️ Star 支持一下！

Made by Blake 黑哥 讲一场演出，而不是堆一摞幻灯片。

更多开源工具

本项目属于问问黑哥的开源武器库。全部开源项目的清单、用途和协议,见 heigeai.com/opensource。