SuperAPI AI 工具集

screen-recorder

编程与开发

查看项目

更新于 10-16 06:49

技能介绍

用途:为页面某个区域生成短视频,让智能体或审阅 PR 的人看到静态截图隐藏的动态效果。它不是测试套件,也不是长期资产,每次录制都是写入 .agent/recordings/ 的一次性产物。

主要能力:用 Playwright 的 recordVideo 录制指定 URL 与选择器区域,可执行脚本化交互(悬停、点击、聚焦、滚动、按键),再用 ffmpeg 裁剪到目标元素边界并降采样。默认输出 webm,可选 mp4、gif;默认时长 5000 毫秒,上限 15 秒;默认视口 1280x800;默认最大宽度 768 像素、关键帧间隔 15 帧。

使用方式:先做预检,确认 npx playwright、Chromium 驱动和 ffmpeg 是否可用,缺失时先询问用户再安装。然后收集并回显 url、selector、interaction、duration、viewport、output-name、out-format、max-width、keyint、reduced-motion 等输入。接着按模板生成 .agent/recordings/<slug>/record.mjs,运行 node .agent/recordings/<slug>/record.mjs,从 stdout 读取 VIDEO=<绝对路径>,再用 ffmpeg 裁剪降采样,最后打印交付摘要。

适用场景:diff 涉及动画、过渡或交互运动代码;需要至少两帧才能证伪的缺陷或功能;PR 审阅者询问动态效果;animations 技能需要 60fps 与 prefers-reduced-motion 的视觉证据;ux 技能发现与时机、焦点顺序、交互反馈相关的严重问题。

限制:仅用无头 Chromium,不用 headed、webkit 或 firefox;每次运行只允许一个页面、一个上下文、一段录制;必须在读取视频路径前 await context.close();裁剪依赖 ffmpeg,缺失则跳过裁剪;录制 staging 或生产 URL 需用户明确同意;.agent/recordings/ 不应提交到 git。静态截图足够、编写持久 Playwright 测试、分析已有 trace.zip 或已有录屏时,不应使用本技能。