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 端,請參閱遠端存取與用戶端。
系統需求
| Windows | Windows 10 版本 1809 或更新版本,或 Windows 11。64 位元,Intel/AMD(x64)或 ARM(ARM64)。 |
| Git for Windows | 必要:代理程式與 Bromure Agentic Coding 的指令都在 Git Bash 下執行。若缺少,安裝程式會提議安裝。 |
| Microsoft Edge WebView2 Runtime | Sidecar 的視窗需要它。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 會顯示這個發行者。接著:
- 如果缺少 Git for Windows 或 WebView2 Runtime,安裝程式會把它們列為元件。保持勾選即可一併安裝:Git 來自 winget,WebView2 來自 Microsoft。如果兩者都已存在,就會略過這一頁。
- 安裝程式會把 Bromure Sidecar 複製到
%LOCALAPPDATA%\Programs\Bromure Sidecar。 - 在最後一頁,保持勾選 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。
- 按一下 Sign in to bromure.io。瀏覽器會開啟 bromure.io 的登入頁面。
- 用你 Mac 所使用的帳號登入,並核准加入這台 PC。
- 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:
- 卡片顯示 Connecting。
- 第一次會顯示 Waiting for approval:「Allow this PC in Bromure AC's fleet dialog on Mac.」在 Mac 上,當 Bromure Agentic Coding 詢問時核准這台 PC。
- 卡片顯示 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 Code | Anthropic | 完整整合:在 Bromure Agentic Coding 中的即時狀態、聊天與委派。 |
| Codex | OpenAI | |
| Grok Build | xAI | |
| Kimi Code | Moonshot 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 health | Sidecar 是否在執行? |
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 的狀態。 |