# AI Agent 企业级超级智能体平台

**Repository Path**: north-dream-testing/Super-Intelligent-Agent-Platform

## Basic Information

- **Project Name**: AI Agent 企业级超级智能体平台
- **Description**: 开源的**超级智能体编排平台**，通过协调子智能体、记忆系统和沙盒环境，配合可扩展的技能体系，能够自主完成从深度研究、数据分析到内容生成的各类复杂任务。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-25
- **Last Updated**: 2026-09-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🦌 鹿流 (DeerFlow) — 超级智能体平台

> **D**eep **E**xploration and **E**fficient **R**esearch **Flow**

[![Python](https://img.shields.io/badge/Python-3.12%2B-3776AB?logo=python&logoColor=white)](./backend/pyproject.toml)
[![Node.js](https://img.shields.io/badge/Node.js-22%2B-339933?logo=node.js&logoColor=white)](./Makefile)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![Version](https://img.shields.io/badge/Version-2.1.0--rc0-blue)](./frontend/package.json)

鹿流（DeerFlow）是一个开源的**超级智能体编排平台**，通过协调子智能体、记忆系统和沙盒环境，配合可扩展的技能体系，能够自主完成从深度研究、数据分析到内容生成的各类复杂任务。

---

## 目录

- [项目概述](#项目概述)
- [技术架构](#技术架构)
- [核心功能](#核心功能)
- [模块界面预览](#模块界面预览)
  - [产品首页](#产品首页)
  - [用户登录](#用户登录)
  - [智能对话工作区](#智能对话工作区)
  - [对话管理](#对话管理)
  - [定时任务](#定时任务)
  - [能力中心 — 插件](#能力中心--插件)
  - [能力中心 — 技能](#能力中心--技能)
  - [回收站](#回收站)
  - [系统设置](#系统设置)
  - [案例展示](#案例展示)
- [快速开始](#快速开始)
  - [环境要求](#环境要求)
  - [Docker 部署（推荐）](#docker-部署推荐)
  - [本地开发模式](#本地开发模式)
  - [混合部署模式](#混合部署模式)
- [配置说明](#配置说明)
  - [模型配置](#模型配置)
  - [环境变量](#环境变量)
  - [技能与工具](#技能与工具)
- [项目结构](#项目结构)
- [安全说明](#安全说明)
- [贡献指南](#贡献指南)
- [许可证](#许可证)

---

## 项目概述

鹿流 2.0 是从深度研究框架全面重构而来的超级智能体平台。与 1.x 版本完全不同，2.0 版本引入了全新的架构设计，具备以下核心能力：

| 能力维度 | 说明 |
|---------|------|
| **深度研究** | 自主搜索、收集和分析多源信息，生成结构化研究报告 |
| **智能编码** | 在沙盒环境中执行代码、管理文件、运行长期任务 |
| **内容生成** | 生成幻灯片、图片、视频、播客、网页等多种格式内容 |
| **任务编排** | 通过子智能体协作处理需要数分钟到数小时的复杂任务 |
| **定时调度** | 支持定时、单次、间隔三种调度模式的自动化任务 |
| **技能扩展** | 通过插件（MCP）和技能（Skill）文件无限扩展能力边界 |

---

## 技术架构

```
┌─────────────────────────────────────────────────────┐
│                    前端层 (Next.js 16)                │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐ │
│  │ 对话界面  │ │ 能力中心  │ │ 定时任务  │ │ 设置   │ │
│  └────┬─────┘ └────┬─────┘ └────┬─────┘ └───┬────┘ │
│       └─────────────┴────────────┴────────────┘      │
│                         │ API Rewrites (Proxy)       │
└─────────────────────────┼────────────────────────────┘
                          │
─────────────────────────┼────────────────────────────
│                    网关层 (FastAPI)                    │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐ │
│  │ 认证服务  │ │ Agent调度 │ │ 技能管理  │ │ 任务队列│ │
│  └────┬─────┘ └────┬─────┘ └────┬─────┘ └───┬────┘ │
│       └─────────────┴────────────────────────┘      │
│                         │                             │
│  ┌──────────────────────┴──────────────────────────┐ │
│  │              LangGraph 编排引擎                   │ │
│  │  ────────┐ ┌────────┐ ┌────────┐ ┌─────────┐ │ │
│  │  │Lead    │ │Research│ │Coder   │ │Planner  │ │ │
│  │  │Agent   │ │Agent   │ │Agent   │ │Agent    │ │ │
│  │  └────────┘ └────────┘ └────────┘ └─────────┘ │ │
│  └─────────────────────────────────────────────────┘ │
─────────────────────────┬────────────────────────────
                          │
┌─────────────────────────────────────────────────────┐
│                    基础设施层                           │
│  ┌──────────┐ ┌──────────┐ ┌──────────────────────┐ │
│  │  Redis   │ │ 沙盒环境  │ │ LLM Provider (API)   │ │
│  │ (消息队列)│ │ (Docker)  │ │ DeepSeek / OpenAI等  │ │
│  ──────────┘ └──────────┘ ──────────────────────┘ │
└─────────────────────────────────────────────────────┘
```

**技术栈概览：**

| 层级 | 技术选型 | 版本 |
|-----|---------|------|
| 前端框架 | Next.js (App Router) | 16.3.3 |
| 前端语言 | TypeScript + React | — |
| 后端框架 | FastAPI + LangGraph | Python 3.12+ |
| 认证系统 | Better Auth | — |
| 消息队列 | Redis | — |
| 沙盒环境 | Docker (AIO Sandbox) | — |
| 包管理 | pnpm (前端) / uv (后端) | 10.x / latest |

---

## 核心功能

### 智能体编排引擎

基于 LangGraph 构建的多智能体协作系统，包含 Lead Agent（主导智能体）、Research Agent（研究智能体）、Coder Agent（编码智能体）、Planner Agent（规划智能体）等多种角色，可根据任务类型自动调度和协作。

### 技能与工具系统

- **内置技能**：学术论文审阅、代码文档生成、数据分析可视化、咨询分析等
- **插件生态**：飞书/Lark、钉钉、企业微信、腾讯文档、Notion、GitHub、Jira 等
- **MCP 扩展**：支持通过 Model Context Protocol 接入任意第三方服务
- **自定义技能**：通过 `.skill` 文件定义专属工作流

### 沙盒执行环境

基于 Docker 的安全沙盒，支持命令执行、文件管理、长期任务运行，具备隔离性、安全性和持久化特性。

### 长期记忆系统

跨会话记忆能力，智能体可以记住用户偏好、历史上下文和项目信息，提供个性化的连续服务体验。

### 定时任务调度

支持三种调度模式：
- **重复执行**：按日/周/月等周期自动运行
- **单次执行**：在指定时间执行一次
- **间隔执行**：按固定时间间隔循环执行

---

## 模块界面预览

以下截图均来自项目实际运行界面（语言：简体中文）。

### 产品首页

星空主题的产品着陆页，展示平台核心定位与能力概览。

![产品首页](screenshots/01-landing-page.png)

> 首页包含产品标语、核心能力介绍、案例展示、技能系统介绍、沙盒环境说明等模块，并提供「2.0 启动」入口直接进入工作区。

### 用户登录

基于 Better Auth 的用户认证系统，支持邮箱密码登录与注册。

![用户登录](screenshots/02-login-page.png)

> 登录页提供邮箱/密码输入、保持登录选项、注册入口。首次部署需通过 `/setup` 页面创建管理员账号。

### 智能对话工作区

核心交互界面，支持自然语言输入与多种快捷操作模式。

![智能对话工作区](screenshots/03-workspace-chat.png)

> 工作区包含：左侧导航栏（新对话、对话、智能体、定时任务、能力中心、项目、回收站）、中央对话输入区（支持附件上传、语音输入、闪速模式）、底部快捷操作按钮（小惊喜、写作、研究、收集、学习、创建）、右上角模型选择器（支持 DeepSeek Chat 等多模型切换）。

### 对话管理

历史对话的浏览、搜索与管理界面。

![对话管理](screenshots/04-chat-list.png)

> 对话列表支持「近期会话」和「已归档」两个标签页切换，提供搜索框快速定位历史对话。

### 定时任务

可视化定时任务创建与管理界面。

![定时任务](screenshots/05-scheduled-tasks.png)

> 支持快速创建模板（GitHub Trending 日榜、每日科技新闻摘要、GitHub Issue 分诊、每周周报），可配置 Agent 类型、任务标题、提示词、调度模式（重复/单次/间隔）、执行时间和时区。底部提供任务搜索和多维度筛选（状态、类型）。

### 能力中心 — 插件

插件市场，提供办公协作、文档知识、搜索研究、业务数据、研发运维五大类别的集成插件。

![能力中心 - 插件](screenshots/06-capabilities.png)

> 已集成飞书/Lark、钉钉群通知、企业微信群通知、腾讯文档、Notion、OpenViking、网页搜索、网页读取、Exa、Firecrawl、SQL 数据库、HubSpot CRM、GitHub、Jira/Confluence、浏览器自动化等插件，支持一键安装或配置。

### 能力中心 — 技能

技能库管理界面，支持官方内置、社区、自定义技能的浏览与启用。

![能力中心 - 技能](screenshots/10-skills.png)

> 技能卡片展示技能名称、描述和启用状态。支持通过 `.skill` 文件安装自定义技能，或在线新建技能。内置技能包括学术论文审阅、bootstrap、chart-visualization、claude-to-deerflow、code-documentation、consulting-analysis 等。

### 回收站

已删除对话的暂存区域，支持恢复或永久删除。

![回收站](screenshots/07-trash.png)

> 回收站提供对话的二次确认删除机制，防止误操作导致数据丢失。

### 系统设置

用户偏好设置面板，涵盖账号、外观、通知、渠道、记忆、子智能体、关于等模块。

![系统设置](screenshots/08-settings.png)

> 设置面板左侧导航包含：账号管理、外观主题（系统/浅色/深色）、语言切换、通知配置、渠道集成、记忆管理、子智能体配置、关于信息。

### 案例展示

平台内置的案例库，展示各类实际应用场景。

![案例展示](screenshots/09-showcase.png)

> 案例页面展示完整的对话过程，包括智能体的思考步骤、文件生成（HTML/CSS 等）、To-do 列表管理，以及底部的持续对话输入区。

---

## 快速开始

### 环境要求

| 依赖项 | 最低版本 | 说明 |
|-------|---------|------|
| Docker Desktop | 20.10+ | 用于运行网关、Redis 和沙盒环境 |
| Node.js | 22+ | 前端开发与构建 |
| Python | 3.12+ | 后端服务 |
| pnpm | 10+ | 前端包管理 |
| Git | 2.30+ | 版本控制 |

### Docker 部署（推荐）

```bash
# 1. 克隆项目
git clone https://gitee.com/north-dream-testing/Super-Intelligent-Agent-Platform.git
cd deer-flow

# 2. 运行配置向导（交互式选择 LLM 提供商、搜索工具等）
make setup

# 3. 启动所有服务（网关 + Redis + 前端）
make up

# 4. 访问应用
# 打开浏览器访问 http://localhost:3000
# 首次访问需通过 http://localhost:3000/setup 创建管理员账号
```

### 本地开发模式

```bash
# 1. 启动后端服务
make backend

# 2. 启动前端开发服务器
cd frontend
pnpm install
pnpm dev

# 3. 访问 http://localhost:3000
```

### 混合部署模式

适用于开发调试场景，Docker 运行基础设施（网关 + Redis），本地运行前端：

```bash
# 1. Docker 启动网关和 Redis
docker compose up -d gateway redis

# 2. 本地启动前端（确保 .env 中 NEXT_PUBLIC_BACKEND_BASE_URL 为空）
cd frontend
pnpm install
pnpm dev
```

> **注意**：`NEXT_PUBLIC_BACKEND_BASE_URL` 必须保持为空，否则 Next.js 的 API 代理重写规则将失效，导致前端无法连接网关。

---

## 配置说明

### 模型配置

在 `config.yaml` 中配置 LLM 模型：

```yaml
models:
  - name: deepseek-chat
    display_name: DeepSeek Chat
    use: langchain_openai:ChatOpenAI
    model: deepseek-chat
    api_base: https://api.deepseek.com
    api_key: ${DEEPSEEK_API_KEY}

  - name: deepseek-reasoner
    display_name: DeepSeek Reasoner
    use: langchain_openai:ChatOpenAI
    model: deepseek-reasoner
    api_base: https://api.deepseek.com
    api_key: ${DEEPSEEK_API_KEY}
```

### 环境变量

核心环境变量配置在 `.env` 文件中：

| 变量名 | 说明 | 示例 |
|-------|------|------|
| `DEEPSEEK_API_KEY` | DeepSeek API 密钥 | `sk-xxxxxxxx` |
| `BETTER_AUTH_SECRET` | 认证加密密钥（生产环境必须修改） | `your-secret-key` |
| `DEER_FLOW_INTERNAL_AUTH_TOKEN` | 内部服务认证令牌 | `your-auth-token` |
| `NEXT_PUBLIC_BACKEND_BASE_URL` | 后端地址（留空使用 Next.js 代理） | *(留空)* |
| `APT_MIRROR` | APT 包镜像（中国用户） | `https://mirrors.aliyun.com` |
| `NPM_REGISTRY` | NPM 镜像（中国用户） | `https://registry.npmmirror.com` |

### 技能与工具

工具配置在 `config.yaml` 的 `tools` 部分：

```yaml
tools:
  web_search:
    provider: ddg          # DuckDuckGo 搜索
  web_fetch:
    provider: jina         # Jina 网页读取
  image_search:
    enabled: true          # 图片搜索
```

沙盒配置：

```yaml
sandbox:
  provider: local          # 本地 Docker 沙盒
  allow_host_bash: true    # 允许宿主机 Bash 执行
```

---

## 项目结构

```
deer-flow/
├── backend/                # Python 后端服务
│   ├── src/                # 核心源代码
│   │   ├── agents/         # 智能体定义（Lead/Research/Coder/Planner）
│   │   ├── skills/         # 技能实现
│   │   ├── tools/          # 工具实现（搜索/读取/沙盒）
│   │   └── server/         # FastAPI 服务
│   ├── tests/              # 后端测试
│   └── pyproject.toml      # Python 项目配置
├── frontend/               # Next.js 前端应用
│   ├── src/
│   │   ├── app/            # App Router 页面
│   │   │   ├── workspace/  # 工作区页面（对话/定时任务/能力中心）
│   │   │   └── showcase/   # 案例展示页面
│   │   ├── core/           # 核心模块（认证/配置/国际化）
│   │   └── components/     # React 组件
│   ├── public/             # 静态资源
│   └── next.config.js      # Next.js 配置（含 API 代理重写）
├── skills/                 # 技能文件目录
├── docker/                 # Docker 编排文件
├── config.yaml             # 应用主配置文件
├── config.example.yaml     # 配置模板
├── Makefile                # 构建与运行命令
└── docs/                   # 项目文档
```

---

## 安全说明

### 部署安全

- **认证密钥**：生产环境必须修改 `BETTER_AUTH_SECRET` 为强随机字符串
- **内部令牌**：`DEER_FLOW_INTERNAL_AUTH_TOKEN` 应使用足够长度的随机值
- **沙盒隔离**：建议启用 Docker 沙盒模式，避免在宿主机直接执行代码
- **网络隔离**：网关服务默认绑定 `127.0.0.1`，外网访问需配置反向代理

### 建议措施

1. 不要在版本控制中提交 `.env` 文件
2. 生产环境使用 HTTPS 反向代理（如 Nginx + Let's Encrypt）
3. 定期更新依赖以修复安全漏洞
4. 沙盒环境中限制网络访问范围