环境

环境窗格用于设置导出到工作区虚拟机中每个 shell 的纯环境变量。这些是非机密的配置旋钮——日志级别、功能开关、构建切换项——你希望它们出现在代理的环境中，而无需接入任何交换或凭据机制。

编辑工作区窗口的环境窗格，显示空状态消息“未配置环境变量”以及一个“添加变量”按钮

该窗格的说明既阐明了它的用途，也阐明了它不适用于什么：纯 KEY=VALUE 键值对通过 proxy.env（由 .bashrc 加载）导出到虚拟机中的每个 shell。不进行代理替换——值会原样落到虚拟机上，因此请勿在此放置机密。适合用于日志级别、功能开关、构建切换项。在未配置任何内容时，它显示为未配置环境变量。

变量如何导出

你添加的每个变量都会写入 proxy.env，这是工作区元数据共享区上的一个文件，受管的 .bashrc 会为每个 shell 加载它。这意味着该值会出现在每个终端标签页、代理运行的每条命令以及每个登录和非登录 shell 中——原封不动，与你输入的完全一致。这里没有 brm_… 伪值，也没有传输交换：该窗格是一个直通通道，这正是机密不应放在此处的原因。

如果你需要虚拟机持有令牌或密码，请改用凭据窗格。在那里定义的任何内容都会作为伪值注入，并在传输时交换为真实值；而在环境窗格中输入的机密则会以明文形式落入沙箱内部。

添加和编辑变量

点击添加变量以追加一行。每行包含一个名称字段和一个值字段，以及一个用于删除它的减号按钮。

名称会根据 shell 标识符规则 [A-Za-z_][A-Za-z0-9_]* 进行校验——它必须以字母或下划线开头，且只能包含字母、数字和下划线。不符合该规则的名称会显示一条内联的橙色警告，且不会被导出。值没有限制，会按写入的内容原样使用。

提示： 将相关的切换项归组到一个工作区中，而让一个临时工作区保持空白。由于这些变量是按工作区区分的，一个为详细调试而调整的工作区（RUST_LOG=debug、NODE_ENV=development）会与一个配置为纯净的类生产构建的工作区保持独立。

对运行中会话的实时刷新

编辑该窗格并存储不需要重启虚拟机。Bromure Agentic Coding 会递增一个内部的 env.generation 计数器并重新写入 proxy.env；存储后打开的新 shell 会重新加载它并立即看到更新后的值。已经在运行的前台代理会保持它启动时的环境，直到退出为止——一个新的提示（或一个新的标签页）会采用该更改。

尽管这些值在设计上属于非机密，它们在存储时仍会与该窗格的其他数据一起存储在工作区的加密 secrets.enc 数据块中，而不是存储在明文的 profile.json 中。

设置参考

设置类型默认值描述
变量列表Name = Value 行的列表空每行通过 proxy.env 将一个变量导出到每个虚拟机 shell。名称必须匹配 [A-Za-z_][A-Za-z0-9_]*，否则会显示警告并被跳过。值按原样使用——不进行替换。
添加变量按钮—追加一个新的空行。

相关章节

  • 凭据 — 机密应放置之处；作为伪值注入并在传输时交换。
  • MCP — 配置工具服务器，其中一些会读取环境变量。
  • 设置参考 — 一览所有窗格。