playwright-cli 是一个基于 @playwright/cli 的浏览器自动化命令行工具,主要用于网页操作、页面快照、截图与设计评审场景。
主要能力:可用 open/goto 打开并导航页面,用 click、type、fill、hover、select、drag、drop、upload、check 等命令操作元素;用 snapshot 获取页面或指定元素的结构快照,并用快照中的 ref(如 e15)或 CSS 选择器、Playwright locator 定位元素。支持 screenshot 与 pdf 保存文件,resize 调整视口,go-back/go-forward/reload 导航,press/keydown/keyup 键盘操作,mousemove 等鼠标操作。
还支持标签页管理(tab-list、tab-new、tab-close、tab-select)、存储管理(state-save/state-load、cookie、localstorage、sessionstorage 系列命令)、网络请求拦截(route、unroute),以及 DevTools 能力:console、requests、run-code、tracing-start/stop、video-start/stop、show --annotate、generate-locator、highlight。全局 --raw 可仅返回结果值,便于管道处理;--json 可输出结构化 JSON。
使用方式:无全局安装时可用 npx @playwright/cli@latest 运行,或执行 npm install -g @playwright/cli@latest 安装。会话可用 -s=名称 隔离;open 支持 --browser=chrome/firefox/webkit/msedge、--persistent、--profile、--config;attach 支持通过扩展或 CDP 连接已运行浏览器;close、close-all、kill-all、delete-data 管理会话与数据。
典型场景:为 /review 捕获桌面与移动截图(如 resize 1440 900、375 812 后 screenshot),为 /improve --restructure 采集灵感页并缓存到 design/.cache/inspiration/,表单提交、多标签工作流、DevTools 调试、交互式标注会话等。
限制:具体收费、价格与平台支持范围资料中暂未提供;涉及截图输出路径与审计流程的约定由调用方命令或智能体决定。