用途
Frontend Slides 用于创建零依赖、动画丰富的 HTML 演示文稿,完全在浏览器中运行。它支持三种模式:从零开始创建新演示文稿、将 PowerPoint 文件(.ppt 或 .pptx)转换为 HTML 演示文稿,以及对现有 HTML 演示文稿进行布局、动效或排版方面的改进。该技能适用于制作演讲、路演、工作坊或内部演示等场景。
主要能力
- 零依赖:默认生成一个自包含的 HTML 文件,内联 CSS 和 JavaScript。
- 视口适配:每张幻灯片必须适配单个视口,无内部滚动。
- 视觉探索:通过生成单页预览文件来帮助用户选择风格,而非使用抽象问卷。
- 独特设计:避免通用的紫色渐变、Inter 字体白底等模板化设计。
- 生产质量:代码包含注释,具备可访问性、响应式和性能优化。
- PPT 转换:优先使用 python3 和 python-pptx 提取文本、图片和备注,保留幻灯片顺序、演讲者备注和提取的资源。
- 导航与动画:包含键盘、触摸/滑动、鼠标滚轮导航,进度指示器或幻灯片索引,以及进入时的揭示动画。
- 可访问性:使用语义化结构(main、section、nav),保持对比度可读,支持纯键盘导航,尊重 prefers-reduced-motion。
使用方式
- 检测模式:选择新演示文稿、PPT 转换或增强现有 HTML 幻灯片。
- 发现内容:询问最少必要信息,包括目的(路演、教学、会议演讲、内部更新)、长度(短 5-10、中 10-20、长 20+)和内容状态(完整文案、粗略笔记、仅主题)。如果用户已有内容,请其在样式设计前粘贴。
- 发现风格:默认进行视觉探索。如果用户已知所需预设,直接使用;否则询问演示文稿应营造的感觉(印象深刻、充满活力、专注、启发),生成 3 个单页预览文件到 .ecc-design/slide-previews/ 目录,每个预览自包含、清晰展示排版/颜色/动效,且幻灯片内容约 100 行以内。然后询问用户保留哪个预览或混合哪些元素。
- 构建演示文稿:输出 presentation.html 或 [presentation-name].html。仅当演示文稿包含提取或用户提供的图片时,才使用 assets/ 文件夹。必需结构包括:语义化幻灯片 section、来自 STYLE_PRESETS.md 的视口安全 CSS 基础、主题值的 CSS 自定义属性、用于键盘/滚轮/触摸导航的演示控制器类、用于揭示动画的 Intersection Observer、reduced-motion 支持。
- 强制视口适配:每张 .slide 必须使用 height: 100vh; height: 100dvh; overflow: hidden; 所有字体和间距必须使用 clamp() 缩放。内容不适配时拆分为多张幻灯片,绝不通过缩小字体至可读尺寸以下来解决溢出,绝不允许幻灯片内出现滚动条。
- 验证:在 1920x1080、1280x720、768x1024、375x667、667x375 尺寸下检查完成的演示文稿。如果可用浏览器自动化,使用它验证无幻灯片溢出且键盘导航正常。
- 交付:删除临时预览文件(除非用户想保留),在有用时使用平台相应的打开方式打开演示文稿,总结文件路径、使用的预设、幻灯片数量和易于主题定制的点。
适用场景
- 创建演讲、路演、工作坊或内部演示文稿。
- 将 .ppt 或 .pptx 幻灯片转换为 HTML 演示文稿。
- 改进现有 HTML 演示文稿的布局、动效或排版。
- 与尚不清楚设计偏好的用户一起探索演示风格。
限制
- 内容密度有上限:标题幻灯片 1 个标题 + 1 个副标题 + 可选标语;内容幻灯片 1 个标题 + 4-6 个要点或 2 个短段落;功能网格最多 6 张卡片;代码最多 8-10 行;引用 1 个引用 + 出处;图片 1 张受视口约束的图片。
- 避免反模式:无视觉标识的通用创业渐变、系统字体演示文稿(除非有意编辑风格)、长要点墙、需要滚动的代码块、在短屏幕上断裂的固定高度内容框、无效的否定 CSS 函数如 -clamp(...)。
- PPT 转换时,如果 python-pptx 不可用,需询问是否安装或回退到手动/基于导出的工作流。
- 字体可来自 Google Fonts 或 Fontshare。
- 相关技能:frontend-patterns 用于演示文稿周围的组件和交互模式;liquid-glass-design 当演示文稿有意借用 Apple 玻璃美学时;e2e-testing 如果需要为最终演示文稿进行自动化浏览器验证。
交付清单
- 演示文稿可从本地文件在浏览器中运行。
- 每张幻灯片适配视口且无滚动。
- 风格独特且有意图。
- 动画有意义,不嘈杂。
- 尊重 reduced motion。
- 在交付时解释文件路径和定制点。