--- name: browser_visible description: "当用户希望打开真实可见的浏览器窗口（而非后台无头模式）时，使用 browser_use 的 headed 参数启动浏览器，随后可正常 open/snapshot/click 等。适用于用户想亲眼看到页面、演示或调试场景。" metadata: builtin_skill_version: "1.1" copaw: emoji: "🖥️" requires: {} ---

# 可见浏览器（真实窗口）参考

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

## 何时使用

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

## 使用方式（browser_use）

1. **先以可见模式启动浏览器** 调用 **browser_use**，`action` 为 `start`，并传入 **headed=true**： ```json {"action": "start", "headed": true} ``` 成功后会出现一个真实的 Chromium 浏览器窗口。

2. **再按需打开页面并操作** 与无头模式用法相同，例如： - 打开 URL：`{"action": "open", "url": "https://example.com"}` - 获取页面结构：`{"action": "snapshot"}` - 点击、输入等：使用 `ref` 或 `selector` 进行 click、type 等

3. **关闭可见浏览器** 使用完毕后可调用：`{"action": "stop"}` 关闭浏览器。

## 与默认（无头）模式的区别

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

## 注意

- 若当前已有浏览器在运行，需要先 `stop` 再以 `headed: true` 重新 `start`，才能切换到可见窗口。 - 可见模式会占用桌面并需要图形环境，服务器或无图形环境可能无法使用。