DeepTutor：开源本地 AI 导师，从知识库检索到三层记忆的实践手册

DeepTutor开源本地 AI 导师从知识库检索到三层记忆的实践手册【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorDeepTutor 是一款开源 AI 导师核心定位是以智能体为原生的设计思路把对话、知识库检索、协同写作和长期记忆装进同一个可本地部署的 Web 应用里。本文讲清楚它怎么装、怎么用、怎么调。当你面对一份看不懂的论文、一个跑不通的代码这时候大多数人会先上网搜一堆零散答案再问一个对你材料一无所知的聊天机器人。后者的问题是它接触不到你的资料回答只能泛泛而谈遇到不懂的还容易编。DeepTutor 针对这个断层做了两件事先把你自己的文档索引成知识库再让对话里的智能体循环自动调用检索、代码执行等工具把答案落在你的材料上信息不足时它会停下来反问而不是硬猜。 核心能力问、写、记三步走问对话能检索、能跑代码、能调外部智能体对话工作区入口是一个智能体循环模型按轮次思考需要时调工具、观察结果最后以一条不带工具的消息收尾。你可以把回答锚定在选定的知识库上、附带 PDF 或图片做一次性引用、也可以在对话中途实时调用 Claude Code、Codex、Gemini 等本机编码智能体。拿不准时ask_user工具会暂停本轮提出结构化的澄清问题你回答后它再继续。底层实现见聊天智能体模块用户可开关的工具brainstorm、web_search、paper_search、reason 等和上下文工具rag、exec、write_note 等会随场景自动挂载。写协同写作走的是外科手术式编辑写笔记或报告时不必整篇重生成选一段文字让它改写、扩写或压缩。编辑智能体可以引用知识库或网络证据每处修改都以接受/拒绝的 diff 形式展示你批准后才落盘。文档自动保存实时预览支持 KaTeX 公式草稿成熟后可存回笔记本作为后续对话的上下文。记三层记忆可以审查、可以改DeepTutor 的记忆不是藏在向量库里而是你能直接读的文件L1 是各轮次的事件日志L2 是各场景提炼的事实L3 是跨场景合成的知识。L2 引用 L1、L3 引用 L2所以画像里每条结论都能追到原始事件。记忆覆盖聊天、笔记本、测验、知识库、书本、协同写作等 7 个场景你可以直接打开文件修正。实现位于三层记忆服务。 Docker 一键部署或 pip 三条命令启动最短路径是直接从 PyPI 安装要求环境里有 Python 3.11–3.13 和 Node.js 20pip install -U deeptutor deeptutor init deeptutor startinit会依次询问端口、LLM 提供商、API key 和模型名启动后打开 http://127.0.0.1:3782 即可使用。如果你倾向容器化一步到位直接跑一条docker run即可镜像为 ghcr.io/hkuds/deeptutor:latest数据落在deeptutor-data卷里仓库的 CONTAINERIZATION.md 还给了 podman 和 rootless 部署细节。Ollama、LM Studio 等本地 LLM 方案统一在 Web 端的 Settings → Models 里配置。⚙️ 进阶玩法多用户部署、技能系统与智能体扩展多用户部署打开认证后每个用户有独立的data/工作区首个注册用户自动成为管理员模型、知识库、技能通过授权分配给其他人逻辑见多用户权限模块。技能系统用deeptutor skill install装社区技能本质是 SKILL.md 剧本文件模型按需加载不用改代码。智能体扩展deeptutor/agents/下的智能体模块分别处理聊天、数学动画、研究等能力全部跑在同一个智能体循环上切换目标而不是切换引擎。 适合谁学生把课程 PDF 和讲义建一个知识库对话时按你的材料作答再用测验和掌握度路径复习。研究者让研究智能体产出带引用的报告配合论文搜索工具梳理相关工作成稿交给协同写作打磨。培训团队内网多用户模式部署一套实例服务整个团队管理员按人分配模型和知识库。 避坑与调优容器连接、索引、内存四件事容器内连不上 Ollama容器里的 localhost 指向容器自身启动时加--add-hosthost.docker.internal:host-gateway并把 Base URL 改成http://host.docker.internal:11434/v1。知识库大、索引慢或失败先检查文档格式和嵌入服务可用性FAISS 向量后端能加速大库检索单篇失败文档可单独移除不必整库重建。低配机器卡顿换更小的本地模型、减少并发索引v1.5.8 起开发服务器有真实内存上限LLM 客户端和索引缓存也做了有界化长期运行更省内存。多用户配置混乱第一个注册的用户即管理员其他用户看不到模型或知识库通常是管理员还没分配授权去/admin/users检查。先试最短路径三条命令装完即用。项目GitHub_Trending/dee/DeepTutor文档见官方站点 deeptutor.info。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考