用途：为 ClawHub 的 UI 变更生成人类可读的视觉证据。代理应针对功能编写临时 Playwright 场景，而不是手动点界面。
模式：--mode before-after 用于缺陷修复、回归、文案或布局变更等需要主分支与候选对比的情况，是默认模式，会运行 origin/main 基线加候选 worktree；--mode feature 用于主分支不存在的新页面、新流程或新 UI 状态，只运行候选车道。
运行方式：每条证明车道默认全栈运行，其 Git checkout 会启动本地 Convex 后端、推送该车道的函数/模式，并基于车道本地 Convex URL 构建前端；需要夹具时加 --seed-command '<command>'。开发认证为可选项，仅在需要时用 --dev-auth 或显式 --env KEY=VALUE。场景放在 .artifacts/proof-scenarios/，导出一个 async 函数，接收 { baseURL, expect, page, proof }，每个 proof.step() 执行后截图。
命令：先干跑，默认前后对比：bun run proof:ui -- --mode before-after --scenario .artifacts/proof-scenarios/my-fix.pw.ts --dry-run；新功能仅候选：bun run proof:ui -- --mode feature --scenario .artifacts/proof-scenarios/my-feature.pw.ts --dry-run；真实桌面证明：bun run proof:ui -- --mode before-after --scenario .artifacts/proof-scenarios/my-fix.pw.ts --provider hetzner；带种子夹具：bun run proof:ui -- --mode before-after --seed-command 'bunx convex run --no-push devSeed:seedNixSkills' --scenario .artifacts/proof-scenarios/my-fix.pw.ts --provider hetzner。产物写入 .artifacts/clawhub-ui-proof/<timestamp>/，含截图、可用时视频、summary.json 和 report.md；feature 模式只有候选产物。仅将广泛有用的场景提升为 e2e/proofs/。
发布：在 PR 上展示时用 bun run proof:publish -- --proof-dir .artifacts/clawhub-ui-proof/<timestamp> --target-pr <number>，会把截图、视频预览 GIF、MP4、summary.json、report.md 复制到 qa-artifacts 分支并更新带标记的 PR 评论；起草评论体时先用 --dry-run。需要在 GitHub issue 中展示图片时，改用 here.now 链接而非直接上传附件，并附一句该图能证明什么。
限制：不要用 proof:ui 检查贡献者提供的截图、视频或日志；这些产物应直接审阅并说明其能证明或不能证明什么。