DeepTutor 快速上手指南：带本地知识库的开源 AI 学习助手，把讲义变成私教

DeepTutor 快速上手指南带本地知识库的开源 AI 学习助手把讲义变成私教【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorAI 聊天工具经常答得飘你昨天刚讲过的资料它今天就忘了你花力气整理的 PDF、讲义和笔记它根本用不上。DeepTutor 是一款开源 AI 学习助手就是冲着这个问题来的——它可以把你的资料建成本地知识库让聊天、出题、研究、解题都基于资料作答还会留下可检查、可修改的三层记忆。如果你是想让 AI读过你的资料、记住你的进度的自学者、考研党或教师这篇指南会带你用约 10 分钟跑通本地工作台。DeepTutor 适合谁读你的资料、记得住你、回答有出处DeepTutor 不是一个能聊天的网页而是一个智能体原生的学习工作台。智能体原生的意思是聊天、出题、研究、解题、可视化、掌握度练习这些功能全部跑在同一套代理引擎上切换的是目标而不是引擎上下文跟着你走。它和普通聊天工具的关键差别在于三件事一个引擎跑所有模式Chat、Ask Questions、Quiz、Research、Visualize、Solve、Mastery Path、Immersive Reading 共享同一套运行时和会话上下文学习上下文跨功能可用知识库、互动书、Co-Writer 草稿、笔记本、题库、人格预设和记忆在任何一个界面里都能被调用而不是各存各的孤岛回答有出处基于知识库的回答会给出引用来源系统记住的每件事都可以追溯、查看甚至修改。第一次运行的最短路径四条命令拉起 DeepTutor 工作台正式安装前先确认两个环境条件Python 3.11–3.13以及 PATH 中的 Node.js 20。先建一个独立的工作目录——DeepTutor 的所有配置和数据都会放在这个目录下的data/user/settings/里换目录等于换一套全新的工作台mkdir -p my-deeptutor cd my-deeptutor pip install -U deeptutor这一步从 PyPI 拉取完整的前后端包不需要 clone 仓库。看到安装成功、没有报错就可以继续。然后初始化并启动deeptutor init deeptutor startdeeptutor init会依次询问后端端口默认 8001、前端端口默认 3782、LLM 提供商/Base URL/API Key/模型名以及可选的 embedding 和搜索配置。不确定就一路回车跳过之后到网页设置页补配。deeptutor start会同时拉起后端和前端保持终端窗口开着看到终端打印出前端地址后浏览器打开http://127.0.0.1:3782出现聊天工作台界面就说明启动成功。要停止服务在那个终端按CtrlC前后端会一起停。另外两条备用路径按你的习惯选Docker不想装 Python 环境可以用一个容器跑完整应用-v卷会保留你的配置和工作区打开的同样是 3782 端口docker run --rm -d --name deeptutor \ -p 127.0.0.1:3782:3782 \ -v deeptutor-data:/app/data \ ghcr.io/hkuds/deeptutor:latest源码开发需要改代码、跟项目迭代时clone 仓库地址为https://gitcode.com/GitHub_Trending/dee/DeepTutor后依次安装依赖并进入开发模式cd DeepTutor python3 -m venv .venv source .venv/bin/activate python -m pip install -e .cd web npm ci --legacy-peer-deps deeptutor start --dev两种方式最终看到的页面和目录布局完全一致。如何配置模型云端密钥和 Ollama 本地模型都行打开工作台后的第一件事是给系统接上一个大脑。进入Settings → Models新增一条 LLM 配置填 Base URL、API Key、模型名保存即可。设置页支持先存草稿再应用的流程配错一个提供商不会影响当前正在运行的会话。如果你希望推理完全不经过云端可以搭配 Ollama 跑本地模型。先在终端起服务并拉一个模型ollama serve ollama pull wizardlm2:7b拉取完成后回到 Settings → Models把 Base URL 填成http://127.0.0.1:11434/v1模型名填你刚拉取的本地模型保存即可。如果你是通过 Docker 部署的把127.0.0.1换成host.docker.internal指到宿主机。DeepTutor 设置页面配置 LLM 模型、界面语言与主题两个补充说明Embedding 模型只在你要用知识库/RAG 功能时才需要单独配一个 embedding 配置纯聊天可以跳过界面语言与主题Appearance 里可以切换中英文界面内置 Default、Cream、Dark、Glass 四套主题离线环境下同样生效。第一次上传资料建立带引用的本地知识库模型接好之后做私人导师化的关键一步是把资料喂进去。进入Knowledge Center新建知识库把 PDF、DOCX、PPTX、Markdown 拖进去系统会自动解析并建立索引。多引擎可选默认引擎是 LlamaIndex本地向量 BM25也可以换成 GraphRAG、LightRAG、PageIndex或者直接关联你的 Obsidian 笔记库。每个知识库绑定一种引擎索引带版本重新建索引会生成新的version-N目录旧索引保留出问题可以回退不会被重建毁掉终端等价命令deeptutor kb create my-kb --doc textbook.pdf一条命令完成同样的事deeptutor kb create my-kb --doc textbook.pdf验证方式在聊天里挂上这个知识库问一句请结合资料解释梯度下降的收敛条件之类的基于资料的问题。回答带上具体的段落引用说明资料接地已经生效。进阶体验把讲义编译成互动书或用协作写作精修工作台跑起来之后最值得优先试的两个功能是把学到的东西变成成果。Book 引擎资料变成一册活书Book 能把知识库、笔记本、题库或聊天历史编译成一册互动读物。它不是静态 PDF而是由类型化模块组成的阅读环境文字、测验卡片、时间线、代码、交互组件、动画、概念图都可以是书里的一个块每页还带独立的侧边对话读到哪里问到哪里。创建流程会先给你一份章节大纲你确认结构后才生成内容不会一次性盲目输出完成后还能导出为 Markdown。Co-Writer选中文字让 AI 精修Co-Writer 是双栏协作写作界面左边编辑、右边实时预览支持 KaTeX 数学公式和 Mermaid 图表文档自动保存。它的核心操作是外科手术式编辑——选中任意一段文字让 AI 重写、扩写或精简改动可以基于知识库或网络证据每次都以接受/拒绝的差异对比呈现落不落盘由你说了算。定稿后可以直接存回笔记本成为后续可复用的上下文。如何检查三层记忆验证 AI 是否真的记得你DeepTutor 的记忆是文件形式的三层系统不藏在黑盒向量库里每一层都看得见、改得动L1 工作区镜像实时记录每次交互形成只追加的事件轨迹L2 表面摘要为聊天、笔记本、题库等每个学习表面整理出精炼事实L3 跨表面合成把不同场景的学习内容关联起来形成你的长期画像。在 Memory 页面打开记忆图谱L3 在中心、L2 在中间环、L1 轨迹在外圈因为 L2 引用 L1、L3 引用 L2任何一条合成结论都能追溯回最初的原始事件。如果它记错了你直接改对应的记忆文件就行。终端里也可以随时查看当前记忆内容deeptutor memory show验证方法连续聊几轮、再录两条笔记本后打开 Memory 页面看 L2 是否出现了新事实、L3 是否引用了 L2。如果链条清晰说明记忆系统在你自己的工作流里已经运转起来了。上手验收自检清单、下一步与常见问题按这份清单过一遍全部打勾就说明基本入门了浏览器成功打开http://127.0.0.1:3782看到聊天工作台Settings → Models 里配好至少一个模型云端密钥或 Ollama 本地模型均可创建了一个知识库并上传了至少一个文档问过一个基于资料的问题看到了带引用的回答在 Memory 页面看过 L1 / L2 / L3 三层记忆。下一步可以做的事用 Book 把一份讲义变成互动读物把 Co-Writer 里写好的笔记存回笔记本终端党deeptutor chat进入交互式对话deeptutor run deep_solve x^24 -f json单次执行并输出结构化 JSON方便脚本或其他 Agent 驱动子代理在 My Agents 里连接本地的 Claude Code、Codex 等命令行 Agent聊天中随时调用IM 伙伴Partners 可以把同一个大脑接到飞书、Telegram、Slack、Discord 等十几条渠道让导师常驻团队使用认证默认关闭、单用户运行在data/user/settings/auth.json开启后重启第一个注册用户成为管理员之后每位用户拥有隔离的会话、记忆和知识库管理员通过授权控制每个人可用的模型、知识库和工具。遇到问题先做三件事运行deeptutor doctor它会检查当前工作区是否具备启动条件加--online还会探测已配置的模型服务所有配置都在data/user/settings/下的 JSON/YAML 文件里推荐用网页设置页编辑大多数配置是草稿-应用流程改坏了不会立刻生效知识库里某个文档解析失败单独移除该文档即可不需要删库重建端口冲突则在deeptutor init或system.json里改端口。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考