跳到正文
cccskills
免费在 GitHub 公开

browser_visible

Configure how the browser starts, including window visibility, proxy settings, extra launch options, and a custom browser executable. It also explains opening a local debugging port so other local tools can connect.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

当用户需要控制 browser 的浏览器启动方式时,使用本 skill。

browser 默认由 Playwright 直接管理、不开放调试端口(需让其他本地工具附加时显式传 `cdp_port`);`headed` 控制是否显示窗口,`private_mode` 保留用于兼容、不再改变默认行为,`browser_args` 传入额外的 Chromium 启动参数,`executable_path` 指定自定义浏览器可执行文件路径。

集成工具Playwright
查看安装方法

适用场景

  • Show the browser window during automation
  • Start a browser with a proxy or incognito mode
  • Choose a specific installed browser
  • Open a debugging port for local tools

包含的文件(1)

  • SKILL.md3.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

已弃用: 此参考服务于稳定的 browser 实现。启用实验模式时,请优先使用统一的 browser 工具。

浏览器启动模式

browser.start 的启动方式:

  • 默认:Playwright 直接管理,不开放调试端口
  • cdp_port=N:managed CDP,开放本地调试端口供其他本地工具附加(详见 browser_cdp skill)
  • private_mode=true:与默认相同,保留用于兼容

参数含义:

  • headed:是否显示浏览器窗口
  • private_mode:保留用于兼容,不再改变启动方式
  • browser_args:额外的 Chromium 启动参数(字符串),多个参数用空格分隔。适用于所有启动路径(headless、headed、managed CDP)。例如 "--incognito" 启用隐身模式,"--proxy-server=http://127.0.0.1:7890" 设置代理。默认空字符串(无额外参数)。
  • executable_path:自定义浏览器可执行文件路径(字符串)。设置后覆盖系统默认浏览器检测,可指定任意基于 Chromium 的浏览器。例如 "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"。仅允许包含已知浏览器关键词(chrome、chromium、edge、firefox、brave 等)的可执行文件,且文件必须存在。默认空字符串(使用系统默认)。

以上参数互不影响,可自由组合。

常见用法

默认启动:

{"action": "start"}

打开可见窗口:

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

隐身模式:

{"action": "start", "headed": true, "browser_args": "--incognito"}

指定浏览器路径 + 设置代理:

{"action": "start", "headed": true, "browser_args": "--proxy-server=http://127.0.0.1:7890", "executable_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"}

private_mode

已是默认行为,无需设置。该参数仅为兼容旧调用而保留,与 cdp_port 同时传入会被拒绝。

什么时候用 browser_args

当用户需要传入 Chromium 原生启动参数时使用,常见场景:

  • 隐身/无痕模式(--incognito、--inprivate)
  • 设置代理(--proxy-server)
  • 指定窗口大小(--window-size=1920,1080)
  • 禁用 GPU(--disable-gpu)
  • 加载扩展(--load-extension=/path/to/ext)

参数使用 shell 风格的空格分隔,在 Windows 上会自动处理路径中的反斜杠。

什么时候用 executable_path

当用户需要使用非系统默认的浏览器时使用,常见场景:

  • 系统默认是 Chrome,但用户想用 Edge
  • 安装了多个浏览器,想指定某一个
  • 使用便携版浏览器

注意:executable_path 只接受包含已知浏览器关键词(chrome、chromium、edge、firefox、brave、vivaldi、opera、360se、yandex、tor)的可执行文件,且路径必须指向一个真实存在的文件。

注意

  • 默认由 Playwright 直接管理,不开放调试端口
  • 启动方式完全由调用参数决定
  • managed CDP 依赖本机存在 Chrome / Chromium / Edge
  • 用户手动操作可见浏览器时,不一定会刷新 idle 计时
  • private_mode、browser_args、executable_path 都是每次 start 的显式参数,不会持久保存
  • 若当前已有浏览器在运行,需要先 stop 再重新 start,才能切换启动方式、窗口可见性或启动参数。
  • 可见模式会占用桌面并需要图形环境,服务器或无图形环境可能无法使用。

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Find installation steps, configuration guidance, and command examples for Alibaba Cloud CLI using local Chinese documentation. The skill checks its quick reference or relevant documentation pages before suggesting commands, parameters, and options.

中文简介正在准备中。当前显示英语简介。

  • Look up installation and configuration steps
  • Check commands for querying ECS instances
  • Find output filtering and pagination options
agentscope-ai/QwenPaw3.6万2026年10月16日 更新

browser

免费

Use QwenPaw's built-in Browser SDK, a browser control interface, to read pages, search, fill forms, click controls, and capture screenshots through asynchronous Python. The workflow checks the page before and after actions and hands authentication steps to a person.

中文简介正在准备中。当前显示英语简介。

  • Search a website and inspect the resulting page
  • Fill forms and select options in a browser
  • Read page text and capture screenshots
agentscope-ai/QwenPaw3.6万2026年10月16日 更新

browser

免费

Automate browser tasks through QwenPaw's built-in Browser SDK using asynchronous Python. Read page content, fill forms, click controls, and capture screenshots, checking the resulting page after each action to verify what happened.

中文简介正在准备中。当前显示英语简介。

  • Search a website and inspect the results
  • Fill forms and operate page controls
  • Capture page screenshots
agentscope-ai/QwenPaw3.6万2026年10月16日 更新

Connect an agent to an existing Chrome browser, find local CDP ports used for remote browser control, or start a browser on a specified port for sharing with other agents and tools.

中文简介正在准备中。当前显示英语简介。

  • Connecting to Chrome with existing logins and open tabs
  • Finding available local browser debugging ports
  • Starting a browser on a fixed debugging port
agentscope-ai/QwenPaw3.6万2026年10月16日 更新

Connect to an existing Chrome browser or launch one with an explicit debugging port for sharing across agents and tools. It also covers scanning local CDP ports, the connection endpoints used to control a browser.

中文简介正在准备中。当前显示英语简介。

  • Connect to Chrome with existing logins and open tabs
  • Find available local browser debugging ports
  • Launch a browser with a fixed debugging port
agentscope-ai/QwenPaw3.6万2026年10月16日 更新

Configure browser startup with a visible or hidden window, and optionally open a local debugging port for another tool to connect. The skill explains launch parameters, compatibility behavior, and when a browser restart is required.

中文简介正在准备中。当前显示英语简介。

  • Show the browser window during automated work
  • Open a local debugging port for another tool
  • Check the behavior of older launch parameters
agentscope-ai/QwenPaw3.6万2026年10月16日 更新

查看 agentscope-ai 的全部技能

报告此技能的问题