用途：在已配置的 Chrome DevTools MCP 上操作共享的、已登录的 Chromium 浏览器，完成浏览、调试、自动化、视觉检查以及控制台和网络分析，同时不影响用户与其他智能体正在使用的标签页和会话状态。
环境约定：以 ~/.local/libexec/mcp/chrome-devtools 及当前会话暴露的工具为准。包装器负责服务版本、参数、日志与浏览器附加，不要直接运行 MCP 包。MCP 只附加到已开启远程调试的浏览器；附加失败时不要另启浏览器或新建配置文件。只能查看与任务相关的页面，不要暴露无关标签页标题或内容。以实时工具清单为准，缺失的工具即当前会话不可用。
页面管理：交互前先调用 list_pages，将初始页面视为既有状态。需要新页面时优先使用 background: true 的 new_page，并记录每个新建页面返回的 pageId，不要靠页面列表差异推断归属。对每个页面级工具传入明确的 pageId；仅在需要置前时使用 select_page。只有在任务明确依赖某既有页面当前状态时才导航或修改它，且绝不关闭既有页面，任务结束时只关闭本任务创建的页面。
交互与证据：同一页面按导航、等待已知信号、获取新快照、用快照中的标识交互的顺序进行，导航或 DOM 显著变化后刷新快照。结构优先 take_snapshot，视觉证据用 take_screenshot，无障碍树没有的信息用 evaluate_script。动作响应默认 includeSnapshot: false，高流量结果需分页过滤。遇到 Cookie 弹窗默认只选必要或基本 Cookie；无此选项则全部接受。大文件用 filePath 写入任务授权路径或临时位置。
权限与隐私：只读检查任务相关登录状态是允许的；提交表单、切换账号、安装扩展、购买等外部变更需与浏览器外同等的授权。不要绕过网络请求头脱敏，也不要通过页面或进程探测获取凭据。
排障：附加或传输失败时，先访问 http://127.0.0.1:${PRB_AGENT_CHROMIUM_PORT:-9222}/json/version 检查调试端点，再查看 $XDG_CACHE_HOME/chrome-devtools-mcp/logs/ 或 ~/.cache/chrome-devtools-mcp/logs/ 下最新日志，报告失败层级；不要擅自另启浏览器、改客户端配置或改包装器参数。