Playwright 浏览器 QA
基于浏览器的前端质量检查——在 CLI、MCP 和操作员指定的浏览器之间进行解析链;默认无头模式,可选可见模式,硬失败严格可见模式。
概述
当任务涉及任何前端标记时,质量审查步骤会自动针对本地开发界面运行一次浏览器检查,并将截图、trace 和简短摘要写入每个任务的产物目录。对于不涉及前端的任务,该检查会静默跳过。如果主机上没有可用的浏览器工具,该步骤会记录一条发现并继续执行——工具缺失绝不会成为阻塞项。
解析链
内置的检测脚本(dev-tools/detect-playwright-tooling.sh)首先遵循 DATARIM_PLAYWRIGHT 中的显式覆盖(playwright-cli、playwright-mcp、env-browser 或 none),该覆盖会绕过探测。否则,它按以下顺序选择第一个可用的工具:命令行 Playwright、通过 MCP 桥接的 Playwright、通过环境变量提供的操作员指定浏览器二进制文件。如果三者均不存在,解析链返回「none」,该步骤会输出一行提示信息,而不是截图。
有头模式
- 默认——无头运行。无需显示器。
- 可见(宽松)——操作员通过标志或在原始任务说明中要求可见浏览器。如果有可用的显示器,浏览器会在屏幕上打开;如果没有,该步骤会记录一条提示并回退到无头模式。
- 可见(严格)——相同的标志,但契约更严格。如果显示器不可用,该步骤会以硬失败代码退出;操作员必须在有显示器的机器上运行。
通过 /dr-qa --headed 或 /dr-qa --headed-strict 请求模式,或通过 init-task frontmatter 键 qa_browser_mode(headed、headed-strict 或 skip 以抑制该检查)。
产物布局
每次运行都会写入一个带时间戳的子目录:datarim/qa/playwright-{TASK-ID}/run-<ISO-timestamp>/,其中包含 screenshot.png、可选的 trace.zip、合并的标准输出和标准错误日志,以及简短的 summary.md。一个 latest 符号链接指向最近一次运行(在不支持符号链接的文件系统上使用复制回退)。
并发
每个任务的锁可防止两个并行的质量审查运行相互覆盖对方的产物。该锁使用一种可移植机制,在没有标准锁定命令的系统上会优雅降级。
来源
随 Datarim v2.8.0 发布的契约。