DeepTutor

 

DeepTutor: 终身个性化辅导

   

                   

功能特性 · 快速开始 · 探索 · CLI · 生态系统 · 社区

---

🤝 欢迎各种形式的贡献！ 请前往路线图对路线图项目投票或提出新建议，并参阅我们的贡献指南了解分支策略、编码标准以及如何开始。

📦 发布说明

[2026.7.9] v1.5.1 — 从知识库中删除单个失败的文档——即使该文档处于错误状态——而无需删除并重建整个知识库。

[2026.7.4] v1.5.0 — LlamaIndex 摄取现在遵循你的文档解析引擎，支持多模态图像提取；Partner 和 Soul ID 在非拉丁字符名称下保持 URL 安全；可选的 RAG 附加组件在 Python 3.14+ 上可以干净安装。

过往发布（1 周以上前）

[2026.6.30] v1.4.15 — 为 Partners 新增原生 Mattermost 频道，修复了引导式学习多项选择题评分问题，并确保配置的零 chunk 重叠得以尊重。

[2026.6.29] v1.4.14 — 一键点击已分配的 partner 即可聊天；Deep Research 标记部分报告；LightRAG 索引无需 MinerU；FAISS 处理非 ASCII 路径；PocketBase 会话按用户隔离。

[2026.6.27] v1.4.13 — Partners 支持非拉丁字符名称并可分配给用户；登录后 logo 正确渲染（#599）；小型知识库可靠检索；容器在 rootless Podman 下干净启动。

[2026.6.24] v1.4.12 — 新增 LightRAG Server 检索引擎、轻量级 PyMuPDF4LLM 解析引擎，以及一个 FAISS 向量后端，大幅提升大型知识库检索速度。

[2026.6.23] v1.4.11 — 所有云 OpenAI 兼容提供商的原生工具调用；重新设计的后台用户管理页面；测验选项中的 LaTeX 支持；诚实的会话加载旋转动画；可配置的容器主机绑定。

[2026.6.21] v1.4.10 — 自助 Profile 页面，支持头像；无 root 权限的容器指南，带单端口请求时代理；非管理员用户默认拒绝 MCP 工具。

[2026.6.19] v1.4.9 — 设置优化：搜索仅显示提供商需要的字段；连接配置文件可重命名并按提供商自动命名；评分后的 Mastery Path 题目流入题目库。

[2026.6.18] v1.4.8 — 在 My Agents 下连接你自己的 Partners，并在聊天中实时咨询它们——它们通过自己的角色、库和技能来回答——每个 Partner 都拥有自己的私有记忆。

[2026.6.18] v1.4.7 — 连接你本地的 Claude Code / Codex，并在对话中间进行实时咨询；My Agents 升级为顶级 /agents 页面；Partner 对话支持分支/继续/删除，并提供可回放的操作轨迹。

[2026.6.17] v1.4.6 — 四个界面整合：Space 学习仪表板（可导入的 My Agents 和顶级 Memory）；Knowledge Center（包含 GraphRAG / PageIndex / LightRAG / 关联 KB / Obsidian）；开放设置的 Settings；以及按模型能力门控。

[2026.6.14] v1.4.5 — 引导式学习基于聊天 agent 循环重构，引入硬性按类型掌握门控和 /learning 仪表板；新的循环插件框架；以及 Partner 对话的 Markdown 导出/保存到笔记本功能。

[2026.6.13] v1.4.4 — 通过安全门控，使用 deeptutor skill install 从 ClawHub 安装社区技能；知识库文件支持真实的浏览器内 DOCX/XLSX 预览。

[2026.6.12] v1.4.3 — TutorBot 演变为 Partners，基于生产级 IM 管道（15 个频道、实时流式传输）；Chat 迁移到单一 agent 循环；实现真正的按用户隔离；Visualize 界面重构。

[2026.5.28] v1.4.2 — 稳定性 + 打磨：Gemini 2.5+ 在 Visualize 和 Chat 中无障碍使用；认证路由修复（#485）；流畅的流式聊天体验；侧边栏最近会话；Lemonade 本地提供商支持。

[2026.5.27] v1.4.1 — 安全 + 稳定性：TutorBot 工具沙箱加固；按用户资源隔离；多模态图像回退；TutorBots 的 HTTP/SSE API；以及 v1.4.0 聊天回归修复。

[2026.5.22] v1.4.0 — v1.4 GA 版本：Auto Mode、三层 Memory、agentic Deep Research / Solve / Question、LlamaIndex RAG 重构、Visualize/Animator 合并、重启安全的回合运行时。

[2026.5.21] v1.4.0-beta — 三层 Memory 工作台（L1/L2/L3）；所有聊天功能基于单一 agent 引擎重构；仅 LlamaIndex RAG；统一的 Settings + Capabilities 界面。

[2026.5.10] v1.3.10 — 远程 Docker CORS 恢复；所有 SDK 提供商支持 DISABLE_SSL_VERIFY；更安全的代码块引用；可选的 Matrix E2EE 附加组件。

[2026.5.9] v1.3.9 — TutorBot Zulip 和 NVIDIA NIM 支持；更安全的思考模型路由；deeptutor start；侧边栏工具提示；会话存储一致性。

[2026.5.8] v1.3.8 — 可选的多用户部署，支持隔离的用户工作区、管理员授权、认证路由、限定范围的运行时访问。

[2026.5.4] v1.3.7 — 思考模型/提供商修复；可见的知识索引历史；更安全的 Co-Writer 清除/模板编辑。

[2026.5.3] v1.3.6 — 基于目录的聊天和 TutorBot 模型选择；更安全的 RAG 重新索引；OpenAI Responses token 限制修复；技能编辑器验证。

[2026.5.2] v1.3.5 — 更流畅的本地启动设置；更安全的 RAG 查询；更干净的本地 embedding 认证；Settings 暗色模式打磨。

[2026.5.1] v1.3.4 — 书籍页面聊天持久化和重建流程；聊天到书籍引用；更强的语言/推理处理；RAG 文档提取加固。

[2026.4.30] v1.3.3 — NVIDIA NIM + Gemini embedding 支持；统一的 Space 上下文（聊天历史/技能/记忆）；会话快照；RAG 重新索引弹性。

[2026.4.29] v1.3.2 — 透明的 embedding 端点 URL；针对无效持久化向量的 RAG 重新索引弹性；思考模型输出的内存清理；Deep Solve 运行时修复。

[2026.4.28] v1.3.1 — 稳定性：更安全的 RAG 路由和 embedding 验证；Docker 持久化；IME 安全的输入；Windows/GBK 鲁棒性。

[2026.4.27] v1.3.0 — 带版本号的知识库索引与重新索引工作流；重建的知识工作区；带新适配器的 embedding 自动发现；Space 中心。

[2026.4.25] v1.2.5 — 持久的聊天附件，带文件预览抽屉；附件感知的能力管道；TutorBot Markdown 导出。

[2026.4.25] v1.2.4 — 文本/代码/SVG 附件；一键 Setup Tour；Markdown 聊天导出；紧凑的知识库管理 UI。

[2026.4.24] v1.2.3 — 文档附件（PDF/DOCX/XLSX/PPTX）；推理思考块显示；Soul 模板编辑器；Co-Writer 保存到笔记本。

[2026.4.22] v1.2.2 — 用户自主编辑的技能系统；聊天输入性能大修；TutorBot 自动启动；书库 UI；可视化全屏。

[2026.4.21] v1.2.1 — 分阶段 token 限制；所有入口点的重新生成响应；RAG 和 Gemma 兼容性修复。

[2026.4.20] v1.2.0 — Book Engine "活书"编译器；多文档 Co-Writer；交互式 HTML 可视化；题目库 @-提及。

[2026.4.18] v1.1.2 — 模式驱动的 Channels 标签页；RAG 单管道整合；外部化的聊天提示。

[2026.4.17] v1.1.1 — 通用 "立即回答"；Co-Writer 滚动同步；统一设置面板；流式传输停止按钮。

[2026.4.15] v1.1.0 — LaTeX 块级数学大修；LLM 诊断探测；Docker + 本地 LLM 指南。

[2026.4.14] v1.1.0-beta — 可书签化的会话；Snow 主题；WebSocket 心跳和自动重连；embedding 注册表大修。

[2026.4.13] v1.0.3 — 带书签与分类的题目笔记本；Visualize 中的 Mermaid 图表；embedding 不匹配检测；Qwen/vLLM 兼容性；LM Studio 和 llama.cpp 支持；Glass 主题。

[2026.4.11] v1.0.2 — 搜索整合，带 SearXNG 回退；提供商切换修复；前端资源泄露修复。

[2026.4.10] v1.0.1 — Visualize 能力（Chart.js/SVG）；测验重复预防；o4-mini 模型支持。

[2026.4.10] v1.0.0-beta.4 — Embedding 进度跟踪，带速率限制重试；跨平台依赖修复；MIME 验证修复。

[2026.4.8] v1.0.0-beta.3 — 原生 OpenAI/Anthropic SDK（去除 litellm）；Windows Math Animator 支持；鲁棒的 JSON 解析；完整中文国际化。

[2026.4.7] v1.0.0-beta.2 — 热重载设置；MinerU 嵌套输出；WebSocket 修复；最低 Python 3.11+。

[2026.4.4] v1.0.0-beta.1 — Agent 原生架构重写（约 20 万行）：工具 + 能力插件模型、CLI 和 SDK、TutorBot、Co-Writer、引导式学习、持久化 Memory。

[2026.1.23] v0.6.0 — 会话持久化、增量文档上传、灵活的 RAG 管道导入、完整中文本地化。

[2026.1.18] v0.5.2 — Docling 支持 RAG-Anything、日志系统优化、Bug 修复。

[2026.1.15] v0.5.0 — 统一服务配置、每个知识库可选 RAG 管道、题目生成重构、侧边栏自定义。

[2026.1.9] v0.4.0 — 多提供商 LLM 和 embedding 支持、新的首页、RAG 模块解耦、环境变量重构。

[2026.1.5] v0.3.0 — 统一 PromptManager 架构、GitHub Actions CI/CD、GHCR 上的预构建 Docker 镜像。

[2026.1.2] v0.2.0 — Docker 部署、Next.js 16 和 React 19 升级、WebSocket 安全加固、关键漏洞修复。

📰 新闻

• 2026-05-22 🌐 官方文档网站上线：deeptutor.info —— 指南、参考和能力导览一站式获取。
• 2026-04-19 🎉 111 天内达到 20k 星！感谢大家对真正个性化、智能化辅导的支持。
• 2026-04-10 📄 我们的论文已在 arXiv 发布——阅读预印本了解 DeepTutor 的设计和理念。
• 2026-02-06 🚀 仅 39 天达到 10k 星！非常感谢我们不可思议的社区。
• 2026-01-01 🎊 新年快乐！加入我们的 Discord、微信或 Discussions —— 让我们一起塑造 DeepTutor。
• 2025-12-29 🎓 DeepTutor 正式发布！

✨ 关键特性

DeepTutor 是一个 agent 原生的学习工作空间，将辅导、问题求解、测验生成、研究、可视化和掌握练习整合在一个可扩展的系统中。

• 单一运行时覆盖所有模式 —— 聊天、测验、研究、可视化、求解和掌握路径都在同一个 agent 循环上运行，因此你只需切换目标，而非引擎，上下文随学习者移动。
• 连接的学习上下文 —— 知识库、书籍、Co-Writer 草稿、笔记本、题目库、角色和记忆在所有工作流中保持可用，而非孤立在各自工具中。
• 子代理和 Partners —— 在任何回合中咨询实时的 Claude Code、Codex 或 Partner（或导入它们的过往对话），并在同一大脑上运行持久的 IM 伴侣。
• 多引擎知识 —— 跨 LlamaIndex、PageIndex、GraphRAG、LightRAG 或链接的 Obsidian 库的版本化 RAG 库，带可插拔的文档解析。
• 可扩展的工具和技能 —— 内置工具、MCP 服务器、图像/视频/语音生成模型，以及来自 EduHub 的可安装社区技能。
• 可检查的记忆 —— L1 轨迹、L2 表面摘要和 L3 综合使得个性化可见且可编辑，并带有记忆图，每项主张都可追溯到其证据。

---

🚀 快速开始

DeepTutor 提供四种安装路径。它们都共享同一个工作空间布局：设置文件存放在启动目录下的 data/user/settings/ 中（如果显式设置了 DEEPTUTOR_HOME 或 deeptutor start --home，则在该目录下）。对于完整应用，推荐流程是 选择一个工作空间目录 → 安装 → deeptutor init → deeptutor start。

方案 1 — 通过 PyPI 安装 · 完整的本地 Web 应用 + CLI，无需克隆仓库

完整的本地 Web 应用 + CLI，无需克隆仓库。需要 Python 3.11+ 以及 PATH 上的 Node.js 20+ 运行时（deeptutor start 会启动打包的 Next.js 独立服务器）。

mkdir -p my-deeptutor && cd my-deeptutor
pip install -U deeptutor
deeptutor init     # 提示输入端口、LLM provider（LLM 提供商）和可选的 embedding 提供商
deeptutor start    # 启动后端 + 前端；保持终端打开

deeptutor init 会提示输入后端端口（默认 8001）、前端端口（默认 3782）、LLM 提供商 / Base URL / API key / 模型，以及可选的用于知识库 / RAG 的 embedding 提供商。

deeptutor start 后，打开终端打印的前端 URL —— 默认是 http://127.0.0.1:3782。在该终端中按 Ctrl+C 停止后端和前端。跳过 deeptutor init 也可以快速试用；应用会使用默认端口和空模型设置启动，之后可以在 Settings → Models 中配置。

方案 2 — 从源码安装 · 基于签出版本进行开发

用于基于签出版本的开发。使用 Python 3.11+ 和 Node.js 22 LTS 以匹配 CI 和 Docker。

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

# 创建虚拟环境 (macOS/Linux)。Windows PowerShell:
#   py -3.11 -m venv .venv ; .\.venv\Scripts\Activate.ps1
python3 -m venv .venv && source .venv/bin/activate
python -m pip install --upgrade pip

# 安装后端 + 前端依赖
python -m pip install -e .
( cd web && npm ci --legacy-peer-deps )

deeptutor init
deeptutor start

源码安装会在开发模式下针对本地 web/ 目录运行 Next.js；其他所有内容（配置布局、端口、用 Ctrl+C 停止）与方案 1 相同。

Conda 环境（代替 venv）

conda create -n deeptutor python=3.11
conda activate deeptutor
python -m pip install --upgrade pip

可选安装附加组件 —— dev / partners / matrix / math-animator

pip install -e ".[dev]"             # 测试/代码检查工具
pip install -e ".[partners]"        # Partner