开源AI学习助手DeepTutor从零跑通完整指南
【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor
昨晚你把一学期攒下的六份讲义 PDF 和半沓实验报告丢进同一个文件夹,今天想问点问题,却得先翻文件、复制、粘贴。这个断层不在模型聪明与否,而在工具没接住资料,学习状态也随会话结束而清零。开源AI学习助手 DeepTutor 的思路是造一座档案柜:资料进来就被索引,提问出去就带出处,学习过程持续归档。按下面的流程走完,工作台就能投入使用。
本地环境准备:一条 pip 装全前后端
先建独立工作目录,让配置、索引和数据都落在里面,不污染其他项目。
mkdir -p my-learning && cd my-learning pip install -U deeptutor deeptutor init && deeptutor startdeeptutor init会依次询问后端端口(默认 8001)、前端端口(默认 3782)和 LLM 提供方,全部回车跳过也可以,之后到设置页补全。deeptutor start同时拉起前后端,终端打印出访问地址后,浏览器打开http://127.0.0.1:3782,能看到居中的对话输入区和左侧导航。停服务时在该终端按 Ctrl+C,前后端一起退出。
模型接入:云端密钥或本地 Ollama 离线推理
工作台上配的模型,是后面资料、记忆和书籍共用的推理引擎。打开 Settings → Models,在 LLM 卡片里填入 Base URL、API Key 和模型名后保存;设置页支持先存草稿再应用,配错不影响当前会话。要完全离线,就先用 Ollama 拉一个本地模型:
ollama pull qwen2.5:7b再把 Base URL 改成http://127.0.0.1:11434/v1,模型名填刚拉取的。推理链路不经过云端,断网也能检索资料、生成回答。同一页面还有界面语言切换和 Default / Cream / Dark / Glass 四套主题,挑一套顺眼的再往下走。
DeepTutor模型设置页LLM与嵌入配置
多格式讲义导入与版本化知识库索引
进入 Knowledge Center,点右上角新建知识库。填上名称,索引引擎默认 LlamaIndex(本地向量 + BM25 混合检索),也可换 GraphRAG、LightRAG、PageIndex,或关联现成的 Obsidian 笔记库,每个库绑定一个引擎。把 PDF、DOCX、PPTX、Markdown 拖进上传区,系统完成解析与建索引;重新建索引会生成新版本目录,旧索引保留,便于回退。管理逻辑集中在 知识库管理模块,终端侧等价操作只有一行:
deeptutor kb create os-notes --doc lectures.pdf索引跑完后回到对话页,问一句“结合资料解释特征值的几何意义”,回答会附带具体段落引用。从这一句开始,答案不再是泛泛而谈。
DeepTutor知识库创建弹窗与索引引擎选择
追踪一次提问如何从资料引用走到长期记忆
每次提问都会被工作台分三段归档,这是一张完整的溯源链路。第一段,原始事件原样留存:问了什么、引用了哪几段资料、模型怎么答,全部进入可回溯的事件轨迹。第二段,系统把发生在某个学习表面(聊天、笔记本、题库)的会话提炼成精炼事实。第三段,事实积累到一定量后跨表面合成出长期画像,学到哪一章、哪个概念错两次,都写在里面。打开 Memory 页面,在记忆图谱里点一个节点,能沿着引用链追回最初的原始事件;记错了直接改文件。终端里执行deeptutor memory show可随时查看当前记忆内容。
DeepTutor记忆图谱多层记忆关联可视化
把对话与资料编译成互动 Book
资料喂过、问题问过,手里的内容足够编成一册。进入 Book 页点新建,它先输出一份章节大纲,确认结构后才开始生成,不是一次性盲目输出。正文由类型化模块构成:文字、测验卡、时间线、代码、动画、概念图都是一个块,每页带独立侧边对话,读到哪里问到哪里。配套的 Co-Writer 负责精修:左侧编辑、右侧实时预览,支持 KaTeX 公式与 Mermaid 图表;选中一段文字,让 AI 基于知识库重写、扩写或精简,每次改动都以接受或拒绝的差异对比呈现,落不落盘由你决定。编译与渲染的实现可以看 Book 引擎模块。
把同一套工作台接到终端与 IM 渠道
浏览器不是唯一入口。终端里deeptutor chat进入交互式对话,deeptutor run deep_solve "求 x^2=4" --format json输出结构化结果,方便脚本或别的 Agent 直接驱动当前回合。My Agents 里可连接 Claude Code、Codex 等本地命令行代理,聊天中随时 @ 调用,让另一个 AI 参与当前回合。开启多用户认证后,每位成员的会话、记忆与知识库完全隔离,管理员在授权侧控制谁能用哪些模型和工具。Partners 把同一套能力接到飞书、Telegram、Slack 等渠道,工作台在你不在电脑前时也持续在线。
明天打开终端后的第一件事:运行deeptutor memory show,核对它今天替你记住了什么,记错的地方直接改掉。
【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考