DeepTutor完全指南：免费开源AI智能导师，本地部署+三层记忆+多引擎知识库

DeepTutor完全指南免费开源AI智能导师本地部署三层记忆多引擎知识库【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorDeepTutor 是一款免费开源的 AI 智能导师系统采用 Agent-Native智能体原生架构把聊天辅导、知识库检索、解题、协同写作和三层记忆整合到一个可本地部署的学习工作区。适合想拥有专属 AI 学习伙伴的学生、教师以及想嵌入自己工作流的开发者。基于 Apache 2.0 协议开源支持 Ollama 等本地大模型数据不出本机。它适合谁人群典型场景主要用到的功能学生 / 自学者围绕自己的讲义、教材提问错题反复练聊天工作区 知识库RAG 检索 题库教师 / 教育机构在局域网部署一套给班级共享资料多用户部署 共享知识库 掌握度路径Mastery Path按掌握程度排学习计划开发者 / AI 爱好者把导师能力接进自己的 Agent 或聊天工具CLI 的 JSON 输出、技能Skills系统、Partners 即时消息渠道核心功能上手聊天工作区提问就有依据的回答聊天是默认入口也是大多数任务的起点。你可以在一个对话里连续追问让模型调用知识库、联网搜索、执行代码、生成图片也可以让它先停下来向你确认问题再继续。Quiz出题、Research带引用的研究报告、Visualize图表/动画等更深的能力都从聊天发起。知识库让个人资料可被检索上传 PDF、Word、Markdown 等资料建立知识库回答时先检索再作答也就是 RAG检索增强生成。不同知识库可选不同检索引擎默认的 LlamaIndex本地向量BM25、PageIndex、GraphRAG知识图谱检索、LightRAG也可以直接关联已有的 Obsidian 笔记库免去重建索引。Co-Writer 协同写作选中改确认后才生效分栏编辑的 Markdown 写作空间左边写、右边实时预览支持公式渲染。它的特色是外科手术式修改选中一段文字让它改写、扩写或缩写并可以基于知识库或网络证据每次修改以 diff差异对比形式展示你点接受才真正落笔。三层记忆辅导过程留得下来记忆不是藏在向量库里的黑盒而是可读可编辑的文件L1 记录各场景的原始事件轨迹L2 按场景提炼事实条目L3 做跨场景综合。每一层都引用下层任何一条它了解你的结论都能回溯到具体出处Memory Graph记忆图谱把这条链路可视化。Partners把导师接到聊天软件里Partners 是常驻的数字学伴每个伙伴有自己的性格设定SOUL.md、模型策略、私有记忆和工具权限能接入飞书、Telegram、Slack、Discord、钉钉、QQ、企业微信、WhatsApp 等十余个 IM 渠道。反过来聊天里也能临时调用本机的 Claude Code、Codex 等编程 CLI 作为子代理把它们的输出流式展示在侧栏。DeepTutor Partners多平台IM学伴配置界面10 分钟跑起来前提Python 3.11–3.13Node.js 20。最短路径是从 PyPI 安装无需克隆仓库mkdir -p my-deeptutor cd my-deeptutor pip install -U deeptutor deeptutor init # 按提示选端口、LLM 提供商和模型 deeptutor start # 同时启动前后端保持终端开着如果要改源码则从源码安装git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor cd DeepTutor python3 -m venv .venv source .venv/bin/activate pip install -e . deeptutor init deeptutor start如何验证打开终端打印的前端地址默认http://127.0.0.1:3782看到聊天首页即启动成功。到 Settings → Models 里填好模型提供商本地 Ollama 填http://localhost:11434/v1再到 Chat 里发一条测试消息。按CtrlC可同时停掉前后端。Docker 用户只需docker run一个镜像、映射 3782 端口即可容器只发布前端端口API 由容器内部转发。背后怎么工作DeepTutor 分五层协作入口层支持 Web、CLI 和 API/SDK运行时层把每种模式都跑在同一个智能体循环上所以切换聊天/解题/研究只是换目标上下文知识库、记忆、人设跟着学习走核心层把能力分成 L2 能力Chat、Deep Research、Visualize 等和 L1 工具RAG、Memory、执行、MCP 等服务层封装 LLM、会话、沙箱、合作伙伴等最底层是data/下的配置、记忆和知识库文件。记忆按 L1 轨迹 → L2 事实 → L3 综合逐级提炼这也是个性化看得见、可审计的原因。配置与常见问题现象打开 3782 端口没反应或端口冲突→ 原因前端端口被占用 → 在deeptutor init或data/user/settings/system.json里改前端端口Docker 则改-p映射左侧主机端口。现象Docker 部署时连不上宿主机上的 Ollama / LM Studio→ 原因容器内的localhost指向容器自己 → 启动时加--add-hosthost.docker.internal:host-gateway把模型 Base URL 改成http://host.docker.internal:11434/v1。现象知识库索引失败或很慢→ 原因嵌入Embedding服务未启动或个别文档解析出错 → 先确认 Settings 里配置了嵌入服务单篇解析失败可直接从知识库删除该文档不用整个重建。现象内存吃紧、响应变慢→ 原因本地模型过大 → 换更小的模型、减少同时加载的服务大知识库可考虑 FAISS 后端加速检索。现象想多人共用但登录后看不到管理员页面→ 原因认证默认关闭且第一个注册者才是管理员 → 打开data/user/settings/auth.json里的认证开关并重启第一个访问/register的账号成为管理员其余用户资源相互隔离。生态与扩展技能系统技能采用开放的 Agent-Skills 格式一个含SKILL.md的文件夹内置技能在 deeptutor/skills/builtin/用deeptutor skill install 名称从 EduHub官方教育技能仓库安装也兼容 ClawHub安装前会经过安全校验。工具扩展支持 MCP 服务模型可调用的外部工具协议、101 个现成 CLI 应用以及咨询 Claude Code / Codex / Gemini 等外部编程代理。多用户部署开启认证后一个data/目录容纳管理员工作区和各用户隔离工作区模型、知识库、技能通过授权grants分配普通用户看不到 API 密钥。社区与贡献官方文档站点为 deeptutor.info交流渠道有 Discord、微信群、飞书群和 GitHub Issues路线图与贡献规范见仓库内 CONTRIBUTING.md。小结DeepTutor 把能记住你、能查你的资料、能接到聊天软件里这三件事做到了一个开源项目里本地部署加三层记忆的组合是它和通用问答工具的最大区别。项目地址克隆用git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor官方文档deeptutor.info社区入口Discord、微信群、飞书群、GitHub Issues【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考