SuperAPI AI 工具集

chrome-replay

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:在用户当前的真实浏览器会话中回放 Chrome DevTools Recorder 导出的操作记录,借助 Chrome DevTools MCP 完成。前提是 Chrome MCP 已连接,不确定时可参考 context.md。

支持的输入格式:1) JSON(推荐),结构清晰、可渐进读取,适合用 jq 或 Python 分步检查,例如 jq '.steps | length' recording.json、jq '.steps[0:5]' recording.json;2) @puppeteer/replay JS(import { createRunner });3) Puppeteer JS(require('puppeteer')、page.goto、Locator.race)。三种格式语义相同,按实际提供的格式解析。

回放方式:按语义而非字面执行。记录只是参考,选择器、ID、坐标可能已失效,页面状态也可能不同。步骤:先解析记录并用一两句话概括意图;直接执行 navigate 步骤;对每个交互步骤先 take_snapshot,再定位目标元素,优先尝试 aria/... 选择器,其次 text/...、CSS 类提示、快照中的视觉上下文,不要依赖 ember ID、纯数字 ID 或精确 XPath。类型映射:navigate→navigate_page;click→take_snapshot 找 uid 后 click;change→点击元素后 type_text 或 fill;keyDown/keyUp→press_key;scroll→evaluate_script 配合 window.scrollBy;setViewport→emulate viewport;waitForElement→wait_for。每个重要步骤后应再次快照确认结果。

异常处理:可自动处理弹窗、横幅、Cookie 同意框、遮挡点击的提示层,关闭后继续。遇到需要登录或认证、出现 CAPTCHA、页面结构与记录明显不符、即将执行破坏性操作(如删除数据、提交真实表单)、同一步骤尝试超过两次仍卡住时,应暂停并向用户说明当前步骤、预期与实际所见。

限制:依赖 Chrome MCP 连接;记录中的选择器与坐标可能过期,需按语义重新定位;涉及认证、验证码或破坏性操作时无法自动完成,必须人工确认。MCP 配置、已知问题与 Chrome 启动说明见 context.md。