用途:通过 Chrome 扩展与本地原生宿主驱动用户真实的 Chrome 会话,适合依赖已登录浏览器状态(认证 Cookie、会话、已安装扩展)的自动化操作。
主要能力:列出并管理窗口与标签页、navigate 打开页面、snapshot 将页面转为带 @ref 的可操作快照、click/fill/type/keys 进行交互、wait 等待条件成立、get 读取单个值、screenshot/screencast 截图录屏、network/console 读取请求与控制台、js 执行脚本、viewport 模拟设备。
安装与用法:先 npm install -g chrome-relay@latest,再运行 chrome-relay install;用 chrome-relay --version 与 chrome-relay doctor 检查。会话开始先用 chrome-relay profile list 查看已连接实例。核心循环示例:chrome-relay tabs;chrome-relay navigate "https://kushalsm.com" --new;chrome-relay snapshot --tab 1234 -i;chrome-relay click @e12;chrome-relay wait --text "Saved" --tab 1234;chrome-relay snapshot --tab 1234 --diff。
多浏览器与多 Profile:支持 Chrome(含多 Profile)、Dia、Brave 等;每个已安装扩展的浏览器或 Profile 是独立可寻址实例。多实例时未指定范围的命令会报 profile_ambiguous。上传需要 CLI >= 0.8.0,多浏览器路由与上传在 0.8.0 起支持,Dia 检测与 Agent 友好 Profile 选择器在 0.8.1 起支持。
限制:ref 在真实导航后失效并返回 stale_ref;被浮层遮挡的点击返回 click_intercepted;多实例需显式指定 Profile;snapshot -i 只输出可交互元素,读取事实应使用完整快照、get text 或 js。别回显密钥,网络输出含 Cookie 与令牌应先脱敏。资料未提供价格与收费信息。