精通 Playwright CLI：您的 Token-Smart 浏览器自动化指南
Source: Dev.to
请提供您想要翻译的完整文本内容（除代码块、URL 和上述来源链接之外），我将为您将其翻译成简体中文并保持原有的 Markdown 格式。
理解两个 Playwright CLI
以下是让开发者感到困惑的地方：Playwright 生态系统实际上有 两个不同的 CLI。
| CLI | 目的 |
|---|---|
npx playwright | 用于运行和管理测试的标准 CLI |
playwright-cli | 微软为 AI 编码代理设计的新版工具 |
两者各有用途。让我们逐一探讨。
标准 Playwright 测试 CLI
这是你的日常使用工具。每个 Playwright 项目都依赖这些命令。
# 运行所有测试
npx playwright test
# 运行单个测试文件
npx playwright test tests/login.spec.ts
# 以有头模式运行（可看到浏览器）
npx playwright test --headed
# 在指定浏览器中运行
npx playwright test --project=chromium
# 使用指定的报告器
npx playwright test --reporter=html这些命令构成了每个 Playwright 测试工作流的基础。
Source: …
新的 Microsoft playwright-cli
Microsoft 发布了一个专门用于 AI 编码代理的独立 CLI 工具。为什么？为了提升 token 效率。
MCP 的问题
MCP（模型上下文协议）浏览器工具存在一个关键缺陷：每一次浏览器交互都会把大量数据返回给模型，包括：
- 完整的可访问性树
- 控制台日志
- 页面结构元数据
- 工具模式
仅仅几次交互后，模型的上下文窗口就被浏览器状态占满，而不是实际的推理或代码。这导致：
- 更高的 token 使用量和成本
- 响应变慢
- 早期上下文丢失
- 长会话的可靠性下降
playwright-cli 如何解决
playwright-cli 不再把整个浏览器状态推入模型上下文，而是将浏览器状态保留在外部，仅交换最小、结构化的信息。
安装
npm install -g @playwright/cli@latest
playwright-cli --help核心命令
# 打开 URL
playwright-cli open https://example.com/ --headed
# 输入文本
playwright-cli type "Hello World"
# 按键
playwright-cli press Enter
# 点击元素（使用快照中的引用）
playwright-cli click e21
# 填写表单字段
playwright-cli fill e15 "user@example.com"
# 截图
playwright-cli screenshot
# 获取页面快照以获取元素引用
playwright-cli snapshot实际示例
下面是使用 playwright-cli 的购物流程：
# 打开商店
playwright-cli open https://storedemo.testdino.com/ --headed
# 捕获页面状态并获取元素 ID
playwright-cli snapshot
# 使用引用 ID 点击商品
playwright-cli click e255
playwright-cli click e291
playwright-cli click e327
# 购物车更新后快照
playwright-cli snapshot
# 前往结算
playwright-cli click e2609工作流程：open 启动浏览器，snapshot 为元素分配类似 e2609 的引用，click 则使用这些引用进行交互。只有在页面状态变化时才进行快照，从而保持交互的 token 效率。
为什么令牌效率很重要
MCP 工具在每次交互时都会发送大量数据（完整的可访问性树、控制台日志、页面元数据）。经过几次交互后，上下文窗口会被浏览器状态占满，而不是用于推理，导致成本上升、响应变慢以及上下文丢失。
playwright-cli 颠覆了这种模式。它将浏览器状态保留在外部，只交换极少的信息：如 e15、e21 之类的元素引用，而不是完整的 DOM 树。这实现了：
- 更长的浏览器会话
- 更快的操作速度
- 在大型代码库中实现可扩展的自动化
何时使用每个 CLI
Standard Playwright CLI – 用于：
- 以人为本编写/调试测试
- 丰富的报告（HTML、跟踪、视频）
- CI/CD 流水线集成
playwright-cli – 用于：
- AI 代理驱动的浏览器操作
- 令牌成本重要的长推理会话
- 确定性、低噪声的交互
最佳实践： 两者皆用。npx playwright test 用于执行，playwright-cli 用于 AI 辅助的探索。
Source:
超越测试执行
测试执行只是战斗的一半。当测试套件规模超过几十个测试时，会出现新的挑战：
- HTML 报告变得嘈杂且耗时
- 重复的失败可能有不同的根本原因
- 不稳定的测试隐藏了真实的回归
- CI 只显示 什么 失败，而不显示 为什么
故障分拣成为瓶颈。
这时，智能分析可以补足执行。像 TestDino 这样的工具通过 AI 驱动的分类，对跨运行的结果进行分析：
npx tdpw upload ./playwright-report --token="YOUR_API_KEY"TestDino 帮助团队：
- 按根本原因对失败进行分组
- 检测不稳定行为
- 将新回归与重复出现的问题区分开来
层次化的方法——使用 Playwright CLI 执行、使用 playwright-cli 探索、以及智能分析——创建了可扩展的工作流，支持快速执行、令牌高效的 AI 交互以及自动化的故障分拣。
结论
Playwright 生态系统现在提供了两种强大的 CLI 体验，各自针对特定用途：
- Playwright Test CLI – 仍然是编写、运行和调试测试的关键工具。
playwright-cli– 代表了通过令牌效率和最小上下文交换向 AI 原生工具转变的趋势。
它们共同构成了现代浏览器自动化的完整工具包——无论您是人类开发者还是 AI 编码代理。
想要完整的深入了解吗？请查看完整解析，地址为 testdino.com/blog/playwright-cli/。