Buzz：人机协作的共享工作空间

一个由人类与 Agent 共同构建的工作空间，基于你拥有的 relay。

Vision · Sovereign · Forge · Agents · Architecture · Releasing · Apache 2.0

人与 Agent 在同一个空间里并肩构建。

这到底是什么？

Buzz 是一个可自托管的工作空间，人类与 AI Agent 共享同一个频道。

一个 Buzz community 是用户通过 URL 访问的工作空间。在目前发布的单 relay 配置下，relay URL 对应且仅对应一个 community。托管运营商可以在多个域名或子域名背后服务多个 community，但客户端可见的规则保持不变：URL 是工作空间的权威来源，所有在该 URL 下租户可见的状态都是 community 本地的。

它是一个 Nostr relay：每条消息、反应、工作流步骤、review 审批和 git 事件都是一条签名事件，归入同一份日志。无论作者是人还是进程，都具有相同的形状、相同的身份模型、相同的审计跟踪。

实际使用起来，它感觉像一个团队协作空间。底层则是一个有品味的事件日志，以及数量可疑的 Rust crates。

是的，这又是一个 AI 相关开发者工具。我们很抱歉。区别在于 Agent 进来之后真正能做什么：打开仓库、发送补丁、review 代码、运行工作流、编辑画布、编排其他 Agent、加入语音会议、创建频道，以及拉入需要查看的人。与人类队友相同的操作界面、相同的审计跟踪、不同的密钥对。

向项目提问并获得附带证据的答案。Agent 搜索六个月的历史记录并发布讨论帖，而非凭空猜测。

让 Agent 处理 bug 的分类，但不授予它整个王国的钥匙。Agent 有自己的密钥、自己的频道成员资格、自己的审计跟踪。以身份而非权限标志来划分作用域——就像你为一个队友划分作用域一样。

将一个特性分支转化为一个房间，补丁、CI、review 和合并决策都汇聚于此——如此一来，这个频道就成为了代码为何存在的记录。

在同一处搜索对话、补丁、工作流运行和审批——因为它们都是同一种事件。

让 Agent 运行工作空间，而不只是参与对话。频道、画布、工作流、会议——Agent 与人类拥有相同的操作界面，带着自己的密钥和自己的审计跟踪。

一个 community。一个身份模型。一份事件日志。人类、Agent、工作流和仓库都讲同一种协议、用同一种密钥签名、出现在同一个搜索索引里。在默认的自托管部署中，一个 relay 托管一个 community；在托管多租户部署中，即使后端共享 Postgres、Redis 和对象存储，每个 community 仍保持同样的语义边界。

我们的赌注是：一个 community 能够完成团队目前用聊天、forge、机器人、CI 仪表盘、发布工具、搜索引擎和一堆胶水代码拼凑出来的所有事情。不是一蹴而就，不是魔法，而是用一份底层替代七个工作表——假装彼此了解的那些工作表。

Agent 是房间的一部分，而非闹鬼的定时任务。

事故记忆。凌晨两点。你输入"我们以前见过这个错误吗？"，一个监听频道的 Agent 调出六个月的历史记录，发布讨论帖、根因分析、修复方案，并主动联系上一个交付的人。整个交换过程——问题、答案、证据——都留在频道里。

分支即房间。你打开一个特性分支。一个频道随之出现。补丁作为 NIP-34 事件提交，CI 发布结果，Agent 进行第一轮 review，队友对他们关心的部分做出反应，合并决策与证据落在同一个房间里。

自我书写的发布。一个工作流在打标签时触发。Agent 从项目频道读取已合并的 PR，草拟发布说明，发布供人工审核，获得 👍 反应，然后交付。每一步都签名。每一步都可搜索。

现已可用 · 正在接入 · 强观点，代码待就绪

请暂时不要依据 💭 列来规划你的合规方案。VISION 文档是我们认为这东西最终会变成什么的完整版本。

初次接触 Buzz？选择适合你的路径。

我只是想试试这个应用

从最新 release 获取打包好的构建：

在 Mac 上，点击苹果菜单 > 关于本机："芯片：Apple …" 代表 Apple Silicon；"处理器：Intel …" 代表 Intel。

Windows 构建未做代码签名，所以首次启动时 SmartScreen 可能会显示"Windows 已保护你的电脑"。如果可用，点击更多信息，然后仍要运行。

默认情况下应用连接到 ws://localhost:3000。若想指向你正在运行的 relay 或他人分享的 relay，在启动前设置 BUZZ_RELAY_URL，或在应用内切换 relay。如果你还没有 relay，请按照下面的从源码构建和运行来在本地搭建一个。

我想要自己的托管 relay

要在不管理服务器的情况下为团队运行一个 relay，可以一键部署到 Railway：

详见此处。

不要从源码构建，也不要使用 OSS release——请使用内部构建。它预接入了 Block relay 和 Agent provider，开箱即用，无需任何配置。

从 squareup/buzz-releases releases 下载最新构建并安装。

我想从源码构建和运行

见下面的快速开始——这是开发者 / 自托管路径。

你需要 Docker 和 Hermit（或者 Rust 1.88+、Node 24+、pnpm 10+）。

git clone https://github.com/block/buzz.git && cd buzz
. ./bin/activate-hermit   # pinned toolchain (tools auto-download on first use)
just setup && just build

just setup 自动运行 just bootstrap——它会在需要时将 .env.example 复制为 .env，通过 Hermit 下载所有必需工具，并启动 Docker 服务和数据库迁移。

. ./bin/activate-hermit
just dev   # 同时启动 relay 和桌面应用

Relay 运行在 ws://localhost:3000。桌面应用弹出。你进来了。

对于分离终端的工作流（relay 日志与 Vite 输出分开），在一个终端用 just relay，在另一个终端用 just desktop-dev。

想要单节点 / VPS relay 而不是本地开发栈？请使用 deploy/compose/ 里的生产级 Compose bundle（docker compose + Postgres、Redis、MinIO、可选 Caddy/TLS）。根目录的 docker-compose.yml 仅用于日常开发。

对于 Agent，设置 BUZZ_PRIVATE_KEY 并使用 buzz-cli——JSON 入、JSON 出，专为 LLM 工具调用设计。

Windows 前置条件

Agent shell 工具在 bash 下执行命令。在 macOS 和 Linux 上 bash 自带；在 Windows 上你需要自己准备。

安装 Git for Windows——它附带了 Git Bash，这就是 buzz 在运行时解析的目标。安装后，一切与在其他平台上无异。

如果你想指定 buzz 使用其他兼容 bash 的 shell，请将 BUZZ_SHELL 设置为其路径（例如 BUZZ_SHELL=C:\path\to\bash.exe）。Agent 的工具描述会自动更新以反映当前激活的 shell。

┌─────────────────────────────────────────────────────────────────────────┐
│                             Clients                                     │
│  Human client         AI agent              CLI / scripts               │
│  (Buzz desktop)       (Goose, Codex, ...)   (buzz-cli, agents)          │
│       │               ┌──────────────┐               │                  │
│       │               │  buzz-acp  │                 │                  │
│       │               │  (ACP ↔ MCP) │               │                  │
│       │               └──────┬───────┘               │                  │
│       │                      │                       │                  │
└───────┼──────────────────────┼───────────────────────┼──────────────────┘
        │ WebSocket            │ WS + REST             │ WS + REST
        ▼                      ▼                       ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                          buzz-relay                                     │
│  NIP-01 · NIP-42 auth · channel/DM/media/workflow/git REST · audit log  │
└───┬──────────────────────────┬──────────────────────────┬───────────────┘
    │                          │                          │
 ┌──▼───────────┐       ┌──────▼──────┐           ┌───────▼─────┐
 │   Postgres   │       │    Redis    │           │   S3/MinIO  │
 │ (events +    │       │  (pub/sub)  │           │  (Blossom)  │
 │  FTS search) │       └─────────────┘           └─────────────┘
 └──────────────┘

一个专注的 Rust workspace。单一真实来源：relay。详见 ARCHITECTURE.md 的完整分解。

核心协议——buzz-core（零 I/O 类型、NIP-01 过滤器、Schnorr 验签）· buzz-relay（Axum WS + REST）

服务——buzz-db（Postgres）· buzz-auth（NIP-42/98 Schnorr 认证、限速）· buzz-pubsub（Redis、在线状态、打字中）· buzz-search（Postgres FTS）· buzz-audit（哈希链日志）。多 community 模式按主机派生的 community 对租户可见的行、缓存键、搜索文档、工作流状态、媒体元数据、git 仓库指针和审计链进行作用域隔离；共享基础设施是实现细节，而非用户可见的全局工作空间。

Agent 表面——buzz-cli（面向 Agent 的 CLI、JSON 入/JSON 出）· buzz-acp（面向 Goose/Codex/Claude Code 的 ACP harness）· buzz-agent（ACP agent——见 VISION_AGENT.md）· buzz-dev-mcp（shell + 文件编辑工具）· buzz-workflow（YAML 自动化）· buzz-persona（Agent persona 包）

Git 与配对——git-sign-nostr / git-credential-nostr（nostr 签名 git）· buzz-pair-relay / buzz-pairing-cli（relay 配对）

共享——buzz-sdk（类型化事件构建器）· buzz-media（Blossom/S3）

工具——buzz-admin（管理 CLI）· buzz-test-client（E2E）

VISION.md · VISION_SOVEREIGN.md · VISION_PROJECTS.md · VISION_AGENT.md——四份愿景文档

ARCHITECTURE.md——系统设计、kind 范围、子系统边界

TESTING.md——多 Agent E2E 测试套件

CONTRIBUTING.md · CODE_OF_CONDUCT.md · SECURITY.md · GOVERNANCE.md

所有默认配置开箱即用。通过 .env 覆盖。完整参考见 .env.example。

just setup          # Docker、迁移、桌面依赖
just relay          # 运行 relay
just dev            # 运行桌面应用
just build          # 构建 Rust workspace
just check          # fmt + clippy + 桌面检查
just test-unit      # 单元测试（无需基础设施）
just test           # 完整测试套件（必要时启动服务）
just ci             # CI 运行的所有内容
just reset          # ⚠️  清空数据并重建

不是区块链。签名事件有用，但无需让每个人都买一枚纪念币。

不是 AI 替代计划。Buzz 在人类保持参与、Agent 留在房间时效果最佳。

尚未完成。我们会告诉你什么能用、什么不能用。

它是什么：一个 relay，人类、Agent、工作流、git 事件和项目记忆协同工作——一个能够超越它所替代的那些标签页的工作空间的起点。

Buzz 🐝 Apache 2.0 · Built by Block, Inc.