LobeHub 项目介绍

LobeHub 项目介绍

项目定位

LobeHub 是一个以 Agent 为工作单元的企业级 AI Agent 工作空间，提供 Agent 的创建、编排、调度、记忆管理和多模型集成能力。

它让 Agent 像团队成员一样 7×24 小时工作——你负责决策，它们负责执行。

核心能力

• Operator（运营管理）：以 Agent 为工作单元，统一管理、调度和监控所有 AI Agent，支持定时任务和异步执行
• Create（Agent 构建）：内置 Agent Builder，通过自然语言描述自动生成 Agent 配置，支持 10,000+ Skills 和 MCP 插件
• Collaborate（协作编排）：Agent Groups 多 Agent 协作，Pages 共享上下文协同编辑，Projects 结构化跟踪工作
• Evolve（持续进化）：个人记忆系统，包含 5 层分层记忆提取（活动、上下文、经验、身份、偏好），Agent 从交互中持续学习
• 多模型集成：支持 35+ 模型提供商（OpenAI、Anthropic、Google、Bedrock 等），统一路由与故障回退
• IM 网关：集成微信、飞书、Line、QQ、Discord、Slack、Telegram 等多种即时通讯平台

技术栈

层级	技术
前端	Next.js 16 + React 19 + TypeScript，SPA 模式使用 Vite + React Router
UI 组件	Ant Design 6 + @lobehub/ui，CSS-in-JS 零运行时样式
状态管理	Zustand + SWR（数据获取）+ tRPC（类型安全 API）
后端	Next.js App Router + tRPC Server + Hono
数据库	PostgreSQL + Drizzle ORM
缓存	Redis（ioredis）用于状态管理和事件流
测试	Vitest（单元测试）+ Playwright + Cucumber（E2E）
国际化	react-i18next + 自动化 i18n 工作流
包管理	pnpm workspaces monorepo

架构概览

快速体验

方式一：在线体验

访问 app.lobehub.com 直接使用。

方式二：Vercel 一键部署

点击 Vercel 部署按钮，填写 OPENAI_API_KEY 环境变量即可。

方式三：本地开发

git clone https://github.com/lobehub/lobehub.git
cd lobehub
pnpm install
bun run dev          # 全栈开发模式（Next.js + Vite SPA）
bun run dev:spa      # 仅前端开发模式（端口 9876）

教程导读

本教程分为 AI 应用通用知识 和 编程核心技术 两部分：

AI 应用通用知识（ai/ 目录）

从 LobeHub 的源码实现出发，抽象 Agent 架构的通用知识。每个知识点先通过 common/ 目录学习通用原理，再聚焦 LobeHub 的具体实现方案。

覆盖内容：

• GraphAgent 图驱动的执行循环与回溯策略
• 多层人工干预安全网关设计
• Gatekeeper 模式的 5 层分层记忆提取
• 异构 Agent 集成（Claude Code/Codex）
• Supervisor/Executor 多 Agent 编排模式
• 即时通讯网关适配器架构

编程核心技术（dev/ 目录）

聚焦 LobeHub 的工程实践和架构决策，包括 monorepo 组织、SPA+SSR 双模式、Drizzle ORM 数据建模、tRPC 类型安全 API、测试策略等。