browser_visual
Capture visual baselines, compare screenshots, detect UI issues, and review visual reports for automated visual regression testing.
Instructions
视觉回归与 UI 检查工具（v1.9.5 起合并 browser_visual_baseline/compare/report/check/snapshot + screenshot_diff）。通过 mode 参数区分子模式：baseline（默认，建立视觉基线 PNG）/ compare（截取实际图与基线对比，生成 diff）/ report（列出所有视觉产物）/ check（无基线 UI 问题扫描）/ snapshot（三级快照：截图+DOM+CSS）/ diff（手动指定两张截图对比，等价于已废弃的 screenshot_diff）。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | 视觉模式：baseline（默认，建立基线）/ compare（与基线对比）/ report（列出视觉产物）/ check（UI 问题扫描）/ snapshot（三级快照）/ component（组件级元素视觉比对，需指定 name 和 selector）/ diff（手动对比两张截图，等价于 screenshot_diff） | baseline |
| name | No | 基线/对比/产物名称，不含扩展名（mode=baseline/compare/component/diff 时使用；mode=component 时必填） | |
| fullPage | No | 是否全页截图，默认 true；selector 存在时忽略（mode=baseline/compare/snapshot 时使用） | |
| selector | No | 可选 CSS 选择器；指定后只截取该元素（mode=baseline/compare/snapshot/diff 时使用；mode=component 时必填） | |
| severity | No | 最低报告级别（mode=check 时使用），默认 major | major |
| afterPath | No | actualPath 的别名（mode=diff 时使用） | |
| threshold | No | 差异阈值，默认 0.01（mode=diff 时使用） | |
| viewports | No | 响应式检查的 viewport 列表（mode=check 时使用） | |
| actualPath | No | 实际截图路径（mode=diff 时使用） | |
| beforePath | No | baselinePath 的别名（mode=diff 时使用） | |
| sessionName | No | 浏览器会话名称，默认当前活跃会话（mode=baseline/compare/snapshot/component 时使用） | |
| baselinePath | No | 基线截图路径（mode=diff 时使用） | |
| detectIssues | No | 是否自动检测 UI 问题，默认 true（mode=snapshot/check 时使用） | |
| maskSelectors | No | 截图前额外遮挡/脱敏的 CSS 选择器列表，用于忽略动态区域（mode=baseline/compare 时使用） | |
| viewportWidth | No | 自定义 viewport 宽度（mode=snapshot 时使用） | |
| viewportHeight | No | 自定义 viewport 高度（mode=snapshot 时使用） | |
| includeMetadata | No | 是否包含完整元数据，默认 true（mode=snapshot 时使用） | |
| includeResponsive | No | 是否包含响应式检查，默认 false（mode=check 时使用） | |
| maxDiffPixelRatio | No | 组件级视觉比对允许的最大差异像素比例，默认 0.01（mode=component 时使用） | |
| includeAccessibility | No | 是否包含可访问性检查，默认 true（mode=check 时使用） |