项目简介

受众： 新用户、技术评估者、开源贡献者
前提： 无
目标： 理解 CocoCat 是什么、为什么存在、整体架构

仓库地址： https://github.com/liyifu-2026/CocoCat

什么是 CocoCat？

CocoCat 是一个多智能体 AI 协作平台。多个 AI 代理（Agent）以虚拟团队的形式协同工作，各自承担不同的角色（客服、编程、写作、数据分析等），通过统一的消息总线进行通信和协作。

核心理念

• Agent 即角色：每个 Agent 有独立的身份、记忆、技能和 LLM 配置，像一个虚拟员工
• 场景驱动：Scene 定义 Agent 之间的交互流程，类似剧本
• 渠道无关：同一套 Agent 团队可通过微信、飞书、Discord、Web API 等渠道与用户交互
• 安全可控：命令沙箱、文件权限控制、JWT 认证层层防护

系统架构

┌─────────────────────────────────────────────┐
│              用户交互渠道                      │
│   微信 / 飞书 / Discord / Web UI / API        │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│          FastAPI 应用层 (Python)              │
│    REST API / WebSocket / 认证中间件          │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│          Agent 运行时 (Python)                │
│    ReAct Loop + LLM 调用 + 工具执行            │
│    记忆系统 + 知识库 + 场景调度                 │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│          沙箱执行环境                          │
│    本地进程 / CubeSandbox MicroVM             │
└─────────────────────────────────────────────┘

技术栈

层级	技术
Web 后端	FastAPI (Python 3.10+)
Agent 运行时	Python (ReAct Loop)
Web 前端	React + Vite + TypeScript
数据库	SQLite (WAL 模式) + 文件系统
LLM 接口	OpenAI 兼容 API (DeepSeek / GPT / Claude 等 30+ 提供商)
沙箱	本地执行 或 CubeSandbox (KVM MicroVM)

核心能力

• DAG 任务编排：主 AI 将复杂任务分解为有向无环图，子 Agent 并行执行
• 记忆系统：自动从对话中提取关键信息，支持全文搜索 (FTS5)
• 知识库：LLM 驱动的文档摄入 → 结构化 Wiki 页面，支持交叉引用和去重
• 多频道：微信、飞书、Discord、Telegram、Web API 统一接入
• 沙箱安全：路径白名单、命令校验、可选的 MicroVM 隔离