SuperAPI AI 工具集

playwright-stable-profile

测试与质量

查看项目

更新于 10-16 00:00

技能介绍

用途:该技能用于需要稳定、持久会话的浏览器自动化任务,通过真实可见浏览器窗口(有头模式)运行 Playwright,并复用同一份用户目录,使标签页、Cookie 与登录状态得以保留。

主要能力与工作流:采用双脚本模型。脚本 scripts/start.js 负责初始化、启动浏览器、准备显示环境并报告就绪状态;scripts/pl.js 负责把 Playwright CLI 风格的命令转发到已启动的会话。使用前需确认 playwright-cli 存在,可通过 playwright-cli --help 检查,若不存在则参考 references/install-playwright-cli.md 安装。

必要用法:推荐用 pnpm 安装,命令为 pnpm add playwright playwright-cli。随后运行 node scripts/start.js 并等待其报告持久配置就绪,再运行 node scripts/pl.js ... 执行命令,例如 open、snapshot、click、close。默认使用 Playwright 自带的 Chromium,并在用户主目录下创建持久化配置,默认为 ~/.playwright-stable-profile/profile/,不会触碰用户日常使用的浏览器配置。

适用场景:需要保存登录状态、看重真实浏览器行为、涉及反机器人流程或验证码、以及要求浏览器一致性的自动化任务。有物理桌面时使用真实可见窗口;没有时可用 Xvfb 等虚拟显示方案。

限制与注意:规则要求始终使用有头模式,不应把无头模式作为默认答案。启动默认值硬编码在 scripts/start.js 中,如需修改应编辑该文件。清理时可终止浏览器进程,但默认不得删除持久化配置目录,恢复时也不应随意清除浏览器状态。全部命令与配置细节以用户提供的原始资料为准,其余信息暂未提供。