SuperAPI AI 工具集

chrome-cdp

测试与质量

查看项目

更新于 10-15 17:25

技能介绍

用途:通过 Chrome DevTools Protocol 连接本地 Chrome 会话,对已打开的页面进行检查、调试和交互。默认模式连接用户真实的 Chrome;加 --isolated 时使用独立沙盒配置,互不共享扩展、登录和 Cookie。

主要能力与用法:所有命令通过 scripts/cdp.mjs 执行,<target> 取 list 输出中的唯一 targetId 前缀。常用命令包括 list 列出页面、shot 截图(仅视口,需先滚动)、snap 获取无障碍树、eval 执行 JS、html 获取 HTML、nav 导航、net 资源计时、click/clickxy 点击、type 输入文本、loadall 循环加载更多、evalraw 透传原始 CDP 命令、open 开新标签、stop 停止守护进程。

前置条件:Node.js 22+(使用内置 WebSocket)。默认模式需在用户 Chrome 的 chrome://inspect/#remote-debugging 开启远程调试;隔离模式无需额外设置,由 scripts/chrome-debug.sh 按需启动。隔离模式为两步:先运行该启动脚本,再以 CDP_PORT_FILE="$HOME/.chrome-debug-profile/DevToolsActivePort" 前缀执行 cdp.mjs 命令。

坐标:截图按原生分辨率保存,图像像素 = CSS 像素 × DPR;CDP 输入事件使用 CSS 像素,即 CSS px = 截图图像 px / DPR,shot 会打印当前 DPR。

限制:Chrome 在每个标签首次访问时弹出调试允许弹窗;后台守护进程保持会话,闲置 20 分钟自动退出。多个 eval 之间 DOM 可能变化,避免按索引选择元素。跨源 iframe 输入应使用 type 而非 eval。绝不在未获用户批准时静默使用隔离模式;用户请求含糊时需询问。