Bromure Agentic Coding — 使用手冊

歡迎閱讀 Bromure Agentic Coding 的官方使用手冊。這是一款 macOS 應用程式，它把 AI 程式代理——Claude Code、Codex、Grok、Kimi Code、Oh My Pi，以及尋常的 shell 工具——跑在你 Mac 上隔離的 Linux 虛擬機裡，並以一道主機端的閘道把你真正的憑證擋在代理程式伸手不到的地方。

本手冊記述的是版本 5.0.0。它需要 Apple Silicon 上的 macOS 14（Sonoma）或更新版本。

版本 5.0.0 是圍繞工作階段編排的：你與某個代理程式的每一段對話都是側邊欄裡的一列，而你在一個聊天中跟它說話。工作階段所跑的那些 Linux VM，在主視窗裡叫做機器。設定編輯器仍叫它們工作區；這兩個詞指的是同一樣東西。

初次使用這個應用程式？ 請從安裝與首次執行開始，接著照著快速入門走。想要完整的全貌時，再讀概念與架構。其餘的都當作參考來用。

目錄

開始之前

章節涵蓋什麼
1. 簡介這個應用程式是什麼、單一邊界的安全模型、主要功能，以及它與其他工具的比較。
2. 安裝與首次執行系統需求、安裝應用程式、六個步驟的上手嚮導、基礎映像的更新、命令列工具、儲存空間、搬到一台新 Mac，以及卸載。
3. 快速入門從嚮導到一件完成的工作：開始一個工作階段、回答代理程式的問題、看看變動的檔案、檢查追蹤紀錄，然後封存這個工作階段再把它找回來。
4. 概念與架構工作階段、機器、房間與分支；工作階段的狀態；主機與客體；傳輸邊界；什麼會留存；vsock 與 MCP 連接埠；網路。

日常使用

章節涵蓋什麼
5. 工作階段主頁主視窗：側邊欄與它收起的欄軌、工作階段的列與它們的選單、工作階段標頭、機器選單、Linux 膠囊、⌘K 命令面板，以及封存、結束、刪除與復原。
6. 開始一個工作階段新增工作階段的畫面：挑代理程式、挑機器、挑它在哪裡工作（一個新檔案夾、你自己的某一個，或一個儲存庫）、附上檔案、最近的開始，以及用 @ 去問另一個工作階段。
6.1 聊天跟代理程式說話：輸入區、附件、斜線命令與行內終端機、問題卡、活動列、變動檔案的摘要、登入卡、停止、編輯後重送，以及搜尋。
6.2 房間把相關的工作階段編進一個房間：活生生的聊天格狀檢視、版面與標籤頁、放大某一格、房間自己的總機，以及送給整個房間。
6.3 分支與檢視跑在自己 git worktree 上的分支工作階段、把它們併回去、分支視窗，以及帶行註解的檢視視窗。
6.4 代理程式協同工作委派給子工作階段、以 @暱稱向其他工作階段提出請求、委派面板、檔案交接、限制，以及跨機器的請求。
6.5 總機與訊息掌握其他每一個工作階段的總機工作階段、它的安全規則，以及給 Signal、WhatsApp 與 Slack 的訊息連接器。
6.6 機器虛擬機器區段：建立、啟動、暫停與刪除機器、回復個人檔案夾與重置磁碟、終端機與格狀檢視、檔案窗格，以及剪貼板。
6.7 內嵌瀏覽器工作階段旁的 Chromium 瀏覽器：自己操作它、透過瀏覽器工具讓代理程式操作它、保持登入，以及隱私。
Bromure Web 的 Metal 加速獨立的網頁應用程式：Metal 需求、應用程式全域與個別設定檔的控制項、使用中的轉譯器，以及影片支援。
6.8 自動化看板上排定的、無人看顧的代理程式執行：觸發條件、排程、串接、執行歷史、回答它們的提問，以及自動化的 MCP 伺服器。
6.9 編碼任務編碼看板：任務、代理程式規劃的階段、在 worktree 中的自主執行、帶行註解的檢視，以及合併。

設定參考

章節涵蓋什麼
7. 設定參考怎麼打開設定編輯器與偏好設定、分了群組的窗格清單與搜尋設定、預設值範本，以及什麼時候會存下什麼。

設定參考依編輯器的順序，每個窗格一頁：

安全性與傳輸邊界

章節涵蓋什麼
8. 憑證與傳輸邊界真正的祕密怎麼留在主機上，而代理程式只拿到假的：MITM 代理伺服器、登入與 API 金鑰、按憑證的核准，以及入侵警示。
9. 供應鏈防護在代理程式看到之前就檢查、改寫並擋下套件安裝：年齡關卡、OSV、socket.dev、Depi，以及剝除安裝腳本。
10. 提示注入偵測與防護欄在代理程式的 AI 流量中搜尋被注入指令的裝置端偵測器、出向防火牆，以及對破壞性操作的防護欄。
10.5 個人資料保護在一段對話離開你的 Mac 之前，把個人資料換成前後一致的替身，並在回覆中把它換回來。
11. 追蹤與稽核一份工作階段追蹤紀錄記了什麼、追蹤檢閱器、靜態加密、保留期限、匯出，以及隱私。
11.5 安全性總覽與時間軸安全性時間軸視窗：24 小時的總覽、按機器的防護，以及可篩選、可匯出的每一項安全決策時間軸。

模型與基礎設施

章節涵蓋什麼
12. Fusion — 多模型面板同時用好幾個模型回答每一個提示，經評判後在傳輸上合成單一的回覆。
12.5 Squelch — 雜訊更少，token 更省在模型讀取之前，從命令輸出中去除通過的測試、進度等雜訊（仿效 rtk），以及每個工作階段節省的 token。
13. 模型與供應商全域模型盤面：供應商（登入、API 金鑰、Amazon Bedrock、OpenRouter、自訂伺服器、裝置端模型）、每個代理程式的模型選擇、每個工作區的覆寫，以及即時的變更。
13.5 Kubernetes 叢集與登錄檔在你的機器旁邊，於各自的 VM 中跑 k3s 叢集與一個私有容器登錄檔：儲存、負載平衡、附加元件、存取，以及基礎設施的 MCP 伺服器。

超出一台 Mac

章節涵蓋什麼
14. 遠端存取與完整用戶端從另一台 Mac、iPhone、iPad 或 Apple Vision Pro 鏡像一個遠端的 Bromure；遠端偏好設定；走 SSH 的 CLI、通道與 PAC；以及遠端的安全模型。
15. 企業版 — 註冊與機群註冊到 bromure.io、遙測上傳什麼（以及不上傳什麼）、機群檢視，以及離場。

參考

章節涵蓋什麼
16. CLI、API 與 MCPbromure-cli 命令列工具、迴路的控制 API、各個 MCP 伺服器，以及 AppleScript。
16.5 進階進階使用者的工具：ext4 檔案瀏覽器與檔案系統檢查，以及還原或回復一台機器的家目錄。
17. 疑難排解按症狀編排，診斷安裝、機器、登入、TLS、供應鏈、磁碟空間與遠端存取的問題。
18. 詞彙表本手冊所用每一個術語的定義。
19. 附錄 — 檔案位置、連接埠與環境參考表格：磁碟上的位置、網路與 vsock 連接埠、環境變數、預設值、鍵盤快速鍵，以及客體端的速查表。

本手冊的體例

  • 粗體文字指的是螢幕上的某個控制項或標籤，字面就是應用程式以英文顯示的樣子——按鈕、選單項目、開關、窗格或側邊欄區段（例如 New session 或 Start this VM at login）。
  • 等寬文字是你打進去或看到的命令、檔案路徑、環境變數或字面值（例如 bromure-cli vm ls 或 ~/Library/Application Support/BromureAC）。
  • 像 Workspaces › Infrastructure › Messaging Connector… 這樣的一串是選單路徑：先是選單，然後依序是每個子選單或項目。偏好設定 › 模型指的是偏好設定視窗的模型窗格。
  • 機器與工作區指的是同一樣東西：一台帶著自己設定的隔離 Linux VM。主視窗說機器；設定編輯器、像 New Workspace… 這樣的選單，以及 CLI 說工作區（或描述檔）。
  • 一個工作階段是在一台機器的一個檔案夾裡，與一個代理程式進行的一段對話。它不是機器的一次執行；見概念與架構。
  • 鍵盤快速鍵使用 macOS 的符號：⌘ Command、⌥ Option、⌃ Control、⇧ Shift、⏎ Return、⎋ Escape。
  • 截圖顯示的是英文介面，搭配合成的示範內容。這個應用程式有本地化，所以你的畫面會跟隨你 macOS 的語言。
  • 注意、提示與警告會以框註呈現：

注意： 值得知道的背景說明。

提示： 一條捷徑，或建議的做法。

警告： 弄錯時可能會遺失資料或削弱某項防護的事。

還可以看哪裡

產品下載、技術白皮書與詳盡的功能對照表都在 bromure.io。本手冊沒有回答到的問題，疑難排解彙集了診斷流程，而詞彙表界定了用語。