shot-scraper video 发布：用 storyboard.yml 让 AI 代理自动录制 Web 操作演示视频

一句话看懂

shot-scraper 1.10 新增 video 命令，通过 storyboard.yml 文件定义操作步骤，利用 Playwright 录制 Web 应用操作视频，让 AI 代理自动生成功能演示。

详细发生了什么

Simon Willison 发布了 shot-scraper 1.10，新增 shot-scraper video 命令。该命令接受一个 storyboard.yml 文件，定义在 Web 应用上执行的操作流程，然后使用 Playwright 录制视频。开发者可以指定一系列步骤（如点击、输入、导航），工具会自动打开浏览器、执行操作并生成视频文件（支持 WebM 或 MP4 格式）。

示例中，Simon 用该工具录制了 Datasette 一个未发布功能的演示：从粘贴的 CSV/TSV/JSON 数据创建新表。他通过 --auth 参数传入包含认证 cookie 的 JSON 文件，确保录制时已登录。生成的视频可直接用于文档、PR 或分享。

Simon 此前多次强调“让编码代理生成演示”的重要性，认为这是验证代码实际工作效果的关键。shot-scraper video 正是为此设计：AI 代理可以编写 storyboard.yml，然后调用该命令自动录制演示视频，无需人工干预。

中文圈视角

对中文开发者来说，这个工具有几个实用场景：

1. 自动化演示生成：如果你在开发 Web 应用或 API 工具，可以用 shot-scraper video 自动录制功能演示视频，节省手动录制时间。尤其适合开源项目维护者，在提交 PR 时附上操作视频，让 reviewer 直观看到改动效果。

2. AI 代理工作流：国内开发者使用 Claude、GPT-4 等生成代码时，可以让 AI 同时生成 storyboard.yml 并调用 shot-scraper video 录制演示，实现“代码+演示”一站式输出。不过需要本地安装 Playwright 和 shot-scraper，对服务器环境有一定要求。

3. 平替与对比：类似工具有 Selenium IDE 的录制回放功能，但 shot-scraper video 更轻量，且以 YAML 文件定义步骤，易于版本控制和 AI 生成。国内类似工具如阿里云的“云浏览器”或腾讯的“自动化测试”服务，但多为商业产品，shot-scraper 开源免费，适合个人和小团队。

4. 注意点：录制需要真实浏览器环境，国内访问某些国外站点可能较慢；认证 cookie 需手动导出，安全性需注意。此外，目前只支持 Chromium（Playwright 默认），Firefox 和 Safari 支持待确认。

几条值得记住的细节

• 命令格式：shot-scraper video storyboard.yml --auth auth.json --mp4，其中 --auth 可选，用于携带登录态。
• 输出格式：默认 WebM，加 --mp4 输出 MP4，适合直接嵌入网页。
• storyboard.yml：定义 output（输出路径）、server（启动命令）、steps（操作步骤，如 click, fill, screenshot, wait）等字段。
• 依赖：需要 Python 3.8+ 和 Playwright，安装 shot-scraper 后运行 playwright install chromium 即可。
• 适用场景：功能演示、Bug 复现视频、自动化测试报告、AI 代理工作流验证。

一句话总结

如果你需要快速生成 Web 操作演示视频，或想让 AI 代理自动录制功能验证，shot-scraper video 是一个轻量、开源的好选择。