DeepTutor开源项目从零到一AI学习伴侣的完整上手实战指南【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor你有没有过这样的时刻想系统地学一门新知识收藏了一堆资料却不知道从哪开始遇到一个难题普通聊天机器人给不出针对你学习进度的答案笔记越记越散回头根本找不到。这些问题正是 DeepTutor——一个基于 Agent 原生架构的个性化学习平台——想要替你解决的。它把智能对话、深度研究、可视化、知识库管理、记忆系统和 AI 写作整合在一个界面里让你真正拥有一个懂你的 AI 学习伴侣。这篇文章会带你从零开始完成从安装部署、核心功能上手、进阶玩法到问题排查的完整旅程照着做你就能亲手跑起来并开始使用它。为什么你需要一个懂你的学习工具先聊聊普通工具和 DeepTutor 的本质区别。传统问答工具就像一个临时的家教你问它答问完就忘下一轮从头再来。而 DeepTutor 的思路是终身个性化辅导Lifelong Personalized Tutoring它有几个普通工具给不了的能力一套引擎跑所有模式对话、做题、研究、画图、解题、掌握路径学习全部跑在同一个 Agent 循环上。你切换的是目标而不是工具。上下文跟着你走知识库、书籍、草稿、笔记本、题库、记忆在所有工作流里都能随时调取而不是每个功能各自孤立。记忆可检查、可编辑它的三层记忆系统L1 工作区镜像、L2 表面总结、L3 跨表面知识合成把它记住了你什么摊开给你看你甚至可以手动修正。能调用别的 AI 助手在对话中实时调用你电脑上的 Claude Code、Codex 等编程助手把它们的专业能力变成你的子代理。听起来有点抽象没关系接下来我们从最实际的一步开始把 DeepTutor 跑起来。五分钟极速上手从零到跑通只需三条命令安装 DeepTutor 之前先确认你的环境需要Python 3.11 及以上以及Node.js 20 及以上前端运行依赖。如果你没有 Node.js 也不用慌可以先只用命令行模式。步骤一创建你的专属工作区建议为 DeepTutor 单独建一个文件夹所有数据配置、知识库、记忆都会存在这里面方便备份和管理# 创建并进入专属工作目录文件夹名可以换成你喜欢的 mkdir -p my-deeptutor cd my-deeptutor步骤二安装核心包# 从 PyPI 安装 DeepTutor 主程序-U 表示如果已安装则升级到最新版 pip install -U deeptutor这段命令的作用是把你电脑里的 Python 环境装上 DeepTutor 的命令行工具装好后你在任何目录都能敲deeptutor开头的命令。步骤三初始化并启动# 交互式初始化引导你配置端口、LLM 提供商和嵌入模型 deeptutor init # 一键启动后端 前端保持这个终端窗口开着 deeptutor startdeeptutor init是个贴心的向导它会一步步问你后端端口默认 8001、前端端口默认 3782、选哪个 LLM 提供商、填 API 地址和密钥、要不要配嵌入模型用知识库功能才需要。整个过程不用手改任何配置文件。启动完成后打开浏览器访问http://localhost:3782就能看到 DeepTutor 的主界面了小提示如果只想快速体验可以跳过deeptutor init直接deeptutor start之后在设置 → 模型里补配置。想彻底告别图形界面、纯命令行操作则用deeptutor init --cli加deeptutor chat。三个核心功能拆解先学会这几招再谈进阶跑起来之后从哪个功能开始玩我建议先吃透下面这三个它们是 DeepTutor 最常用、也最能体现特色的能力。第一招Chat 智能对话——一切学习的起点打开界面默认就在 Chat 工作区。它的特别之处在于一个输入框能调兵遣将输入问题后模型会自己判断要不要调用工具——查知识库、搜网页、读论文、算数学、生成图片都可以在同一轮对话里完成。你还可以从输入框上方的下拉菜单切换能力模式Quiz自动生成练习题并批改Research多代理协作输出带引用的研究报告Visualize生成图表和交互式可视化Solve多步骤推理与数学求解Mastery Path基于掌握度的个性化学习路径聊到一半点击输入框旁的 号可以给这一轮对话喂上下文上传文件PDF、Word、PPT 都行、引用聊天历史、指定笔记本、调用题库甚至挂上你的子代理DeepTutor对话上下文扩展菜单第二招Knowledge Center 知识中心——给 AI 装一个私人资料库普通聊天机器人只能答它训练过的内容而 DeepTutor 的 RAG 知识库能让你把教材、论文、课程笔记喂给它之后回答就会基于你自己的资料。创建知识库的完整流程是左侧导航进入Knowledge Center点击右上角 New knowledge base上传文档选择检索引擎默认 LlamaIndex本地向量 BM25 混合检索等索引构建完成回到 Chat 在输入框下方选中这个知识库即可它的一个亮点是检索引擎可选除了默认的 LlamaIndex还有 PageIndex页面级引用的推理检索、GraphRAG / LightRAG知识图谱检索、以及连接本地 Obsidian 笔记库。不同的资料形态用不同的引擎效果会更好。命令行里也有完整镜像操作适合脚本化或不开图形界面的场景# 创建知识库 deeptutor kb create my-notes # 添加学习资料 deeptutor kb add my-notes --doc 线性代数.pdf # 在知识库里搜索mode 支持 hybrid/vector/keyword deeptutor kb search my-notes 矩阵的秩第三招Co-Writer 协同写作——把散乱笔记变成结构化文档Co-Writer 是一个左右分栏的 Markdown 写作空间左边写、右边实时预览支持数学公式和图表。它最核心的用法是**选中即编辑**选中一段文字让 AI 帮你改写、扩写或精简AI 可以引用你的知识库内容作为依据每次改动都会以接受/拒绝的 diff 形式给你确认绝不会偷偷改你的原文。一个典型的学习笔记工作流是先在 Chat 里讨论概念 → 把讨论结果存进笔记本 → 在 Co-Writer 里新建草稿 → 选中关键段落让 AI 扩写成完整的章节 → 完成后保存回笔记本作为长期可复用的学习资料。进阶玩法把 DeepTutor 用到飞起来基础三招学会了下面这些进阶能力才是 DeepTutor 拉开差距的地方。我会用步骤 实战示例的方式讲你跟着做就能复现。玩法一让 Claude Code 当你的子代理遇到需要读代码、调试程序的学习任务可以让 DeepTutor 现场调用你电脑上的 Claude Code 或 Codex。操作步骤在My Agents页面连接本地的 Claude Code / Codex 命令行回到 Chat输入框上方选择该 Agent或输入触发提问DeepTutor 会真去运行那个代理并把它的工具调用过程实时显示在侧边活动面板DeepTutor调用Claude Code子代理演示它的意义在于DeepTutor 负责规划与教学子代理负责专业执行两边互补。比如让它解释某个开源库的 Agentic RAG 实现它会把源码翻出来给你讲而不是泛泛而谈。玩法二把资料变成活教材Book 功能可以把你的学习资料编译成交互式书籍——不是静态 PDF而是由多种类型块组成、可以互动、每页还能单独聊天的活教材。创建流程是在 Book 页面点击 New book选择来源知识库、笔记本、题库或聊天历史确认 AI 提议的章节大纲先看结构再生成避免一次性盲生成生成后每一章都由文本、测验卡片、时间线、代码、动画、交互模块等块构成可以随意插入、移动、换块类型适合的场景把你研究过的主题资料整理成一份能给同学讲解的结构化教材章节、练习、可视化一步到位。玩法三用三层记忆系统复盘你的学习DeepTutor 的记忆不是黑盒。打开Memory页面你会看到三层结构L1记录每个动作的原始轨迹L2按领域总结出关键事实L3把各领域知识合成成画像。每一层都标注了来源任何一条它以为你知道的东西都能追溯到原始证据发现记错了可以手动改。命令行的查看与清理也很方便# 查看记忆总结默认显示 L3 综合文档 deeptutor memory show # 查看某个具体面如 chat的记忆 deeptutor memory show chat # 清空全部记忆重新开始 deeptutor memory clear玩法四从社区装一个数学辅导老师DeepTutor 有个技能生态叫 EduHub里面是别人写好、可复用的教学技能。安装技能跟装手机应用一样简单# 搜索技能 deeptutor skill search 数学辅导 # 安装技能 deeptutor skill install math-tutor-skill # 查看本地已安装的技能 deeptutor skill list技能的本质是一个SKILL.md文件——一段写好的行动手册模型按需读取并照着执行。你也可以把自己整理的教学方法论打包成技能发布回社区分享给其他人。排错清单新手最容易踩的五个坑部署和使用过程中难免遇到问题这里把最高频的几个一次性列清楚问题现象可能原因解决方案前端打不开 3782 端口端口被占用或防火墙拦截换端口重跑deeptutor init修改前端端口聊天没有反应/报错未配置 LLM 或模型地址不对打开设置 → 模型检查提供商、Base URL、密钥并测试知识库索引失败未配置嵌入模型在设置中确认嵌入模型已连接索引期间不要关闭终端无法连接本地 OllamaOllama 服务没启动运行ollama serve确认端口 11434 可用子代理连接失败API 密钥或连接参数错误在设置 → Partners Agents里验证子代理配置电脑内存吃紧大模型 索引同时跑换轻量模型如 qwen2.5 小参数量版本减少同时进行的任务另外两个实用小技巧一是资源紧张时在设置 → 记忆里调低 L2/L3 的更新频率二是感觉系统响应变慢可运行deeptutor memory clear清理记忆轨迹释放空间。从使用者到贡献者让 DeepTutor 变得更好用顺手之后你完全可以参与到项目中来。DeepTutor 是 Apache 2.0 开源协议的项目迭代节奏很快社区也活跃。如果你习惯源码方式安装比如想改代码可以克隆仓库来开发# 克隆源码仓库 git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor # 进入目录并创建虚拟环境避免污染系统 Python cd DeepTutor python3 -m venv .venv source .venv/bin/activate # 以可编辑模式安装后端并安装前端依赖 python -m pip install -e . ( cd web npm ci --legacy-peer-deps ) # 启动--dev 开启前端热更新改代码即时生效 deeptutor init deeptutor start --dev参与方式由浅入深报告问题在使用中遇到 bug 或体验不佳的地方到 Issues 里反馈分享使用案例把你的学习场景、配置方法写成文章帮助别人发布技能把你在 EduHub 积累的技能分享给社区贡献代码认领 Roadmap 上的任务从修 bug 开始多用户部署为学习小组或班级配置带账号隔离的共享环境设置里开启 auth第一个注册用户自动成为管理员结语最好的学习方式就是开始使用到这里你其实已经完成了从知道 DeepTutor到上手 DeepTutor的跨越跑起来了环境用会了对话、知识库和协同写作尝试了子代理、记忆和技能生态也知道遇到问题该去哪排查。DeepTutor 的价值不在于功能清单有多长而在于它把学习这件事的过程沉淀了下来——每一次提问、每一份笔记、每一个知识点之间的关联都被记录、总结、可视化变成真正属于你的知识资产。它适合学生、研究者也适合任何想把学习这件事做得更系统的人。现在打开浏览器新建一个对话把你一直想学却迟迟没开始的那门课作为第一个问题问它吧。你的 AI 学习之旅就差这一步。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 DeepTutor开源项目从零到一：AI学习伴侣的完整上手实战指南
DeepTutor开源项目从零到一AI学习伴侣的完整上手实战指南【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor你有没有过这样的时刻想系统地学一门新知识收藏了一堆资料却不知道从哪开始遇到一个难题普通聊天机器人给不出针对你学习进度的答案笔记越记越散回头根本找不到。这些问题正是 DeepTutor——一个基于 Agent 原生架构的个性化学习平台——想要替你解决的。它把智能对话、深度研究、可视化、知识库管理、记忆系统和 AI 写作整合在一个界面里让你真正拥有一个懂你的 AI 学习伴侣。这篇文章会带你从零开始完成从安装部署、核心功能上手、进阶玩法到问题排查的完整旅程照着做你就能亲手跑起来并开始使用它。为什么你需要一个懂你的学习工具先聊聊普通工具和 DeepTutor 的本质区别。传统问答工具就像一个临时的家教你问它答问完就忘下一轮从头再来。而 DeepTutor 的思路是终身个性化辅导Lifelong Personalized Tutoring它有几个普通工具给不了的能力一套引擎跑所有模式对话、做题、研究、画图、解题、掌握路径学习全部跑在同一个 Agent 循环上。你切换的是目标而不是工具。上下文跟着你走知识库、书籍、草稿、笔记本、题库、记忆在所有工作流里都能随时调取而不是每个功能各自孤立。记忆可检查、可编辑它的三层记忆系统L1 工作区镜像、L2 表面总结、L3 跨表面知识合成把它记住了你什么摊开给你看你甚至可以手动修正。能调用别的 AI 助手在对话中实时调用你电脑上的 Claude Code、Codex 等编程助手把它们的专业能力变成你的子代理。听起来有点抽象没关系接下来我们从最实际的一步开始把 DeepTutor 跑起来。五分钟极速上手从零到跑通只需三条命令安装 DeepTutor 之前先确认你的环境需要Python 3.11 及以上以及Node.js 20 及以上前端运行依赖。如果你没有 Node.js 也不用慌可以先只用命令行模式。步骤一创建你的专属工作区建议为 DeepTutor 单独建一个文件夹所有数据配置、知识库、记忆都会存在这里面方便备份和管理# 创建并进入专属工作目录文件夹名可以换成你喜欢的 mkdir -p my-deeptutor cd my-deeptutor步骤二安装核心包# 从 PyPI 安装 DeepTutor 主程序-U 表示如果已安装则升级到最新版 pip install -U deeptutor这段命令的作用是把你电脑里的 Python 环境装上 DeepTutor 的命令行工具装好后你在任何目录都能敲deeptutor开头的命令。步骤三初始化并启动# 交互式初始化引导你配置端口、LLM 提供商和嵌入模型 deeptutor init # 一键启动后端 前端保持这个终端窗口开着 deeptutor startdeeptutor init是个贴心的向导它会一步步问你后端端口默认 8001、前端端口默认 3782、选哪个 LLM 提供商、填 API 地址和密钥、要不要配嵌入模型用知识库功能才需要。整个过程不用手改任何配置文件。启动完成后打开浏览器访问http://localhost:3782就能看到 DeepTutor 的主界面了小提示如果只想快速体验可以跳过deeptutor init直接deeptutor start之后在设置 → 模型里补配置。想彻底告别图形界面、纯命令行操作则用deeptutor init --cli加deeptutor chat。三个核心功能拆解先学会这几招再谈进阶跑起来之后从哪个功能开始玩我建议先吃透下面这三个它们是 DeepTutor 最常用、也最能体现特色的能力。第一招Chat 智能对话——一切学习的起点打开界面默认就在 Chat 工作区。它的特别之处在于一个输入框能调兵遣将输入问题后模型会自己判断要不要调用工具——查知识库、搜网页、读论文、算数学、生成图片都可以在同一轮对话里完成。你还可以从输入框上方的下拉菜单切换能力模式Quiz自动生成练习题并批改Research多代理协作输出带引用的研究报告Visualize生成图表和交互式可视化Solve多步骤推理与数学求解Mastery Path基于掌握度的个性化学习路径聊到一半点击输入框旁的 号可以给这一轮对话喂上下文上传文件PDF、Word、PPT 都行、引用聊天历史、指定笔记本、调用题库甚至挂上你的子代理DeepTutor对话上下文扩展菜单第二招Knowledge Center 知识中心——给 AI 装一个私人资料库普通聊天机器人只能答它训练过的内容而 DeepTutor 的 RAG 知识库能让你把教材、论文、课程笔记喂给它之后回答就会基于你自己的资料。创建知识库的完整流程是左侧导航进入Knowledge Center点击右上角 New knowledge base上传文档选择检索引擎默认 LlamaIndex本地向量 BM25 混合检索等索引构建完成回到 Chat 在输入框下方选中这个知识库即可它的一个亮点是检索引擎可选除了默认的 LlamaIndex还有 PageIndex页面级引用的推理检索、GraphRAG / LightRAG知识图谱检索、以及连接本地 Obsidian 笔记库。不同的资料形态用不同的引擎效果会更好。命令行里也有完整镜像操作适合脚本化或不开图形界面的场景# 创建知识库 deeptutor kb create my-notes # 添加学习资料 deeptutor kb add my-notes --doc 线性代数.pdf # 在知识库里搜索mode 支持 hybrid/vector/keyword deeptutor kb search my-notes 矩阵的秩第三招Co-Writer 协同写作——把散乱笔记变成结构化文档Co-Writer 是一个左右分栏的 Markdown 写作空间左边写、右边实时预览支持数学公式和图表。它最核心的用法是**选中即编辑**选中一段文字让 AI 帮你改写、扩写或精简AI 可以引用你的知识库内容作为依据每次改动都会以接受/拒绝的 diff 形式给你确认绝不会偷偷改你的原文。一个典型的学习笔记工作流是先在 Chat 里讨论概念 → 把讨论结果存进笔记本 → 在 Co-Writer 里新建草稿 → 选中关键段落让 AI 扩写成完整的章节 → 完成后保存回笔记本作为长期可复用的学习资料。进阶玩法把 DeepTutor 用到飞起来基础三招学会了下面这些进阶能力才是 DeepTutor 拉开差距的地方。我会用步骤 实战示例的方式讲你跟着做就能复现。玩法一让 Claude Code 当你的子代理遇到需要读代码、调试程序的学习任务可以让 DeepTutor 现场调用你电脑上的 Claude Code 或 Codex。操作步骤在My Agents页面连接本地的 Claude Code / Codex 命令行回到 Chat输入框上方选择该 Agent或输入触发提问DeepTutor 会真去运行那个代理并把它的工具调用过程实时显示在侧边活动面板DeepTutor调用Claude Code子代理演示它的意义在于DeepTutor 负责规划与教学子代理负责专业执行两边互补。比如让它解释某个开源库的 Agentic RAG 实现它会把源码翻出来给你讲而不是泛泛而谈。玩法二把资料变成活教材Book 功能可以把你的学习资料编译成交互式书籍——不是静态 PDF而是由多种类型块组成、可以互动、每页还能单独聊天的活教材。创建流程是在 Book 页面点击 New book选择来源知识库、笔记本、题库或聊天历史确认 AI 提议的章节大纲先看结构再生成避免一次性盲生成生成后每一章都由文本、测验卡片、时间线、代码、动画、交互模块等块构成可以随意插入、移动、换块类型适合的场景把你研究过的主题资料整理成一份能给同学讲解的结构化教材章节、练习、可视化一步到位。玩法三用三层记忆系统复盘你的学习DeepTutor 的记忆不是黑盒。打开Memory页面你会看到三层结构L1记录每个动作的原始轨迹L2按领域总结出关键事实L3把各领域知识合成成画像。每一层都标注了来源任何一条它以为你知道的东西都能追溯到原始证据发现记错了可以手动改。命令行的查看与清理也很方便# 查看记忆总结默认显示 L3 综合文档 deeptutor memory show # 查看某个具体面如 chat的记忆 deeptutor memory show chat # 清空全部记忆重新开始 deeptutor memory clear玩法四从社区装一个数学辅导老师DeepTutor 有个技能生态叫 EduHub里面是别人写好、可复用的教学技能。安装技能跟装手机应用一样简单# 搜索技能 deeptutor skill search 数学辅导 # 安装技能 deeptutor skill install math-tutor-skill # 查看本地已安装的技能 deeptutor skill list技能的本质是一个SKILL.md文件——一段写好的行动手册模型按需读取并照着执行。你也可以把自己整理的教学方法论打包成技能发布回社区分享给其他人。排错清单新手最容易踩的五个坑部署和使用过程中难免遇到问题这里把最高频的几个一次性列清楚问题现象可能原因解决方案前端打不开 3782 端口端口被占用或防火墙拦截换端口重跑deeptutor init修改前端端口聊天没有反应/报错未配置 LLM 或模型地址不对打开设置 → 模型检查提供商、Base URL、密钥并测试知识库索引失败未配置嵌入模型在设置中确认嵌入模型已连接索引期间不要关闭终端无法连接本地 OllamaOllama 服务没启动运行ollama serve确认端口 11434 可用子代理连接失败API 密钥或连接参数错误在设置 → Partners Agents里验证子代理配置电脑内存吃紧大模型 索引同时跑换轻量模型如 qwen2.5 小参数量版本减少同时进行的任务另外两个实用小技巧一是资源紧张时在设置 → 记忆里调低 L2/L3 的更新频率二是感觉系统响应变慢可运行deeptutor memory clear清理记忆轨迹释放空间。从使用者到贡献者让 DeepTutor 变得更好用顺手之后你完全可以参与到项目中来。DeepTutor 是 Apache 2.0 开源协议的项目迭代节奏很快社区也活跃。如果你习惯源码方式安装比如想改代码可以克隆仓库来开发# 克隆源码仓库 git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor # 进入目录并创建虚拟环境避免污染系统 Python cd DeepTutor python3 -m venv .venv source .venv/bin/activate # 以可编辑模式安装后端并安装前端依赖 python -m pip install -e . ( cd web npm ci --legacy-peer-deps ) # 启动--dev 开启前端热更新改代码即时生效 deeptutor init deeptutor start --dev参与方式由浅入深报告问题在使用中遇到 bug 或体验不佳的地方到 Issues 里反馈分享使用案例把你的学习场景、配置方法写成文章帮助别人发布技能把你在 EduHub 积累的技能分享给社区贡献代码认领 Roadmap 上的任务从修 bug 开始多用户部署为学习小组或班级配置带账号隔离的共享环境设置里开启 auth第一个注册用户自动成为管理员结语最好的学习方式就是开始使用到这里你其实已经完成了从知道 DeepTutor到上手 DeepTutor的跨越跑起来了环境用会了对话、知识库和协同写作尝试了子代理、记忆和技能生态也知道遇到问题该去哪排查。DeepTutor 的价值不在于功能清单有多长而在于它把学习这件事的过程沉淀了下来——每一次提问、每一份笔记、每一个知识点之间的关联都被记录、总结、可视化变成真正属于你的知识资产。它适合学生、研究者也适合任何想把学习这件事做得更系统的人。现在打开浏览器新建一个对话把你一直想学却迟迟没开始的那门课作为第一个问题问它吧。你的 AI 学习之旅就差这一步。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考