[G6-03] 建立可重复的 demo fixture 和截图状态脚本

[NongHua123]

P1 · Marketing / QA

问题

临时手工摆出的截图无法复现，也容易混入个人账号、真实 Key 和状态不一致的数据。

交付与验收

• 提供无个人数据的 demo Provider、资源名、成功/失败状态和 canary 测试凭据。
• 每张截图有准备步骤、目标页面、预期状态、清理步骤和 evidence ID。
• 定义平台、窗口尺寸、DPI、主题、语言和 Agent/工具矩阵；首轮至少覆盖 zh-CN/en 与 Windows/macOS。
• fixture 和脚本绑定版本，旧状态不能在新 UI 上继续冒充当前证据。

[NongHua123]

补充：把“可重复截图”锁到同一捕获环境

建议把“截图可重复”拆成两个条件：同一 capture profile 下可以做像素比较；跨平台、跨系统版本或跨渲染环境只能检查状态是否一致，不能共用一张 golden。Playwright 官方明确提醒，截图会受 OS、版本、设置、硬件、供电状态和 headless 模式影响，基线应在相同环境中生成；toHaveScreenshot 会连续截取，直到两张结果一致后再与基线比较。它默认停用动画、隐藏输入光标，也允许设置 scale、stylePath、mask 和差异阈值。这里要加一条限制：stylePath 和 mask 只能处理已登记的时间戳、头像等波动区域，不能遮住错误、版本、关键状态，也不能改出产品本来没有的画面。

建议每次捕获保存：captureProfileId、fixture ID/version/hash、FyAgent SHA/build、Agent/Provider/version、OS 完整版本与架构、Playwright/浏览器版本及 channel、headless、viewport、窗口尺寸、DPR/scale、locale、timezone、主题、reducedMotion、字体包、固定时钟/seed、等待条件、截图选项、baseline hash 和 runId。Windows、macOS、zh-CN、en 各建基线；任一关键字段变化就标记 non_comparable，不能自动沿用旧基线。原生窗口、系统权限框或 WebView 以外区域不属于页面截图证据，应另存 native_window_capture。

验收再加三项：失败时保留 actual、expected、diff；更新 golden 必须关联 UI 变更与 reviewer；同一 profile 连跑两次均通过，才算可重复。

官方资料：

• https://playwright.dev/docs/test-snapshots
• https://playwright.dev/docs/api/class-pageassertions#page-assertions-to-have-screenshot-1
• https://playwright.dev/docs/api/class-testoptions

复核日期：2026-08-12