3条命令搭好你的DeepTutor AI学习助手
【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor
深夜,桌面堆着三份PDF讲义和几页复习笔记,你想让AI帮你梳理考点,可通用聊天工具既记不住你学到哪,也读不了"你的资料"。DeepTutor 是一个定位"终身个性化辅导"的开源 AI 学习助手:它记得你的学习进度、把你的文档建成可检索的知识库,还能把资料编译成互动教材。这篇新手上手指南带你走完安装、启动和第一次实战,跟着做,几分钟内就能在本地看到界面。
先把环境装干净
准备三样东西:
- Python 3.11–3.13
- Node.js 20+(运行前端界面用)
- 一个独立目录,作为你的"学习工作区"
不确定版本就先在终端跑python --version和node -v。然后按顺序执行这 4 条命令:
mkdir -p my-deeptutor && cd my-deeptutor pip install -U deeptutor deeptutor init deeptutor startdeeptutor init是一个四步向导:端口 → LLM 提供商 → 嵌入模型 → 确认汇总,全程跟着提示选,不用手改任何配置文件。deeptutor start会同时拉起后端 API(默认端口 8001)和前端界面(默认端口 3782),终端会打印前端地址。
注意:没有云端 API 密钥也可以在 init 里选 Ollama 本地模型,一样能跑通,速度取决于你本机配置。
浏览器打开http://127.0.0.1:3782,看到干净的主界面就说明装好了。在终端按Ctrl+C可同时停掉前后端两个服务。
先看一眼功能地图
左侧导航有一整排模块,核心 6 个先记牢:
| 模块 | 是什么 | 适合谁 | 解决什么问题 |
|---|---|---|---|
| Chat 对话 | 同一 agent 循环里的多轮对话,上下文跟随你 | 所有人日常答疑 | 每次提问不用从头交代背景 |
| Solve 深度解题 | 多阶段解题,可挂 RAG、联网搜索等工具 | 做题卡壳的学生 | 解题步骤有依据、可核查 |
| Research 深度研究 | 多代理协作,检索网络与论文并生成引用 | 写论文、做调研的人 | 查资料、读文献、出引用一条龙 |
| Knowledge 知识中心 | 多引擎 RAG:LlamaIndex、GraphRAG、LightRAG、Obsidian 等 | 资料多的"囤积者" | 散落文档变成可提问的库 |
| Book 书籍 | 把知识库编译成带章节、带练习的互动教材 | 自学、备考的人 | 按章学,不用硬啃几百页原文 |
| Memory 记忆 | L1 实时轨迹、L2 主题总结、L3 跨域合成 | 长期学习者 | 问"我上次学到哪"它能答上来 |
此外还有 Visualize(图表、Mermaid、数学动画)、Quiz(智能出题)、Mastery Path(掌握路径)、Co-Writer(协同写作),按需自取即可。
提示:别急着把每个模块都点一遍,先挑一个对应当下需求的用熟,再扩展。
把散落笔记变成"活"的学习资产
选一个最日常的完整场景:把一份讲义资料变成可对话、可复习、可自测的学习资产。总共 3 步。
第 1 步:把资料喂进知识库
终端里建库,--docs-dir会递归读取文件夹下所有受支持格式(PDF、DOCX、Markdown 等):
deeptutor kb create calculus --docs-dir ./notes deeptutor kb list完成后你会看到:kb list里出现calculus及导入状态。导错了单个文件也没关系,用deeptutor kb delete清理即可,不用整库重建。
第 2 步:一键编译成互动教材
在界面左侧导航进入Book模块,新建一本书并选中刚建好的知识库。DeepTutor 会把库内内容编译成章节结构,配上练习题和可交互模块。
完成后你会看到:书籍界面出现目录和第一章。这本书就是"按你的资料"生成的学习地图,哪里不会点哪里。
第 3 步:让 Memory 替你记账
学完一两章,切到Memory模块。三层记忆自动归档你的学习轨迹:L1 保留实时事件流,L2 按主题总结,L3 做跨领域合成,还配有记忆图谱可以追溯每条结论的来源。
完成后你会看到:下次打开对话,直接问"我上次学到哪了"或"总结几个易混概念",助手会基于记忆作答,而不是重新猜一遍。
完整流程就是:kb create建库 → Book 编译成书 → Memory 沉淀轨迹。
先避坑,再选下一步
卡住时先对号入座:
| 问题现象 | 可能原因 | 解决动作 |
|---|---|---|
deeptutor start后浏览器打不开 | 前端端口 3782 被占用 | 重跑deeptutor init换端口 |
| 连本地 Ollama 失败 | Ollama 服务没起 | 先ollama serve,再确认localhost:11434可访问 |
| 知识库索引迟迟建不好 | 嵌入模型未配置或网络受限 | 在 Settings → Models 检查嵌入端点,或换本地模型 |
| 对话回复很慢 | 用了较大的云端模型 | 临时切轻量模型,缩短单次上下文 |
| 导入 PDF 后内容缺失 | 个别格式解析不完整 | 换成 Markdown 源文件重试 |
提示:行为不对时先跑
deeptutor config show,确认端口、模型、密钥是否与预期一致,往往能快速定位问题。
跑通之后,三个方向可以选:
- 扩展能力:社区技能库里有现成的学习技能,一条命令搜索并安装。
deeptutor skill search "数学辅导" deeptutor skill install <hub>:<slug>接入外部 AI:通过 Subagents 与 Partners 连接 Claude Code、Codex 等外部编程助手,在任意一轮对话里随时召唤它们参与干活。
参与共建:从源码克隆仓库,阅读 deeptutor_cli/ 的命令行实现和 deeptutor/services/memory/ 的三层记忆源码,再动手提改进。
git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor到这里,终端敲deeptutor start,打开http://127.0.0.1:3782,把你手边的第一份资料丢进去,向 DeepTutor 问出第一个问题。
【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考