+9
日增长
9,099
stars
769
forks
25
watchers
28
prs
22
issues
0
releases
README
html-ppt · HTML PPT 工作室 一款专业级的 AgentSkill,让 AI 做出真正能打的 HTML 演示文稿。 36 套主题、15 套完整 deck 模板、36 种页面布局、47 个动效 (27 个 CSS + 20 个 Canvas FX),加上全新的 演讲者模式 —— 像素级 完美预览 + 逐字稿提词器 + 计时器。纯静态 HTML/CSS/JS,无需构建。 作者: lewis <[email protected]> 协议: MIT English docs: README.md !html-ppt 封面 · 实时预览 一行命令装好 36 主题 × 20 Canvas FX × 36 布局 × 15 完整 deck + 演讲者模式。 上图里的每一个预览都是真实的 iframe 加载真实模板文件 —— 不是截图,不是色卡。 🎤 演讲者模式(全新) 在任何 deck 里按 S 键,弹出一个独立的演讲者窗口,包含 4 个可拖拽、 可调整大小的磁吸卡片:当前页预览、下一页预览、逐字稿、计时器。两个窗口 通过 BroadcastChannel 双向同步翻页。 !演讲者模式 · 4 个磁吸卡片 为什么预览是像素级完美的: 每个卡片是一个 ,加载的是同一 份 deck HTML 文件,只是 URL 多了 ?preview=N 参数。runtime 检测到这个 参数后,只渲染第 N 页并隐藏所有 chrome —— 所以预览使用和观众视图完全相 同的 CSS、主题、字体、viewport,颜色和排版保证 100% 一致。 丝滑翻页(零闪烁): 翻页时演讲者窗口通过 postMessage({type:'preview-goto', idx:N}) 通知 iframe,iframe 只是切换 .is-active class —— 不重新加载、 不白屏、不闪烁。 逐字稿 3 条铁律: 1. 提示信号,不是讲稿 — 关键词加粗,过渡句独立成段 2. 每页 150–300 字 — 约 2–3 分钟/页的节奏 3. 用口语,不用书面语 — "所以" 不是 "因此","这个" 不是 "该" 详见 references/presenter-mode.md,或直接复制 templates/full-decks/presenter-mode-reveal/ 这个现成模板 —— 每一页都带完整 150–300 字的示例逐字稿。 一行命令安装 bash npx skills add https://github.com/lewislulu/html-ppt-skill 装好后,任何支持 AgentSkill 的 agent(Claude Code / Codex / Cursor / OpenClaw 等) 都能用这套能力做 PPT。对 agent 说: "做一份 8 页的技术分享 slides,用 cyberpunk 主题" "把这段 outline 变成投资人 pitch deck" "做一个小红书图文,9 张,白底柔和风" "做一份带演讲者模式的产品分享,我想要有逐字稿" 离线 / 手动安装 npx skills add 需要目标机器能联网。下面三种方式,对网络的依赖依次递减。 1. 从本地副本安装。 在任意能联网的机器上取到仓库,把整个目录搬过去(git、zip、U 盘都行), 然后把 CLI 指向本地目录而不是 URL: bash git clone https://github.com/lewislulu/html-ppt-skill npx skills add ./html-ppt-skill npx 本身仍需下载一次 skills 包。完全隔离的机器请先在联网机器上 npm i -g skills,或者直接用方式 2。 2. 纯手工拷贝 —— 不需要 Node,也不需要 CLI。 一个 skill 就是一个根目录下放着 SKILL.md 的文件夹。放进你的 agent 会扫描的目录即可: | Agent | 项目级 | 全局 | |---|---|---| | Claude Code | .claude/skills/html-ppt/ | ~/.claude/skills/html-ppt/ | | Codex | .agents/skills/html-ppt/ | ~/.codex/skills/html-ppt/ | | Cursor | .agents/skills/html-ppt/ | ~/.cursor/skills/html-ppt/ | | OpenCode | .agents/skills/html-ppt/ | ~/.config/opencode/skills/html-ppt/ | | Gemini CLI | .agents/skills/html-ppt/ | ~/.gemini/skills/html-ppt/ | | Windsurf | .windsurf/skills/html-ppt/ | ~/.codeium/windsurf/skills/html-ppt/ | bash mkdir -p ~/.claude/skills cp -R html-ppt-skill ~/.claude/skills/html-ppt ls ~/.claude/skills/html-ppt/SKILL.md 必须存在 运行时只需要 SKILL.md、assets/、templates/、references/、scripts/。 docs/ 是约 4.6 MB 的 README 配图,离线拷贝时可以删掉。 3. 完全不用 agent。 模板就是普通静态文件,可以直接用: bash ./scripts/new-deck.sh my-talk open examples/my-talk/index.html 断网能用吗? 能,只有一个前提要说清楚。主题、布局、动效、演讲者模式、PNG 导出全部是本地静态 HTML/CSS/JS,零构建、运行时不发请求。唯一的远程依赖是 assets/fonts.css, 它 @import 了 Google Fonts。 断网时这些 import 直接失败,浏览器回落到 assets/base.css 里已经声明好的系统字体栈 (-apple-system / Helvetica / Georgia / Menlo),所以 deck 照常渲染,只是字体不同。 如果要在离线环境下锁定字体,把 assets/fonts.css 换成指向自带字体文件的 @font-face 规则,或者删掉这些 import、接受系统字体。 Skill 内容一览 | | 数量 | 位置 | |---|---|---| | 🎤 演讲者模式 | 新增 | S 键 / ?preview=N | | 🎨 主题 | 36 | assets/themes/.css | | 📑 完整 deck 模板 | 15 | templates/
Top issues
#6請問能在綫編輯嗎? 一次很難成型可用的稿件,需要微調。3 comments · 2026-04-20#12需要在线编辑功能2 comments · 2026-05-19#5能增加配图的自动生成吗?2 comments · 2026-04-20#4Feature Request: 配套 PPTX 导出工具 html-to-pptx1 comments · 2026-04-18#47Idea: a bundle step so a deck can be shared as a link (host-agnostic, offline default unchanged)0 comments · 2026-10-23#44Fragile relative asset paths when generating decks into shallow directories (../../../Users/...) — consider a --self-contained mode0 comments · 2026-09-16#23Feature idea: editable PPTX handoff from HTML decks0 comments · 2026-06-18