SuperAPI AI 工具集

frontend-slides

前端与建站

查看项目

更新于 11-10 16:20

技能介绍

用途

Frontend Slides 用于创建零依赖、动画丰富的 HTML 演示文稿,完全在浏览器中运行。它支持三种模式:从零开始创建新演示文稿、将 PowerPoint 文件(.ppt 或 .pptx)转换为 HTML 演示文稿,以及对现有 HTML 演示文稿进行布局、动效或排版方面的改进。该技能适用于制作演讲、路演、工作坊或内部演示等场景。

主要能力

  • 零依赖:默认生成一个自包含的 HTML 文件,内联 CSS 和 JavaScript。
  • 视口适配:每张幻灯片必须适配单个视口,无内部滚动。
  • 视觉探索:通过生成单页预览文件来帮助用户选择风格,而非使用抽象问卷。
  • 独特设计:避免通用的紫色渐变、Inter 字体白底等模板化设计。
  • 生产质量:代码包含注释,具备可访问性、响应式和性能优化。
  • PPT 转换:优先使用 python3 和 python-pptx 提取文本、图片和备注,保留幻灯片顺序、演讲者备注和提取的资源。
  • 导航与动画:包含键盘、触摸/滑动、鼠标滚轮导航,进度指示器或幻灯片索引,以及进入时的揭示动画。
  • 可访问性:使用语义化结构(main、section、nav),保持对比度可读,支持纯键盘导航,尊重 prefers-reduced-motion。

使用方式

  1. 检测模式:选择新演示文稿、PPT 转换或增强现有 HTML 幻灯片。
  2. 发现内容:询问最少必要信息,包括目的(路演、教学、会议演讲、内部更新)、长度(短 5-10、中 10-20、长 20+)和内容状态(完整文案、粗略笔记、仅主题)。如果用户已有内容,请其在样式设计前粘贴。
  3. 发现风格:默认进行视觉探索。如果用户已知所需预设,直接使用;否则询问演示文稿应营造的感觉(印象深刻、充满活力、专注、启发),生成 3 个单页预览文件到 .ecc-design/slide-previews/ 目录,每个预览自包含、清晰展示排版/颜色/动效,且幻灯片内容约 100 行以内。然后询问用户保留哪个预览或混合哪些元素。
  4. 构建演示文稿:输出 presentation.html 或 [presentation-name].html。仅当演示文稿包含提取或用户提供的图片时,才使用 assets/ 文件夹。必需结构包括:语义化幻灯片 section、来自 STYLE_PRESETS.md 的视口安全 CSS 基础、主题值的 CSS 自定义属性、用于键盘/滚轮/触摸导航的演示控制器类、用于揭示动画的 Intersection Observer、reduced-motion 支持。
  5. 强制视口适配:每张 .slide 必须使用 height: 100vh; height: 100dvh; overflow: hidden; 所有字体和间距必须使用 clamp() 缩放。内容不适配时拆分为多张幻灯片,绝不通过缩小字体至可读尺寸以下来解决溢出,绝不允许幻灯片内出现滚动条。
  6. 验证:在 1920x1080、1280x720、768x1024、375x667、667x375 尺寸下检查完成的演示文稿。如果可用浏览器自动化,使用它验证无幻灯片溢出且键盘导航正常。
  7. 交付:删除临时预览文件(除非用户想保留),在有用时使用平台相应的打开方式打开演示文稿,总结文件路径、使用的预设、幻灯片数量和易于主题定制的点。

适用场景

  • 创建演讲、路演、工作坊或内部演示文稿。
  • 将 .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。
  • 在交付时解释文件路径和定制点。