DeepTutor 新手教程10 分钟搭好你的 AI 个性化学习工作台【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor十几个 PDF 和网页笔记摊在桌面每次提问都得手动把背景贴一遍。DeepTutor 是开源的 AI 个性化学习工作台聊天导学、知识库、生成书籍、三层记忆装在同一个系统里模型换成你顺手的就能开工。读完本文你能把它装起来、建第一个知识库并让回答落在自己的资料上。最快启动方式装好、启动、看到首页 这一节只干一件事让你看到首页。环境只要两样Python 3.11 以上和 Node.js 20 以上。最短路径是装官方 PyPI 包不用克隆仓库mkdir -p my-deeptutor cd my-deeptutor # 建一个干净的启动目录数据都会落在这里 pip install -U deeptutor[full] # 装完整 Web 应用加 CLI看到 Successfully installed 就成了 deeptutor init # 配置向导端口、模型提供商、API Key没想好就一路跳过 deeptutor start # 前后端一起拉起保持终端开着deeptutor start打印出前端地址后浏览器打开http://127.0.0.1:3782。看到 Good evening 问候语、左侧有 Home、Partners、Book、Resources 等入口这条路就算通了再往输入框丢一个问题流式回答回来闭环成立。跳过 init 也能启动模型配置之后在 Settings → Providers 里补。想从源码装做开发或二次定制克隆仓库后按贡献指南建虚拟环境、编辑模式安装、进 web 目录装前端依赖再改用开发模式启动即可git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor第一次真正用起来聊天、知识库、生成书籍聊天导学要的不只是答案还有过程触发场景碰到一个看不懂的公式或概念你想知道为什么和它和什么连在一起而不只要结论。操作路径直接在输入框提问 → 左下角 Mode 下拉切到 Explain、Solve、Practice、Research 等模式 → 点输入框加号塞入文件、历史会话或书籍 → 点工具栏知识库图标做整场对话绑定的粘性引用。产出一份把思考、搜索、翻库过程摊开给你看的回答问题太模糊时它会停下来反问不猜着答。知识库建库步骤让回答落在你的资料上触发场景学习资料散在十几个 PDF 和网页里每次提问都要重新贴一遍背景。操作路径左侧 Resources → Knowledge Center → 点右上角 New knowledge base → 默认 LlamaIndex 引擎本地向量加 BM25直接用上传 PDF、Markdown → 解析引擎后续可在 Settings → Knowledge Base 换成 Text、MinerU、Docling 等。产出回到聊天勾选这个库回答就带引用地落在你的资料上它同时还是后面生成书籍的原料库。生成书籍把一个主题编译成可交互的书触发场景某块内容你反复学想把它变成一套能反复翻、带自测的结构化材料。操作路径Book 页 → New book → 来源选新知识库、笔记、题库或历史会话 → 生成前先给出章节提纲让你过目不满意可改 → 确认后再动笔。产出一本章节加类型化内容块组成的书每章混着文字、测验卡、代码块、交互 HTML块可以单独增删、移动、换类型每页还自带问答读到哪问到哪。用得久才显出的东西三层记忆明文可查。它的记忆不是黑盒向量库而是文件L1 按日期追加原始事件流L2 是各功能面提炼的事实清单L3 是对你偏好和近期关注的综合判断每层都引用下层。你能得到Memory 页直接编辑、清理在记忆图谱上悬停任意节点能看到这条结论背后是哪条原始记录。因材施教不是玄学是一堆你能追责的明文。Partner把助教搬进你的 IM。机制是每个 Partner 有独立的人设文件SOUL.md、模型策略和私有记忆接上飞书、Telegram、Discord、企业微信等渠道后它就在 IM 里独立收发消息。你能得到一个随叫随到的私教反向也成立——聊天里可以把某个 Partner 当子代理来咨询两个脑互相借力。技能市场能力是攒出来的。Learning Space 放的是长期留存的东西会话、笔记、题库、Mastery Path 学习路径、人设和 Skills。技能就是模型按需读取的 SKILL.md 剧本可以自己写也能从社区市场 EduHub 一键导入带安全审核门槛。你能得到答错的题自动进复习计划用得越久复习队列越准。大概率会踩的坑聊天框转圈无反应或回答答非所问→ 原因没配模型 → 解法去 Settings → Providers 补上 Base URL、API Key 和模型名保存刷新。deeptutor start提示端口被占用→ 原因8001 或 3782 已被别的进程占了 → 解法重跑deeptutor init换端口或改data/user/settings/system.json里的端口再重启。本地模型Ollama / LM Studio在容器里连不上→ 原因Base URL 填了127.0.0.1在 Docker 里它指向的是容器本身 → 解法选 OpenAI 兼容类提供商地址换成http://host.docker.internal:11434/v1。知识库建了但检索差或文档解析报错→ 原因漏配 Embedding 模型或解析引擎和文档类型不匹配 → 解法先在 Settings → Knowledge Base 配好 Embedding再按文档类型换解析引擎单篇失败删掉那一篇重建不用推倒整个库。换机器或想备份→ 原因不确定数据在哪 → 解法数据全在启动目录的data/下配置、知识库、记忆、会话都是明文 JSON/YAML/Markdown整目录拷走即可换地方用DEEPTUTOR_HOME或deeptutor start --home指定。接下来怎么安排 ✅配好一个模型在 Settings → Providers 把 Base URL、API Key、模型名填全聊天和后面的功能才有模型可用。建一个知识库把最常用的一批资料传进去聊天里勾选引用回答就落在自己的资料上。问满十个问题切 Explain、Solve、Practice 两三种模式让三层记忆开始积累。三层记忆的精细调整、Partner 与 IM 渠道、EduHub 技能导入现在不用碰等资料变多、使用习惯稳定之后再配收益更大。想深入看实现从这几个入口进开发文档入口docs-for-dev/README.md架构说明docs-for-dev/ARCHITECTURE.md代理逻辑源码deeptutor/agents/【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考