proof-video 用于为代码改动提供可核验的浏览器证据。它基于 ClawHub 的真实浏览器证明运行器,记录并剪辑功能展示或前后对比视频,附加到 GitHub PR。
用途与要求:录制前先声明被验证的行为、源码引用、本地 URL、fixture 和预期可见结果;前后对比须保持相同视口、主题、账号、数据和交互顺序。必须使用真实本地实例、真实隔离浏览器,不得用 HTML 模拟、合成截图、拦截的成功响应或手写 UI 充当证据。
主要能力:捕获真实 UI 状态(加载、空、典型、密集、错误、权限等),支持桌面与移动端;用 ffmpeg/ffprobe 剪辑,烧入一到两行字幕,做 1.5–2× 聚焦缩放,空闲等待可加速但需标注倍率,关键结果保持原速并停留数秒;前后对比中明确标注 BEFORE 失败基线与 AFTER 成功结果。
使用方式:用现有运行器配合任务场景,示例命令为 bun run proof:ui -- --runner local --mode feature --scenario .artifacts/proof-scenarios/example.pw.ts --candidate-url http://127.0.0.1:3000,前后对比用 --mode before-after 及 --baseline-url/--candidate-url。发布前须逐帧检查截图与视频,确认状态、文字、取景、时序和隐私。附加到 PR 使用 gh pr comment 与 --attach,视频仅支持 .mp4/.mov/.webm 且不能带 #alt 后缀,视频 URL 需单独成行。上传后资源不可删除,须先检查脱敏。
限制:不得把媒体提交到任何仓库分支;旧 proof:publish 已弃用;若 gh 不支持 --attach 需更新 CLI 或改用官方上传流程,失败时应如实报告而非声称已发布。资料未提供具体收费、平台范围与性能数据。