DeepTutor：来自港大的开源终身AI导师，2.7万星的个性化学习革命-无双技术网

你有没有想过——如果有一个AI，它不只是回答你一个问题，而是记住你学过的所有内容、了解你的知识盲区、能给你出题测验，还能像真正的导师一样引导你系统性地掌握一门学科？

今天要介绍的开源项目 DeepTutor，正是为了实现这个愿景而生。它由香港大学数据科学实验室（HKUDS）打造，目前已在 GitHub 上斩获 26,911 Star，成为 AI 教育领域最受关注的开源项目之一。

GitHub: HKUDS/DeepTutor | 官网: deeptutor.info | 论文: arXiv 2604.26962 | License: Apache 2.0

DeepTutor 是什么？

一句话概括：一个基于AI Agent的终身个性化学习系统。

与传统AI聊天工具不同，DeepTutor 不是一问一答的对话机器人。它是一个完整的学习工作台，将辅导对话、问题解答、测验生成、深度研究、知识可视化和掌握度练习整合在同一个可扩展系统中。所有学习功能共享同一个 Agent 引擎，学习上下文在不同功能之间无缝流转——就像有一个真正的私人家教，了解你的一切学习轨迹。

项目自2025年12月底上线以来，短短不到7个月就积累了2.7万Star，39天破万星，111天破2万星，堪称现象级增长。

八大核心功能模块

Home（主页）

默认的 Agent 对话界面，集成了工具调用、RAG 检索、文件附件和记忆功能。你可以直接拖入 PDF、DOCX、PPTX 等文档，AI 会在对话中结合文档内容回答你的问题。

Partners（伙伴）

这是 DeepTutor 最独特的创新之一。你可以创建拥有独立人格、知识库和记忆的 AI 伙伴，它们可以是你配置的学习助手、学科导师、写作伙伴，甚至能通过 15 种 IM 通道（Discord、微信、Telegram 等）与你持续对话。每个 Partner 拥有自己的私人记忆，不会与其他用户混淆。

My Agents（我的智能体）

连接你本地的 Claude Code 或 Codex Agent，在对话过程中实时调用它们的能力。你还能导入这些 Agent 的历史对话进行分析和学习。

Co-Writer（协同写作）

一个支持选区感知的 Markdown 编辑器，AI 可以基于你的知识库或网络搜索结果辅助写作。适合写论文、技术文档、学习笔记。

Book（交互式书本）

将知识库和笔记编译为「活的书」——不是静态 PDF，而是可以互动提问、自动更新的交互式学习材料。多文档协同编辑，支持 @ 提及知识库内容。

Learning Space（学习空间）

可复用的学习中枢，集中管理你的技能（Skills）、人格（Personas）、笔记本（Notebooks）和题库（Question Bank）。支持引导式学习（Guided Learning），AI 会按知识点类型设定掌握度门槛，只有达标才能进入下一阶段。

Memory（记忆系统）

DeepTutor 最硬核的技术特色之一：三层记忆架构。L1 是原始对话轨迹，L2 是表层摘要，L3 是深层语义合成。每一条记忆都可追溯其证据来源——你可以查看 AI 是基于哪段对话得出了对你的某个判断。这让个性化变得可审查、可编辑。

Knowledge Center（知识中心）

支持五种检索引擎：LlamaIndex、PageIndex、GraphRAG、LightRAG，还能直接链接 Obsidian 笔记库。知识库版本化管理，文档解析引擎可插拔。最近 v1.4.12 新增的 FAISS 向量后端让大规模知识库检索速度大幅提升。

技术架构亮点

Agent-native 架构：所有功能运行在同一个 Agent 循环上，切换功能模块只改变目标（objective），引擎不变，学习上下文持续保持
可扩展工具与技能系统：内置工具、MCP Server 集成、图片/视频/语音生成模型接入，支持从 EduHub 安装社区技能
多用户隔离：支持多用户部署，每人独立工作空间，PocketBase 会话按用户隔离
多引擎知识检索：LlamaIndex、PageIndex、GraphRAG、LightRAG 可混合使用，按知识库选择合适的检索管线
全平台部署：PyPI 一键安装、Docker 单容器部署、源码开发模式、纯 CLI 轻量模式四种安装路径
技术栈：Python 3.11+、FastAPI 后端、Next.js 前端、WebSocket 实时通信

快速上手

方式一：PyPI 安装（推荐新手）

最简路径，不需要 clone 仓库：

mkdir -p my-deeptutor && cd my-deeptutor
pip install -U deeptutor
deeptutor init   # 配置端口、LLM 提供商、API Key
deeptutor start  # 启动后端 + 前端

打开浏览器访问 http://127.0.0.1:3782 即可使用。

方式二：Docker 部署

docker run --rm --name deeptutor \
  -p 127.0.0.1:3782:3782 \
  -v deeptutor-data:/app/data \
  ghcr.io/hkuds/deeptutor:latest

数据和配置通过 Docker Volume 持久化，重启不丢失。只需要暴露 3782 端口，前端代理会自动转发 API 请求到内部后端。

方式三：源码开发模式

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
( cd web && npm ci --legacy-peer-deps )
deeptutor init && deeptutor start

适合二次开发或需要热重载前端的场景。