用途：为 Claude 提供浏览器访问能力，避免“盲写代码”，可在真实页面中查看渲染结果、排查控制台与网络问题、分析性能并模拟用户操作。
主要能力：视觉检查（截图、DOM 快照、查看渲染输出）；控制台与日志（读取控制台消息、捕获 JavaScript 错误）；网络分析（检查 API 请求/响应、分析请求头、调试 fetch 调用）；性能（录制 trace、测量 LCP、CLS、TBT 等 Core Web Vitals、定位瓶颈）；用户模拟（点击、填表、拖放、处理对话框）；设备仿真（模拟移动视口、限制 CPU/网络、测试响应式设计）。
使用方式：按顺序执行快速开始流程。先运行 bash scripts/detect_environment.sh 检测环境（windows、linux 或 wsl2）；再用 bash scripts/check_chrome.sh <environment> 验证 Chrome 是否安装，未安装时参考 references/chrome-installation.md，未安装完成前不要继续；接着用 claude mcp list | grep -i chrome 检查 MCP 服务状态，未安装则执行 claude mcp add chrome-devtools -- npx chrome-devtools-mcp@latest --browserUrl http://127.0.0.1:9222；然后运行 bash scripts/detect_dev_server.sh 检测开发服务器（检查 5173、5174、5175、3000、3001、8080、8000 端口）；再用 bash scripts/launch_chrome.sh <environment> <url> [headed] 启动带调试的 Chrome，headed 可选，省略则默认无头；最后用 curl -s http://127.0.0.1:9222/json/version 验证连接，并用 mcp__chrome-devtools__list_pages 工具测试。
适用场景：前端开发中的可视化调试、控制台与网络问题排查、性能分析、响应式与移动端测试、浏览器自动化操作。
限制与注意：需先安装并验证 Chrome；常见问题包括“Target closed”需关闭所有 Chrome 实例后带调试重启、模块未找到需清理 npm 缓存（rm -rf ~/.npm/_npx && npm cache clean --force）、连接被拒需确保以 --remote-debugging-port=9222 启动、端口占用需结束现有 Chrome 或换端口、沙箱中 Chrome 无法启动可用 --browserUrl 连接手动启动的 Chrome、WebDriver 登录被阻止可用 --autoConnect 连接正常浏览器会话。更多配置与排错见 references 目录下对应文档。