SuperAPI AI 工具集

demo-video

测试与质量

查看项目

更新于 10-15 19:54

技能介绍

用途:为运行中的 Web 应用录制带字幕的完整用户流程演示视频,逐帧核验后转为 mp4 交付。它属于可视化验证手段:截图捕捉像素回归,E2E 套件证明行为,演示视频则像真人视角一样证明整个面向用户的流程,并同时充当通过的 E2E 测试。

主要能力:通过 Playwright 内置录制(而非外部录屏)生成视频;用注入页面的字幕条实现无音频解说;按章节组织“字幕→操作→断言→结果字幕”;复用项目的 e2e 辅助(登录、种子数据、fixture);优先使用确定性的假 AI 模式保证可重复。

使用方式:编写临时 Playwright 规格文件(如 e2e/zz-<name>-video.spec.ts),一个测试对应一个视频,配置 test.use({ video: { mode: 'on', size: { width: 1280, height: 800 } }, viewport: { width: 1280, height: 800 } }) 并设置超时。导航后调用 caption() 注入字幕条并暂停约 2200ms。录制后执行:rm -rf test-results/zz-<name>*、npx playwright test e2e/zz-<name>-video.spec.ts、find test-results -name "video.webm",再用 ffmpeg 转 mp4:ffmpeg -y -i "<video.webm>" -c:v libx264 -pix_fmt yuv420p -movflags +faststart out.mp4,并抽取帧人工查看确认字幕与章节正确。最后按 YYYY-MM-DD-NN-<project>-<what-it-proves>.mp4 命名交付,并删除临时规格。

注意事项:滚动揭示动画需真实滚动才会显示;OTP 等异步步骤要等下一 UI 状态再读取;选择器需排除 New/Create 按钮;错误状态应驱动真实错误界面。前置条件为项目安装 @playwright/test 且有可用的开发/预览服务器,以及 PATH 中有 ffmpeg。其余细节资料未提供。