mcpField
B
browser_visible

browser_visible

github.com/agentscope-aiAgent 工作流36.7k52 次安装今天更新
代码仓库

关于 browser_visible

此 Skill 说明 `browser_use.start` 的启动选项，包括显示浏览器窗口和由 Playwright 管理的模式。它解释各设置的适用情形，并列出前提条件与限制。

主要功能

  1. 01说明 headed 和 private 模式
  2. 02展示启动参数组合
  3. 03说明 private 模式的适用情形
  4. 04列出浏览器及环境要求
  5. 05解释模式切换行为

适用场景

  1. 01启动可见浏览器窗口
  2. 02按需使用 Playwright 管理的浏览器
  3. 03检查环境是否支持 headed 浏览

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agentscope-ai/qwenpaw --skill browser_visible

安装后在 Claude Code 中输入/browser_visible确认已加载。

详细介绍

浏览器启动模式

browser_use.start 只有两种启动模式：

  • 默认：托管 CDP
  • private_mode=true：由 Playwright 托管

参数含义：

  • headed：是否显示浏览器窗口
  • private_mode：是否禁用 CDP 并改用 Playwright

这两个参数相互独立，可以自由组合。

常见用法

默认启动：

{"action": "start"}

打开可见窗口：

{"action": "start", "headed": true}

不使用 CDP：

{"action": "start", "private_mode": true}

可见窗口 + 不使用 CDP：

{"action": "start", "headed": true, "private_mode": true}

何时使用 private_mode

只有当用户明确要求以下情况之一时，才设置 private_mode=true：

  • 不希望浏览器通过 CDP 托管
  • 希望改用 Playwright
  • 希望降低其他本地工具通过 CDP 连接的可能性

否则，只需根据需要设置 headed=true。

注意事项

  • 默认是托管 CDP
  • 启动模式完全由调用参数决定
  • 托管 CDP 需要在本地安装 Chrome / Chromium / Edge
  • private_mode=true 并不意味着绝对无法被检测——它只是切换到 Playwright 管理
  • 当用户手动操作可见浏览器时，空闲计时器可能不会刷新
  • private_mode 是每次 start 调用的显式参数，不会被持久化
  • 如果浏览器已在运行，必须先 stop 然后再 start，才能切换启动模式或窗口可见性
  • 可见模式会占用桌面，并且需要图形环境；在服务器或无头环境中可能无法工作

评论

支持 Markdown