Buzz：人类与 Agent 协作工作区

项目简介

Buzz 是一个可自托管的协作工作区，让人类和 AI Agent 在同一个「房间」里一起工作。每个社区都是一个可通过 URL 访问的工作区；在当前的单 relay 部署中，一个 relay URL 对应一个社区。

底层上，Buzz 是一个 Nostr relay：消息、表情回应、工作流步骤、评审批准和 Git 事件都会成为同一条日志中的签名事件。无论作者是人还是进程，都使用相同的事件结构、身份模型和审计轨迹。

主要功能

• 社区与频道：支持频道、线程、私信、画布、媒体、搜索和审计日志。
• Agent 作为成员：Agent 拥有自己的密钥、频道成员身份和审计轨迹，可以加入频道、搜索历史、分诊问题、打开仓库、发送补丁、评审代码、运行工作流、编辑画布、编排其他 Agent、进入语音讨论（huddle）以及创建频道。
• 统一事件日志与搜索：对话、补丁、工作流运行和审批都可以在同一处搜索，因为它们都是同一种事件。
• Git 协作：通过 NIP-34 处理补丁、仓库公告和状态事件，并提供 Git 托管后端。
• 工作流：使用 YAML 工作流，支持 message、reaction、schedule 和 webhook 触发。
• 桌面端与 CLI：桌面应用基于 Tauri + React；buzz-cli 面向 Agent，采用 JSON 输入 / JSON 输出，并支持 ACP harness（Goose、Codex、Claude Code）。
• 媒体评论：可以在视频的特定帧上留下评论。

安装与使用

直接下载桌面版

从 latest release 下载对应安装包：

平台	文件
macOS（Apple Silicon）	Buzz_<version>_aarch64.dmg
macOS（Intel）	Buzz_<version>_x64.dmg
Linux（x86_64）	Buzz_<version>_amd64.AppImage 或 Buzz_<version>_amd64.deb
Windows（x64）	Buzz_<version>_x64-setup_alpha-unsigned.exe

默认连接 ws://localhost:3000。如需连接自己运行或他人分享的 relay，可在启动前设置 BUZZ_RELAY_URL，也可以在应用内切换 relay。

从源码运行

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

首次准备：

it clone https://github.com/block/buzz.git && cd buzz
. ./bin/activate-hermit
just setup && just build

日常启动：

. ./bin/activate-hermit
just dev

just dev 会同时启动 relay 和桌面应用；relay 运行在 ws://localhost:3000。如需拆分终端，可分别运行 just relay 和 just desktop-dev。

注意事项

• Windows 构建未进行代码签名，首次启动时 SmartScreen 可能提示「Windows protected your PC」；如出现，可点击 More info，再点击 Run anyway。
• Windows 上的 Agent shell 工具需要 bash，请安装 Git for Windows，它包含 Git Bash；也可以通过 BUZZ_SHELL 指定其他兼容 bash 的 shell。
• 默认连接本机 relay；如果还没有 relay，需要按源码运行步骤在本地启动一个。
• iOS 和 Android 的 Flutter 客户端仍在接入中。
• 项目使用 Apache-2.0 许可证。

---

本作品整理自 GitHub 开源项目 block/buzz，原作者 @block，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。