讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Chrome Devtools Remote

Polar Sponsor
爱发电 赞助
.NET 9.0

使用chrome-devtools CLI通过HTTPS驱动远程chrome-devtools-mcp服务器(通常部署在tailnet上)。用于用户需要导航、截屏等操作时。

chrome-devtools-remote. 您正在远程运行 chrome-devtools CLI , 以对抗用户运行在另一个主机上的 chrome-dev

功能概述

chrome-devtools-remote. 您正在远程运行 chrome-devtools CLI , 以对抗用户运行在另一个主机上的 chrome-dev是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。

核心要点

  • 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
  • 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
  • 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

chrome-devtools-remote

您正在以 远程 模式运行 chrome-devtools CLI,连接至用户在另一台主机上运行的 chrome-devtools-mcp 服务端。该远程服务端拥有并管理浏览器实例;您的职责是驱动它完成操作。

何时使用此能力

当收到以下任一请求时触发:

  • 明确指定了远程机器(例如“在实验室 Mac 上”、“在主机 X 上”、“在我的 Tailnet 主机上”),并要求执行浏览器相关操作;
  • 提供了 chrome-devtools-mcp 的 HTTPS URL(通常以 /mcp 结尾),并请求执行交互式浏览器操作;
  • 提到了环境变量 CHROME_DEVTOOLS_MCP_REMOTE_URL 或 CHROME_DEVTOOLS_MCP_REMOTE_INSECURE。

若用户希望控制一台 本地 浏览器,请改用标准的 chrome-devtools CLI(不带 --remote 参数),或使用 mcp__chrome-devtools__* MCP 工具。

安装(本地主机上仅需一次)

chrome-devtools 客户端 CLI 与服务端同属一个 npm 包。请在运行 agent 的机器上全局安装 —— 不要 在远程主机上安装:

npm install -g @vibebrowser/chrome-devtools-mcp
chrome-devtools --version   # 应输出 0.26.6 或更高版本

您无需在远程主机上安装任何内容 —— 远程主机应已部署好 https://.../mcp 服务,并通过带外方式完成配置。

常见问题排查:

  • command not found: chrome-devtools — npm 全局 bin 路径未加入 PATH。请将 $(npm config get prefix)/bin 添加至 PATH;若使用 macOS Homebrew,则在 shell 配置文件(如 ~/.zshrc)中添加 eval "$(brew shellenv)"。
  • 首次运行时报错 Cannot find package 'pkce-challenge' — 属已知打包缺陷(issue dzianisv/chrome-devtools-mcp#17)。临时解决方案:cd "$(npm root -g)/@vibebrowser/chrome-devtools-mcp" && npm install pkce-challenge --no-save。

连接

请在每个 shell 会话中 仅配置一次 终端地址,并在执行其他操作前验证连通性。

export CHROME_DEVTOOLS_MCP_REMOTE_URL="https://lab.tailnet.ts.net/mcp"
chrome-devtools status --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"

健康响应将打印 status=ok http=200 及一段 JSON 正文。任何其他响应均为硬性失败 —— 请直接向用户呈现错误信息,切勿重试。

若未设置 URL,请向用户询问一次终端地址。推荐格式为:https:///mcp(/mcp 路径为必需项;仅访问裸域名将返回 404)。

连接时可选参数说明:

场景 应传入的参数
自签名证书(常见于未使用 Tailscale 签发证书的 Tailnet 环境) 每次调用均加 --insecure,或设置环境变量 export CHROME_DEVTOOLS_MCP_REMOTE_INSECURE=1
Bearer Token 网关认证 --header "Authorization: Bearer $TOKEN" —— 可重复指定,不缓存,每次调用均需显式传入
自定义静态请求头(例如 X-Tenant: foo) --header "X-Tenant: foo"
终端位于 Tailscale 后方,但 status 返回 Failed to reach remote 在本地运行 tailscale status;可能原因:目标主机离线,或 URL 中主机名错误

一旦 status 返回成功,后续所有形如 chrome-devtools ... --remote "$URL" 的调用,都将复用同一个服务端标签页(Tab),其会话 ID 以粘性方式缓存在 ~/.cache/chrome-devtools-mcp/remote/.session 中。

会话模型 —— 在组合多条命令前请务必阅读

每次 CLI 调用均复用存储于 ~/.cache/chrome-devtools-mcp/remote/.session 下的粘性会话 ID。这意味着:

  • navigate_page → take_snapshot → click → take_screenshot 均作用于 同一 服务端标签页。您可以将其拆分为多个独立 CLI 调用并默认保持上下文连续性。
  • 若服务端在两次调用之间重启,下次调用将自动透明地初始化一个新会话。服务端标签页状态将丢失 —— 请在继续操作前重新导航至目标页面。
  • 如需显式终止服务端会话并释放其浏览器上下文,请运行:chrome-devtools stop --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"。

常用操作

所有命令均支持 --output-format json 参数,以返回结构化输出,便于通过管道传递给 jq 等工具处理。

# 打开网页
chrome-devtools navigate_page "https://example.com" --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"

# 获取结构化可访问性快照(用于查找可点击元素的 uid)
chrome-devtools take_snapshot --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL" --output-format json

# 根据快照中获取的 uid 点击元素
chrome-devtools click "$UID" --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"

# 向输入框填充内容
chrome-devtools fill "$UID" "value" --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"

# 截图(保存至本地 /tmp/.png)
chrome-devtools take_screenshot --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"

# 在页面中执行 JavaScript —— 返回值必须为 JSON 可序列化类型
chrome-devtools evaluate_script '() => document.title' --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"

# 读取页面控制台日志
chrome-devtools list_console_messages --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"

# 列出页面加载以来的所有网络请求
chrome-devtools list_network_requests --remote "$CHROME_DEVTOOLS_MCP_REMOTE_URL"

实用示例

对已部署 Web 应用进行冒烟测试

URL="$CHROME_DEVTOOLS_MCP_REMOTE_URL"
chrome-devtools navigate_page "https://app.example.com" --remote "$URL"
chrome-devtools evaluate_script '() => ({title: document.title, ready: document.readyState})' --remote "$URL"
chrome-devtools list_console_messages --remote "$URL" --output-format json
chrome-devtools take_screenshot --remote "$URL"

若 console_messages 输出中包含任意 level: "error" 条目,请向用户明确呈现 —— 这类错误通常是“页面显示异常”类问题的根本原因。

驱动登录表单

chrome-devtools navigate_page "https://app.example.com/login" --remote "$URL"
chrome-devtools take_snapshot --remote "$URL" --output-format json > /tmp/snap.json
# 从 /tmp/snap.json 中找出邮箱输入框、密码输入框和提交按钮的 uid
chrome-devtools fill "" "$LOGIN_EMAIL" --remote "$URL"
chrome-devtools fill "" "$LOGIN_PASSWORD" --remote "$URL"
chrome-devtools click "" --remote "$URL"

采集 CrUX 风格性能轨迹

chrome-devtools performance_start_trace --remote "$URL"
chrome-devtools navigate_page "https://app.example.com" --remote "$URL"
chrome-devtools performance_stop_trace --remote "$URL" --output-format json

输出规范

  • 始终打印所导航页面的 URL,以便用户明确当前操作的是哪个标签页。
  • 对于截图操作,请打印保存路径(例如 Saved to /tmp/.png.)—— CLI 已在 stdout 中自动输出该行。
  • 对于 evaluate_script,优先使用 --output-format json,并仅透出相关字段,避免完整输出 structuredContent 封装体。
  • 若用户询问“页面上有什么内容”,请优先使用 take_snapshot 而非 take_screenshot —— 快照为纯文本,更轻量且易于推理分析。

典型故障模式

现象 原因 解决方法
Failed to reach remote DNS 解析失败、Tailscale 离线,或 URL 错误 在本地主机运行 tailscale status;核对 --remote 参数中的 URL
Streamable HTTP error: ... 404 Session not found 服务端重启导致粘性会话 ID 失效;CLI 内部已自动重试一次 —— 若仍出现此错误,说明重试也返回了 404 执行 chrome-devtools stop --remote $URL 清除本地粘性会话指针,再重试原命令
TLS 验证错误(UNABLE_TO_VERIFY_LEAF_SIGNATURE、SELF_SIGNED_CERT_IN_CHAIN) 服务端使用自签名证书(未使用 Tailscale 签发的证书) 添加 --insecure 参数,或设置 export CHROME_DEVTOOLS_MCP_REMOTE_INSECURE=1
Bad Request: Mcp-Session-Id header is required 本地缓存目录在会话中途被清空 首次调用将自动创建新会话;直接重试即可
长时间空闲后首次调用卡住 服务端空闲回收机制已关闭该会话 同 404 场景处理方式 —— 先 stop,再重试

禁止事项

  • 不要循环调用 navigate_page 来“等待页面加载完成” —— 应改用带文本选择器的 wait_for。
  • 不要在命令链的每一步都执行 take_screenshot —— 用户几乎总是只需要最终结果截图,而非五张中间过程截图。
  • 不要对使用真实证书的托管服务端启用 --insecure —— 此参数会静默禁用整个 CLI 进程的 TLS 验证。
  • 不要尝试在 --remote 模式下执行 start 子命令 —— 该子命令仅用于管理本地守护进程。
目录

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

2587

2026.03.24

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3459

2023.11.06

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

2226

2023.08.11

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

0

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

0

2026.11.17

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

0

2026.11.17

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

0

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
第二十三期_前端开发
第二十三期_前端开发

共98课时 | 12.1万人学习

Node.js基础教程
Node.js基础教程

共8课时 | 1.5万人学习

nodejs开发基础教程
nodejs开发基础教程

共15课时 | 4.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn