用途:pwdebug 提供基于 Playwright 的命令行工具,用于操作真实浏览器实例进行前端调试,并可在多次命令间复用同一浏览器会话。
主要能力:启动常驻浏览器服务;在新标签页打开页面;执行 JS 表达式;截图(支持全页);交互式拾取元素;监听控制台日志;查看最近日志。当前仅支持 Chromium,通过 CDP 连接。
使用方式:工作目录应为该文件所在目录,示例命令默认从该目录执行。必须直接执行脚本,不要用 uv run python 或 python。启动浏览器服务:./scripts/pwdebug.py start;打开页面:./scripts/pwdebug.py nav https://example.com --new;执行 JS:./scripts/pwdebug.py evaluate "document.title";截图:./scripts/pwdebug.py screenshot --full;拾取元素:./scripts/pwdebug.py pick "点击登录按钮";监听日志:./scripts/pwdebug.py watch-logs;查看日志:./scripts/pwdebug.py logs 100。CLI 入口为 ./scripts/pwdebug.py,日志路径 ~/.cache/pwdebug/console.log.jsonl,状态路径 ~/.cache/pwdebug/server.json。
依赖与安装:脚本依赖通过 uv --script 管理。
限制:仅支持 Chromium;必须直接执行脚本,不能通过 uv run python 或 python 调用。其他平台、收费与效果信息暂未提供。