SaaS 演示视频
成果
构建一个全屏、自动移动的演示页面,该页面可以录制为精美的SaaS产品视频。优先选择简短的客户故事而非功能巡览:问题钩子、产品操作、客户时刻、结果揭示、业务成果、最终行动号召。
使用此技能创建或改进诸如 /demo、/presentation、/video-demo 或等效的独立HTML/React页面等路由。
必需输入
在实施前收集或推断这些信息。仅在遇到阻碍时提问。
- 产品名称、领域、受众和主要承诺。
- 目标时长和宽高比,通常为30-60秒和16:9。
- 要展示的现有应用路由:注册、仪表盘、产品创建、链接创建、客户页面、分析。
- 品牌资产:Logo、颜色、字体、产品图片、客户图片、截图、图标、手机框架。
- 真实工作流程约束:应用实际做什么,什么是手动的,什么是自动的,哪些数据可用。
- 旁白脚本或时间线。如果用户已生成音频,请使用确切的时间戳。
- 最终行动号召和录制URL。
切勿编造产品不支持的行为。如果商店手动复制链接,应说明这一点,而不是说应用自动发送。
故事板
默认30-50秒结构:
- 问题钩子:展示一个现实的客户问题或痛点。
- 管理操作:添加产品、创建私有链接、复制消息。
- 客户时刻:客户收到链接、打开链接、上传图片、开始生成。
- 结果揭示:与干净揭示动画的之前/产品/结果并排展示。
- 业务成果:重要的仪表盘指标。
- 最终行动号召:简短的产品承诺和域名。
使用应用的真实域名和真实产品语言。对于社交电商,除非产品实际集成Instagram API,否则仅将Instagram风格的DM界面用作视觉故事工具。
实现模式
使用应用现有技术栈。对于Next.js应用,优先选择:
- 一个路由,如
src/app/demo/page.tsx。 - 一个用于定时演示的客户端组件。
- 使用 Framer Motion 实现场景切换、光标移动、揭示效果、微光和缩放。
- 使用现有的UI组件、Logo、调色板和资源。
- 查询参数场景预览,例如
/demo?scene=resultReveal。
核心演示组件行为:
- 将场景定义为数据:
id、title、caption、durationMs、cursor和可选的视觉焦点/相机元数据。 - 从
durationMs计算场景开始时间。 - 使用挂钟时间线,以便开发热重载或重新渲染不会意外重置播放。
- 添加播放、暂停、重启、上一个和下一个控件,除非用户想要一个纯粹的录制页面。
- 如果与生成的音频同步,确保场景时长与音频时间戳范围完全匹配。
- 添加
data-demo-cursor-target属性到重要的UI控件,并通过getBoundingClientRect()计算光标位置。当存在真实目标时,避免硬编码光标坐标。 - 使用
ResizeObserver和requestAnimationFrame保持光标目标在不同视口大小下准确。 - 尊重减少动效设置。
视觉方向
使其感觉像现代SaaS发布/演示视频:
- 全屏舞台,而非普通文档页面。
- 对重要点击进行电影级缩放。
- 从上个光标位置开始连续移动的平滑光标。
- 简短叠加字幕:“1. 添加产品”、“2. 发送链接”、“3. 客户尝试”。
- 在浏览器/手机框架内的真实应用截图或逼真的UI模拟。
- 带有闪烁、擦拭、模糊至清晰或并排比较的结果揭示时刻。
- 包含2-4个高信号指标的干净仪表盘结果画面。
- 无密集段落、无开发者日志、无虚假技术术语。
对于移动客户流程,使用手机框架。确保其内部内容在桌面和移动录制视口中保持清晰可读。
旁白和计时
如果用户需要旁白,为语音模型提供提示:
- 语调:自信、温暖、高端、清晰、不机械。
- 节奏:匹配目标时长。
- 产品名称的发音说明。
- 按场景带有时间戳的脚本。
如果用户提供了生成的音频时间戳,将场景时长更新为这些确切范围,并验证总时长。
请参阅 references/storyboard-and-voiceover.md 以获取可复用的计时和旁白模板。
验证
在完成之前:
- 本地运行应用或确认现有开发/生产服务器。
- 运行相关检查:类型检查、Lint、构建或框架等效项。
- 在桌面和移动尺寸下使用Playwright/浏览器检查。
- 验证无水平溢出。
- 验证手机框架内容可见。
- 使用DOM目标测量验证光标落在预期按钮上。
- 如果实现了查询参数预览场景,验证每个预览场景正常工作。
- 验证最终公共URL或本地URL返回
200 OK。 - 如果嵌入了视频iframe,验证iframe在渲染的HTML中存在。
单独报告任何已知的开发环境警告,例如在公网IP开发服务器上的Next HMR WebSocket失败。
交付
返回:
- 演示页面URL。
- 添加或更改的路由/文件。
- 场景时长表。
- 旁白提示(如果请求)。
- 验证命令/结果。
- 任何录制说明,例如推荐的视口大小以及是否隐藏控件。