環境

環境窗格設定會匯出到機器 VM 中每一個 shell 的純環境變數(機器在設定編輯器中即工作區)。它們用於非祕密的設定——記錄層級、功能旗標、建置開關——那些你想放進代理程式環境、又不需要任何憑證處理的東西。

環境窗格,顯示空狀態訊息「未設定任何環境變數」與一個「新增變數」按鈕。

說明文字寫出這個窗格的用途與不適用之處:「純 KEY=VALUE 配對,透過 proxy.env(由 .bashrc 載入)匯出到 VM 中的每一個 shell。不做代理替換——這些值會原封不動抵達 VM,所以不要把祕密放在這裡。適合記錄層級、功能旗標、建置開關。」什麼都沒設定時,它會顯示未設定任何環境變數。

變數如何被匯出

每個變數都會寫入 proxy.env,而機器受管的 .bashrc 會為每一個 shell 載入它。那個值會出現在每一個終端機、代理程式執行的每一個指令,以及每一個登入與非登入 shell 中,形式與你輸入的完全相同。沒有替身,線路上也沒有替換。

至於權杖或密碼,請改用憑證窗格:在那裡 VM 只會拿到一個替身,真實值則在線路上被放入。輸入在這個窗格中的祕密,會以明文抵達 VM 內部。

新增與編輯變數

新增變數會附加一列,含一個名稱欄位與一個值欄位;減號按鈕可移除它。名稱必須是有效的 shell 識別碼——一個字母或下底線,接著是字母、數字與下底線。不符合的名稱會顯示橙色警告,且不會被匯出。值會照你所寫的使用。

在執行中的機器上的變更

儲存會在不重新啟動的情況下生效:proxy.env 會被重寫,而儲存之後開啟的 shell 會看到新值。已經在執行的代理程式會保有它啟動時的環境;新的分頁或新的工作階段則會取得這項變更。

這些值儲存在機器已加密的 secrets.enc 中,與這個窗格的其他資料相同,而不是在 profile.json 裡。

設定參考

設定類型預設說明
變數清單名稱/值的列空每一列透過 proxy.env 把一個變數匯出到每一個 shell。無效的名稱會顯示警告並被略過。值會原樣使用。
新增變數按鈕—附加一個空白列。

相關章節

  • 憑證 — 祕密該放的地方。
  • MCP — MCP 伺服器,其中有些會讀取環境變數。
  • 設定參考 — 所有窗格一覽。