DeepTutor 快速上手5 分钟装好你的 AI 私教知识库、记忆与子代理一次配齐【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorDeepTutor 是一个开源的 AI 学习助手把答疑对话、知识库检索、深度研究和三层记忆装进一个本地可运行的网页应用适合自学党、研究生和想系统性吃透某个领域的人。资料越囤越多为什么学进脑子里的却越来越少问题不在找资料在于没有人和这些资料一起被结构化。DeepTutor 的思路反过来先让机器读懂你的资料再带着它们回答你。先认门路DeepTutor 是什么、适合谁一句话定位它是Agent 原生的学习工作台——聊天、出题、研究、可视化、掌握度追踪都跑在同一个代理循环上你切换的是目标不是引擎。所有数据默认落在本机的data/目录不强制上云。能力做什么什么时候用Chat 对话多轮问答可挂载知识库、附件、笔记日常答疑第一入口Knowledge 知识库多引擎 RAG 检索你的文档有 PDF/笔记要基于提问时Memory 三层记忆L1 事件流水 / L2 要点 / L3 合成想让学习有连续性Book 智能书籍把资料编译成带习题的交互教材系统性学一门课My Agents 子代理咨询 Claude Code、Codex 等外部 AI需要真实调试代码时Mastery Path 掌握路径按表现调整讲解深度与练习长期刷题巩固命令清单在 deeptutor_cli/ 目录里每个子命令都能--help自查。 五分钟跑起来DeepTutor 安装与启动验证装它只有一条主命令但先确认两件事Python 3.11–3.13、Node.js 20打包的前端服务器要靠它启动。前置依赖python3 --version # 需要 3.11 及以上 node --version # 需要 20预期版本号达标。不达标先升级后面会卡住。安装命令pip install -U deeptutor预期pip 输出成功随后deeptutor --help能打印出完整命令列表。初始化向导怎么走deeptutor init一段问答式向导依次问你后端端口默认8001、前端端口默认3782、LLM 提供商 / Base URL / API Key / 模型名最后可选填嵌入embedding提供商——暂时不做知识库可以跳过。预期当前目录下生成data/user/settings/配置。启动验证deeptutor start预期终端打印前端地址默认 http://127.0.0.1:3782 浏览器打开能看到左侧导航加中间对话区。这个终端要一直开着CtrlC才会同时停掉前后端。功能深挖新手最高频的三个场景装好只是开始下面三个是日常用得最多的按使用频率从高到低排。 场景一把 PDF 变成可提问的知识库你手里有一门课的 PDF直接问通用问题它答的是公共知识而不是你的资料。解法是先建库deeptutor kb create ml-notes --doc 线性代数.pdf deeptutor kb add ml-notes --doc 复习提纲.md deeptutor kb search ml-notes 特征值分解有哪几种方法库支持 LlamaIndex默认、PageIndex、GraphRAG、LightRAG、Obsidian 等多种引擎Web 端的知识中心里同样能建管理逻辑在 deeptutor/knowledge/。之后对话中挂上这个库回答会基于你的文档并给出引用。资料第一次真正被读懂而不是被存着。 场景二三层记忆让学习有连续性上周问过的错点这周再问它还记得吗DeepTutor 的记忆不是黑盒向量库而是可读的三层文件L1 是追加式事件流水L2 按场景提炼要点L3 做跨场景合成L2 引用 L1、L3 引用 L2每条结论都能回溯到原始事件。deeptutor memory show # 查看 L2/L3 内容Web 端记忆页能看到记忆图谱哪条合成来自哪条原始记录一目了然。掌握路径Mastery Path正是基于这些历史表现来调节讲解深度和练习难度——这是它越用越懂你的底层。 场景三把 Claude Code 拉进来当子代理遇到要真刀真枪调代码的问题单靠对话容易纸上谈兵。DeepTutor 可以把本机装好的 Claude Code、Codex、Gemini 等 CLI 当子代理在聊天框选 Agent 芯片或输入指定咨询轮数它的实际执行过程会实时流进侧边 Activity 面板。IM 侧的常驻伙伴则用deeptutor partner create my-bot --name 代码陪练效果是它替你跑代码、读输出、再回来汇总你只负责看结论和验收。按你的习惯改造它本地或云端模型模型放哪儿取决于你更在意隐私还是省事方案适合配置要点本地Ollama 等数据不出门、零 token 成本Base URL 指向http://localhost:11434/v1云端 APIOpenAI 等开箱即用、模型强Settings → Models 填提供商与 Key最小配置长这样在 Settings → Models 里各建一个 profileLLM : Ollama · Base URL http://localhost:11434/v1 · Model llama3 Embed : Ollama · Base URL http://localhost:11434/api/embed · Model all-minilm云端只需把提供商换成 OpenAI填模型名和 API Key省钱用轻量模型追效果换旗舰随时切换。记忆服务的实现在 deeptutor/services/memory/想调记忆合并的预算参数可以看 Settings → Memory。技能生态一句话带过deeptutor skill search socratic tutor搜社区技能deeptutor skill install socratic-tutor装进本地自己写的 SKILL.md 也能deeptutor skill publish分享出去。 问题速查DeepTutor 常见故障对照表现象可能原因解决办法预防一句容器内连不上宿主机 Ollama容器里的 localhost 指向容器自己加--add-hosthost.docker.internal:host-gatewayBase URL 改用host.docker.internal:11434/v1本机开发优先用 pip 安装别上容器知识库索引失败没配嵌入模型Settings → Models 补一个 embedding profile建库前先测好连接前端 3782 打不开端口被占重跑deeptutor init换端口启动前先确认端口空闲start --dev卡在旧前端进程残留 lock 文件停掉终端打印的 PID确无进程则删除web/.next/dev/lock与web/.next/lock后重试退出统一用 CtrlC 干净停子代理不响应本地 CLI 未登录或配置错先在本机终端确认该 CLI 能独立运行升级 CLI 后先单独验证一次把这套班子用起来DeepTutor 的价值不在单个功能而在于知识库、记忆、子代理共用同一套上下文——你喂进去的资料和积累的学习表现会被每个功能持续复用。现在打开终端跑deeptutor start等页面加载完后问它第一个问题帮我用我上传的资料梳理一下矩阵特征值分解的完整思路。从这条回答开始它会越来越像你的。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考