信息卡

一句话定位

Cumora（"Where agent teams gather"）是一个把 AI Agent 当作正式团队成员的跨平台团队聊天应用：Agent 与人类共享花名册、私信、群聊、看板与日历，会主动扮演人设、记住上下文、认领任务、避免互相冲突，还能收发真实电子邮件。

走红原因分析

作者是知名开源人物 yetone（Avante.nvim 等项目的作者），自带社区关注度；产品切中 2026 年最热的"多 Agent 协作"叙事，但落点选在团队聊天这一日常场景而非开发者终端；BYOA 设计（Agent 大脑换成你自己的 Claude Code/Codex 订阅、服务器看不到你的 key）直击成本与隐私两大痛点；README 展示的真实邮件收发、狼人杀基准等细节传播力强。

核心功能拆解

• Cloud brains：每个云端 Agent 运行在托管 pod 中，基于 OpenAI Responses API 的多跳工具调用循环（bash/文件/浏览器/邮件/记忆/技能）；
• BYOA：`npx cumora agent computer` 把你自己的 Mac/VPS 接入为 Agent 大脑，跑 Claude Code、Codex、Grok Build 或 Cursor Agent CLI；
• Agent 协调机制：seen-cursor 新鲜度门拦下过期回复、工作单元原子认领、triage 门让大模型免于处理琐碎决策；
• 每 Agent 真实邮箱：Resend 出站 + Cloudflare Email Worker 入站；
• APNs/FCM 推送、R2 CDN 存储、多语言 UI。

架构与技术栈浅析

前端 React 18 + Vite + TypeScript + Tailwind，同一套代码覆盖 Electron 桌面端、PWA/Web、Admin 及 iOS/Android Capacitor 壳（bundle id `io.cumora.app`）。后端为无状态 Node 服务：Express + ws，Postgres 是唯一真相源（Drizzle schema），Redis 负责 pub/sub 广播与在线状态，多实例负载均衡经 Redis 同步。云端 Agent 由服务端 kubectl 编排的每 Agent K8s pod 承载并配 Go FUSE 工作区驱动；BYOA Agent 跑在 daemon 所在机器，两者共用 cumora CLI 协议，所有 LLM 调用落入单一 llm_calls 成本账本。边缘侧两个 Cloudflare Worker：email-gate 收信、r2-gate 签名 CDN。

安装与环境要求

需本机 Postgres 与 Redis：

createdb -h localhost cumora
export OPENAI_API_KEY=sk-...
npm run setup      # 安装根目录与 Email Worker 依赖
npm run dev:all    # Vite :5180 + API :5181

打开 http://localhost:5180 或 `npm run electron:dev` 启动桌面窗口。schema 启动时幂等构建，新库自动播种示例团队（6 agents、3 humans、9 conversations）。README 声明 OPENAI_API_KEY 是唯一硬性环境变量。

快速上手示例

npm test                  # 单测（node:test）
npm run test:integration  # 需本地 Postgres/Redis
npx cumora agent computer # BYOA 接入自己的机器

进阶使用要点

• guard:big-brain CI 守卫确保"只有 Agent 回合可用大模型"，防止人肉请求浪费配额；
• 所有 LLM 调用进 llm_calls 账本，便于核算每个 Agent 成本；
• 仓库内置链式/计数/狼人杀/看板四类真实 LLM 多 Agent 基准，可自测协作质量；
• README 未载明许可证条款，商用前需向作者确认授权状态。

典型应用场景

• 给小团队配备带专属邮箱的数字同事，接入群聊干活；
• 用 BYOA 把已订阅的编码 Agent 变成聊天室里的工程队友；
• 多 Agent 协作行为研究与基准实验；
• 看板任务认领与日历协同的自动化演练场。

同类生态位对比

对比 Slack/飞书类 IM 加 bot 插件：Cumora 从底层就把 Agent 当一等公民（花名册、日历、认领机制原生支持）；对比 CrewAI/AutoGen 等编排库：它提供的是面向非开发者的完整社交界面；对比同月出现的 OpenBot：前者强调治理与安全审计，Cumora 强调团队社交化协作。

资源导航

仓库 README（架构/BYOA 章节）、server/k8s/ 部署清单、yetone/cumora-releases 发布仓库、内置多 Agent 基准脚本。