Buzz 源码拆解

真实链路，而非目录复述

从 WebSocket EVENT/REQ 进入 Relay，跟到事务提交、Redis 广播、本地 fan-out、权限复核和客户端状态更新。

协议与产品一起读

解释 Nostr Kind/Tag 如何承载频道、线程、DM、Agent、工作流、Huddle、Git 和 Push，而不是只罗列常量。

明确完成度

每个子系统区分已实现、部分实现和愿景，并记录源码与旧架构文档之间的漂移。

关注安全边界

多租户类型、社区级联合主键、读写双向权限门、Redis 非安全边界、配对密钥擦除与 Push 代际围栏。

关注“为什么”

分析 durable acceptance、提交后副作用、动态订阅、生成列搜索、S3 CAS、租约代际等选择背后的取舍。

可继续深挖

每章提供关键源码入口；源码地图按目标给出 30 分钟、半天和专题阅读路线。

一句话理解 Buzz

Buzz 不是“在聊天应用里加一个机器人”，而是把人、Agent、频道、项目、自动化和本地工具都放进同一套事件协议与权限模型中。Relay 是权威协调核心；Nostr 事件是跨客户端的公共语言；PostgreSQL 保存可查询事实；Redis 负责跨 pod 的低延迟协调；Desktop 同时承担 UI、密钥、本地 Git/媒体和 Agent 进程管理。

text

Human / Agent / CLI / Git client
              │
              │ Nostr WebSocket + HTTP + Git smart HTTP
              ▼
      ┌───────────────────┐
      │    Buzz Relay     │  ← tenant/auth/access/ingest/query
      └──────┬─────┬──────┘
             │     │
       durable     └──── low-latency coordination
             │                  │
             ▼                  ▼
        PostgreSQL            Redis
             │
             ├── event/channel/workflow/audit/push facts
             └── S3-compatible object storage for media and Git packs

先读哪几章

你的目标	推荐顺序
快速建立全局模型	产品定位 → 总体架构 → 总体评估
理解 Relay 核心	事件模型 → 认证 → 写入 → 读取
理解数据一致性	PostgreSQL → Redis → 运维与质量
理解 Agent 系统	ACP Harness → Agent Runtime → 工作流
理解扩展边界	Push → Git → Mesh

你的目标

推荐顺序

快速建立全局模型

产品定位 → 总体架构 → 总体评估

理解 Relay 核心

事件模型 → 认证 → 写入 → 读取

理解数据一致性

PostgreSQL → Redis → 运维与质量

理解 Agent 系统

ACP Harness → Agent Runtime → 工作流

理解扩展边界

Push → Git → Mesh