#剧作家鲍泽 ## 目的使用“playwright-cli”自动化浏览器——Playwright 的令牌高效 CLI。默认情况下无头运行，通过命名会话（`-s=`）支持并行会话，并且不会将工具模式加载到上下文中。 ## 关键细节 * **默认情况下是无头的** — 将 `--headed` 传递给 `open` 以查看浏览器 * **并行会话** — 使用 `-s=` 运行多个独立的浏览器实例 * **持久配置文件** — 调用之间保留的 cookie 和存储状态 * **令牌高效** — 基于 CLI，上下文中没有可访问性树或工具模式 * **视觉模式**（选择加入）- 设置“PLAYWRIGHT_MCP_CAPS=vision”以在上下文中接收屏幕截图作为图像响应，而不仅仅是保存到磁盘 ## 会议 **始终使用命名会话。** 从用户提示中派生出一个简短的、描述性的短横线命名。这为每个任务提供了一个在调用期间累积的持久浏览器配置文件（cookie、localStorage、历史记录）。 # 从提示上下文中获取会话名称： #“测试 mystore.com 上的结帐流程”→ -s=mystore-checkout #“从竞争对手的网站上抓取定价”→ -s=competitor-pricing # "UI 测试登录页面" → -s=login-ui-test playwright-cli -s=mystore-checkout 打开 https://mystore.com --persistent playwright-cli -s=mystore-checkout 快照 playwright-cli -s=mystore-checkout 单击 e12 管理会话： playwright-cli list # 列出所有会话 playwright-cli close-all # 关闭所有会话 playwright-cli -s= close # 关闭特定会话 playwright-cli -s=<名称> 删除数据 # 擦除会话配置文件 ## 快速参考核心：打开[url]，转到，点击，填写，输入，快照，截图[ref]，关闭导航：后退、前进、重新加载键盘：按、keydown 、keyup 鼠标：mousemove 、mousedown、mouseup、mousewheel 选项卡：选项卡列表、选项卡新 [url]、选项卡关闭 [索引]、选项卡选择 <索引> 保存：屏幕截图 [ref]、pdf、屏幕截图 --filename=f 存储：状态保存、状态加载、cookie-*、localstorage-*、sessionstorage-* 网络：路由<模式>、路由列表、取消路由、网络 DevTools：控制台、运行代码

、跟踪启动/停止、视频启动/停止
    会话：-s=<名称> 、列表、全部关闭、全部终止
    配置：open --headed、open --browser=chrome、调整大小  
    

## 工作流程

  1. 从用户提示中派生会话名称，并使用“--persistent”打开以保留 cookie/状态。始终在启动时通过 env var 设置视口：


    
    
    PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 playwright-cli -s=<会话名称> 打开  --persistent
    # 或标题：
    PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 playwright-cli -s=<会话名称> 打开  --persistent --headed
    # 或使用视觉（屏幕截图作为上下文中的图像响应返回）：
    PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 PLAYWRIGHT_MCP_CAPS=vision playwright-cli -s=<会话名称> 打开  --persistent
    

  3.通过快照获取元素引用：


    
    
    playwright-cli 快照
    

  4. 使用快照中的引用进行交互：


    
    
    playwright-cli 单击 
    playwright-cli 填充  “文本”
    playwright-cli 输入“文本”
    playwright-cli 按 Enter
    

  5. 捕获结果：


    
    
    playwright-cli 截图
    playwright-cli 屏幕截图 --filename=output.png
    

  6. **完成后始终关闭会话。** 这不是可选的 - 完成任务后关闭指定会话：


    
    
    playwright-cli -s=<会话名称> 关闭
    

## 配置

如果工作目录中存在“playwright-cli.json”，则会自动使用它。如果用户提供配置文件的路径，请使用“--config path/to/config.json”。否则，跳过配置 — 环境变量和 CLI 默认值就足够了。
    
    
    {
      “浏览器”：{
        “浏览器名称”：“铬”，
        "launchOptions": { "headless": true },
        “contextOptions”：{“视口”：{“宽度”：1440，“高度”：900}}
      },
      "outputDir": "./截图"
    }
    

## 完整帮助

运行“playwright-cli --help”或“playwright-cli --help ”以获取详细的命令用法。

有关完整文档，请参阅 [docs/playwright-cli.md]()。

剧作家鲍泽

包含技能