如何5分钟搭起你的个人学习工作台：DeepTutor零基础快速指南
【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor
周六晚上9点40分。你桌面那个叫「机器学习笔记」的文件夹里，躺着11份PDF、2份PPT，还有一份你没印象写过的Markdown。你问聊天机器人，它只会给通用答案，不知道你上次卡在哪一步。DeepTutor是一个可以装在本地的开源学习助手：它记得你的学习轨迹，还能直接用你自己的文档回答问题。
🧭 DeepTutor适合谁
一句话解释它的定位：它像一个升级成整个学习间的学习桌——图书馆（知识库）内置在桌洞里，图书管理员（检索引擎）已经上岗，连笔记本（记忆）都替你记着。
- 如果你是备考季的学生，它会把你散落的讲义整理成可检索的知识库，让每个回答都有出处。
- 如果你在做技术调研或写论文，它会自己查资料，产出带引用结论的报告。
- 如果你在新领域自学，它会记录你对每个知识点的掌握程度，给你进度而不是感觉。
如果你只想在云端和AI闲聊、不需要它碰自己的文件，普通聊天产品就够了，不用装它。
✅ 五分钟跑起来
环境检查：2条命令看是否达标
在终端输入python --version，需要3.11–3.13；输入node -v，需要20+（前端界面依赖它）。版本不够就去官网装新版，这是唯一的前置要求。
安装步骤：3条命令完成
pip install -U deeptutor # 装核心包，无需clone仓库 deeptutor init # 四步向导：端口 → LLM → 嵌入模型 → 确认 deeptutor start # 拉起后端(默认8001)+前端(默认3782)deeptutor init会依次让你：选端口（默认 8001/3782）、选 LLM 提供商、选嵌入模型（只用知识库才需要）、核对汇总。没有云端密钥的话，向导里选 Ollama 等本地方案一样能跑。跳过 init 也行，它用默认端口启动，之后再进Settings → Models补模型。四种安装路径的细节见 README.md。
启动并打开：浏览器指向 127.0.0.1:3782
deeptutor start跑完后，终端会打印一个地址，浏览器打开即可。看到左侧一列导航、中间是对话区的主界面，就算成功了；按Ctrl+C可以同时停掉前后端两个服务。
📚 用你自己的笔记做一件真事
目标：让「机器学习笔记」那个文件夹开口回答问题。一共三步。
第一步：一条命令把文件夹建成知识库。在文件夹所在机器上执行：
deeptutor kb create ml-notes --docs-dir ./机器学习笔记 # 递归导入文件夹内全部支持格式成功后，终端打印一张知识库表：名字、状态、文档数，一眼确认导进去了多少。
第二步：提问，验证答案带出处。回到浏览器，在对话输入区挂上ml-notes，问「两份讲义对梯度下降的讲法有什么不同？」。成功后，回答会附上来源引用——这就是"它在读你的东西"而不是在背通识的时刻：
第三步：（可选）把知识库编成交互式教材。左侧导航打开Book，新建书并选中ml-notes，它会先给出章节大纲，你确认后才开始编译成带练习题的教材，哪里薄弱就点哪里：
学几章之后再看Memory模块：L1 事件轨迹、L2 主题总结、L3 跨领域合成，三层记忆把你学过的东西自动归档，每条结论都能追溯到原始记录。
能力速查
| 你想达成的目标 | 用这个功能 | 在哪里点 |
|---|---|---|
| 在一堆资料里查东西、问出处 | Knowledge Center | 左侧导航 Knowledge |
| 把讲义变成可翻阅的成体系教材 | Book | 左侧导航 Book |
| 让AI查文献、写带引用的结论 | Research | 首页能力面板 Research |
| 按知识点确认自己掌握了没 | Mastery Path | 对话输入区 More Capabilities |
| 长文笔记选中一段让AI改写 | Co-Writer | 左侧导航 Co-Writer |
| 回看自己学过什么、卡在哪 | Memory | 左侧导航 Memory |
🛠️ 自检与避坑
| 现象 | 最可能的原因 | 一分钟解决 |
|---|---|---|
| 浏览器打不开 3782 页面 | 前端端口被占用 | 重跑deeptutor init换一个前端端口，再deeptutor start |
| 知识库索引迟迟不建好 | 嵌入模型没配置 | Settings → Models 里检查嵌入端点连通性，或换本地嵌入模型 |
| 连 Ollama 一直失败 | Ollama 服务没起 | 终端执行ollama serve，再确认 11434 端口能访问 |
| 回复很慢 | 用了较大的云端模型 | Settings → Models 切换到轻量模型并保存 |
| PDF 导入后内容缺失 | 个别格式解析不全 | Settings → Knowledge Base 换解析引擎（MinerU/Docling 等）重新导入 |
| 不确定配置对不对 | 配置与预期有出入 | 执行deeptutor config show核对端口、模型、密钥 |
🚀 玩熟之后往哪走
- 装现成技能：社区技能库搜索后一条命令安装，
deeptutor skill search "socratic tutor"，再deeptutor skill install socratic-tutor。 - 接外部工具：在My Agents里连接本机的 Claude Code 或 Codex，对话中途直接咨询它；想要常驻的 IM 伙伴，用
deeptutor partner create建一个。 - 参与共建：先读 CONTRIBUTING.md 了解分支规范和代码标准，或
git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor拉下源码从改文档开始。
那个周六晚上的文件夹还躺在桌面，但它的性质变了：不再是一堆孤立的 PDF，而是一本随时可问的知识库、一本翻得开的教材、一份记得你卡在哪里的档案。现在打开终端，把"五分钟跑起来"那三条命令敲进去，看到主界面后，导入你的第一个文件夹。
【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
