Playwright CLI 技能：终端浏览器自动化与测试指南 | 无需全局安装
The Agent Skills Directory
97 周安装量
安装命令
npx skills add https://smithery.ai/skills/openai/playwright🇨🇳中文介绍
Playwright CLI 技能
使用 playwright-cli 从终端驱动真实浏览器。优先使用捆绑的包装器脚本，这样即使 CLI 未全局安装也能工作。将此技能视为 CLI 优先的自动化。除非用户明确要求测试文件，否则不要转向 @playwright/test。
先决条件检查（必需）
在提出命令之前，请检查 npx 是否可用（包装器依赖于此）：
command -v npx >/dev/null 2>&1
如果不可用，请暂停并请用户安装 Node.js/npm（它提供 npx）。请逐字提供以下步骤：
# 验证 Node/npm 是否已安装
node --version
npm --version
# 如果缺失，安装 Node.js/npm，然后：
npm install -g @playwright/cli@latest
playwright-cli --help
一旦 npx 存在，就继续使用包装器脚本。全局安装 playwright-cli 是可选的。
技能路径（设置一次）
export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export PWCLI="$CODEX_HOME/skills/playwright/scripts/playwright_cli.sh"
用户作用域下的技能安装在 $CODEX_HOME/skills 下（默认：~/.codex/skills）。
快速开始
使用包装器脚本：
"$PWCLI" open https://playwright.dev --headed
"$PWCLI" snapshot
"$PWCLI" click e15
"$PWCLI" type "Playwright"
"$PWCLI" press Enter
"$PWCLI" screenshot
如果用户偏好全局安装，这也是有效的：
npm install -g @playwright/cli@latest
playwright-cli --help
核心工作流程
- 打开页面。
- 快照以获取稳定的元素引用。
- 使用最新快照中的引用进行交互。
- 在导航或显著的 DOM 更改后重新快照。
- 在有用时捕获工件（截图、pdf、追踪）。
最小循环：
"$PWCLI" open https://example.com
"$PWCLI" snapshot
"$PWCLI" click e3
"$PWCLI" snapshot
何时需要再次快照
在以下情况后再次快照：
- 导航
- 点击会显著改变 UI 的元素
- 打开/关闭模态框或菜单
- 标签页切换
引用可能会过时。当命令因引用缺失而失败时，请再次快照。
推荐模式
表单填写和提交
"$PWCLI" open https://example.com/form
"$PWCLI" snapshot
"$PWCLI" fill e1 "user@example.com"
"$PWCLI" fill e2 "password123"
"$PWCLI" click e3
"$PWCLI" snapshot
使用追踪调试 UI 流程
"$PWCLI" open https://example.com --headed
"$PWCLI" tracing-start
# ...交互...
"$PWCLI" tracing-stop
多标签页工作
"$PWCLI" tab-new https://example.com
"$PWCLI" tab-list
"$PWCLI" tab-select 0
"$PWCLI" snapshot
包装器脚本
包装器脚本使用 npx --package @playwright/cli playwright-cli，因此 CLI 无需全局安装即可运行：
"$PWCLI" --help
除非仓库已经标准化使用全局安装，否则优先使用包装器。
参考
只打开你需要的：
- CLI 命令参考：
references/cli.md - 实用工作流程和故障排除：
references/workflows.md
防护措施
- 在引用像
e12这样的元素 ID 之前，始终先快照。 - 当引用似乎过时时，重新快照。
- 除非必要，优先使用显式命令而非
eval和run-code。 - 当你没有最新的快照时，使用占位符引用如
eX并说明原因；不要用run-code绕过引用。 - 当视觉检查有帮助时，使用
--headed。 - 在此仓库中捕获工件时，使用
output/playwright/并避免引入新的顶级工件文件夹。 - 默认使用 CLI 命令和工作流程，而不是 Playwright 测试规范。
每周安装数
97
来源
首次出现
2026年3月6日
安全审计
安装于
codex80
gemini-cli75
opencode74
github-copilot72
amp71
cline71
🇺🇸English
Playwright CLI Skill
Drive a real browser from the terminal using playwright-cli. Prefer the bundled wrapper script so the CLI works even when it is not globally installed. Treat this skill as CLI-first automation. Do not pivot to @playwright/test unless the user explicitly asks for test files.
Prerequisite check (required)
Before proposing commands, check whether npx is available (the wrapper depends on it):
command -v npx >/dev/null 2>&1
If it is not available, pause and ask the user to install Node.js/npm (which provides npx). Provide these steps verbatim:
# Verify Node/npm are installed
node --version
npm --version
# If missing, install Node.js/npm, then:
npm install -g @playwright/cli@latest
playwright-cli --help
Once npx is present, proceed with the wrapper script. A global install of is optional.
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
