Bromure Agentic Coding — 用户手册

欢迎阅读 Bromure Agentic Coding 的官方用户手册。这是一款 macOS 应用程序，它把 AI 编码代理——Claude Code、Codex、Grok、Kimi Code、Oh My Pi，以及寻常的 shell 工具——跑在你 Mac 上隔离的 Linux 虚拟机里，并以一道主机端的网关把你真正的凭据挡在代理伸手不到的地方。

本手册记述的是版本 5.0.0。它需要 Apple Silicon 上的 macOS 14（Sonoma）或更新版本。

版本 5.0.0 是围绕会话编排的：你与某个代理的每一段对话都是边栏里的一行，而你在一个聊天中跟它说话。会话所跑的那些 Linux VM，在主窗口里叫做机器。设置编辑器仍叫它们工作区；这两个词指的是同一样东西。

初次使用这个应用程序？ 请从安装与首次运行开始，接着照着快速上手走。想要完整的全貌时，再读概念与架构。其余的都当作参考来用。

目录

开始之前

章节涵盖什么
1. 简介这个应用程序是什么、单一边界的安全模型、主要功能，以及它与其他工具的比较。
2. 安装与首次运行系统需求、安装应用程序、六个步骤的上手向导、基础镜像的更新、命令行工具、存储空间、搬到一台新 Mac，以及卸载。
3. 快速上手从向导到一件完成的工作：开始一个会话、回答代理的问题、看看变动的文件、检查追踪记录，然后归档这个会话再把它找回来。
4. 概念与架构会话、机器、房间与分支；会话的状态；主机与客体；传输边界；什么会留存；vsock 与 MCP 端口；网络。

日常使用

章节涵盖什么
5. 会话主页主窗口：边栏与它收起的栏轨、会话的行与它们的菜单、会话标头、机器菜单、Linux 胶囊、⌘K 命令面板，以及归档、结束、删除与撤销。
6. 开始一个会话新建会话的界面：挑代理、挑机器、挑它在哪里工作（一个新文件夹、你自己的某一个，或一个仓库）、附上文件、最近的开始，以及用 @ 去问另一个会话。
6.1 聊天跟代理说话：输入区、附件、斜杠命令与行内终端、问题卡、活动行、变动文件的摘要、登录卡、停止、编辑后重发，以及搜索。
6.2 房间把相关的会话编进一个房间：活生生的聊天网格视图、版面与标签页、放大某一格、房间自己的总机，以及送给整个房间。
6.3 分支与审查跑在自己 git worktree 上的分支会话、把它们并回去、分支窗口，以及带行注释的审查窗口。
6.4 代理协同工作委派给子会话、以 @昵称向其他会话提出请求、委派面板、文件交接、限制，以及跨机器的请求。
6.5 总机与消息掌握其他每一个会话的总机会话、它的安全规则，以及给 Signal、WhatsApp 与 Slack 的消息连接器。
6.6 机器虚拟机分区：创建、启动、挂起与删除机器、回退主目录与重置磁盘、终端与网格视图、文件窗格，以及剪贴板。
6.7 嵌入式浏览器会话旁的 Chromium 浏览器：自己操作它、透过浏览器工具让代理操作它、保持登录，以及隐私。
Bromure Web 中的 Metal 加速独立的网页应用：Metal 要求、应用全局和按配置文件的控件、当前渲染器，以及视频支持。
6.8 自动化看板上排定的、无人看顾的代理运行：触发条件、排程、串接、运行历史、回答它们的提问，以及自动化的 MCP 服务器。
6.9 编码任务编码看板：任务、代理规划的阶段、在 worktree 中的自主运行、带行注释的审查，以及合并。

设置参考

章节涵盖什么
7. 设置参考怎么打开设置编辑器与设置、分了组的窗格清单与搜索设置、默认值模板，以及什么时候会存下什么。

设置参考依编辑器的顺序，每个窗格一页：

安全与传输边界

章节涵盖什么
8. 凭据与传输边界真正的秘密怎么留在主机上，而代理只拿到假的：MITM 代理服务器、登录与 API 密钥、按凭据的批准，以及入侵警报。
9. 供应链保护在代理看到之前就检查、改写并挡下包安装：年龄关卡、OSV、socket.dev、Depi，以及剥除安装脚本。
10. 提示注入检测与护栏在代理的 AI 流量中搜索被注入指令的设备端检测器、出站防火墙，以及对破坏性操作的护栏。
10.5 个人数据保护在一段对话离开你的 Mac 之前，把个人数据换成前后一致的替身，并在回复中把它换回来。
11. 追踪与审计一份会话追踪记录记了什么、跟踪检查器、静态加密、保留期限、导出，以及隐私。
11.5 安全概览与时间线安全时间线窗口：24 小时的概览、按机器的防护，以及可筛选、可导出的每一项安全决策时间线。

模型与基础设施

章节涵盖什么
12. Fusion — 多模型面板同时用好几个模型回答每一个提示，经评判后在传输上合成单一的回复。
12.5 Squelch — 噪音更少，token 更省在模型读取之前，从命令输出中去除通过的测试、进度等噪音（仿照 rtk），以及每个会话节省的 token。
13. 模型与提供方全局模型盘面：提供方（登录、API 密钥、Amazon Bedrock、OpenRouter、自定义服务器、设备端模型）、每个代理的模型选择、每个工作区的覆盖，以及即时的更改。
13.5 Kubernetes 集群与注册表在你的机器旁边，于各自的 VM 中跑 k3s 集群与一个私有容器注册表：存储、负载均衡、附加组件、访问，以及基础设施的 MCP 服务器。

超出一台 Mac

章节涵盖什么
14. 远程访问与富客户端从另一台 Mac、iPhone、iPad 或 Apple Vision Pro 镜像一个远程的 Bromure；远程设置；走 SSH 的 CLI、隧道与 PAC；以及远程的安全模型。
15. 企业版 — 注册与设备群注册到 bromure.io、遥测上传什么（以及不上传什么）、设备群视图，以及离场。

参考

章节涵盖什么
16. CLI、API 与 MCPbromure-cli 命令行工具、回环的控制 API、各个 MCP 服务器，以及 AppleScript。
16.5 高级高级用户的工具：ext4 文件浏览器与文件系统检查，以及恢复或回退一台机器的主目录。
17. 故障排除按症状编排，诊断安装、机器、登录、TLS、供应链、磁盘空间与远程访问的问题。
18. 术语表本手册所用每一个术语的定义。
19. 附录 — 文件位置、端口与环境参考表格：磁盘上的位置、网络与 vsock 端口、环境变量、默认值、键盘快捷键，以及客体端的速查表。

本手册的体例

  • 粗体文字指的是屏幕上的某个控件或标签，字面就是应用程序以英文显示的样子——按钮、菜单项目、开关、窗格或边栏分区（例如 New session 或 Start this VM at login）。
  • 等宽文字是你打进去或看到的命令、文件路径、环境变量或字面值（例如 bromure-cli vm ls 或 ~/Library/Application Support/BromureAC）。
  • 像 Workspaces › Infrastructure › Messaging Connector… 这样的一串是菜单路径：先是菜单，然后依序是每个子菜单或项目。设置 › 模型指的是设置窗口的模型窗格。
  • 机器与工作区指的是同一样东西：一台带着自己设置的隔离 Linux VM。主窗口说机器；设置编辑器、像 New Workspace… 这样的菜单，以及 CLI 说工作区（或描述文件）。
  • 一个会话是在一台机器的一个文件夹里，与一个代理进行的一段对话。它不是机器的一次运行；见概念与架构。
  • 键盘快捷键使用 macOS 的符号：⌘ Command、⌥ Option、⌃ Control、⇧ Shift、⏎ Return、⎋ Escape。
  • 截图显示的是英文界面，搭配合成的示范内容。这个应用程序有本地化，所以你的界面会跟随你 macOS 的语言。
  • 注意、提示与警告会以框注呈现：

注意： 值得知道的背景说明。

提示： 一条捷径，或建议的做法。

警告： 弄错时可能会丢失数据或削弱某项防护的事。

还可以看哪里

产品下载、技术白皮书与详尽的功能对照表都在 bromure.io。本手册没有回答到的问题，故障排除汇集了诊断流程，而术语表界定了用语。