Playwriter 插件教程

按 Playwriter 官方 Getting started 走一遍。跑通标准：某个标签上的扩展图标变绿，并且 playwriter session new 能打出会话 id（例如 1），再用 -e 在你已经打开的 Chrome 里执行一条 Playwright。

本页商店截图是在自动化 Chromium 里打开的：会弹出 Switch to Chrome?，「Add to Chrome」是灰的。请用本机 Google Chrome 打开同一条商店链接再点添加。

1. 用 Chrome 安装扩展

1. 用 Google Chrome 打开：https://chromewebstore.google.com/detail/playwriter/jfeammnjpkecdekppnclgkkffahnhfhe
2. 点 Add to Chrome，在系统确认框里点添加。
3. 装完后点工具栏拼图图标，把 Playwriter 钉在工具栏。

官网入口也可以：https://playwriter.dev 点 Get Chrome Extension。

2. 在标签上点图标，等到变绿

官方写明：在你要控制的那个标签上点扩展图标，变绿才算连上。灰的标签不会被控制。Chrome 连上后，这个标签上会出现自动化横幅。

3. 安装 CLI 和 skill

官方命令（本机已跑过 npm i -g playwriter，CLI 版本 playwriter/0.7.0）：

npm i -g playwriter
npx -y skills add https://playwriter.dev

4. 先确认扩展已连接，再跑命令

扩展没点绿时，本机实测 playwriter session new 会先起本地 CDP relay（localhost:19988），然后等到超时：

ERROR code=extension_not_connected
No connected browsers detected. Click the Playwriter extension icon.

图标变绿后再跑官方 First commands（-e 外面用单引号）：

playwriter session new
playwriter -e "page.goto('https://example.com')"
playwriter -e "snapshot({ page })"

5. 翻车点

• 所有页变成 about:blank：官方已知 chrome.debugger 问题，重启 Chrome。
• 不要 browser.close()，那会把用户的 Chrome 关掉。
• Remote control 会把当前标签交给远端，只跟完全信任的人分享。

出处：playwriter.dev · README