Bromure Agentic Coding — 用户手册

欢迎阅读 Bromure Agentic Coding 的官方用户手册。这款 macOS 应用在一次性 Linux 虚拟机内运行 AI 编码代理——Claude Code、Codex CLI、Grok CLI、Kimi Code、Oh My Pi 以及普通的 shell 工具——并配有一个宿主机端网关，使你真实的凭据始终不被代理触及。

本手册记录的是 4.6.0 版本。它需要运行在 Apple Silicon 上的 macOS 14 (Sonoma) 或更高版本。如果你是初次使用，请先阅读简介，然后阅读快速入门；其余内容都是可供你随时查阅的参考资料。

初次使用应用？ 让代理跑起来的最快路径是先完成安装，再按照快速入门的操作演练进行。

目录

快速上手

章节涵盖内容
1. 简介应用是什么、单一边界安全模型、核心支柱功能，以及它与其他工具的比较。
2. 安装系统要求、下载并安装应用、首次启动的设置流程、基础镜像更新、迁移，以及卸载。
3. 快速入门从全新安装到让代理运行起来，约十分钟：创建工作区、选择代理、共享文件夹、运行任务，以及检查追踪。

基础知识

章节涵盖内容
4. 概念与架构宿主机与客户机、工作区与会话与虚拟机、虚拟机生命周期、传输边界、存储、vsock 桥接，以及网络。
5. 工作区工作区浏览器：状态标签、资源卡片、配置摘要，以及创建、复制、重置和删除工作区。
6. 会话统一的会话窗口：启动和关闭会话、标签页与工作树、浏览器窗格与文件窗格、文件传输，以及检查点。
嵌入式浏览器使用工作区内置的 Chromium：自己驱动它、让代理通过浏览器工具驱动它、保持登录状态，以及隐私。
自动化在看板上进行的计划中的无人值守代理运行：创建它们、触发器与计划、链式自动化、运行历史，以及回应它们的提示。
编码任务编码看板：任务简报、由代理规划且带有依赖关系的阶段、在 worktree 中自主运行、带行内评论的 diff 审阅，以及合并。

设置参考

章节涵盖内容
7. 设置参考如何打开编辑工作区编辑器，以及全部十六个窗格的逐页参考。

设置参考为每个窗格提供一页：通用、代理、本地模型、Fusion、文件夹、凭据、环境、MCP、追踪、护栏、供应链、提示注入、外观、浏览器、资源，以及应用级的自动化窗格。

深入了解各支柱

章节涵盖内容
8. 凭据与传输边界真实机密如何留在宿主机上，而代理只拿到伪造的：MITM 代理服务器、逐个凭据的生命周期、批准，以及泄露检测器。
9. 供应链保护在代理看到之前对软件包安装进行审查、重写和拦截——时效门槛、OSV、socket.dev、Depi，以及脚本剥离。
10. 提示注入检测与护栏在设备上运行的检测器扫描代理的 AI 流量以查找被注入的指令，外加剥离破坏性基础设施操作的护栏。
11. 追踪与审计会话追踪记录了什么、追踪检查器、静态加密、保留、导出，以及隐私。
12. Fusion — 多模型面板用多个模型同时回答每个提示，在传输过程中评判并综合为单一回复。
13. 本地与混合推理使用 MLX 在你自己的 Apple Silicon 上运行模型、模型目录、云/本地混合回退，以及推理指标。

超越单台 Mac

章节涵盖内容
14. 远程访问与富客户端从任何地方访问你的沙盒——富客户端镜像、CLI、SSH、隧道、PAC，以及远程安全模型。
15. 企业版 — 注册与设备群通过 Bromure Enterprise Manager 进行注册、上传哪些遥测数据（以及不上传哪些）、设备群视图，以及注销。

参考

章节涵盖内容
16. CLI、自动化与 MCPbromure-cli 命令行界面、环回控制 API、MCP 服务器，以及 AppleScript。
进阶高级用户工具，包括无需启动即可读取已停止工作区主目录镜像的 ext4 文件浏览器。
17. 故障排除按症状归类，诊断设置、虚拟机、身份验证、TLS、供应链、磁盘空间和远程访问问题。
18. 术语表本手册中使用的每个专业术语的定义。
19. 附录参考表：磁盘上的位置、网络端口、环境变量与启动参数，以及客户机虚拟机速查表。

本手册使用的约定

  • 粗体文本表示应用界面上的控件，其名称与应用标注的完全一致——按钮、菜单项、开关或窗格（例如 登录时启动此虚拟机）。
  • 等宽文本表示你输入或看到的命令、文件路径、环境变量或字面值（例如 bromure-cli run 或 ~/Library/Application Support/BromureAC）。
  • 截图展示的是简体中文界面。应用已完全本地化；你的界面将与你的 macOS 语言一致。
  • 注意、提示和警告以标注形式出现：

注意： 值得了解的背景信息。

提示： 一个快捷方式或推荐做法。

警告： 如果操作有误，可能会丢失数据或削弱某项保护的事项。

其他参考资源

产品下载、技术白皮书和详细的功能对照表位于 bromure.io。对于本手册未能回答的问题，故障排除汇集了诊断流程，而术语表则定义了相关词汇。