HKUDS/DeepTutor 源码：https://github.com/HKUDS/DeepTutor # DeepTutor：终身个性化辅导系统 Python 3.11+ (https://www.python.org/downloads/) Next.js 16 (https://nextjs.org/) 许可协议 GitHub 发布页 (https://github.com/HKUDS/DeepTutor/releases) arXiv (https://arxiv.org/abs/2604.26962) Discord (https://discord.gg/eRsjPgMU4t) 飞书 微信 (https://github.com/HKUDS/DeepTutor/issues/78) 功能特性 · 快速开始 · 探索 · CLI · 生态系统 · 社区 — > 🤝 欢迎各种形式的贡献！ 在 路线图 (https://github.com/HKUDS/DeepTutor/issues/498) 上投票或提议新项目，并参阅我们的贡献指南了解分支策略、编码规范及如何上手。 ### 📦 版本发布 > [2026.7.9] v1.5.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.5.1) — 可从知识库中删除单个失败文档（即使处于错误状态），而无需删除并重建整个库。 > [2026.7.4] v1.5.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.5.0) — LlamaIndex 数据摄入现在遵循您的文档解析引擎，支持多模态图像提取；Partner 与 Soul ID 在非拉丁名称下保持 URL 安全；可选的 RAG 附加组件可干净安装于 Python 3.14+。 历史版本（超过1周） > [2026.6.30] v1.4.15 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.15) — 为 Partner 提供原生 Mattermost 频道，修复了引导学习中多项选择题评分及配置零分块重叠未被正确应用的问题。 > [2026.6.29] v1.4.14 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.14) — 点击已分配 Partner 即可一步进入聊天；深度研究标记部分报告；LightRAG 无需 MinerU 即可索引；FAISS 处理非 ASCII 路径；PocketBase 会话按用户隔离。 > [2026.6.27] v1.4.13 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.13) — Partner 支持非拉丁名称并可分配给用户；登录后渲染 Logo (#599)；小型知识库可靠检索；容器在无根 Podman 下干净启动。 > [2026.6.24] v1.4.12 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.12) — 新增 LightRAG Server 检索引擎、轻量级 PyMuPDF4LLM 解析引擎，以及 FAISS 向量后端，大幅提升大型知识库检索速度。 > [2026.6.23] v1.4.11 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.11) — 在所有云端 OpenAI 兼容提供商上支持原生工具调用；重新设计的管理员用户页面；测验选项支持 LaTeX；诚实的会话加载旋转器；可配置的容器主机绑定。 > [2026.6.21] v1.4.10 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.10) — 自助 Profile 页面（含头像）；无根容器指南（单端口请求时代理）；默认禁止非管理员用户使用 MCP 工具。 > [2026.6.19] v1.4.9 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.9) — 设置优化：搜索仅显示您的提供商所需的字段；连接配置文件可重命名并按提供商自动命名；评分过的掌握路径问题流入您的题库。 > [2026.6.18] v1.4.8 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.8) — 在 我的代理 下连接您自己的 Partner，并在聊天中实时咨询——通过其自身的人设、知识库和技能回答——每个 Partner 获得独立的私有记忆。 > [2026.6.18] v1.4.7 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.7) — 连接您本地的 Claude Code / Codex 并在对话中实时咨询；我的代理 升级为顶层 /agents；Partner 对话支持分支/恢复/删除，并带有可重放轨迹。 > [2026.6.17] v1.4.6 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.6) — 四大面板整合：Space 学习仪表板（可导入 我的代理 及顶层记忆）；知识中心（支持 GraphRAG / PageIndex / LightRAG / 链接知识库 / Obsidian）；开放设置；按模型能力门控。 > [2026.6.14] v1.4.5 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.5) — 引导学习基于聊天代理循环重构，增加严格的逐类型掌握门控及 /learning 仪表板；新的循环插件框架；Partner 对话支持 Markdown 导出/保存到笔记本。 > [2026.6.13] v1.4.4 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.4) — 通过 deeptutor skill install 从 ClawHub (https://clawhub.ai/) 安装社区技能（带有安全门控）；知识库文件支持浏览器内 DOCX/XLSX 实时预览。 > [2026.6.12] v1.4.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.3) — TutorBot 升级为 Partner，运行于生产级 IM 管道（15 个频道、直播流）；聊天移至单一代理循环；真正的按用户隔离；重建的 Visualize。 > [2026.5.28] v1.4.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.2) — 稳定性与优化：Visualize 和 Chat 中解除 Gemini 2.5+ 阻塞；认证路由修复 (#485)；流畅流式聊天体验；最近会话侧边栏；Lemonade 本地提供商支持。 > [2026.5.27] v1.4.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.1) — 安全与稳定性：TutorBot 工具沙箱锁定；按用户资源隔离；多模态图像回退；TutorBot 的 HTTP/SSE API；修复 v1.4.0 聊天回归问题。 > [2026.5.22] v1.4.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.0) — v1.4 GA：自动模式；三层记忆；代理驱动的深度研究/解题/问答；LlamaIndex RAG 重构；Visualize/Animator 合并；重启安全的对话运行时。 > [2026.5.21] v1.4.0-beta (https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.0-beta) — 三层记忆工作台（L1/L2/L3）；所有聊天能力基于单一代理引擎重构；仅 LlamaIndex RAG；统一的设置+能力面板。 > [2026.5.10] v1.3.10 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.10) — 远程 Docker CORS 恢复；DISABLE_SSL_VERIFY 在所有 SDK 提供商中生效；更安全的代码块引用；可选的 Matrix E2EE 附加组件。 > [2026.5.9] v1.3.9 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.9) — TutorBot 支持 Zulip 和 NVIDIA NIM；更安全的思考模型路由；deeptutor start 命令；侧边栏工具提示；会话存储一致性。 > [2026.5.8] v1.3.8 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.8) — 可选的多人部署，支持隔离的用户工作区、管理员授权、认证路由和受限运行时访问。 > [2026.5.4] v1.3.7 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.7) — 思考模型/提供商修复；可见的知识索引历史；更安全的 Co-Writer 清除/模板编辑。 > [2026.5.3] v1.3.6 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.6) — 基于目录的模型选择（聊天和 TutorBot）；更安全的 RAG 重索引；OpenAI Responses token 限制修复；技能编辑器验证。 > [2026.5.2] v1.3.5 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.5) — 更流畅的本地启动设置；更安全的 RAG 查询；更干净的本地嵌入认证；设置页面暗色模式优化。 > [2026.5.1] v1.3.4 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.4) — 书籍页面聊天持久化与重建流程；聊天到书籍引用；更强的语言/推理处理；RAG 文档提取加固。 > [2026.4.30] v1.3.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.3) — NVIDIA NIM + Gemini 嵌入支持；统一的 Space 上下文（聊天历史/技能/记忆）；会话快照；RAG 重索引弹性。 > [2026.4.29] v1.3.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.2) — 透明嵌入端点 URL；针对无效持久化向量的 RAG 重索引弹性；思考模型输出的记忆清理；Deep Solve 运行时修复。 > [2026.4.28] v1.3.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.1) — 稳定性：更安全的 RAG 路由和嵌入验证；Docker 持久化；IME 安全输入；Windows/GBK 兼容性。 > [2026.4.27] v1.3.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.0) — 带版本的知识库索引与重索引工作流；重建的知识工作区；嵌入自动发现（新适配器）；Space 中心。 > [2026.4.25] v1.2.5 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.5) — 持久化聊天附件（文件预览抽屉）；附件感知的能力管道；TutorBot Markdown 导出。 > [2026.4.25] v1.2.4 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.4) — 文本/代码/SVG 附件；一键设置向导；Markdown 聊天导出；紧凑的知识库管理界面。 > [2026.4.24] v1.2.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.3) — 文档附件（PDF/DOCX/XLSX/PPTX）；推理思考块显示；Soul 模板编辑器；Co-Writer 保存到笔记本。 > [2026.4.22] v1.2.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.2) — 用户自建技能系统；聊天输入性能大修；TutorBot 自动启动；书籍库界面；可视化全屏。 > [2026.4.21] v1.2.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.1) — 按阶段 token 限制；所有入口点支持重新生成回答；RAG 与 Gemma 兼容性修复。 > [2026.4.20] v1.2.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.0) — 书籍引擎“活书”编译器；多文档 Co-Writer；交互式 HTML 可视化；题库 @提及。 > [2026.4.18] v1.1.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.2) — 基于 schema 的频道标签页；RAG 单管道整合；外部化聊天提示。 > [2026.4.17] v1.1.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.1) — 通用“立即回答”；Co-Writer 滚动同步；统一设置面板；流式停止按钮。 > [2026.4.15] v1.1.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.0) — LaTeX 块级数学大修；LLM 诊断探测；Docker + 本地 LLM 指南。 > [2026.4.14] v1.1.0-beta (https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.0-beta) — 可书签会话；雪景主题；WebSocket 心跳与自动重连；嵌入注册中心重构。 > [2026.4.13] v1.0.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.3) — 带书签和分类的问答笔记本；Visualize 中的 Mermaid；嵌入不匹配检测；Qwen/vLLM 兼容性；LM Studio 与 llama.cpp 支持；玻璃主题。 > [2026.4.11] v1.0.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.2) — 搜索整合（SearXNG 回退）；提供商切换修复；前端资源泄漏修复。 > [2026.4.10] v1.0.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.1) — Visualize 能力（Chart.js/SVG）；测验重复预防；o4-mini 模型支持。 > [2026.4.10] v1.0.0-beta.4 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.4) — 嵌入进度跟踪与速率限制重试；跨平台依赖修复；MIME 验证修复。 > [2026.4.8] v1.0.0-beta.3 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.3) — 原生 OpenAI/Anthropic SDK（移除 litellm）；Windows 数学动画器支持；健壮 JSON 解析；完整中文 i18n。 > [2026.4.7] v1.0.0-beta.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.2) — 热设置重载；MinerU 嵌套输出；WebSocket 修复；最低 Python 3.11+。 > [2026.4.4] v1.0.0-beta.1 (https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.1) — 代理原生架构重写（~20万行）：工具+能力插件模型；CLI 与 SDK；TutorBot；Co-Writer；引导学习；持久记忆。 > [2026.1.23] v0.6.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.6.0) — 会话持久化；增量文档上传；灵活 RAG 管道导入；完整中文本地化。 > [2026.1.18] v0.5.2 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.2) — RAG-Anything 的 Docling 支持；日志系统优化；错误修复。 > [2026.1.15] v0.5.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.5.0) — 统一服务配置；每个知识库可选 RAG 管道；问题生成重构；侧边栏自定义。 > [2026.1.9] v0.4.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.4.0) — 多提供商 LLM 与嵌入支持；新首页；RAG 模块解耦；环境变量重构。 > [2026.1.5] v0.3.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.3.0) — 统一 PromptManager 架构；GitHub Actions CI/CD；GHCR 上的预构建 Docker 镜像。 > [2026.1.2] v0.2.0 (https://github.com/HKUDS/DeepTutor/releases/tag/v0.2.0) — Docker 部署；Next.js 16 与 React 19 升级；WebSocket 安全加固；关键漏洞修复。 ### 📰 新闻 - 2026-05-22 🌐 官方文档站点上线：deeptutor.info (https://deeptutor.info/) —— 指南、参考和能力介绍一站式获取。 - 2026-04-19 🎉 111天达成 20k 星标！感谢大家支持真正个性化、智能化的辅导系统。 - 2026-04-10 📄 论文已在 arXiv 发表——阅读预印本 (https://arxiv.org/abs/2604.26962)，了解 DeepTutor 的设计理念。 - 2026-02-06 🚀 仅39天达成 10k 星标！衷心感谢我们了不起的社区。 - 2026-01-01 🎊 新年快乐！加入我们的 Discord (https://discord.gg/eRsjPgMU4t)、微信 (https://github.com/HKUDS/DeepTutor/issues/78) 或 Discussions (https://github.com/HKUDS/DeepTutor/discussions) —— 让我们一起塑造 DeepTutor。 - 2025-12-29 🎓 DeepTutor 正式发布！ ## ✨ 核心功能 DeepTutor 是一个代理原生的学习工作空间，将辅导、解题、测验生成、研究、可视化和掌握练习集成在一个可扩展系统中。 - 统一运行时 — 聊天、测验、研究、可视化、解题和掌握路径均运行在同一代理循环上，切换目标而不切换引擎，上下文随学习者移动。 - 关联学习上下文 — 知识库、书籍、Co-Writer 草稿、笔记本、题库、人设和记忆在所有工作流中保持可用，而非孤立在独立工具中。 - 子代理与 Partner — 在任意对话回合中咨询实时 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。 选项一 — 从 PyPI 安装 · 完整本地 Web 应用 + CLI，无需克隆 完整本地 Web 应用 + CLI，无需克隆。需要 Python 3.11+ 和 PATH 上的 Node.js 20+ 运行时（打包的 Next.js 独立服务器由 deeptutor start 启动）。 bash mkdir -p my-deeptutor && cd my-deeptutor pip install -U deeptutor deeptutor init # 提示输入端口 + LLM 提供商 + 可选嵌入 deeptutor start # 启动后端 + 前端；保持终端开启 deeptutor init 会提示输入后端端口（默认