浏览器

每个工作区都附带一个嵌入式 Chromium 浏览器,其代理可以通过内置的 browser MCP 服务器驱动它——导航、点击、输入、截图、读取控制台和网络日志。该浏览器运行在它自己的一次性虚拟机中,与工作区的 Ubuntu 虚拟机相互独立,因此代理打开的页面绝不会触及代理自身的环境。浏览器窗格控制两件事:该浏览器是否在会话之间记住你的登录状态,以及共享的浏览器镜像如何下载到你的 Mac。

编辑工作区窗口的浏览器窗格,显示保持网站登录状态开关(关闭);一个权限部分,其中允许上传文件和允许下载文件已开启、允许摄像头和允许麦克风已关闭;以及一个标注为已安装、带有重新下载按钮的浏览器镜像部分

窗格打开时会显示应用在控件上方展示的相同摘要:此工作区拥有一个嵌入式 Chromium 浏览器,其代理可通过内置的 browser MCP 服务器驱动它,且它运行在自己的一次性虚拟机中。该窗格仅设置策略——你需从会话窗口的代理浏览器窗格(⌃⌘B)驱动浏览器本身,而代理则通过 MCP 工具驱动它。两者均在 会话 中介绍,完整的 browser_* 工具列表见 自动化与 CLI

保持网站登录状态

保持网站登录状态开关决定浏览器是临时的还是持久的:

  • 关闭(默认)——浏览器每次都从干净的配置文件启动,并在窗口关闭时忘记一切。没有 cookie、登录信息或历史记录会保留下来。这是与工作区其余隔离模型相匹配的完全一次性行为。
  • 开启——cookie、登录信息和历史记录会保存在位于 ~/Library/Application Support/BromureAC/browser-profiles/<workspace-id>/image/profile.img每个工作区独立的加密磁盘上,因此代理会在会话之间保持网站登录状态。该配置文件磁盘归属于这一个工作区,绝不会与其他工作区共享。

由于持久化设置会改变浏览器虚拟机的启动方式,更改它会重启该虚拟机。当你存储更改时,应用会警告:

更改“保持网站登录状态”将通过重启此工作区的浏览器来生效——其打开的标签页将会关闭。已存储的登录信息会保留在每个工作区独立的加密磁盘上:设置开启时会使用它们,关闭时则会直接忽略它们。

关闭此设置不会删除已存储的配置文件磁盘——它只是在关闭期间被忽略,并在你重新开启设置时再次被使用。

注意: 持久化登录状态是以隔离性换取便利性。一个已登录且代理可以驱动的浏览器,对代理而言是一份长期存在的凭据,代理可以在它访问的任何页面上使用它;除非某个工作流确实需要持久登录,否则请让此项保持关闭。

浏览器镜像

浏览器虚拟机从一个共享的浏览器镜像启动——与同门的 Bromure 网页浏览器使用的相同 Alpine + Chromium 镜像。它只下载一次并由每个工作区共享,因此窗格底部的浏览器镜像部分是应用级别的,而非每个工作区独立的。它显示的内容取决于镜像的来源:

状态说明文字操作
由 Bromure Web 安装“由 Bromure Web 安装(大小)——与 Agentic Coding 共享,由 Bromure 应用管理。”无——Bromure 网页应用拥有并更新它。
由 Agentic Coding 下载“已安装(大小)——从 dl.bromure.io 下载到 ~/Library/Application Support/BromureAC/browser。”重新下载
未安装“未安装。将在工作区首次打开浏览器时自动下载,或立即下载。”立即下载

当 Bromure Agentic Coding 自行下载了镜像时,重新下载会获取一份全新副本。它会先确认——重新下载浏览器镜像?——并说明:

下载一份全新副本(几 GB)并替换当前镜像。打开的浏览器会话会继续运行,并在下次启动时采用新镜像。

在安装或重新下载进行期间,该部分会用一个实时进度条和百分比取代按钮;失败时会以红色内联显示。

首次打开许可

你不必从此窗格安装镜像。任何工作区首次打开其浏览器窗格时,会话窗口会在获取任何内容之前显示一次性的许可卡片——安装浏览器?,并附注 Chromium 运行在其自己的一次性虚拟机中,且需一次性下载约 500 MB 内容并安装到你的 Library 文件夹,以及下载并安装 / 暂不两个按钮。在你接受之前不会下载任何内容。由于镜像是共享的,只安装一次——无论从此窗格还是从该卡片——即可服务于每个工作区。

浏览器虚拟机的生命周期

浏览器虚拟机是惰性创建的,仅在窗格(或代理工具调用)首次需要它时才创建,并在空闲时被回收:

  • 隐藏约 10 秒后,虚拟机会在内存中被挂起,从而停止占用 CPU,同时保留其状态。
  • 窗格关闭约 5 分钟后,虚拟机会被完全拆除;下次打开时会冷启动一个全新的虚拟机。

代理的 browser MCP 工具调用可以自行为选定的工作区启动并显示浏览器,但它绝不会重新打开你有意关闭的窗格。浏览器虚拟机与工作区共享同一个 NAT 网络段,因此代理可以通过工作区虚拟机的 LAN IP 访问工作区正在运行的开发服务器——绝不能用 localhost,因为浏览器是一个不同的虚拟机。有关窗格在窗口中的行为,请参阅 会话

设置参考

设置类型默认值范围
保持网站登录状态开关关闭(完全临时)每个工作区
浏览器镜像状态 + 立即下载 / 重新下载未安装(首次打开浏览器时自动提示)应用级别(与所有工作区以及 Bromure Web 共享)

与每个工作区窗格一样,保持网站登录状态也可以在偏好设置模板上设置,以便新工作区继承它——请参阅 设置参考。持久配置文件磁盘使用与保护你工作区其余机密相同的宿主机持有密钥进行加密;凭据模型在 凭据与传输边界 中有所描述。