環境

環境窗格用於設定會匯出至工作區 VM 內每個 shell 的純環境變數。這些是非密鑰的組態調整項——記錄層級、功能旗標、建置開關——你希望它們存在於代理程式的環境中，但不必牽涉任何替換或憑證機制。

編輯工作區視窗的環境窗格，顯示空狀態訊息「未設定環境變數」以及一個「新增變數」按鈕

此窗格的說明文字同時闡明它的用途以及它不適用的情境：透過 proxy.env 匯出至 VM 內每個 shell 的純 KEY=VALUE 配對（由 .bashrc 載入）。不做代理伺服器替換——數值會原封不動地落在 VM 上，因此請勿在此放置密鑰。適合用於記錄層級、功能旗標、建置開關。 在尚未設定任何項目時，它會顯示未設定環境變數。

變數如何匯出

你新增的每個變數都會寫入 proxy.env，這是工作區中繼資料共用區上的一個檔案，受管理的 .bashrc 會為每個 shell 載入它。這表示該數值會出現在每個終端機分頁、代理程式執行的每個指令，以及每個登入與非登入 shell 中——原封不動，與你輸入的完全一致。這裡沒有 brm_… 誘餌，也沒有傳輸替換：此窗格是直接的直通機制，這正是密鑰不該放在這裡的原因。

如果你需要 VM 保存權杖或密碼，請改用憑證窗格。在該處定義的任何項目都會以誘餌形式注入，並在傳輸時替換為真實數值；而輸入到環境窗格的密鑰則會以明文形式落在沙箱內部。

新增與編輯變數

點選新增變數以附加一列。每一列都有一個名稱欄位和一個數值欄位，並附有一個減號按鈕可將其移除。

名稱會依 shell 識別字規則 [A-Za-z_][A-Za-z0-9_]* 進行驗證——它必須以字母或底線開頭，且只能包含字母、數字和底線。不符合的名稱會顯示行內橘色警告，且不會被匯出。數值則不受限制，會完全依你所寫的方式使用。

提示： 將相關的開關集中在一個工作區，並讓臨時工作區保持空白。由於這些變數是各工作區專屬的，一個針對詳細偵錯調校的工作區（RUST_LOG=debug、NODE_ENV=development）便會與另一個為乾淨的類生產環境建置而設定的工作區區隔開來。

執行中工作階段的即時重新整理

編輯此窗格並儲存後，不需要重新啟動 VM。Bromure Agentic Coding 會遞增內部的 env.generation 計數器並重新寫入 proxy.env；儲存後開啟的新 shell 會重新載入它，並立即看到更新後的數值。已在執行中的前景代理程式會保留它啟動時的環境，直到結束為止——新的提示（或新的分頁）才會採用變更。

雖然這些數值就設計而言是非密鑰的，但儲存時它們仍會與此窗格的其他資料一起，存放在工作區加密的 secrets.enc 資料塊中，而不是純文字的 profile.json 內。

設定參考

設定類型預設值說明
變數清單Name = Value 列的清單空白每一列會透過 proxy.env 將一個變數匯出至每個 VM shell。名稱必須符合 [A-Za-z_][A-Za-z0-9_]*，否則會顯示警告並被略過。數值會原封不動地使用——不做替換。
新增變數按鈕—附加一個新的空白列。

相關章節

  • 憑證 — 密鑰該存放的位置；以誘餌形式注入，並在傳輸時替換。
  • MCP — 設定工具伺服器，其中部分伺服器會讀取環境變數。
  • 設定參考 — 一覽所有窗格。