用途：browse 是 Browserbase 的主命令行界面，可用于驱动本地或 Browserbase 托管的浏览器会话，完成网页自动化、云 API 管理、Functions 开发与技能安装。
主要能力：可打开页面、通过可访问性快照、截图、DOM/文本读取和网络捕获检查页面；按 refs、选择器、XPath、键盘、鼠标、文件和视口控件与页面交互；管理 Browserbase 项目、会话、上下文、扩展、fetch 和 search API；开发、发布和调用 Browserbase Functions；浏览和脚手架 Browserbase 模板；诊断浏览器设置问题；发现并安装 Browse.sh 目录技能。
使用方式：先确认 CLI 存在，运行 which browse || npm install -g browse，再执行 browse --help。可用 browse skills install 安装或刷新技能。浏览器目标通过标志选择，例如 browse open https://example.com --local、--remote、--remote --verified --proxies、--auto-connect 或 --cdp。远程与云 API 命令需要 export BROWSERBASE_API_KEY=...。非平凡任务建议使用命名会话 --session <name>，并行任务分别使用不同会话。多数自动化先 open 页面，再 snapshot 获取引用并交互，随后再次 snapshot 验证，最后 browse stop 清理。
适用场景：本地开发与 localhost 调试适合 --local；受保护站点、验证浏览器模式、验证码、代理或会话持久化适合 --remote。用 browse cloud fetch 做简单 HTTP 抓取，用 browse cloud search 做网络搜索。
限制：--local 需要机器已安装 Chrome 或 Chromium，容器或 CI 无浏览器时应改用 --remote。--verified 需要 Browserbase Scale 计划。搜索的 provider 与 mode 选择需要 Search API 升级，升级部署前不可用。会话模式在启动后固定，冲突标志会导致失败，需先 browse stop。不要猜测或构造技能 slug，只能从 list 或 find 结果复制精确 slug 安装。同一失败命令不要原样重试，应先用 browse doctor --json 诊断并调整方案。