skills/agentscope-ai/copaw/browser_visible

browser_visible

SKILL.md

可见浏览器(真实窗口)参考

默认情况下,browser_use 在后台以无头(headless)模式运行,不会弹出浏览器窗口。当用户明确希望打开真正的浏览器窗口看到浏览器界面有界面的浏览器可见浏览器时,应使用本 skill:先以 headed 模式启动浏览器,再按需打开页面并操作。

何时使用

  • 用户说:「打开真实浏览器」「打开有界面的浏览器」「我想看到浏览器」「不要后台,要能看到窗口」
  • 用户希望亲眼看到页面加载、点击、填表等过程(演示、调试、教学)
  • 用户需要与可见页面交互(如登录、验证码等需人工参与的场景)

使用方式(browser_use)

  1. 先以可见模式启动浏览器
    调用 browser_useactionstart,并传入 headed=true

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

    成功后会出现一个真实的 Chromium 浏览器窗口。

  2. 再按需打开页面并操作
    与无头模式用法相同,例如:

    • 打开 URL:{"action": "open", "url": "https://example.com"}
    • 获取页面结构:{"action": "snapshot"}
    • 点击、输入等:使用 refselector 进行 click、type 等
  3. 关闭可见浏览器
    使用完毕后可调用:{"action": "stop"} 关闭浏览器。

与默认(无头)模式的区别

模式 启动方式 是否弹出窗口
无头模式 {"action": "start"} 否(后台)
可见模式 {"action": "start", "headed": true} 是(真实窗口)

注意

  • 若当前已有浏览器在运行,需要先 stop 再以 headed: true 重新 start,才能切换到可见窗口。
  • 可见模式会占用桌面并需要图形环境,服务器或无图形环境可能无法使用。
Weekly Installs
35
GitHub Stars
11.6K
First Seen
12 days ago
Installed on
gemini-cli35
github-copilot35
codex35
amp35
cline35
kimi-cli35