用途:用于调试 Web 应用、诊断页面错误、检查控制台输出和截取页面截图。通过 Chrome DevTools Protocol 自动控制 Chrome,核心工具是 scripts/chromectl.py。
主要能力:启动 Chrome 实例(有头或无头)、打开页面、监控控制台输出、执行 JavaScript 表达式、截取截图、列出目标页面。支持协作调试(可见窗口,开发者与 Claude 共同操作)和自动化调试(无头后台运行)。
使用方式:常用命令包括 scripts/chromectl.py start(默认有头)、start --headless(无头)、open URL、console-tail --id $TARGET --for 30、screenshot --id $TARGET -o file.png、eval --id $TARGET -e "expression"、list、stop。目标 ID 可通过 open 命令配合 jq 提取。eval 支持 Promise,可检查页面状态、调用函数、触发点击或滚动等操作。
适用场景:调试 Web 应用问题、检查控制台错误与警告、截图识别视觉问题、实时监控页面行为、自动化页面检查、诊断 JavaScript 错误。不适用于一般网页浏览、直接编辑 HTML/CSS 或需要复杂用户交互的测试。
限制与注意:console-tail 只捕获命令启动之后的新消息,不显示历史消息;无头 Chrome 实例不可见且可能阻止正常 Chrome 启动,调试结束务必执行 stop;可在不同端口运行多个实例。详细命令参考见 references/chromectl-reference.md。