Agent Skills
返回列表
💻

Chromium 实时会话调试器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/debug-live-chromium-sessions-with-browser-debugger-cli 技能。

技能介绍

要解决的具体问题

当代理需要调试失败的浏览器任务时，传统调试方式往往依赖事后复现，而实时会话中的关键信息会随着页面刷新或任务结束消失。开发者面临两个具体痛点：一是难以快速获取失败时刻的 DOM 结构变化，导致定位选择器或交互逻辑问题耗时；二是无法实时追踪控制台报错、网络请求与 CDP（Chrome DevTools Protocol）遥测数据，使异步任务失败的排查缺乏直接证据。

技能如何工作

该技能通过 browser-debugger-cli 建立与实时 Chromium 会话的连接，核心能力聚焦于数据拉取而非代码注入。具体工作方式包括：

  • DOM 快照提取：直接从当前会话中拉取完整的 DOM 树状态，支持分析动态生成的元素结构
  • 多维度数据整合：同时获取控制台输出、网络请求日志与 CDP 遥测数据，形成完整的调试上下文
  • 定向排查支持：通过命令行参数指定需要重点关注的数据维度，减少无关信息干扰

使用流程遵循「连接-拉取-分析」三步模式：首先通过 browser-debugger-cli 连接到已运行的 Chromium 实例，然后按需拉取指定类型的数据，最后结合上下文定位失败原因。这种工作方式避免了传统调试中「启动-配置-复现」的冗长链路，直接作用于实时会话。

适用边界与注意点

该技能适用于基于 Chromium 内核的浏览器（如 Chrome、Edge、Brave 等），且需要 Node.js 与 npm 环境支持。平台兼容性方面仅覆盖 macOS 与 Linux，Windows 用户需考虑 WSL 或其他兼容层方案。

使用时需注意：技能依赖实时会话的持续运行状态，若任务在拉取数据前已结束，将无法获取历史数据。对于需要模拟用户交互的场景，该技能不提供交互模拟能力，需结合其他自动化工具使用。此外，CDP 遥测数据的详细程度受浏览器版本与启动参数影响，建议结合官方文档调整调试配置。

文档参考

  • 上游仓库：https://github.com/1991513ccie-png/skills
  • 原始文档：https://raw.githubusercontent.com/szymdzum/browser-debugger-cli/HEAD/README.md

使用场景

  • 代理执行浏览器自动化任务失败，需要从实时会话中拉取DOM与控制台数据定位错误原因
  • 浏览器自动化脚本选择器失效，需要查看实时页面DOM结构确认元素是否正确渲染
  • AI代理调用浏览器执行任务时网络请求异常，需要拉取网络日志与CDP遥测数据排查问题
  • 浏览器任务执行过程中出现控制台报错，需要获取实时CDP遥测数据还原失败场景

适合人员

  • 负责编写浏览器自动化脚本、经常需要排查任务执行失败原因的开发工程师
  • 使用AI代理驱动浏览器完成网页操作、需要实时诊断失败问题的自动化工程师
  • 维护基于Chromium的测试流程、需要在任务失败时快速定位问题的QA工程师
  • 开发依赖浏览器环境的爬虫或数据采集工具、需要调试实时会话异常的后端工程师