block/buzz-app

项目介绍

Buzz 是一个面向团队聊天的桌面应用，同时能在用户自己的电脑上运行 AI 代理。用户可以加入社区，在频道和私信中交流，并把 Claude、Codex、Goose 或 Pi 这类代理拉进对话直接答复。它适合希望在一个客户端里同时获得聊天和具备编码能力代理、又不想自建代理基础设施的团队。

身份是一个保存在系统安全存储（如 macOS 钥匙串）中的私钥，社区通过邀请链接或社区地址加入。代理隶属于某个社区，并在 Buzz 打开时于本机执行，默认工作目录是 ~/.buzz，可以在其中运行命令和编辑文件。

快速使用

1. 从发布页下载对应平台的构建。macOS 版本已签名并公证；Windows 安装包未签名，运行时会出现 SmartScreen 警告；Linux 提供在 Ubuntu 24.04 上构建的 .deb 或 AppImage。安装后 Buzz 会自动更新。
2. 首次启动时，可以新建身份、一键沿用 Buzz 0.X 的现有身份，或粘贴已有的 nsec1… 私钥。随后立即通过 Settings → Identity → Copy private key 复制并保存私钥，Buzz 不会代为备份。
3. 加入社区：打开邀请链接并选择 Accept invite in Buzz，或在 Join a community 页面粘贴链接或社区地址。没有邀请时，可使用公开的反馈社区邀请，也可以在 buzz.xyz 创建社区，或从 block/buzz 自建 relay。
4. 在应用坞打开 Agents，点击 Create your first agent，填写名称、选择 Harness，可选设置模型和指令后创建。不同 Harness 的要求不同：Claude 和 Codex 仅支持 macOS/Linux，需要登录并下载集成（分别约 250 MB 和 130 MB）；Goose 随应用附带，需要填写模型提供商的密钥；Pi 三平台可用，但需要 Node.js 22.19 以上并先在设置中启用 Pi 插件。
5. 通过 + → New chat 发起聊天，或从代理资料页发消息，也可在频道中 @ 代理。若代理尚未加入频道，Buzz 会提示邀请。
6. 如需使用命令行，可把内置 CLI 链接到 PATH：

mkdir -p ~/.local/bin
ln -sf /Applications/Buzz.app/Contents/Resources/bin/buzz ~/.local/bin/buzz

使用约束

• Buzz 1.0 处于 beta：构建直接来自 main，没有稳定发布通道，更新可能破坏插件。
• macOS Intel、Windows 和 Linux 的测试程度低于 Apple Silicon macOS。Claude 和 Codex 代理仅支持 macOS/Linux；Goose 和 Pi 全平台可用。
• 私钥没有备份，丢失后无法在其他机器上恢复身份。
• 从 Buzz 0.X 迁移身份不会带走社区和代理，需要重新加入社区并手动导入代理。
• 插件 API 属于预览：manifest、命令、网络与文件访问、代理工具和快捷键相对稳定，而 relay 数据读取、向会话或侧栏添加内容、代理钩子以及宿主页面 UI 容易随更新失效。
• 从源码构建需要 bin/ 中由 Hermit 固定的工具链和 Tauri 桌面端前置依赖，桌面构建入口为 bin/just desktop。

HotRepo 点评

仓库目前只有一条榜单记录：2026-11-12 的 TypeScript 日榜显示 205 星、当日新增 50 星、最好名次第 8，没有记录到全语言日榜名次。单日数据不足以构成趋势，只能说明项目在 beta 阶段获得过一次集中关注。对采用者而言，更实际的风险来自上面的 beta 约束：Windows 构建未签名、只有 main 一条构建通道、插件 API 仍属预览。