跳到主要内容
中文
← 技能
技能 · 代码仓库

把产品操作做成自然流畅的演示动画

用连贯的鼠标操作动画,演示产品怎么用。Stageshow 用 React 重建精简的产品界面,让输入、点击和反馈相互配合,也能制作官网中的静态配图与功能卡片组。

@benjitaylor Stageshow
  • 界面动效
  • 网页设计
  • 代码动画
  • CSS

可用于 Claude Code · Codex

前置要求

  • Node.js >= 22.20
  • React >= 18

概览

你会得到什么

  • 用 React 和 CSS 制作的产品配图,或按既定动作播放的操作演示。
  • 可移入项目的组件包、示例和本地预览器,用来调整界面、鼠标与状态变化。
  • 截取关键帧的检查脚本,用来检查桌面、手机和关键状态。

适用场景

  • 在官网首屏或功能卡片中,演示一段简短的产品操作。
  • 制作静态产品配图,以及大小卡片组合的功能介绍区。

教程

先看懂一段好的操作演示

产品介绍页常常需要演示“输入内容后会发生什么”。直接让 AI 做,容易得到厚重的卡片、突兀的状态切换,或鼠标点击与画面反馈对不上的动画。

Stageshow 把界面构图、鼠标动作和状态变化放在同一套流程中:从已有示例起步,替换成你的产品内容,再逐帧检查。交付的是可嵌入网页的 React 动画,也可以制作静态配图或大小卡片组合的功能介绍区。

看上方第二段前后对比视频,关注三件事:输入文字时光标是否跟得上、密码强度是否随着输入变化、点击按钮后是否出现明确的完成结果。精简界面不是把内容删空,而是让观众一眼看见当前操作和结果。

这里的点击与输入是编排好的演示。它们改变展示场景,不会真的注册账户或操作你的应用。

与站内同类怎样选

  • Stageshow:为官网或功能卡片制作界面配图、鼠标操作动画,保留产品特征,突出一次操作。
  • Emil 界面技能合集:打磨用户实际使用的界面动效、移动端交互和边界状态。
  • 产品镜头配方:把产品功能组织成宣传片,交付 MP4 和 Remotion 工程。

安装技能,打开官方示例

安装与预览

  1. 准备 Node.js 22.20 或更高版本。在本机终端执行官方安装命令,按安装器提示选择你使用的 AI 编程工具:

    npx skills add benjitaylor/skills --skill stageshow

    技能包含设计说明、React 组件、示例与检查脚本。后续制作需要这些配套文件,不要只复制 SKILL.md。

  2. 为了先看示例,在本机终端另取一份仓库并启动预览:

    git clone https://github.com/benjitaylor/skills.git stageshow-examples
    cd stageshow-examples/stageshow
    npm install
    npm run dev

    macOS、Linux 打开 http://stageshow.localhost:1355;Windows 打开终端打印的本地地址,通常为 http://127.0.0.1:5173。这个目录用于预览和练习,与安装器保存技能的位置是两回事。

  3. 在预览器中找到 form-error,看完一轮“输入邮箱 → 发现错误 → 修正邮箱 → 创建完成”。试用暂停、重播、慢放和逐帧按钮,再点 Phone 看窄屏布局。

    能看见完整流程、暂停后能继续,说明预览已启动。这个内置示例带你练习表单反馈;它不要求你复刻前后对比视频的每个细节。

把示例改成自己的产品

先准备产品名称、页面截图或设计稿、品牌颜色,以及要展示的一次操作。只选一个结果,例如“修正邮箱后完成注册”,不要第一版就塞进整个产品流程。

下面是本站整理的练习请求。让 AI 编程工具打开上一步克隆的仓库,在对话中发送;附上你的截图,并替换方括号内容:

请使用 stageshow,为[产品名称]制作一段放在官网功能介绍区的注册演示动画。

参考附件中的真实界面与品牌色。先告诉我准备保留哪些产品特征、演示哪几个动作,以及完成后观众会看见什么,确认后再写代码。

从 stageshow/examples/form-error 复制一份作为起点,不改原示例。先在同一预览器中制作,再交给我迁移到自己的 React 网页。

演示顺序:输入缺少域名结尾的邮箱 → 显示邮箱错误 → 补全邮箱 → 点击创建 → 按钮显示完成。
只在当前步骤需要的位置显示真实文案,其余内容简化。鼠标落在对应控件上之后再点击,反馈紧跟触发它的操作。错误消失时,周围内容不要突然跳动。

桌面版和手机窄屏分别安排布局,文字保持可读。减少动态效果时,显示能独立说明完成结果的静态画面。

先给我首版预览地址和关键画面,等我确认后再完善细节。

打开 AI 给出的预览,先检查操作因果:错误是否由未补全的邮箱触发、修正后是否消失、完成反馈是否出现在点击之后。不要只凭代码编译成功判断动画完成。

只改最影响理解的一处

如果过程太快,不必重做整段。说明要调整哪一步,以及后续动作如何跟着变化。例如继续发给 AI:

邮箱错误提示停留得太短,观众来不及读。
把这一段的阅读时间增加约 0.8 秒,再开始补全邮箱;后续动作顺延。
保留界面、文案和其他步骤。先给我这一小段的慢放与正常速度预览。

修改后看错误出现、停留、修正这三个时刻。这里改变的是阅读时间,鼠标与后续状态也应顺延,而不是只延迟某一条文字。

检查动画,再放进自己的网页

  1. 在 stageshow-examples/stageshow 目录运行官方检查:

    npm run typecheck
    npm run check:css
  2. 用本机 Chrome 截取检查图。以下以官方 form-error 为例;把地址换成你正在运行的预览地址,改好自己的示例后,把 capture=form-error 中的 form-error 换成新示例名称。若 Chrome 没有安装在默认位置,先设置 CHROME_PATH。

    node scripts/film.mjs "http://stageshow.localhost:1355/?capture=form-error" --gate --out shots/form-wide.png
    node scripts/film.mjs "http://stageshow.localhost:1355/?capture=form-error" --width 390 --gate --out shots/form-phone.png
    node scripts/film.mjs "http://stageshow.localhost:1355/?capture=form-error" --states --gate --out shots/form-states.png

    ?capture= 打开示例本身,便于截帧;上面的命令输出 PNG 检查图,不是 MP4。检查无阻塞问题时,脚本末尾会显示 rehearsal passed;你仍需正常播放一遍,看鼠标落点、弹出内容和收尾是否自然。

  3. 确认首版后,让 AI 把新组件、需要的素材及 kit/ 移入你的 React 18 或更高版本项目,修正导入路径,并安装 lucide-react 等实际使用的依赖。在真实页面中再次检查桌面与手机效果,而不只看独立预览器。

换成自己的场景时,沿用这份需求骨架:

用 stageshow 为[产品名称]制作[静态配图 / 操作动画 / 功能卡片组]。
放在[网页位置],可用宽度[桌面宽度 / 手机宽度],背景[颜色]。
参考素材:[截图、设计稿、品牌色]。
观众要看懂:[核心功能;若是动画,写明操作和结果]。
动作顺序(仅动画填写):[三到五个动作]。
重点保留:[产品特征与关键文字]。
播放方式(仅动画填写):[循环 / 进入视口播放一次 / 悬停播放]。
先给构图方案;若有动画,再列动作顺序。确认后做首版,检查关键画面后再调整。

原项目代码采用 MIT 许可;示例中的第三方应用图标、品牌标记等另有来源,使用时按仓库的 NOTICE.md 核对,并换成你的产品素材。