Agent Skills
› ymx10086/ResearchClaw
› browser-visible
browser-visible
GitHub用于启动可见的 Chromium 浏览器窗口,满足用户查看交互过程、演示或需人工登录验证码等场景。通过 headed=true 参数实现,区别于后台无头模式。
触发场景
用户明确要求打开真实浏览器或有界面浏览器
用户希望亲眼看到页面加载和点击过程
需要处理需人工参与的交互如登录或验证码
安装
npx skills add ymx10086/ResearchClaw --skill browser-visible -g -y
SKILL.md
Frontmatter
{
"name": "browser-visible",
"emoji": "🖥️",
"description": "Launch a visible (headed) Chromium browser for interactive research tasks, demos, or debugging. Use when the user explicitly asks to see a real browser window, watch page interactions, or needs manual login\/CAPTCHA handling."
}
可见浏览器(真实窗口)参考
默认情况下,browser_use 在后台以无头(headless)模式运行,不会弹出浏览器窗口。当用户明确希望打开真正的浏览器窗口、看到浏览器界面、有界面的浏览器或可见浏览器时,应使用本 skill:先以 headed 模式启动浏览器,再按需打开页面并操作。
何时使用
- 用户说:「打开真实浏览器」「打开有界面的浏览器」「我想看到浏览器」「不要后台,要能看到窗口」
- 用户希望亲眼看到页面加载、点击、填表等过程(演示、调试、教学)
- 用户需要与可见页面交互(如登录、验证码等需人工参与的场景)
使用方式(browser_use)
-
先以可见模式启动浏览器
调用 browser_use,action为start,并传入 headed=true:{"action": "start", "headed": true}成功后会出现一个真实的 Chromium 浏览器窗口。
-
再按需打开页面并操作
与无头模式用法相同,例如:- 打开 URL:
{"action": "open", "url": "https://example.com"} - 获取页面结构:
{"action": "snapshot"} - 点击、输入等:使用
ref或selector进行 click、type 等
- 打开 URL:
-
关闭可见浏览器
使用完毕后可调用:{"action": "stop"}关闭浏览器。
与默认(无头)模式的区别
| 模式 | 启动方式 | 是否弹出窗口 |
|---|---|---|
| 无头模式 | {"action": "start"} |
否(后台) |
| 可见模式 | {"action": "start", "headed": true} |
是(真实窗口) |
注意
- 若当前已有浏览器在运行,需要先
stop再以headed: true重新start,才能切换到可见窗口。 - 可见模式会占用桌面并需要图形环境,服务器或无图形环境可能无法使用。
版本历史
- 1baaa92 当前 2026-07-25 05:31


