agent-browser-visual 是 agent-browser 技能中的内部模板，入口为 agent-browser 技能。它定义了一套视觉证据采集与回归测试的执行协议，核心围绕 agent-browser 命令行工具展开。
用途方面，文档给出用例决策树，将目标映射到命令：在部署前后捕获视觉回归使用 diff screenshot --baseline；并排比较预发与生产使用 diff url；检测 DOM 结构变化使用 diff snapshot；制作可分享的演示或缺陷报告视频使用 record start 到 record stop；为文档或工单生成标注截图使用 screenshot --annotate；捕获完整网络轨迹用于性能或调试使用 network har start 到 network har stop。
主要能力包括：视觉回归对比与阈值控制，文档说明默认阈值 0.1 可容忍抗锯齿和轻微渲染差异，0.05 可捕获细微颜色或字体变化，0.01 为像素级敏感，0.2 为动态内容区域的宽容模式；可通过 -s 参数限定到特定元素以减少无关区域噪声；可对比两个环境的 URL 快照，并可选截图和全页。DOM 快照差异支持与当前会话上次快照或保存的基线文件对比，支持 -s 限定范围、-c 紧凑和 -d 深度限制。视频录制支持从新 URL 录制、先打开页面再录制以保留认证状态，以及 record restart 用于重拍；WebM 转 GIF 给出 ffmpeg 命令示例。标注截图会输出带编号标签和元素名称图例的图片。HAR 录制可捕获完整网络轨迹，用于诊断慢页面、验证 API 调用和审计第三方请求。
使用方式上，文档提供了完整工作流示例：先 open 再 wait --load networkidle 再截图建立基线，变更后同样等待网络空闲再执行 diff screenshot 对比，并可限定元素范围。视频录制建议先 open 和 wait，再 snapshot 探索并规划动作，最后 record start。HAR 必须在导航前启动。
适用场景包括：部署前后视觉回归检查、预发与生产对比、DOM 结构变化验证、演示与缺陷报告视频制作、文档与工单标注截图、性能调试与第三方请求审计。
限制与注意事项：文档以“绝不”规则列出，包括绝不在 wait --load networkidle 前比较截图，因为动画帧会导致误报；绝不对像素级检查使用默认差异阈值；绝不在有意 UI 变更后跳过基线更新，否则过期基线会持续产生误报；绝不在导航后启动 network har start，HAR 必须在要捕获的请求之前开始；绝不在打开页面前启动 record start，应在 open 和 wait 之后开始以保留认证状态。恢复模式表还列出动画或加载导致差异时增加 wait 500，过于敏感时提高阈值，漏报真实回归时降低阈值，视频过大时缩小录制范围，HAR 缺失早期请求时重启，录制丢失认证状态时先 open 和 wait 再录制。常见陷阱部分再次强调截图前等待页面稳定、有意设计变更后更新基线、diff screenshot 必须提供 --baseline、HAR 必须在 open 或 reload 前启动、录制前先打开页面。