SuperAPI AI 工具集

release-demo-video

编程与开发

查看项目

更新于 11-08 08:06

技能介绍

用途:在准备发布新版本时,把该项目的更新内容制作成约两分钟的 MP4 演示视频。成品是一个带可定位时间轴的 HTML 页面,既可在浏览器中实时播放,也可由脚本逐帧录制为视频。

主要能力与流程:

  1. 列出功能:读取 CHANGELOG.md 的 ## Unreleased 部分,把条目归为 6–9 个章节,每章对应一个场景;优先展示用户最易察觉的变化,CLI 与破坏性变更放最后。视频中的每条命令、标志、输出行和设置名都必须来自实际运行或阅读,不能凭记忆编写。
  2. 捕获真实 UI:把 scripts/reference-shots.spec.ts 复制到 browser/,为每个场景要绘制的状态添加截图,运行 Playwright 生成 PNG 并逐张查看,之后删除副本。测试环境用假 GitHub 和假聊天代理提供 PR 42。
  3. 构建页面:把 template.html 复制到仓库根目录的 release-video/index.html,设置 VERSION、替换场景并保留引擎;用模板已有的类(如 .card、.chat、.diff、.term、.yml、.dlg、.rail)在视频尺度上绘制界面模型,正文不小于 16px。
  4. 审核静帧:目标总时长约 2:00,调整 SCENES 时长;用 stills.mjs 渲染静帧并逐张检查,关注文字换行/溢出、光标错位、等宽字体连字、与第 1 步事实不符等问题。
  5. 渲染并检查:渲染到主检出目录的 release-video/(链接工作树的该目录会随工作树删除),同时保留页面副本;用 ffmpeg 从 MP4 抽 3–4 帧查看(含至少一个点击中帧),报告路径、时长(ffprobe)和大小,列出需用户确认的假设(如版本号)。视频无音轨。

引擎要点:<script> 由单一时间值驱动,任意帧可精确渲染。SCENES 定义场景顺序与时长,场景淡入 0.5 秒、最后 0.45 秒淡出;元素上的 data-at 控制本地秒数淡入上滑;data-chapter 添加章节条;R['<scene id>'] 提供逐帧逻辑,辅助函数包括 P、place、reveal、io;终端用 data-type="cmd" 在 $ 后打字并调用 termRender;typeYaml 以语法着色方式逐字打出配置;聊天回答用 class="stream" 并调用 stream;cursor 定义移动与点击关键帧。?render 停止实时播放以便脚本调用 window.videoSeek(t),?t=<s> 从指定秒开始播放。模板已处理两个问题:diff 列规则用子选择器保持行内高亮样式,等宽文本设置 font-variant-ligatures: none。字体来自 Google Fonts(Inter、JetBrains Mono),渲染需要网络访问。

适用场景:项目发布前的功能演示视频制作、需要贴近真实产品界面的录屏式动画。

限制:视频约两分钟、无音轨;需网络加载字体;命令与 UI 文案必须来自实际运行或源码;渲染目录选择需注意工作树生命周期。