- name
- kai-slide-creator
- description
- 生成HTML演示文稿/幻灯片 — 21 种风格模版，播放/演讲者模式。适用于路演、产品发布、技术分享、方案宣讲等场景。
- version
- 2.24.3
- metadata
- {"openclaw":{"emoji":"🎞","os":["darwin","linux","windows"],"homepage":"https://github.com/kaisersong/slide-creator","requires":{"bins":["python3"]},"install":[]}}
kai-slide-creator
生成零依赖 HTML 演示文稿，纯浏览器运行。主路径是 IR-first：user prompt → BRIEF.json → HTML → validate。
安装
Claude Code: 告诉 Claude「安装 https://github.com/kaisersong/slide-creator」 OpenClaw: clawhub install kai-slide-creator
使用方式
/slide-creator ... 是 Claude/OpenClaw 的 slash 技能调用，不是 bash 命令。
规划深度：
自动(Auto) — 快速出稿，约 3-6 分钟精修(Polish) — 深度规划，约 8-15 分钟，自动执行 Review
内容类型 → 风格推荐：
| 内容类型 | 推荐风格 |
|---|---|
| 数据报告 / KPI 看板 | Data Story、Enterprise Dark、Swiss Modern |
| 商业路演 / VC Deck | Bold Signal、Aurora Mesh、Enterprise Dark |
| 产品发布 / SaaS | Blud Sky、Aurora Mesh、Glassmorphism、Electric Studio |
| 开发工具 / API 文档 | Terminal Green、Neon Cyber、Neo-Retro Dev Deck |
| 研究 / 思想领导力 | Modern Newspaper、Paper & Ink、Swiss Modern |
| 创意 / 个人品牌 | Vintage Editorial、Split Pastel、Neo-Brutalism |
| 哲学 / 思想 | Chinese chan |
命令路由
自动 (Auto) — 快速出稿 | 精修 (Polish) — 深度规划，自动执行 Review
| 命令 | 加载内容 | 行为 |
|---|---|---|
--plan [prompt] | references/brief-template.json | 创建 BRIEF.json；仅在用户明确要求时额外派生 PLANNING.md |
--generate | SKILL.md + 已选风格文件（内置 references/*.md / blue-sky-starter.html；自定义 themes/<name>/reference.md）+ composition 源 + references/title-quality.md + references/html-template.md + references/js-engine.md + references/base-css.md + references/impeccable-anti-patterns.md | 从 BRIEF.json 生成 HTML，并执行写入前门禁；如用户显式要求 eval，同步产出单 deck 评测 JSON |
--review [file.html] | references/review-checklist.md + 目标 HTML | 执行 17 项检查点 → 确认窗口 → 修复/报告 |
| 无 flag (交互式) | references/workflow.md + 其他按需 | 遵循 Phase 0-5 |
| 直接给内容 + 风格 | 同 --generate | 先落一个有效 BRIEF.json，再走同一个 deterministic renderer 与 strict 写入前门禁；禁止手拼最终 HTML |
渐进式披露： 每个命令只加载所需文件。--plan 只提炼 IR，不接触 CSS。
核心规则（按优先级）
- 风格强制
所有颜色、字体、组件、背景、动画、图表色、signature elements 都必须且只能来自选中的风格文件。模板里的 [from style file] 和示例值只是占位，禁止直接使用。 默认推荐面第一阶段聚焦 4 个 production presets：Swiss Modern / Enterprise Dark / Data Story / Blue Sky；但用户显式指定任意当前 preset 时，必须保留该选择。support tier 只影响默认推荐优先级，不影响显式指定。 Swiss Modern 额外要求 canonical export path：面板保持 .slide direct child，token 保持 --bg/--text/--red，使用 canonical 类（.left-panel/.right-panel/.stat-row/.cta-block），并写入 data-export-role；不得生成 .left-col/.right-col 或 --bg-primary/--accent 这类兼容别名。
- 叙事弧线
先锁内容结构，再锁 composition route。每页都要有明确 page role、不同布局意图和足够的信息推进；不要先拼播放/编辑壳子，再回头补故事。内部 route 名称属于实现细节，不要挤占用户入口层。
- 标题质量
标题必须是断言式，禁止 Overview / Introduction / Summary / 结论 / 概览 这类通用标签。多行标题必须平衡，不能出现孤儿行、塌陷中间行或靠过窄 measure 硬挤换行。规则和示例只看 references/title-quality.md。
- 运行时与壳子基线
非 Blue Sky 风格必须走共享壳子：body[data-preset]、scroll-snap、SlidePresentation、PresentMode、首屏 .visible 修复、data-notes、shell markers。Blue Sky 是唯一允许保留自身 #stage/#track 架构的 preset。
- 可降级功能
播放模式、编辑模式、水印都默认开启，但优先级低于风格、叙事和标题。 - 播放模式：默认开启 - 编辑模式：默认开启，可省略编辑模式，尤其在用户明确说不要或 existing HTML/导入场景受约束时 - 水印：默认保留，但必须是 JS 注入到最后一页，position: absolute，禁止 position: fixed
详见 references/html-template.md。生成任何 HTML 前必读此文件。
Direct-route guard: 无论是 --generate 还是“直接给内容 + 风格”，都必须先 materialize 一个有效 BRIEF.json，再通过 render_from_brief() 同一路径渲染，并在写出最终文件前通过 python3 scripts/validate_html.py "$TMP_HTML" --strict。禁止在交互式路径里绕过 BRIEF 直接手写最终 HTML。
Optional eval artifact: 当用户显式要求 eval / 评测 时，生成链路应在 strict gate 通过后额外写出单 deck 评测 JSON。原始 CLI 对应 --eval（默认写同名 .eval.json）或 --eval-out <path>；评测至少包含 style_score (= style_signature_coverage)、quality gates、hard failures 与关键 diagnostics。
Pre-Write Validation Pipeline（写入前门禁）
组装完整 HTML 后，先写入临时文件，再运行：
任一失败都算生成失败，必须修复或重生直到通过。
核心门禁顺序：
- 风格强制 / canonical export
选中风格的 Signature Elements、Typography、Components、Background 必须完整注入；不得遗漏 checklist 项。Blue Sky 例外：使用 blue-sky-starter.html 基底。
- 叙事弧线 / composition route
页数、page roles、composition route 必须完整；连续两页不得使用相同布局；每页至少使用 2-3 种组件类型，不得只用 .g + .bl 堆砌。
- 标题质量
标题必须断言式；禁止通用标签；多行标题不得有孤儿行、塌陷中间行或浏览器自然换行失衡。规则只认 references/title-quality.md。
- 架构隔离 / runtime
非 Blue Sky 风格必须使用 scroll-snap-type: y mandatory + SlidePresentation。#stage/#track/translateX 只允许 Blue Sky。
- Preset metadata / shell markers
body[data-preset] 必须存在且非占位；写出 id="slide-N"、#brand-mark、.nav-dots、.progress-bar、.slide-num-label、data-export-role。
- 对比度 / token 使用
文字对比必须正确；浅底不用浅字，深底不用深字；优先用风格 token，不要发明局部颜色。
- 字体 / CJK
Google Fonts 合并为单一链接；<style> 开头要有 body { background-color: ... } 回退；CJK 页面追加对应 Noto Sans SC/JP/KR。
- CSS 工程
布局、背景、间距通过 CSS 选择器定义；inline style="" ≤ 5 处，目标 0。
- 低级错误与模板完整性
禁止 U+FE0F。Blue Sky 模板路径还要检查 REQUIRED BLOCK、@keyframes、以及 go() 返回 boolean。
更多视觉和内容规则在--review/ Phase 3.5 Review 中执行。完整反模式映射表见references/impeccable-anti-patterns.md。
风格参考
只读取已选风格的文件：
- 内置预设：完整列表、风格说明和选择建议都在
references/style-index.md - 支持层级：默认推荐面与 support tier 定义在
references/preset-support-tiers.json - 内置风格文件位置：统一在
references/下；Blue Sky 例外，使用references/blue-sky-starter.html - 自定义主题：
themes/<name>/reference.md
- 风格选择器：
references/style-index.md - 视口与共享 CSS：
references/base-css.md - 设计质量基线：
references/design-quality.md - 标题规则：
references/title-quality.md - 反模式：
references/impeccable-anti-patterns.md
- `BRIEF.json` 已存在 → 直接读取并作为真相源
- 只有在用户明确要求人工审阅时才派生 `PLANNING.md`
- 现有 HTML 增强遵循 `references/workflow.md` 的 Enhancement Mode
## 相关技能
- **kai-html-export** — 导出 PPT（图片模式或 Native 模式）