用途:Chrome Profile Bridge 是构建在 playwright-cli 之上的增强层,为浏览器自动化增加 Chrome 配置文件(profile)定向能力。当用户提到某个特定 Chrome 配置文件(如“用我的工作配置文件”“在 Jack 的浏览器中打开”),或需要访问依赖已有登录状态的站点(税务、银行、邮件)时,应优先使用本技能;若任务不需要特定配置文件,则直接使用 playwright-cli。
架构:本技能(配置文件定向)→ playwright-cli(浏览器控制)→ Chrome 扩展 → 真实 Chrome。相比 MCP(每会话加载约 25 个工具定义、约 114K tokens)、Claude in Chrome(屏蔽金融/银行站点、需 Anthropic 登录)和直接 CDP(Chrome 136+ 阻止默认用户数据目录的远程调试),本技能在 Chrome 内运行、无站点限制、保留全部登录状态。
前置条件:安装 @playwright/cli(npm install -g @playwright/cli@latest);从 Chrome 应用商店安装 Playwright MCP Bridge 扩展;从扩展状态页复制 Token 并设为 PLAYWRIGHT_MCP_EXTENSION_TOKEN 环境变量;将 scripts/pw 复制到 $PATH 中(如 ~/.local/bin/pw)。
用法:列出可用配置文件 pw list-profiles;打开浏览器 pw open --extension(默认配置文件)或 pw open --extension --pw-profile="Profile 1"(指定配置文件);随后可用全部 playwright-cli 命令控制浏览器,如 playwright-cli goto、snapshot、click、fill、screenshot、close。
浏览器卫生:使用真实配置文件时清理尤为重要,任务相关标签页需在结束前全部关闭,因为配置文件标签页在 playwright-cli close 后仍会保留;扩展桥接会话相互隔离,每个 pw open --extension 创建新窗口,tab-list 和 tab-close 仅影响该窗口,之前会话的标签页会成为孤儿,只能手动关闭;每次任务后清理临时文件 rm -rf .playwright-cli/*。
故障排查:ERR_BLOCKED_BY_CLIENT 表示目标配置文件未安装扩展;扩展超时表示 Chrome 打开了错误配置文件,可显式使用 --pw-profile="Default";Token 不匹配需核对环境变量与扩展状态页;应用商店版扩展 ID 为 mmlmfjhmonkocbjadbfplnigmagldckm,开发/侧载版 jakfalbnbhgkpmoaakfflhflbfpkailf 与 @playwright/cli 不兼容。