Video Proof 技能综合评估
核心用法
Video Proof 是一款面向软件开发工作流的自动化演示录制工具，核心使命是解决"代码完成了，如何证明它真的能用"的问题。该技能通过 Playwright 驱动 Chromium 浏览器，在开发者指定的本地或远程应用上执行预设的交互脚本，同步捕获屏幕录像、关键节点截图、浏览器控制台日志，并生成结构化的测试报告。
使用流程分为三步：配置 Proof Spec（YAML 格式）、执行录制脚本、获取输出资产。Proof Spec 支持声明式定义启动命令、端口探测、页面导航、元素交互、断言验证等完整流程，覆盖从 Next.js、Vite 到 Django、Rails、Go、Docker 等全技术栈。对于纯 API 场景，还提供无浏览器模式的 api-proof.js 替代方案。
显著优点
技术栈无侵入：不依赖特定框架，任何能通过 shell 命令启动的 HTTP 服务均可接入，极大降低了跨团队推广成本。
资产标准化输出：自动生成 video.webm/mp4、命名截图、console.log、proof-summary.md 五种格式，直接满足 PR 审查、文档更新、异步演示等多场景需求。
断言驱动可靠性：内置 assert_visible、assert_url 等验证指令，避免"录了个寂寞"——确保视频内容对应功能真实可用，而非单纯的形式合规。
CI/CD 友好：以退出码 0/1 标识成败，失败时自动捕获 FAILURE.png，天然适配自动化流水线。
潜在缺点与局限性
Node.js 生态依赖：运行环境限定 Node.js 18+，Playwright 与 Chromium 的安装包体积较大（约 100MB+），在资源受限或网络隔离环境部署存在摩擦。
录制稳定性受环境波动影响：动画等待时长、数据加载延迟需手动配置 wait 步骤，缺乏智能等待机制可能导致偶发录制失败或视频内容空洞。
无原生并行能力：单次录制单实例，大规模回归测试场景下效率受限。
视频质量不可调：固定分辨率与帧率，无法针对高清演示或移动端适配做精细化配置。
适合人群
- 远程协作团队：需要异步提交功能演示视频替代同步会议
- 开源项目维护者：要求 PR 附带可视化证据，降低 review 认知负荷
- 自由开发者/外包方：向客户交付"可观看的完成证明"，提升信任度
- 技术写作人员：快速生成功能更新的配图与视频素材
常规风险
浏览器版本漂移：Playwright 与 Chromium 版本强绑定，升级 Node 环境可能导致录制行为微妙变化，建议锁定依赖版本。
敏感数据泄露：录制脚本若操作含真实用户数据的本地环境，截图与视频可能意外捕获隐私信息，需建立数据脱敏规范。
长时间录制磁盘压力：未压缩的 webm 与 mp4 双格式存储，高分辨率长视频可能快速消耗存储空间。
断言误报风险：assert_visible 依赖 DOM 可见性而非功能正确性，视觉上存在但逻辑错误的元素会通过验证，需配合其他测试手段兜底。