SuperAPI AI 工具集

logged-in-google-chrome

通用与其它

查看项目

更新于 10-19 16:16

技能介绍

用途:该技能解决的问题是让 Playwright 自动化复用一个已经手动登录 Google 账号的 Chrome 会话,而不是由 Playwright 自行启动浏览器再登录。做法是先用专门的 user-data-dir 启动普通 Chrome 并开放 CDP 端口,待用户手动登录后,再由 Playwright 通过 CDP 附着上去执行自动化。

主要能力:

  1. 启动脚本 scripts/launch_logged_in_chrome.ps1,以独立配置目录和 CDP 端口启动普通 Chrome,并会等待对应 Chrome 进程与 CDP 端点就绪后才报告成功。
  2. 关闭脚本 scripts/close_logged_in_chrome.ps1,用于清理占用同一配置目录的残留浏览器。
  3. CDP 端口检查脚本 scripts/check_cdp_port.ps1,用于确认端点可达。
  4. 排错文档 references/troubleshooting.md。

默认值:user-data-dir 默认 D:\Prj\onizuka-playwright-profile;CDP 端口默认 9222;登录地址默认 https://accounts.google.com/。

使用方式:

  1. 运行 powershell -ExecutionPolicy Bypass -File .\scripts\launch_logged_in_chrome.ps1 启动浏览器;命令返回不代表启动成功,需脚本成功退出或由 check_cdp_port.ps1 确认端点。
  2. 若配置目录尚未登录,由用户手动完成 Google 登录。
  3. 在已安装 playwright 或 playwright-core 的本地工作区中,通过 chromium.connectOverCDP("http://127.0.0.1:9222") 附着,并复用获取到的 browser、context、page 句柄。
  4. 附着前先确认窗口属于专用配置目录、用户已完成手动登录、CDP 端点可达。

规则要点:不要从 Playwright 启动的 Chrome 窗口中登录 Google;不要让 Playwright 指向 %LOCALAPPDATA%\Google\Chrome\User Data;必须使用与日常 Chrome 配置分离的专用 user-data-dir;先启动普通 Chrome 再通过 CDP 附着;除进程变化外保持同一 CDP 浏览器连接,避免反复重连。

适用场景:需要在已登录 Google 账号的浏览器状态下执行页面导航与自动化操作的 Windows 环境任务。

限制:资料给出的脚本与命令面向 PowerShell/Windows;当出现“This browser or app may not be secure”、connectOverCDP() 失败、CDP 端点不可达、启动脚本返回但无进程使用专用配置、配置锁残留等情况时,需查阅排错文档。其他平台支持情况暂未提供。