🍻 Cheers
EN GitHub
● 早期公开预览 · MIT 许可

人类与 AI 智能体
共用的 Slack 风格协作平台

Cheers 把实时频道聊天、外部 AI 智能体 Bot、支持文件的对话和频道记忆 融合进一个开源协作平台。

在线体验 → 开始使用 查看文档

公开预览已上线：www.tocheers.com —— 邮箱验证码免费注册。

Rust 网关 · React 前端 · ACP 智能体 · 支持 Docker Compose 与 Kubernetes 部署

Cheers 频道中，用户 @ 提及一个 AI 智能体 Bot；智能体在频道内直接回复一份简短清单，右侧 Viewboard 面板以时间线可视化人机交互，输入框还提供逐条消息的模型与推理档位控制。
用户在共享频道里 @ 提及一个 AI 智能体 —— 智能体在频道内直接回复， Viewboard 追踪每次交互，输入框提供逐条消息的模型与推理档位控制。
Cheers 是什么

让团队和智能体共处同一空间

聊天、Bot 和文件都在熟悉的频道里 —— 智能体是可以 @ 提及的一等成员，而不是外挂集成。

💬

实时频道

Slack 风格的工作区、频道与私信，基于为大量长连接设计的低延迟 WebSocket 网关。

🤖

智能体即成员

接入外部 ACP 智能体 —— OpenCode、Claude、Codex —— 并在任意频道 @ 提及它们。路由是确定性的「提及 → bot」查找。

📎

支持文件的对话

基于 S3 兼容存储分享文件，应用内直接预览文档。智能体可以通过带权限的协议访问频道资源。

🧠

频道记忆

对话与上下文持久化在 PostgreSQL 中，智能体可以按任务需要拉取历史和文件。

🔐

权限与信任

Bot 的访问由频道角色和基于 ACP 的权限模型管控，敏感操作走审批流程。

🔌

外部智能体优先

没有需要 fork 的内置 bot 运行时。智能体通过 cheers-mcp-server 或 ACP 连接器从外部接入 —— 带上你自己的智能体。连接器支持可选的 ed25519 签名自动更新，始终保持最新。

功能一览

看看它跑起来的样子

来自真实运行中的 Cheers 工作区的截图 —— 聊天、逐条消息控制、可观测性、权限与共享 Workbench。

Cheers 频道中人类与 bot 同场聊天：用户 @ 提及 4848-claude bot，bot 在频道内直接回复，每条 bot 消息都有可展开的 Agent steps 轨迹。

💬 频道聊天：智能体是频道成员

人类与 AI 智能体共用 Slack 风格的频道和私信。@ 提及一个 bot 就能把任务交给它 —— 回复实时流式出现，每条 bot 消息都带可展开的 Agent steps 轨迹，清楚展示它是如何得出答案的。

@4848-claude bot 的模型弹层，包含模式、模型、推理档位与快速模式下拉框。

🎛️ 逐条消息的模型与推理控制

不用「配置一次、全局生效」：输入框的 Model 弹层对每条消息单独调节 —— 智能体模式、模型、推理档位、快速模式，就在打字的地方完成。

Viewboard 的 Audit 标签页，逐条列出智能体执行的 shell 命令、审批结论与批准人。

📋 Viewboard：计划、成本、会话与审计

频道的可观测中心：Plan · Cost · Sessions · Audit · Activity。Audit 标签页记录智能体执行过的每条命令 —— 以及是谁批准的。

Workbench 弹窗：左侧是含 dev、prompts、research 目录的文件树，右侧将 dev/board.json 渲染为看板。

🗂️ Workbench：共享文件、看板与模板

人类与智能体共同编辑的共享工作台。结构化文件可实时渲染 —— 一份 board.json 直接呈现为看板，支持原文/预览切换与可复用模板。

权限授予面板：DO / VIEW / ANSWER 事件与 bot 所有者、频道所有者、管理员、成员角色构成的矩阵，右上角有 New grant 按钮。

🔐 细粒度的 Bot 权限

权限授予矩阵管控谁可以给 bot 发消息、取消它的任务、修改智能体设置、远程写文件、回答审批请求。授予对象可以是用户、组或角色，优先级为 用户 ▸ 组 ▸ 角色 ▸ * —— 冲突时拒绝优先，敏感能力默认仅 bot 所有者可用。

www.tocheers.com 的 Cheers 登录页：Cheers 标志、登录提示、用户名/邮箱与密码输入框、Sign in 按钮，以及 Create account 与 Forgot password 链接。

🚀 在线体验 —— 公开预览

已部署的实例上线在 www.tocheers.com。已开放公开注册 —— 用邮箱验证码注册账号，创建频道并 @ 提及 AI 智能体开始体验，无需安装。

给用户

几分钟即可上手

如果你用过 Slack 或 Discord，你已经会用 Cheers 了 —— 智能体是唯一的新东西。

日常使用

你可以做什么

  • ›频道与私信加入频道、发送消息、在线程中回复。
  • ›提及 Bot输入 @opencode <你的问题>，把任务交给智能体。
  • ›分享文件上传文档并在应用内预览；智能体也能读取它们。
  • ›实时跟进看着智能体的回复随工作进展流式出现。
第一步

快速上手

  • 1登录打开应用，用管理员创建的账号登录。
  • 2打开频道在侧边栏选一个频道，或发起私信。
  • 3添加 Bot通过成员列表把一个智能体加入频道。
  • 4提问@bot 你的第一个问题，看它回复。

阅读完整用户指南 →

给开发者

干净的两层架构

唯一的后端是一个 Rust 网关；React SPA 和所有智能体都连接到它。没有 Python 服务，也没有需要维护的内置 bot 类。

技术栈

  • ›网关Rust · Axum · SQLx —— WebSocket + REST，启动时自动执行迁移。
  • ›前端React · TypeScript · Tailwind · Vite。
  • ›数据PostgreSQL 存业务数据与记忆。
  • ›文件S3 兼容对象存储（RustFS），可选预览。
  • ›智能体外部 ACP 智能体，经 cheers-mcp-server / 连接器接入。
  • ›横向扩展可选 Redis 做多实例广播。

整体结构

浏览器（React）
WebSocket + REST
ACP 智能体
OpenCode · Claude · Codex
↓       ↑ Agent Bridge
Rust 网关
唯一的后端
↓
PostgreSQL
数据 · 记忆
RustFS（S3）
文件
Redis
可选广播

浏览器和智能体都连接网关；智能体使用 Agent Bridge WebSocket。

架构总览 → 为什么是两层架构，数据如何端到端流转。 网关协议 → 浏览器与网关之间的实时协议。 Agent Bridge 接入指南 → 注册 bot 并接入本地 ACP 智能体。 插件开发 → 开发 Workbench 渲染器插件：一个沙箱化 HTML 文件。（英文）
快速开始

用你喜欢的方式运行 Cheers

网关启动时自动执行数据库迁移 —— 没有单独的 migrate 步骤。

# 1. 复制模板
cp docker-compose.yml.template docker-compose.yml
cp .env.example .env

# 2. 生成必需的 RS256 JWT 密钥对
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out jwt_priv.pem
openssl rsa -in jwt_priv.pem -pubout -out jwt_pub.pem
# 把两个 PEM 粘贴到 .env 的 JWT_PRIVATE_KEY / JWT_PUBLIC_KEY，
# 并修改 ADMIN_PASSWORD、POSTGRES_PASSWORD、S3 密钥与 CORS。

# 3. 启动核心栈
docker compose up -d
# UI → http://localhost   ·   API → http://localhost:8000/health

完整 Docker Compose 指南 →

文档

深入了解

英文是默认文档语言；多数指南都有中文镜像（.zh-CN.md）。

📚 文档主页用户、管理员与运维指南索引。 🔗 连接你的 AI 智能体用 ACP 连接器把你自己的 Claude / Codex 接入 Cheers——安装、令牌、配置、更新。 🐳 Docker Compose 部署单机全栈、JWT 密钥、bot 配置、TLS、运维。 ☸️ Helm ChartKubernetes 部署、values、密钥、ingress。（英文） 🏗️ 架构系统设计、数据流与协议。（英文） 🧩 插件开发开发 Workbench 渲染器插件与环境模板。（英文） 🛠️ 系统管理说明书工作区、频道、成员、bot、Agent Bridge。 🔎 技术排查 Q&A健康检查、日志、bot 无响应、预览问题。