☰
3条命令搭好你的DeepTutor AI学习助手
2026/10/19 12:02:16 网站建设 项目流程

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 start

deeptutor 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,确认端口、模型、密钥是否与预期一致,往往能快速定位问题。

跑通之后,三个方向可以选:

  1. 扩展能力:社区技能库里有现成的学习技能,一条命令搜索并安装。
deeptutor skill search "数学辅导" deeptutor skill install <hub>:<slug>
  1. 接入外部 AI:通过 Subagents 与 Partners 连接 Claude Code、Codex 等外部编程助手,在任意一轮对话里随时召唤它们参与干活。

  2. 参与共建:从源码克隆仓库,阅读 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询