DeepTutor 快速入门指南10 分钟搭一个个人 AI 学习助手把课程资料变成互动教材【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor周六下午两点距离线性代数期中考试还有三天。你终于把资料凑齐了下载文件夹里 40 份课件 PDF、班级群里转发的 2 份讲义还有备忘录里手敲的一页公式摘要。全塞给通用聊天机器人它不记得你昨天卡在哪道题上下文也装不下 40 个文件。DeepTutor 就是为这种局面做的个人 AI 学习助手开源、本地安装把你的资料收进知识库之后它是个知道你学到哪一步的学伴。本文拿把课程资料变成能复习、能自测的备考包这个真实任务做主线从 4 条安装命令带你走到一次完整实战最后附一张问题速查表。DeepTutor 本地安装步骤4 条命令完成部署DeepTutor 对环境的胃口很温和需要Python 3.11 及以上3.11–3.13和Node.js 20。不确定就先在终端跑python --version和node -v看一眼。提示DeepTutor 的配置、知识库、记忆全部存放在你启动命令所在的工作目录data/user/settings/之下。所以先建一个专属工作区以后备份、迁移就是整个文件夹拷走的事。# 1. 建立并进入专属工作区 mkdir -p ~/deeptutor cd ~/deeptutor # 2. 安装核心包含 Web 界面 命令行工具 pip install -U deeptutor # 3. 交互式向导依次选端口、LLM 提供商、嵌入模型 deeptutor init # 4. 同时启动后端 API 与前端界面保持终端不关 deeptutor startdeeptutor start跑完后浏览器打开终端里打印的地址默认http://127.0.0.1:3782看到干净的主界面就算成功了之后在终端按CtrlC前后端一起停止。注意赶时间可以跳过deeptutor init界面能起模型稍后在Settings → Models里补配没有云端 API 密钥也没关系向导里选 Ollama 等本地模型方案一样能跑通。打开 DeepTutor 主界面认识这个 AI 学习工作台你面前不只是一个聊天框而是一张工作台。左侧导航从上到下是 Home、Partners、My Agents、Co-Writer、Book、Learning Space 六个主功能区底部还有 Memory、Knowledge Center、Settings。中间是聊天区重点看输入框下方的三个位置左下的 Chat 下拉是能力切换器Chat日常对话、Quiz自动生成可校验的题、Research多代理研究并给出引用、Visualize图表 / 图解 / 交互页面More Capabilities 里还有 Solve多步推理解题和 Mastery Path掌握式辅导 按钮负责挂载一次性引用文件、历史对话、书、笔记本、题库只对这一轮生效底部一排 chip知识库、子代理、人格、模型、语音是粘性上下文选中后整个会话都带着走。模型需要动手时会自动调工具rag查你的知识库、web_search上网查、write_note往笔记本记一笔遇到拿不准的地方ask_user会把对话暂停用选项卡的形式反问一句而不是猜。如何创建知识库把课程资料导入 DeepTutor Knowledge Center这个模块解决什么问题你有一堆散落文档想让它变成随时可引用、可提问的资料库。适合谁资料多的备考党和做项目调研的人。左侧导航进入Knowledge Center点New knowledge base弹窗里有两种入口Create new上传文档、建全新索引和Link existing直接复用别处已建好的索引比如你的 Obsidian 库或远端 LightRAG 实例原地读取、不再建索引。DeepTutor 创建知识库弹窗选择检索引擎并上传初始文档建库时还要选索引引擎一个知识库绑定一个引擎特点与适用LlamaIndex默认本地向量 BM25 混合检索开箱即用新手首选PageIndex托管服务按页引用需要 API key适合 PDF/MarkdownGraphRAG / LightRAG知识图谱检索需额外安装依赖适合关系复杂的资料Obsidian直接挂你的库辅导过程原地读写无需上传文档解析引擎在Settings → Knowledge Base里选Text-only、PyMuPDF4LLM、MinerU、Docling、markitdown处理扫描件和公式文档时换引擎往往立竿见影。习惯终端的话同样的事几条命令就做完deeptutor kb create linear-algebra --docs-dir ./downloads/lectures # 建库并批量导入一个文件夹 deeptutor kb list # 看看库里有什么 deeptutor kb search linear-algebra 特征值 # 试搜一条提示单个文档解析失败或导错了删掉那个文件就行不用整库推倒重建重新索引会写新的版本目录不会毁掉正在用的旧索引。如何用 Book 模块把资料编译成互动教材适合谁想系统复习、把读过一遍变成确实学会的人。解决的问题对着几十页 PDF 从第一页刷到尾效率太低。左侧Book模块点New book选择资料来源——知识库、笔记本、题库甚至某次历史对话都可以。接下来它先给出一版章节大纲让你审确认后才开始生成内容而不是盲出一稿让你抽卡。每个章节由带类型的块拼成正文、提示框、测验卡、闪卡、时间线、代码块、图表、交互式 HTML、数学动画、概念图几乎每页还配一个Page Chat读到哪问到哪。测验卡可以直接作答翻面看解析哪个块不满意单独插入、移动、重生成或换类型不用整章重写。DeepTutor 书籍章节内嵌测验卡作答后展开答案解析到这里你的 40 份 PDF 已经变成一本按你的资料生成、边读边考你的教材——哪里不会点哪里。用 Mastery Path 跟踪掌握度用 Memory 沉淀学习进度Mastery Path适合备考党输入主题比如特征值与特征向量它把主题拆成目标清单顶部是进度条和待复习提醒每个目标明确标记 Mastered / Not started没过关的目标不能跳过hard gate。路径卡片上的New (in Chat)一键把这条路径接回对话继续辅导学习记录和辅导现场不脱节。DeepTutor Mastery Path目标清单、掌握度进度条与待复习提醒Memory解决的是每次对话都像初次见面的问题。它是三层可见记忆L1 是工作区实时镜像加追加式事件流水L2 是各模块的事实摘要L3 是跨模块合成结论。关键点在于——这些都是你能打开编辑的普通文件不是黑盒向量库下面的 Memory Graph 还能把任意一条合成结论追溯回它背后的原始事件。所以隔两天再问我上次学到哪了它是有依据地答而不是客套。刷新频率等参数在Settings → Memory调。DeepTutor 常见问题速查新手最可能卡住的 6 件事现象可能原因解决步骤deeptutor start后前端打不开前端端口被占用或构建中途报错看终端最后打印的地址和报错释放占用端口CtrlC停干净再重跑能对话但回答说未配置模型init 时没配 LLM或跳过了 initSettings → Models补一个 Base URL / API key / 模型名保存即生效知识库索引一直卡住没进度嵌入模型未配置或连不通init 向导或Settings → Models里配 embedding provider先确认端点可达个别 PDF 导入后内容缺失解析引擎没吃透该格式Settings → Knowledge Base换 Text-only 或 PyMuPDF4LLM 重试坏文件可单独删除不用重建库Docker 里连宿主机的 Ollama 失败容器内的 localhost 不是宿主机启动时加--add-hosthost.docker.internal:host-gatewayBase URL 填http://host.docker.internal:11434/v1start --dev前端卡住不动残留的 Next.js 锁文件停掉未退出的前端进程清掉web/.next下的锁文件后重启见 README.md 的 dev-server troubleshooting提示任何拿不准的问题先deeptutor config show对照一遍端口、模型、密钥能定位掉一大半。用熟之后装社区技能、接子代理、用终端驱动它装技能Learning Space → Skills 里可以Import from EduHub直接浏览社区目录把技能下进你的库终端里同样顺手所有导入都会过一道安全校验门deeptutor skill search socratic tutor deeptutor skill install socratic-tutor # 拉取 → 校验 → 注册自己写的SKILL.md也能deeptutor skill publish发布回社区。接子代理与 PartnerMy Agents 可把你机器上的 Claude Code、Codex 等 CLI 接进来对话中用 Agent chip或输在回合中途召唤它们的产出实时流进活动面板Partners 则是带独立人格、模型和 IM 渠道飞书、Telegram、Discord 等的常驻学伴可以让它在固定时间提醒你复习。终端驱动deeptutor chat进多轮 REPLdeeptutor run deep_solve 求 ∫sin(x)cos(x)dx --kb linear-algebra --tool rag单发一回合再加--format json每个回合输出 NDJSON方便让别的 agent 把 DeepTutor 当工具使。完整命令对照表见 deeptutor_cli/README.md。容器化不想装环境的话一条命令起整个应用只暴露 3782 一个端口配置和知识库落在deeptutor-data卷里持久化细节看 CONTAINERIZATION.md。想读源码折腾的仓库地址是git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor装法按 README.md 的源码安装部分走。今天就能做的第一步还是那个周六下午。打开终端执行deeptutor start然后打开 http://127.0.0.1:3782把输入框左下的能力切到Quiz用 挂上你的linear-algebra知识库发出第一问出 10 道关于特征值与特征向量的中等难度选择题附解析。答完之后顺手打开 Memory 页看看它有没有把你记下——从这一刻起线性代数复习不再每次从零开始。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考