Bromure Agentic Coding — 使用手冊

歡迎閱讀 Bromure Agentic Coding 的官方使用手冊。這是一款 macOS 應用程式，能在可拋棄式的 Linux VM 中執行 AI 編碼代理程式——Claude Code、Codex CLI、Grok CLI 以及一般的 shell 工具——並透過主機端的閘道，讓您真正的憑證不會落入代理程式的掌控範圍。

本手冊記錄的是版本 4.3.0。它需要在 Apple Silicon 上執行 macOS 14（Sonoma）或更新版本。如果您是初次接觸，請先閱讀簡介，接著閱讀快速上手；其餘內容皆為參考資料，您可在需要時隨時查閱。

初次使用應用程式？ 讓代理程式最快跑起來的途徑，是先進行安裝，再完成快速上手導覽。

目錄

開始使用

章節內容涵蓋
1. 簡介應用程式是什麼、單一邊界的安全模型、支柱功能，以及它與其他工具的比較。
2. 安裝系統需求、下載與安裝應用程式、首次啟動的設定流程、基底映像檔更新、遷移，以及解除安裝。
3. 快速上手從全新安裝到讓代理程式運作，約十分鐘即可完成：建立工作區、選擇代理程式、共用資料夾、執行任務並檢視追蹤記錄。

基礎

章節內容涵蓋
4. 概念與架構主機與客體、工作區與工作階段與 VM 的差異、VM 生命週期、傳輸邊界、儲存、vsock 橋接與網路。
5. 工作區工作區瀏覽器：狀態標籤、資源卡片、設定摘要，以及建立、複製、重設與刪除工作區。
6. 工作階段統一的工作階段視窗：啟動與關閉工作階段、分頁與工作樹、瀏覽器與檔案窗格、檔案傳輸，以及檢查點。
內嵌瀏覽器使用工作區內建的 Chromium：自行操作、透過瀏覽器工具讓代理程式操作、保持登入狀態，以及隱私。
自動化在看板上進行的排程、無人值守的代理程式執行：建立它們、觸發條件與排程、串接的自動化、執行歷史，以及回應其提示。
程式任務程式看板：需求簡報、由代理程式規劃且帶有依賴關係的階段、在 worktree 中自主執行、附行內註解的 diff 審閱，以及合併。

設定參考

章節內容涵蓋
7. 設定參考如何開啟 編輯工作區 編輯器，以及全部十六個窗格的逐頁參考。

設定參考為每個窗格提供一個頁面：一般、代理程式、本機模型、Fusion、資料夾、憑證、環境、MCP、追蹤、防護欄、供應鏈、提示注入、外觀、瀏覽器、資源，以及應用程式全域的自動化窗格。

深入了解各項支柱

章節內容涵蓋
8. 憑證與傳輸邊界真正的密鑰如何留在主機上，而代理程式只拿到假的：MITM 代理伺服器、各憑證的生命週期、核可，以及入侵偵測器。
9. 供應鏈保護在代理程式看到之前，先審查、改寫並封鎖套件安裝——時效閘門、OSV、socket.dev、Delpi 與指令碼移除。
10. 提示注入偵測與防護欄在裝置端掃描代理程式 AI 流量以找出注入指令的偵測器，加上可移除破壞性基礎設施操作的防護欄。
11. 追蹤與稽核工作階段追蹤記錄記載了什麼、追蹤檢視器、靜態加密、保留、匯出與隱私。
12. Fusion — 多模型面板以多個模型同時回應每個提示，並在傳輸過程中經評審與整合，匯集成單一回覆。
13. 本機與混合推論使用 MLX 在您自己的 Apple Silicon 上執行模型、模型目錄、雲端／本機混合備援，以及推論指標。

超越單一 Mac

章節內容涵蓋
14. 遠端存取與完整用戶端從任何地方連上您的沙箱——完整用戶端鏡像、CLI、SSH、通道、PAC，以及遠端安全模型。
15. 企業版 — 註冊與機群使用 Bromure Enterprise Manager 進行註冊、哪些遙測資料會上傳（哪些不會）、機群檢視，以及解除納管。

參考資料

章節內容涵蓋
16. CLI、自動化與 MCPbromure-cli 命令列介面、回送控制 API、MCP 伺服器，以及 AppleScript。
進階進階使用者工具，包括可在不啟動 VM 的情況下讀取已停止工作區家目錄映像檔的 ext4 檔案瀏覽器。
17. 疑難排解依症狀分類，診斷設定、VM、驗證、TLS、供應鏈、磁碟空間與遠端存取問題。
18. 詞彙表本手冊使用的每個專業術語定義。
19. 附錄參考表格：磁碟上的位置、網路連接埠、環境變數與啟動引數，以及客體 VM 速查表。

本手冊使用的慣例

  • 粗體 文字表示畫面上的控制項，其名稱與應用程式的標示完全相同——按鈕、選單項目、切換開關或窗格（例如 登入時啟動此 VM）。
  • 等寬 文字是您輸入或看到的命令、檔案路徑、環境變數或字面值（例如 bromure-cli run 或 ~/Library/Application Support/BromureAC）。
  • 螢幕截圖顯示的是正體中文（台灣）介面。應用程式已完整在地化；您的畫面會與您的 macOS 語言相符。
  • 附註、提示與警告以callout形式呈現：

附註： 值得知道的背景資訊。

提示： 一項捷徑或建議做法。

警告： 若操作有誤，可能會遺失資料或削弱某項保護的事項。

其他可查閱之處

產品下載、技術白皮書與詳細功能對照表都位於 bromure.io。若本手冊未能回答您的問題，疑難排解彙整了診斷程序，而詞彙表則定義了相關詞彙。