用途：在 Playwright 中建立 AI 增强的视觉回归测试体系，指导设置、编写、审查或调试视觉测试、视觉 AI 集成和截图对比流水线。
主要能力：强调用 AI 视觉引擎替代纯像素匹配，以基线为唯一真源，开展组件级与页面级截图对比；覆盖多视口响应式测试、明暗与高对比主题测试、动态内容遮罩、跨浏览器矩阵，以及带人工审查门禁的 CI 集成。
使用方式：建议项目按 tests/visual 下分 pages、components、responsive、themes、cross-browser 组织，配合 fixtures、utils 与 git 跟踪的 screenshots 基线目录；在 playwright.config.ts 中配置 toHaveScreenshot 的 maxDiffPixels、maxDiffPixelRatio、threshold、animations，并定义 chromium/firefox/webkit 桌面、平板、移动等项目及 snapshotPathTemplate；通过 fixtures 关闭动画、定义 viewports 断点矩阵，用 screenshot 工具等待网络空闲、图片与字体加载并隐藏滚动条，用 masking 工具替换时间戳、头像、计数器并隐藏 tooltip 等噪声；测试示例涵盖首页 hero、导航、页脚、仪表盘侧边栏与统计卡片、按钮变体等。
适用场景：Web 应用视觉回归测试搭建、AI 视觉平台集成、响应式与主题视觉验证、Storybook 组件视觉测试、跨分支与环境基线管理、视觉审查门禁流水线。
限制：资料未提供具体安装命令、依赖版本、各 AI 视觉服务的配置细节与收费信息；文中代码为示例组织方式，实际落地需结合项目自行调整。