Windows 版 Bromure Sidecar

Bromure Sidecar 會把 Windows PC 變成 Bromure Agentic Coding 的 原生機器。你 Mac 上的機器是 Linux VM。Sidecar 機器則是一台真正的 Windows PC,直接在 Windows 上、以你自己的 Windows 帳號執行程式設計代理程式——Claude Code、Codex、Grok Build、Kimi Code、Oh My Pi。

當 PC 登入與 Mac 相同的 bromure.io 帳號並 連接 到 Mac 後,它就會以另一部機器的身分出現在 Bromure Agentic Coding 中。它的工作階段會顯示在 Mac 上,與在 VM 中執行的工作階段並列:你可以從 Mac 啟動它們、查看它們、與它們聊天,並把工作委派給它們。你也可以從 Sidecar 的通知區域圖示,在 PC 本身啟動工作階段。

PC 與 Mac 透過 bromure.io 點對點 溝通。PC 只會向外連線,因此不需要轉送連接埠、不需要 VPN,也不必輸入任何位址。

附註: 由於 Sidecar 上的代理程式直接在 PC 上執行,它們不會經過機器的網路邊界。Squelch、憑證注入、追蹤與沙箱政策都是 機器(Linux VM)的功能,不適用於原生機器。Sidecar 代理程式擁有你 Windows 帳號的存取權限;請據此選擇它的核准層級(請參閱核准層級)。

本章涵蓋 Sidecar 的安裝、登入與連接、安裝代理程式、執行工作階段、設定、更新、解除安裝、命令列與疑難排解。關於遠端存取的 Mac 端,請參閱遠端存取與用戶端。

系統需求

WindowsWindows 10 版本 1809 或更新版本,或 Windows 11。64 位元,Intel/AMD(x64)或 ARM(ARM64)。
Git for Windows必要:代理程式與 Bromure Agentic Coding 的指令都在 Git Bash 下執行。若缺少,安裝程式會提議安裝。
Microsoft Edge WebView2 RuntimeSidecar 的視窗需要它。Windows 11 已內建;若缺少,安裝程式會提議安裝。
帳號一個 bromure.io 帳號——也就是你 Mac 上的 Bromure Agentic Coding 所登入的帳號。
系統管理員權限不需要。所有東西都安裝在你自己的帳號中。

在 Windows 11 版本 22H2 及更新版本上,Sidecar 的視窗採用 Windows 11 的半透明樣式;在較舊的版本上外觀較樸素,但運作方式相同。

安裝

下載適合你 PC 的安裝程式:

PC下載
Intel 或 AMD(大多數 PC)BromureSidecar-x64.exe
ARM(例如 Snapdragon 筆電)BromureSidecar-arm64.exe

這些連結永遠指向最新版本。不確定需要哪一個?開啟 設定 → 系統 → 關於,查看 系統類型:「x64 型處理器」表示 x64,「ARM 型處理器」表示 ARM64。ARM64 安裝程式拒絕在 x64 PC 上執行,並會告訴你。

執行安裝程式。它由 Seclio LLC 簽署,因此 Windows 會顯示這個發行者。接著:

  1. 如果缺少 Git for Windows 或 WebView2 Runtime,安裝程式會把它們列為元件。保持勾選即可一併安裝:Git 來自 winget,WebView2 來自 Microsoft。如果兩者都已存在,就會略過這一頁。
  2. 安裝程式會把 Bromure Sidecar 複製到 %LOCALAPPDATA%\Programs\Bromure Sidecar。
  3. 在最後一頁,保持勾選 Start Bromure Sidecar。

安裝程式也會:

  • 在開始功能表加入 Bromure Sidecar 捷徑;
  • 讓 Sidecar 在你登入 Windows 時啟動;
  • 註冊 bromure-agent-host:// 連結類型,bromure.io 用它把登入交回給 PC;
  • 在 設定 → 應用程式 → 已安裝的應用程式 中加入一個項目,供解除安裝使用。

通知區域圖示與飛出面板

Bromure Sidecar 位於工作列的通知區域。如果看不到它的圖示,請按一下 ^ 箭頭;你可以把圖示拖到工作列上,讓它保持可見。

圖示讓你一眼看出狀態:

圖示意義
灰色Sidecar 沒有在執行,或 PC 沒有連接到任何 Bromure Agentic Coding。
彩色已連接。將指標停在上面可看到它所連接的 Mac 名稱。
帶一個點有代理程式需要你:它正在等待回覆或核准。

在圖示上按 左鍵 會開啟 飛出面板,也就是 Sidecar 的面板。按一下其他地方或按 Esc 即可關閉。按 右鍵 會開啟一個選單,內含 Open Bromure Sidecar、Coding Agents… 與 Quit Bromure Sidecar。

飛出面板由上而下顯示:

  • 標頭:「Bromure Sidecar」與一行狀態,例如「Not signed in to bromure.io」、「Signed in as pc-name」或「Attached to Mac as pc-name」。它的兩個按鈕會開啟 Coding agents 與 Settings。
  • 橫幅(適用時):附 Install 按鈕的「Git for Windows is needed」,或附 Update 按鈕的「Bromure Sidecar version is available」。
  • 連線卡片:登入,或連接到 Mac。
  • Sessions:在這台 PC 上執行的代理程式。
  • 頁尾:Coding Agents 與 Quit。

登入 bromure.io

飛出面板的連線卡片顯示 Reach this PC from Bromure AC。

  1. 按一下 Sign in to bromure.io。瀏覽器會開啟 bromure.io 的登入頁面。
  2. 用你 Mac 所使用的帳號登入,並核准加入這台 PC。
  3. bromure.io 透過 bromure-agent-host:// 連結把登入交回給 Sidecar;瀏覽器可能會詢問是否開啟 Bromure Sidecar。請允許。

狀態行會變成「Signing in…」,然後變成「Signed in as pc-name」。

如果瀏覽器無法開啟 Sidecar(例如你在另一台電腦上完成了登入),請從頁面複製 bromure-agent-host:// 連結,然後在飛出面板中按一下 Paste link。

安全性: Sidecar 只接受它自己發起的登入。bromure-agent-host:// 連結不論是來自瀏覽器還是貼上的,都必須帶有你用 Sign in to bromure.io 開始的那次登入的代碼;其他任何連結都會被拒絕,並顯示「that sign-in link wasn't started here — sign in again from the menu」。這能防止網頁或訊息把這台 PC 偷偷加入別人的帳號。如果看到這則訊息,請再按一次 Sign in to bromure.io 並完成那次登入。

機器名稱是 Bromure Agentic Coding 列出這台 PC 時使用的名稱。預設是電腦名稱後面加上 -native;你可以在設定中變更。

連接到 Bromure Agentic Coding

登入後,連線卡片會列出 你帳號中的伺服器:Bromure Agentic Coding 處於上線狀態的 Mac,每一台都標有 Online 或 Offline,並附有 Attach 按鈕。如果一台都沒有列出,會顯示「No Bromure AC server is online in your account」:請在你的 Mac 上開啟 Bromure Agentic Coding(登入同一個帳號,並開啟透過 bromure.io 的遠端存取——請參閱遠端存取與用戶端)。

按一下你 Mac 旁邊的 Attach:

  1. 卡片顯示 Connecting。
  2. 第一次會顯示 Waiting for approval:「Allow this PC in Bromure AC's fleet dialog on Mac.」在 Mac 上,當 Bromure Agentic Coding 詢問時核准這台 PC。
  3. 卡片顯示 Attached,通知區域圖示從灰色變成彩色。

現在這台 PC 會出現在 Mac 的機器之中,位於 Native Machines 底下。連接在重新啟動後依然有效:Sidecar 下次啟動時會自行重新連線。按一下 Detach 即可停止;之後 Mac 會忘記這台 PC,直到你再次連接。

如果連接失敗,卡片會說明原因:

  • 「Can't reach Mac」——Mac 已離線或無法連線。
  • 「Mac didn't accept this machine (is it up to date?)」——請更新 Mac 上的 Bromure Agentic Coding。
  • 「Mac refused this machine」——這台 PC 在 Mac 上被拒絕;Sidecar 會在兩分鐘後重試。

程式設計代理程式

Sidecar 不附帶任何代理程式。開啟 Coding Agents(飛出面板中的按鈕,或通知區域選單中的 Coding Agents…),選擇這台 PC 要執行哪些:

代理程式開發者備註
Claude CodeAnthropic完整整合:在 Bromure Agentic Coding 中的即時狀態、聊天與委派。
CodexOpenAI
Grok BuildxAI
Kimi CodeMoonshot AI
Oh My Pi開放原始碼

每張卡片都會顯示代理程式的狀態(Installed · version、Not installed、Installing、Queued、Failed),以及其安裝程式所執行的確切指令,並附有複製按鈕。

  • Install / Update 會在你的帳號中、不需系統管理員權限地執行代理程式自己的安裝程式,該安裝程式從其開發者下載。Bromure 不會內附或代管其中任何一個。安裝一次只進行一個。大多數代理程式之後會自行保持最新。
  • Sign in… 會讓代理程式登入其供應商。Sidecar 會顯示一次性代碼,附有 Copy 與 Open sign-in page;若是 Claude Code,請把頁面顯示的代碼貼回來,然後按一下 Submit。「Agent: signed in」表示已完成。(Oh My Pi 在這裡沒有登入步驟。)
  • Check again 會重新掃描已安裝的項目,例如在你自己安裝了某個代理程式之後。

核准層級

每張代理程式卡片都有一個核准設定。它適用於新的與恢復的工作階段:

層級代理程式的行為
Ask行動前先詢問——這是代理程式本身的預設。
Auto只在動作有風險時才詢問。Codex:從不詢問,但保留 Codex 自己的沙箱。Kimi Code:只在需要時詢問。
Full從不詢問,沒有任何限制。

Oh My Pi 只提供 Ask 與 Full。

警告: 在 Sidecar 上,Full 表示代理程式可以不經詢問,做任何你的 Windows 帳號能做的事。除非這台 PC 專供代理程式使用,否則請優先選擇 Ask 或 Auto。

工作階段

飛出面板的 Sessions 清單會顯示這台 PC 上執行的每一個代理程式——不論是從 Mac 還是從 PC 啟動的——連同其標題、代理程式、資料夾與狀態:Working、Needs you 或 Idle。單純的終端機會顯示為 Shell。

  • 按一下工作階段 即可在終端機視窗中開啟它(若已安裝 Windows Terminal,就用它)。你隨時可以關閉終端機視窗:工作階段會繼續執行。
  • New 會在 PC 上啟動工作階段:選擇一個已安裝的代理程式,瀏覽到它應該工作的資料夾,然後按一下 Start in this folder。終端機會在該處開啟,而這個工作階段也會出現在 Mac 上的 Bromure Agentic Coding 中。
  • End this session(將指標停在某一列上時出現的電源按鈕)會停止它。

從 Mac 來看,Sidecar 機器的用法和其他機器一樣:在上面啟動工作階段、開啟它的終端機、與 Claude Code 工作階段聊天,或把工作委派給它。路徑以 Linux 的方式顯示:你的 Windows 設定檔資料夾是 /home/ubuntu,而 D:\src 是 /d/src。

代理程式比 Sidecar 活得更久。 它們在獨立的背景處理程序中執行:結束 Bromure Sidecar 或安裝更新都不會停止它們。不過在 Sidecar 結束期間,Mac 無法連到它們;當你在代理程式仍在執行時結束它,會收到警告。重新啟動 Windows、登出 Windows 或解除安裝則會停止它們。

設定

從飛出面板的標頭開啟 Settings:

  • Start at login —— 在你登入 Windows 時啟動 Sidecar,讓代理程式在重新啟動後仍可連線。預設開啟。
  • Machine name —— Bromure Agentic Coding 列出這台 PC 時使用的名稱。清空即可恢復預設值(電腦名稱-native)。
  • SSH host key —— 這台 PC 的 SSH 主機金鑰指紋,附有複製按鈕,方便從 Mac 核對。
  • bromure.io account —— PC 以哪個帳號登入,以及 Sign out。登出也會解除 PC 的連接,並從 PC 移除該帳號的金鑰。

頁尾會顯示 Sidecar 的版本及其 SSH 伺服器的位址(請參閱安全性)。

更新

Sidecar 在啟動兩分鐘後檢查是否有新版本,之後每 12 小時檢查一次。有新版本時,飛出面板會顯示「Bromure Sidecar version is available — Agents keep running while it installs.」按一下 Update:Sidecar 會下載新的安裝程式、加以驗證,並以靜默方式安裝。幾秒後 Sidecar 會自行重新啟動;執行中的代理程式不會被中斷。

除非你按一下 Update,否則不會更新任何東西。你也可以隨時從下載連結執行最新的安裝程式,覆蓋現有版本來安裝新版本。

解除安裝

開啟 設定 → 應用程式 → 已安裝的應用程式,找到 Bromure Sidecar,然後選擇 解除安裝。如果仍有代理程式在執行,解除安裝程式會先詢問:「Agents are still running in Bromure Sidecar. Uninstalling stops them. Continue?」

解除安裝會移除程式、開始功能表捷徑、登入時啟動的項目,以及 bromure-agent-host:// 連結類型。它會保留你的資料夾 %LOCALAPPDATA%\BromureSidecar(登入資訊、設定、記錄):若要徹底清除,請一併刪除該資料夾。若也要把 PC 從你的 bromure.io 帳號移除,請在解除安裝前登出(在設定中)。

安全性

  • 只向外連線。 PC 不對網路開啟任何連接埠。它的 SSH 伺服器只在 127.0.0.1(連接埠 2223)上接聽,而 Mac 透過 PC 自己連上的 bromure.io 中繼來連到它。
  • 用金鑰,不用密碼。 SSH 登入只接受金鑰,且只限你自己的 Windows 使用者名稱。金鑰來自你 bromure.io 帳號中的裝置;Sidecar 每三分鐘同步一次,並在你登出時移除。
  • 在 Mac 上核准。 Mac 只有在你於該處核准之後,才會讓 Sidecar 連接。
  • 你的資料仍屬於你。 Sidecar 的資料夾只有你的帳號與 Windows 本身可以讀取。
  • 已簽署的軟體。 安裝程式及其中每一個程式都由 Seclio LLC 簽署並加上時間戳記;更新在執行前會與公布的 SHA-256 核對。
  • 沒有網路邊界。 如開頭所述,原生機器沒有 Linux VM 的閘道防護。請把 Sidecar 當成你自己的終端機看待,並據此選擇代理程式的核准層級。

命令列

安裝資料夾中的 bromure-sidecar.exe 是 Sidecar 的命令列工具。它的 ctl 指令會與執行中的 Sidecar 溝通:

指令作用
bromure-sidecar ctl healthSidecar 是否在執行?
bromure-sidecar ctl status版本、機器名稱、帳號、連接狀態、SSH 連接埠與指紋、執行中的代理程式。
bromure-sidecar ctl signin開啟 bromure.io 的登入頁面。
bromure-sidecar ctl enroll <code-or-link>用你複製的代碼或連結登入(如同 Paste link)。
bromure-sidecar ctl signout登出 bromure.io(同時解除連接)。
bromure-sidecar ctl servers列出帳號中的伺服器。
bromure-sidecar ctl attach {"id":"<server-id>"}連接到某個伺服器。
bromure-sidecar ctl detach解除連接。
bromure-sidecar ctl machine-name <name>為 PC 重新命名。
bromure-sidecar ctl install-state代理程式的安裝狀態。
bromure-sidecar ctl quit停止 Sidecar(代理程式會繼續執行)。
bromure-sidecar claude在目前資料夾中以 Sidecar 工作階段啟動 Claude Code,並在此處連上它。按 Ctrl-B 再按 D,即可讓它繼續執行而離開。
bromure-sidecar version顯示版本。

在 PowerShell 中,請用單引號括住 JSON 參數:bromure-sidecar ctl attach '{"id":"<server-id>"}'。

檔案與資料夾

路徑內容
%LOCALAPPDATA%\Programs\Bromure Sidecar程式。
%LOCALAPPDATA%\BromureSidecar你的資料:登入資訊、設定、工作階段、SSH 金鑰。
%LOCALAPPDATA%\BromureSidecar\settings.json設定,包括一些沒有按鈕的項目:sshPort(預設 2223)與 updateFeed(設為 "" 即可關閉更新檢查)。編輯後請結束並重新啟動 Sidecar。
%LOCALAPPDATA%\BromureSidecar\logs\bromure-sidecar.log記錄檔。

疑難排解

問題處理方式
「Bromure Sidecar isn't running」從開始功能表啟動 Bromure Sidecar。你的代理程式並未停止。
出現「Git for Windows is needed」橫幅,或指令失敗並顯示「Git for Windows isn't installed on this machine」按一下橫幅中的 Install(它會執行 winget install --id Git.Git -e --scope user),或自行安裝 Git for Windows,然後再試一次。
「WebView2 isn't available」安裝 Microsoft Edge WebView2 Runtime,然後再次啟動 Sidecar。
「that sign-in link wasn't started here — sign in again from the menu」按一下 Sign in to bromure.io 並完成那次登入;請參閱登入 bromure.io。
「This machine was removed from your bromure.io account.」這台 PC 已在 bromure.io 上被移除。請重新登入。
「Enrolled without the agent-host capability…」在 Settings 中登出,然後用 Sign in to bromure.io 重新登入。
「No Bromure AC server is online in your account.」在 Mac 上啟動 Bromure Agentic Coding,登入同一個帳號,並開啟透過 bromure.io 的遠端存取。
卡在 Waiting for approval在 Mac 上的 Bromure Agentic Coding 中核准這台 PC。
代理程式說它沒有安裝從 Coding Agents 安裝它。如果安裝程式已完成,卻仍找不到代理程式,請按一下 Check again,或登出 Windows 後再重新登入。
Settings 畫面顯示「Couldn't start the SSH server」有其他程式正在使用連接埠 2223。在 settings.json 中設定另一個 sshPort,然後結束並重新啟動 Sidecar。
其他任何問題從通知區域選單結束並重新啟動 Sidecar(代理程式會繼續執行),然後查看記錄檔。bromure-sidecar ctl status 可一次顯示 Sidecar 的狀態。