用途：通过 --debug=cli 启动 Playwright 测试，再用 playwright-cli 附加到暂停的实时会话，在测试执行中途探查页面，定位失败原因。与检查冻结 trace 的方式不同，它驱动的是活浏览器。
主要能力：用 pause-at <file>:<line> 在指定源码行设断点，无需在 spec 中插入 page.pause()，也不修改源码；可 snapshot 获取带 eN 引用的 DOM 快照、generate-locator 生成定位器、eval 读取元素或页面状态、console 查看控制台、requests/request 检查网络、step-over 单步、run-code 执行 Playwright TS 片段。
使用方式：先收集测试文件路径、测试名、暂停行号和可选失败提示；校验文件存在、行号位于目标测试体内、工作区无活动 tw-* 会话，并识别项目。随后后台运行 PLAYWRIGHT_HTML_OPEN=never npx playwright test <test-file> -g "<test-name>" --project=<proj> --debug=cli，轮询日志提取 tw-XXXXXX 会话 id，执行 npx playwright-cli attach <session>，再 npx playwright-cli -s=<session> pause-at "<test-file>:<line>" 与 resume。之后每次调用都需带 -s=<session>。诊断后报告根因、证据与建议修复，应用修复前需征得用户同意。
适用场景：调试 Playwright E2E 测试中的定位器漂移、缺少等待、竞态、应用或环境问题。
限制：必须提供四项输入，不能跳过；若 resume 返回 Session closed 说明断点不可达，需重查行号；结束时必须执行 npx playwright-cli close-all 清理，必要时用 kill-all；修复后重跑若仍失败，不自动再次进入调试会话。具体收费、平台与效果资料暂未提供。