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 的状态。