用途：在不打开浏览器的情况下检查 Playwright 测试生成的 .zip 追踪文件，属于文件分析工作流，区别于实时浏览器的 tracing-start/tracing-stop。
前置与入口：追踪文件命令由项目内的 playwright 包提供，而非全局 @playwright/cli。先执行 npm ls --depth=0 playwright @playwright/test 确认依赖，再优先用本地可执行文件：npx --no-install playwright trace open test-results/my-test/trace.zip。若项目未提供 playwright，需先获批准再安装 @playwright/test 或 playwright。全局 CLI 可录制实时追踪，但不提供文件检查命令。
工作流：先用 trace open 解压并查看元数据；trace actions 列出动作及 ID，支持 --grep 与 --errors-only；trace action <action-id> 查看参数、日志、源码与快照阶段；trace requests、trace console、trace errors 提供跨切面视图；trace snapshot <action-id> 获取 DOM 快照或对其运行浏览器命令；trace close 清理解压数据。open 之后的命令作用于当前追踪，打开新追踪会替换旧的。
主要命令：trace requests 支持 --grep、--method、--failed，trace request <request-id> 查看头、正文与安全信息；trace console 支持 --errors-only、--browser、--stdio、--grep；trace attachments 与 trace attachment <编号> -o out.png 处理附件。快照命令仅三类浏览器命令有用：snapshot、eval、screenshot，可用 --phase 指定阶段，用 --filename 重定向输出。
适用场景：排查失败动作、查看某时刻页面状态、查询 DOM、检查网络与控制台错误。
限制：运行于冻结快照上的浏览器命令仅 snapshot、eval、screenshot 有效；需项目提供 playwright 包；跨 GitHub Copilot、Claude Code、Codex 使用时需把文件夹放到相应技能路径，Codex 需同步到 $CODEX_HOME/skills/playwright-trace 并重启。无必需 MCP 服务器，不可在宿主未暴露时声称使用了 MCP。未提供的收费、价格等信息暂未提供。