
DeepTutor开源AI学习助手怎么用完整指南教你3步部署个性化辅导空间【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorDeepTutor是一款免费开源、可完全本地部署的AI学习助手主打终身个性化辅导。不管你是自学编程、备考复习还是想给团队搭一套内部知识系统这篇文章都会用尽量少的技术术语带你走完「安装、接模型、用起来」的全过程最后再附上一份常见坑位清单帮你少走弯路。先别急着装这份指南到底写给谁每次看到AI学习四个字你可能会想这不就是套壳聊天机器人吗如果只是想要一个问答工具市面上随手就能找到。但如果你属于下面这几类人DeepTutor值得你多花十分钟看看自学者今天学Python明天啃论文后天背单词。内容换来换去但希望AI记得你的进度和盲区而不是每次从零开始。老师或助教需要批量出题、整理讲义、批改练习还要盯着每个学生的薄弱点。团队与机构想共享一套知识库又要保证每个成员的数据彼此隔离、权限分明。注重隐私的人资料不想上传云端希望模型和数据都跑在自己的电脑或内网里。一句话总结它瞄准的不是会不会聊天而是能不能一直陪你学下去。它究竟解决了什么麻烦用通用聊天AI辅导学习通常会撞上三堵墙记忆是空白的。上周你刚问过微积分这周再问它完全不记得你卡在哪一步。知识是割裂的。看书的笔记、问答的记录、上传的PDF散落在不同工具里谁也连不上谁。离线基本报废。断网之后很多AI助手立刻失灵更别提处理你自己的私人资料。DeepTutor的思路是把聊天、做题、看书、写作放进同一个引擎里再叠一套可查看、可编辑的记忆系统。你会发现资料和对话不再是一堆孤岛而是围绕你一个人转的连续学习流。从零到一三种安装方式与最简启动步骤上手之前先满足两个前提Python 3.11 及以上以及能跑起来的Node.js20。DeepTutor 的完整形态是「网页前端 本地后端」一条命令就能同时拉起。方式一PyPI 一键安装最省事不需要克隆仓库一个工作目录加三条命令即可mkdir -p my-deeptutor cd my-deeptutor pip install -U deeptutor deeptutor init deeptutor startdeeptutor init会逐个询问端口、模型服务商、API Key 等跳过一次跑不起来因为模型还没配置。deeptutor start启动后终端会打印前端地址默认是http://127.0.0.1:3782用浏览器打开就能开始用。想停止回到终端按CtrlC前后端一起关。方式二Docker 容器运行不喜欢折腾环境的话直接用官方镜像docker run --rm --name deeptutor \ -p 127.0.0.1:3782:3782 \ -v deeptutor-data:/app/data \ ghcr.io/hkuds/deeptutor:latest只需要暴露 3782 一个端口浏览器请求会由容器内部自动转发给后端。配置、知识库、记忆都放在deeptutor-data这个数据卷里删容器也不丢数据。方式三源码或纯命令行想二次开发或者只需要一个终端界面不想要网页可以从源码安装git 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 init deeptutor start --dev纯命令行模式则在安装packaging/deeptutor-cli后执行deeptutor init --cli和deeptutor chat适合在服务器上直接开聊。三种方式共用一个配置目录你在哪个目录启动设置就存在那个目录的data/user/settings/下想换工作区只需换个目录。模型接入云端还是本地两分钟做决定DeepTutor 本身不含模型需要自己接一个大语言模型服务。选哪条路主要看你的隐私需求和硬件水平。走云端在设置里选 OpenAI、Anthropic 或其他兼容服务商填好 Base URL 和 Key 就能用几分钟完成。走本地推荐离线党DeepTutor 对 Ollama 支持得最顺。安装并启动 Ollama 后拉一个对话模型即可ollama serve ollama pull qwen2.5:7b然后在设置 → 模型里把服务商切到 OllamaBase URL 填http://127.0.0.1:11434/v1系统会自动检测到本地服务。LM Studio、llama.cpp、vLLM 这些也都在支持列表里。Docker 部署时注意容器里的localhost指的是容器本身要连宿主机模型需要改用host.docker.internal这样的网关地址。一句话想要绝对离线选 Ollama想要效果拉满且不介意联网选云端。走进主界面一个工作区里的六种学习场景把架构图摊开看顶部是 Web、CLI、Python SDK 三种入口中间是聊天、写作、引导学习等核心能力底部是知识库与持久记忆。所有功能跑在同一套代理循环上所以你在哪儿用上下文都跟着走。聊天不只是问答而是引导主聊天区更像一个导师而非搜索引擎它记得你们之前聊过什么会根据你的水平调整解释的深浅也会在回答里穿插追问。多轮对话、上下文感知这些都是基础真正的差异在于它随时可以调用工具——查资料、算题、跑代码——而不是只会动嘴。互动书籍把教材变成活的「活书」模式把章节内容变成可交互的模块可以插入测验卡片、动画视频、思维导图读到卡壳还能在页面旁边开小窗继续问。教材不再是静态 PDF而是边读边练边对话的学习现场。知识库你的第二大脑入口上传 PDF、Word、PPT、Markdown 都可以系统会做切分、向量化、建索引。底层可选 LlamaIndex、GraphRAG、LightRAG、PageIndex 等多种检索引擎甚至能直接挂一个 Obsidian 仓库。索引支持版本化管理更新之后随时可以回看历史出问题也不用整个重建。协同写作笔记和论文的战场左侧编辑、右侧实时预览Markdown 和 LaTeX 公式都是原生支持。写学习笔记、整理论文、和同学合写文档都比在纯文本编辑器里舒服得多。界面与多语言设置设置里可以切换中英文界面、选择多种主题、管理模型服务商连接。界面清爽参数不多日常用基本不用碰配置文件。让导师越用越懂你记忆、技能与AI伙伴装好、跑通之后才轮到 DeepTutor 真正的看家本领——个性化。它靠一套可见、可改的记忆机制来认识你而不是藏在黑箱里。三层记忆从流水账到知识图谱L1 工作区镜像如实记录你的每一次交互像一本学习流水账。L2 表面摘要给每个学习场景聊天、书籍、写作各自生成摘要方便定位。L3 跨表面合成把不同场景里的知识串成关联图谱回答时会引用证据来源。好处是透明你可以随时打开记忆图谱看 AI 是怎么理解你的哪里记歪了就手动改。这对教育场景特别重要——它敢把怎么猜你的过程摊给你看。技能与AI伙伴扩展能力的边界除了内置工具DeepTutor 还支持安装社区技能包也可以挂载 MCP 服务器来扩展工具集。更有意思的是伙伴机制把 Claude Code、Codex、Gemini 这类编程 CLI 接进来聊天中途就能请它们帮你跑代码、改项目。把 AI 伙伴接到 Discord、飞书、Slack 等渠道上让它常驻聊天群组7×24 小时响应。这些伙伴各自拥有独立的记忆和角色设定适合团队里挂几个专职助手一个答疑、一个整理资料、一个盯进度。团队场景多用户与权限隔离如果是学校、培训机构或公司内部使用多用户模式才是刚需。DeepTutor 的每个账号有完全隔离的工作区会话历史、知识库、记忆互不可见管理员可以按用户开放或收回某项能力比如谁能用知识库、谁能挂工具、谁能访问模型服务。数据访问做到了账号级隔离不会出现我看到了别人的笔记这种事故。想体验多用户在配置里开启认证与注册开关就能从单机个人模式切换到团队模式。常见问题与避坑清单装好后网页打不开确认终端打印的地址没输错默认 3782端口被占用时在deeptutor init里换个端口。提示 Python 版本不兼容官方支持 3.11–3.13太新或太旧都可能出问题。完全断网能用吗能。用 Ollama 跑本地模型配合预先把资料导进知识库断网状态下聊天、检索、做题都能正常运转。配置文件在哪工作区目录下的data/user/settings/模型、端口、功能开关都在这里改完重启生效。不想每次手动配模型跳过init直接start也行应用会用默认端口启动之后在设置 → 模型里补配即可。想进一步研究代码记忆系统的实现在 deeptutor/services/memory/知识库引擎在 deeptutor/knowledge/互动书籍的编译逻辑在 deeptutor/book/中文说明可以参考仓库里的 README.md。最后多说一句工具只是起点。DeepTutor 最值得玩味的地方是它把个性化从营销词变成了可查看、可编辑、可追溯的工程实现。装上它从一句帮我讲讲傅里叶变换开始剩下的就交给时间去验证它是不是真的懂你。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考