test-driven-development
OBobra/superpowers298k2,631 new stars in the last 7 days
browser_visible
以可见模式启动真实浏览器窗口，适用于演示、调试或需要人工参与的场景。控制 headed/cdpPort 等启动参数。
- Star
- 1,157
- Category
- Browser & testing
- License
- Apache-2.0
- Last commit
- Oct 13, 2026
mateclaw-server/src/main/resources/skills/browser_visible/SKILL.md
View on GitHub浏览器启动模式
本技能控制 browser_use 的启动方式，核心参数：
| 参数 | 类型 | 说明 |
|---|---|---|
headed | Boolean | true = 显示窗口；false（默认）= 无头模式 |
cdpPort | Integer | 指定 CDP 调试端口（不填则自动选择） |
常见用法
无头模式（默认，后台自动化）
browser_use(action="start")
可见窗口（演示 / 需要人工操作）
browser_use(action="start", headed=true)
指定 CDP 端口（与外部工具共享）
browser_use(action="start", headed=true, cdpPort=9222)
标准操作序列
# 1. 启动
browser_use(action="start", headed=true)
# 2. 打开页面
browser_use(action="open", url="https://example.com")
# 3. 截取快照（查看页面内容）
browser_use(action="snapshot")
# 4. 点击元素
browser_use(action="click", selector="#submit-btn")
# 5. 输入文本
browser_use(action="type", selector="input[name=email]", text="[email protected]")
# 6. 完成后关闭
browser_use(action="stop")
何时用可见模式
| 场景 | 推荐参数 |
|---|---|
| 向用户演示操作过程 | headed=true |
| 需要用户手动登录（扫码、验证码） | headed=true，遇到登录页暂停并提示用户 |
| 调试自动化脚本 | headed=true |
| 纯自动化、不需要展示 | headed=false（默认） |
跨平台可执行文件路径（需自定义浏览器时）
MateClaw 的 browser_use 会自动检测系统浏览器，无需手动指定路径。如需调试特定 Chrome 安装位置：
Windows 默认路径：
C:\Program Files\Google\Chrome\Application\chrome.exe
C:\Program Files (x86)\Google\Chrome\Application\chrome.exe
macOS 默认路径：
/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
Linux 默认路径：
/usr/bin/google-chrome
/usr/bin/chromium-browser
注意事项
- 可见模式需要图形环境（GUI）；无桌面的服务器无法使用
- 若浏览器已在运行，须先
stop再重新start才能切换headed状态 cdpPort被占用时会报错，换端口或先停止占用该端口的进程- 用户手动操作可见浏览器不会刷新 Agent 的 idle 超时计时
Similar Skills
migrate-to-shoehorn
MAmattpocock/skills288k10,178 new stars in the last 7 days
agent-runtime-gateway-smoke-test
AFaffaan-m/ECC278k4,046 new stars in the last 7 days
Featured
accessibility
Audit accessibility on Web, iOS, and Android to meet WCAG 2.2, with keyboard navigation and screen-reader support.
AFaffaan-m/ECC278k4,046 new stars in the last 7 days
ai-regression-testing
AFaffaan-m/ECC278k4,046 new stars in the last 7 days
Official
firecrawl-build-interact
FIfirecrawl/firecrawl191k2,010 new stars in the last 7 days