自動化
自動化窗格是編輯器中唯一不是以工作區為單位的設定。它用於設定 Bromure Agentic Coding 的 HTTP 自動化 API——一個由外部工具、指令碼與 AI 代理程式用來管理工作區與工作階段的回送控制平面——並套用至整個應用程式。由於它不隸屬於任何單一工作區,因此只有在您以應用程式的偏好設定開啟編輯器時才會出現。
本章沒有此窗格的螢幕擷圖:它是透過 Bromure → 偏好設定…(⌘,)進入,其中編輯器繫結至偏好設定範本,而自動化類別會加入至類別側邊欄的底部。當您編輯一般工作區時,它不會出現。
附註: 與每個以工作區為單位的窗格不同,此窗格並非交易式的。它的控制項會在您變更的當下立即寫入應用程式偏好設定——沒有儲存步驟,切換開關會立即生效。
自動化伺服器是什麼
此窗格的摘要說明得很清楚:Bromure Agentic Coding 在回送介面上公開一個 HTTP API,讓外部工具能夠管理工作區與工作階段,而隨附的 bromure-cli mcp 子命令則為 Claude Code 與 Claude Desktop 等 AI 代理程式包裝了相同的介面。
有兩條存取路徑共用這一個 HTTP 介面,值得將它們區分開來:
- 控制通訊端——一個永遠開啟、僅限擁有者存取的 Unix 通訊端,位於
~/Library/Application Support/BromureAC/control.sock(模式0600)。bromure-cli命令列工具透過此通訊端與應用程式溝通。它獨立於此窗格:無論自動化伺服器是否啟用,CLI 皆可運作,因為通訊端上的檔案權限就是它的存取閘門。 - 自動化 API——透過 TCP 公開的相同路由,預設為關閉,於此處啟用。這是外部 HTTP 用戶端與
bromure-cli mcp伺服器所使用的。關閉此項不會影響 CLI。
完整的路由清單、CLI 以及 MCP 伺服器記載於自動化與 CLI。
啟用自動化伺服器
啟用自動化伺服器開關可開啟與關閉 TCP 監聽器。其說明文字會反映目前的狀態:
- 開啟時:正在監聽
127.0.0.1:9223。將此項切換為關閉會立即停止伺服器;MCP 子命令將無法再連接至應用程式。 - 關閉時:已關閉——HTTP API 與 MCP 子命令均無法使用。
伺服器預設為關閉。當它關閉時,bromure-cli mcp stdio 伺服器沒有可連接的對象,因此任何針對它設定的 MCP 用戶端都會回報沒有工具,直到您在此處啟用伺服器為止。
警告: 自動化 API 沒有驗證機制。在回送介面上,設定檔與工作階段列示,以及工作階段的建立/關閉,對任何本機處理程序都是開放的;變動與內省路由(工作區控制、
exec、應用程式狀態、除錯)另外要求應用程式必須以BROMURE_DEBUG_CLAUDE啟動。由於沒有驗證機制,將監聽器公開到回送介面以外是實實在在的風險——請參閱下方的繫結位址。
連接埠與繫結位址
有兩個欄位可調整伺服器的監聽位置:
- 連接埠——TCP 連接埠,預留位置為 (default: 9223),有效範圍為 1–65535。9223 這個預設值刻意與 Bromure 網頁瀏覽器的自動化連接埠(9222)相差一,如此兩個應用程式便能並行執行。
- 繫結位址——要繫結的介面,預設為
127.0.0.1。任何非回送的值都會引發橙色警告:非回送繫結會將 API 公開至網路。MCP 伺服器沒有驗證機制。 除非您完全了解此暴露風險,否則請將此項維持在127.0.0.1。
此窗格說明了生效時機:連接埠與繫結位址會在下次伺服器啟動時生效。將開關切換為關閉再開啟會立即套用。 換句話說,變更連接埠或位址後,再將啟用自動化伺服器切換為關閉再開啟,即可立即重新繫結。
MCP 用戶端設定
窗格底部有一段可直接貼上的 MCP 用戶端設定片段,用於將 bromure-cli mcp 伺服器接入 MCP 用戶端。內容為:將以下內容加入 ~/.config/claude-code/.mcp.json(或您的 MCP 用戶端的對應檔案):
{
"mcpServers": {
"bromure-cli": {
"command": "/Applications/Bromure Agentic Coding.app/Contents/MacOS/bromure-cli",
"args": ["mcp"]
}
}
}
command 直接指向套件內的應用程式二進位檔。請先啟用自動化伺服器,因為 MCP 伺服器的工作階段與設定檔工具會呼叫您剛才開啟的 HTTP API。
設定儲存位置
此窗格中的所有內容都儲存在應用程式偏好設定中的 io.bromure.agentic-coding 網域下,而非任何 profile.json。這三個相同的鍵值也可從命令列或透過 AppleScript 設定,這對於指令碼化的佈建非常有用:
| 設定 | 偏好設定鍵 | 類型 | 預設值 |
|---|---|---|---|
| 啟用自動化伺服器 | automation.enabled | 布林值 | false |
| 連接埠 | automation.port | 整數(1–65535) | 9223 |
| 繫結位址 | automation.bindAddress | 字串(IP) | 127.0.0.1 |
舉例來說,defaults write io.bromure.agentic-coding automation.enabled -bool true 會啟用伺服器,而 AppleScript 的 set ac app setting "automation.enabled" to value "true" 則會即時切換它。兩者的運作機制,連同 API 與 MCP 伺服器所能執行的一切,都記載於自動化與 CLI。