Chrome

Chrome（及 Chromium）是默认的浏览器引擎。agent-browser 会通过 Chrome DevTools Protocol（CDP）自动发现、启动并管理 Chrome 进程。

二进制发现¶

当未提供 --executable-path 时，agent-browser 会按以下顺序查找 Chrome：

平台	检查的位置
macOS	`/Applications/Google Chrome.app`、 `/Applications/Google Chrome Canary.app`、 `/Applications/Chromium.app`、 `/Applications/Brave Browser.app`、 Puppeteer 缓存（`~/.cache/puppeteer/chrome/` 或 `PUPPETEER_CACHE_DIR`）、 Chrome for Testing 缓存
Linux	`google-chrome`、 `google-chrome-stable`、 `chromium-browser`、 PATH 中的 `chromium`、 Puppeteer 缓存（`~/.cache/puppeteer/chrome/` 或 `PUPPETEER_CACHE_DIR`）、 Chrome for Testing 缓存
Windows	`%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`、 `C:\Program Files\Google\Chrome\Application\chrome.exe`、 `C:\Program Files (x86)\...\chrome.exe`

如果未找到 Chrome，请运行 agent-browser install 从 Chrome for Testing 下载 Chrome。

Chrome 是默认引擎——无需 --engine 标志：

agent-browser open example.com

如需显式指定：

agent-browser --engine chrome open example.com

使用 --executable-path 指向任何基于 Chromium 的浏览器：

agent-browser --executable-path /path/to/chromium open example.com

或通过环境变量：

export AGENT_BROWSER_EXECUTABLE_PATH=/path/to/chromium
agent-browser open example.com

以下功能仅在 Chrome 中可用：

功能	标志
浏览器扩展	`--extension <path>`
持久化配置文件	`--profile <path>`（设置 Chrome 的 `--user-data-dir`）
存储状态	`--state <path>`
文件 URL 访问	`--allow-file-access`
无头截图滚动条	`--hide-scrollbars false` 保持原生滚动条可见
有头模式	`--headed`
自定义启动参数	`--args <args>`

在 Docker、CI 运行器或其他沙盒环境中，可能需要禁用 Chrome 的用户命名空间沙盒：

agent-browser --args "--no-sandbox" open example.com

当 agent-browser 检测到容器环境（Docker、Podman、以 root 身份运行）时，会自动添加 --no-sandbox。

使用换行符分隔参数，或在另一个标志前使用逗号分隔。值内部的逗号保持与该标志关联，因此列表型 Chrome 标志可以正常工作：

agent-browser --args "--disable-features=Translate,HttpsUpgrades,--no-sandbox" open example.com

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 agen/agent-browser