用途：调试失败的 Playwright E2E 测试。先按测试标题精确定位并单跑该用例，开启 tracing、禁用重试，再用 npx playwright trace 命令行工具分析 trace，定位失败根因。
主要流程：确认要调试的测试名（未提供则询问，不猜测、不跑整个套件）；从 playwright.config 读取 testDir 并递归搜索匹配 title，多个匹配时让用户选择；通读 spec 理解 setup 与 fixtures。运行：npx playwright test -g "<exact test title>" --trace on --retries 0，必要时加 --project=<name>。若通过则提示可能不稳定并停止；若失败则提取错误、断言差异、堆栈与 trace zip 路径，必要时用 ls -t test-results/**/trace.zip 找最新 trace。
分析：npx playwright trace open <path-to-trace.zip>；用 trace actions 列出动作，✗ 为失败，可加 --grep="expect" 过滤；trace action <number> 查看详情；trace snapshot <action-number> --name after（或 before）查看页面快照；相关时用 trace requests、trace request <id> 查网络，用 trace console、trace errors 查控制台与页面错误；最后 trace close。
报告：说明失败测试的文件与标题、根因、证据（错误信息、期望与实际、快照）、失败行（path:line）与修复建议，并区分测试缺陷、应用缺陷与环境问题。修复简单且位于测试内时直接改并重跑验证，不加 --trace；问题不明确或为应用/环境问题时说明并提出后续步骤，不用超时、重试或 force: true 掩盖真实缺陷。
限制：仅用于 Playwright 测试调试；需用户提供测试名；trace 分析须用 CLI 而非会阻塞的 show-trace GUI；其他细节暂未提供。