super-slides · diff
git:20260806.5d0b84d to git:20261021.f2ff537
2 added, 0 removed. Audit A to A.
---
name: super-slides
description: >-
创建美观、实用的演示材料，主输出为 HTML 互动演示稿，可选导出 PPT/PDF。用于用户要做演示、PPT、
分享稿、演讲稿、培训材料、答辩、路演、汇报、产品介绍、pitch deck 或课件。即使只说“帮我做个分享”
或“我要汇报一下”，只要需要结构化演示也应触发。
---
# Super Slides
+ 做演示稿，时间常常花在排版上，内容反而没想清楚。Super Slides 先定大纲再做设计，生成一份打开就能放映的网页演示稿，每页只讲一个判断。需要时再导出 PDF 或 PPT，部署到线上也是你选了才做。
+
用分阶段、按需加载的方式生成演示稿。不要一次读取所有参考文件。
## 交付合约
1. 先确认或建立内容大纲，再做视觉设计。
2. 主交付是一个可移植文件夹，至少包含 `index.html` 和离线字体备份 `index-backup.html`。
3. 每页只传达一个主要判断；内容超载时拆页，不压缩字号硬塞。
4. 网络研究、PDF/PPT 导出和在线部署都是按需步骤，不是默认副作用。
5. 只有用户明确选择“部署到线上”后，才可调用外部托管服务。
## 输出边界
开始写文件前，确定一个 `PROJECT_DIR`：
- 优先使用当前项目已授权的交付目录。
- 没有现成项目时，在当前工作目录下创建 `[topic]-slides/`。
- 只有用户明确选择桌面时才写桌面。
- 参考文件中的 `$PROJECT_DIR` 始终指向这个已确认目录。
一旦确定，所有大纲、图表数据、素材、HTML 和导出文件都保持在该目录内。
## 分阶段路由
### 1. 项目与内容
仅读 [project-and-content.md](references/project-and-content.md)。
- 选择“现有文件”、“现有内容”或“从主题开始”。
- 用户已给出足够信息时不重复提问。
- 为事实、数据和外部案例保留来源；用户确认大纲后，再移除面向编辑的临时标记。
- 产出 `PROJECT_DIR/.slide-design/outline.md`。
用户确认大纲前，不进入完整视觉生成。
### 2. 风格发现
大纲确认后，仅读 [style-discovery.md](references/style-discovery.md)。
- 无参考时从 [STYLE_PRESETS.md](STYLE_PRESETS.md) 和 `style-preview.html` 中选。
- 有模板、Logo 或品牌文档时，先分析它们，再提炼配色、字体、网格和图片规则。
- 风格不明时给出少量候选供用户选；已有明确品牌规范时直接遵循。
### 3. 生成与验证
内容和风格都确认后，读 [html-generation.md](references/html-generation.md)，并按需读：
- [viewport-base.css](viewport-base.css)：必须完整纳入演示稿。
- [html-template.md](html-template.md)：HTML 结构参考。
- [animation-patterns.md](animation-patterns.md)：只选 1–2 种统一动画。
- [STYLE_PRESETS.md](STYLE_PRESETS.md)：只读用户选中的风格段落。
交付前检查：
- 导航点数量与页数一致。
- 每页适配 `100vh/100dvh`，不出现滚动溢出。
- 字号使用 `clamp()`，图片有高度上限。
- 键盘、触摸和减少动效偏好都可用。
- 本地图片使用相对路径，备份版离线仍可读。
- 使用真实浏览器进行至少一次完整预览。
### 4. 修改、导出与部署
用户看过 HTML 后，才读 [delivery-and-export.md](references/delivery-and-export.md)。
- 小改直接修改 HTML 并重新验证。
- 结构性改动返回内容阶段；换视觉方向返回风格阶段。
- PDF 导出可用 `scripts/export-pdf.sh`。
- `scripts/extract-pptx.py` 需要 `python-pptx`，只在确实需要抽取 PPTX 时安装。
- 在线部署可用 `scripts/deploy.sh`，但必须有用户当次明确授权。
## 回退策略
- 无法加载网络字体：交付 `index-backup.html`，不阻塞整个演示稿。
- 无法安装导出依赖：保留已验证 HTML，如实说明 PDF/PPT 未生成。
- 外部部署失败：不重复发布未经确认的版本，保留本地交付并报告错误。