ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

DeepTutor 完整指南:把解题、知识库、自动出题与长期记忆装进一个本地工作台

DeepTutor 完整指南:把解题、知识库、自动出题与长期记忆装进一个本地工作台

DeepTutor 完整指南:把解题、知识库、自动出题与长期记忆装进一个本地工作台

【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor

DeepTutor 是一个跑在本地的 AI 个性化学习工作台,帮你把散落的 PDF、论文和笔记变成可检索的知识库,再用带出处的问答、自动生成题目和三层长期记忆盯住你的薄弱环节。

复习到一半,你被三件事拖住了

想象一个常见场景:你刚读完几篇论文,准备开始系统复习。结果资料散在四个文件夹里,PDF、课件、笔记各占一摊,得先手动拼一遍;想问聊天机器人一个细节,它给的答案没有任何出处,你分不清是它读过的还是现编的;而昨天刚问过的那道错题,今天它又当新题从头讲起。

DeepTutor 针对的就是这种"资料、进度、答案三者对不上"的状态。它把整条学习链路——从材料入库、检索问答、练习自测到长期记忆——收进同一个应用里,下面按你真实的學習流程走一遍。

能力速览:DeepTutor 各模块对应哪些环节

模块帮你省掉什么典型使用者
多引擎知识库不用反复粘贴背景材料资料多的自学者
带出处的智能问答不用逐份翻查答案依据被难题卡住的人
自动出题与掌握度路径不用自己判断哪里还没学会备考自学者
三层长期记忆不用翻聊天记录找学习痕迹长期学习者
Book 学习之书 / Co-Writer不用从零搭建笔记结构读论文的学生
深度研究不用手工凑带引用的报告研究生、研究人员
Partners 学习伙伴不用守着浏览器窗口学习小组、团队

跟着你的学习流程走一遍:从入库到沉淀

资料入库:解析、切片、建索引,多引擎知识库怎么挑

这一步很直接:把 PDF、论文、文档丢进知识库,DeepTutor 负责解析、切片、建索引。之后无论是聊天还是创作,都能引用这些入库内容。

检索引擎不止一套:LlamaIndex、PageIndex、GraphRAG、LightRAG 都在可选列表里,你甚至可以直接关联自己的 Obsidian 库。不同引擎适配不同规模的资料,按手头材料的体量挑一个即可,完整实现在 知识库核心源码。

带出处的问答:思考—行动—观察循环如何调用 RAG 与网页搜索

打开 DeepTutor,左侧是 Chat、Knowledge、Book、Co-Writer 等入口,中间是对话框。它和普通问答的区别在背后那套"思考—行动—观察"的 Agentic 循环。

收到问题后,它先判断需要哪些信息,再主动调用工具:知识库检索(RAG)、网页搜索、记忆读取都在这套循环里被按需触发,拿到证据后才组织答案。比如你问"我上次讨论的 RAG 方案里,PageIndex 和 GraphRAG 该怎么选",它能翻出你知识库里的内容和历史对话,而不是泛泛而谈。

同一套引擎还支撑另外两个场景:解题时先收集相关知识,再分步给出解法;出题时基于你指定的知识库内容生成问题,并经过多轮校验控制难度。这套循环的机制可以看 Agentic 循环示意图 和 智能体架构源码。

练习与自测:自动生成题目,掌握度路径盯住薄弱点

学完就考,是检验掌握程度最快的方式。DeepTutor 可以基于你指定的知识库内容自动生成题目,并经过多轮校验保证难度合适,让你学完立刻自测。

真正的闭环靠 Mastery Path(掌握度路径):系统根据你的答题情况判断哪些知识点没过关,把对应题目继续安排进后续练习,直到通过才放行。也就是说,它不只是记录你答错了什么,还会主动规划你下一步练什么。

沉淀成自己的东西:三层长期记忆、Book 学习之书与 Co-Writer

"记得"是个性化学习的关键词。DeepTutor 把记忆分成三层:L1 记录每次交互的原始轨迹,L2 提炼成事实,L3 做综合归纳。在 Memory 页面你能直接看到一张记忆图谱——每条结论都能点回去查它来自哪次聊天、哪份知识库,相关逻辑在 长期记忆服务源码。

如果你想把学过的内容固化下来,还有两个出口。Book 学习之书:选一个主题,它自动生成一本分章节的"活书",可以嵌入测验卡、交互模块,读完随时回查;Co-Writer 协同写作:左边编辑、右边实时预览,支持 LaTeX 公式渲染,适合把论文速读笔记、复习提纲打磨成能直接用的文档,分别对应 Book 模块 与 Co-Writer 模块。

协作与扩展:Partners 接入 IM、多用户隔离与深度研究报告

学习不一定只在浏览器里发生。Partners 模式把"导师"接进你已经在用的 IM 频道,随时提问、随时拿到带上下文的答案,接入配置见 Partners 模块源码。

多个成员共用同一套知识库和记忆时,每个用户拥有独立隔离的工作区,互不干扰——学习小组用它做"共享导师",个人用它做跨设备陪伴。另外,深度研究模块能从选题一路做到带引用的研究报告,适合本科、研究生和研究人员,实现在 深度研究源码。

环境与快速上手:DeepTutor 三步安装与启动

系统要求:

  • Python 3.11–3.13
  • Node.js 20 及以上
  • 建议 8GB 以上内存

最省事的路径是从 PyPI 安装,无需克隆仓库:

  1. 建一个工作目录并安装:mkdir -p my-deeptutor && cd my-deeptutor,然后pip install -U deeptutor
  2. 初始化并配置模型:deeptutor init,按提示填写端口、LLM 提供方和 API Key(也可以跳过,之后在 Web 端 Settings → Models 里配置)
  3. 启动应用:deeptutor start,保持终端开启,浏览器访问http://127.0.0.1:3782即可进入

想基于源码开发或偏好 Docker 部署,也可以先克隆仓库:git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor,再按 容器化部署文档 操作;中文阅读体验可参考 中文 README。

DeepTutor 适合哪几类学习者

  • 备考的学生:把课件和教材入库,自动生成题目自测,用 Mastery Path 盯住薄弱点
  • 读论文的研究生:用深度研究完成从选题到带引用报告的全流程,Co-Writer 整理速读笔记
  • 资料繁多的自学者:多引擎知识库统一管理,检索和引用一步到位
  • 学习小组 / 团队:Partners 把共享导师接进 IM,多用户各自隔离又共享资源
  • 喜欢折腾的开发者:工具体系、技能、MCP 服务和 CLI 应用都能扩展,上手看 贡献指南

十分钟跑起来:最快启动命令

回到开头那个复习卡壳的场景——资料拼不起来、答案没有出处、进度记不住,这三件事都可以交给 DeepTutor 处理。花十分钟装好试试:pip install -U deeptutor,然后deeptutor init && deeptutor start,打开http://127.0.0.1:3782,把第一份材料丢进知识库,你的第一本学习之书就能开始生成了。

【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进