10 分钟装好 DeepTutor：把本地 AI 导师接进你的学习资料-平芜编程栈

10 分钟装好 DeepTutor：把本地 AI 导师接进你的学习资料

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

啃到第 60 页，公式还在，思路没了。你手边不缺教程、视频和题库，缺的是一个随时在、记得你学到哪、还会追问你是不是真懂的人。DeepTutor 就是为此做的：一个装在本地、基于 Agent 架构的 AI 导师，能把你的资料接进来当依据，把每次学习的过程留下来，带着你过一遍而不是替你划重点。它适合想把自学从"刷视频"切换到"过堂检查"的学习者、考研党、程序员。

DeepTutor 能力速览：30 秒看它能干什么

模块	干什么	什么时候用
Chat 核心对话	带工具调用的多轮问答，可挂载知识库、附件、外部代理	日常提问、卡点讨论
Knowledge 知识中心	把 PDF、Markdown 建成多引擎检索库，回答附带原文出处	想让答案"有出处"时
Research 深度研究	多步检索加推理，产出带引用的报告	开题、文献调研、技术预研
My Agents 子代理	在对话中途召唤 Claude Code、Codex 等外部编码工具干活	需要跑代码、改文件时

DeepTutor 安装与启动：四条命令跑起来

前提很简单：Python 3.11–3.13 和 Node.js 20+。建一个专用目录再安装，配置文件都落在当前目录的data/下，以后搬家只需带走这一个目录：

mkdir my-deeptutor && cd my-deeptutor pip install -U deeptutor

装完后执行初始化向导，一路按提示回答端口、LLM 提供商、API Key、模型名，不需要手工改任何 JSON：

deeptutor init

然后启动，终端里会打印前端地址，浏览器打开：

deeptutor start

默认地址是http://127.0.0.1:3782，左侧导航列着对话、知识库、记忆等全部入口，中间就是输入区。若init时没配模型，先到设置 → Models 补上再提问，否则回答不了任何内容。

第一次实战：把一本教材变成会答疑的"老师"

最高频的用法是"喂资料再提问"。先在终端建一个知识库，DeepTutor 会把 PDF 解析、切块并建成检索索引：

deeptutor kb create linear-algebra --doc "线性代数.pdf"

稍等片刻，索引建完。回到网页，点开一条新对话，在输入框工具栏的知识库选项里挂上刚建的库，让它成为这条会话的常驻上下文。接着直接问"特征值分解到底在解决什么问题"。预期效果是：回答明显贴着书里讲，出处指向具体文档，而不是模型凭训练记忆泛泛而谈。想临时补充依据，点输入框旁的 "+"，把历史会话、笔记、文件、题库挂进当前这一轮即可。

进阶玩法：什么时候用、能省什么力气

深度研究：在对话里切到 Research 能力，丢一个课题，它会多步检索、交叉验证，最后交一份带引用的报告。适合开题前摸底，省掉你手工筛文献拼摘要的时间。
子代理协作：在 My Agents 里接上本机的 Claude Code 或 Codex，对话中用 @ 选中它，模型会在这一轮里真的调用那个代理去跑代码、改文件，过程流回当前会话。写示例、改 bug 的脏活直接外包。
三层记忆：你的每次学习动作都会落到本地的 L1 事件流、L2 领域事实、L3 综合画像，全部是明文文件、随时可查可改。省的是你反复解释"我已经学过什么"的力气，导师会按你的进度调讲解深浅。

DeepTutor 记忆图谱：L1 到 L3 三层个性化学习记录

可视化与求解：Visualize 把图表、代码块直接渲染在回答里，Solve 走多步推理并展示中间过程，适合数学题和调程序列。

按你的习惯定制：本地模型配置与技能生态

所有配置都收敛在设置页。想省钱又不想让数据出网，把 LLM 指到本地 Ollama 即可，最小可用配置长这样：

{ "llm_provider": "ollama", "llm_base_url": "http://localhost:11434/v1", "llm_model": "llama3", "embedding_model": "nomic-embed-text" }

云端则填对应提供商的 Base URL、Key 和模型名，切换即时生效，两种模式可以随时来回换。

技能系统方面，deeptutor skill search "数学辅导"能列出社区里的现成玩法，deeptutor skill install一条命令装进本地库；把自己的学习方法论写成SKILL.md，再deeptutor skill publish分享给社区。CLI 命令与行为说明见 deeptutor_cli/，后端模块在 deeptutor/。

DeepTutor 常见坑速查

现象	原因	解决
`deeptutor start`端口冲突	3782/8001 已被占用	重新跑`deeptutor init`改端口
本地模型连不上	Ollama 没启动	`ollama serve`，确认 11434 在监听
知识库索引失败	嵌入模型没配好	设置 → Models 检查 Embedding 配置
子代理超时	外部 CLI 未装好或未授权	在 My Agents 重连对应代理并测试