DeepTutor AI学习代理上手指南：从安装到生成第一本交互学习书的3个关键步骤

DeepTutor AI学习代理上手指南从安装到生成第一本交互学习书的3个关键步骤【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor当你想让 AI 基于自己上传的 50 页 PDF 讲义来答疑而不是只给泛泛的通用答案时DeepTutor 这类 AI 学习代理就是为此设计的一个开源的个性化学习平台能读你的资料、记住你的学习轨迹还能把笔记编译成带测验、动画的交互学习书。一句话说清它是谁DeepTutor 的定位是代理原生agent-native的学习工作区聊天、出题、深度研究、解题、可视化、掌握度练习全部跑在同一个智能体循环上切换的是目标而不是引擎。和常见工具的关键差异在于——维度通用 AI 问答在线课程平台DeepTutor知识来源模型记忆固定课程内容你上传的文档多引擎 RAG个性化无无三层可审计记忆 掌握度路径产出形态纯文本视频/课件交互书、测验、图表、动画扩展性封闭封闭工具、技能、CLI 应用、MCP 均可装装好之后它长什么样先看一眼默认主界面再走安装步骤。第一次运行5 分钟跑通 DeepTutor 安装教程前置要求Python 3.11–3.13 和 Node.js 20 在 PATH 里。推荐最短路径是 PyPI 安装无需克隆源码建一个专用工作目录所有配置、知识库、记忆都存在这里mkdir -p my-deeptutor cd my-deeptutor预期后续所有数据都落在该目录的data/下方便整体备份。安装pip install -U deeptutor预期装好后终端里出现deeptutor命令。初始化deeptutor init会依次询问后端端口默认 8001、前端端口默认 3782、LLM 提供商 / Base URL / API Key / 模型名以及可选的 embedding 提供商。 预期目录里生成data/user/settings/JSON/YAML 配置。跳过 init 也能启动但模型配置为空需要之后在网页 Settings → Models 里补。启动deeptutor start终端会打印前端地址默认http://127.0.0.1:3782init 时改过端口就以终端输出为准。 预期浏览器打开后是 Home 页中间显示 What would you like to learn?左侧边栏有 Partners、My Agents、Co-Writer、Book、Learning Space、Memory、Knowledge Center、Settings。输入框选 Chat 模式直接提问即可想停止时在该终端按CtrlC前后端一起停。如果你更习惯容器Docker 一条命令即可只需对外暴露 3782 一个端口前端会把/api/*和/ws/*转发到容器内后端docker run --rm --name deeptutor \ -p 127.0.0.1:3782:3782 \ -v deeptutor-data:/app/data \ ghcr.io/hkuds/deeptutor:latest首次启动时容器会创建配置模型提供商在网页 Settings 页配置配置、API Key、知识库都持久化在deeptutor-data卷里。容器场景更多细节反代、Podman、rootless见 CONTAINERIZATION.md。启动完成后接下来看四个真实用得最多的场景。场景 1用自己的资料喂给 AI答题才有根据个人使用什么时候用你在啃一门课或一套内部文档想问这份 PDF 里第 X 节的结论是什么而通用 AI 根本不知道你的材料。用哪个功能Knowledge Center知识库中心 Chat 的 RAG 工具。怎么操作侧边栏进 Knowledge Center点右上 New knowledge base上传文档PDF、DOCX、XLSX、PPTX、Markdown 等等待索引完成。回 Chat在输入框工具栏把该知识库挂为粘性上下文跨轮次生效直接提问。得到什么结果回答基于你的文档生成且 RAG 引用可回溯到具体出处。值得注意的是每个知识库可以绑定不同检索引擎——默认 LlamaIndex 是本地向量 BM25 混合开箱即用PageIndex、GraphRAG、LightRAG 等需要额外安装界面会直接标出 Not installed。一个知识库喂给聊天后如果材料比较多下一步可以考虑把它编译成一本书。场景 2把笔记变成可交互的活书个人使用什么时候用你有一堆知识库、笔记或历史对话希望整理成一套带章节、能自测的学习材料而不是一份静态 PDF。用哪个功能Book书。怎么操作侧边栏进 Book点 New book选择来源知识库 / 笔记 / 题库 / 聊天记录。创建流程会先给出章节大纲让你审阅确认结构后才开始生成内容——不是一键盲生成。生成后每个章节编译成类型化区块正文、提示框、测验、闪卡、时间线、代码、交互 HTML、数学动画、概念图谱等每个页面还带独立的 Page Chat可以就着当页追问。得到什么结果一块内容不满意可以单独插入、移动、重新生成甚至切换区块类型比如把一段文字换成测验卡片不用重写整章。适合把学过变成能测、能动、能再问。书和知识库解决了学什么下一个场景解决在哪儿学——把导师搬进你的 IM。场景 3把导师接进飞书/钉钉随时能问团队/移动场景什么时候用你想在通勤路上用飞书、钉钉或 Telegram 直接问学习问题而不是每次都打开网页。用哪个功能Partners伙伴。Partner 是一个有独立人格SOUL.md、独立记忆、独立知识库的常驻伙伴网页聊天和 IM 消息对它就是同一条智能体循环——官方说法是一个有人格和电话号码的聊天。怎么操作侧边栏进 Partners点 New partner起名并设定人设。在 deeptutor/partners/channels/ 对应的渠道配置里填入平台凭据飞书、钉钉、Telegram、Slack、Discord、QQ、企业微信、Matrix、Mattermost 等视已安装的 extras 而定IM 渠道 SDK 通过pip install -e .[partners]安装。在 IM 里给这个 Partner 发消息。得到什么结果回复以流式方式推送到 IM且 Partner 能用自己的知识库和记忆作答它还能作为 subagent 被普通聊天中的consult_subagent工具实时咨询。DeepTutor Partners 伙伴列表界面展示多个已创建伙伴及其 IM 渠道连接状态以上是人用 DeepTutor最后一类用法是让别的程序用 DeepTutor。场景 4让 CLI 和另一个 Agent 驱动 DeepTutor二次开发什么时候用你想在自己的自动化流程、LangChain/AutoGen 循环或 Claude Code / Codex 里把 DeepTutor 当一个可调用的学习引擎。用哪个功能deeptutorCLI 技能系统。怎么操作单轮执行deeptutor run deep_solve Find d/dx[sin(x^2)] --tool reason --format json。加--format json后每轮输出 NDJSON 事件流content、tool_call、tool_result、done每行带session_id方便捕获会话 id 连续多轮。装社区技能deeptutor skill search socratic tutor然后deeptutor skill install socratic-tutor默认从 EduHub 拉取带安全校验门。技能在网页端 Learning Space → Skills 里同样可见、可导入。仓库根目录的 SKILL.md 是一份约 150 行的交接文档教任意会用工具的 LLM 如何操作整个 DeepTutor 表面可以直接喂给 Claude Code 或 Codex。得到什么结果Web 端有的能力kb、session、partner、skill、notebook、memory、configCLI 都有ask_user在无终端环境下会自动空回复而不是挂起对无头运行友好。多人共享部署则打开data/user/settings/auth.json的认证开关第一个注册用户成为管理员其余用户各自隔离工作区、按授权看到被分配的模型/知识库/技能。场景都讲完了花两分钟看看它底层是怎么转的不想看可以直接跳到 FAQ。原理速览非技术读者可跳过DeepTutor 的所有模式Chat、Quiz、Research、Solve、Mastery Path 等共享同一个代理循环模型按思考 → 调工具 → 观察结果 → 回应多轮推进知识库、记忆、人设等上下文统一注入工具RAG、记忆读写、网页抓取、代码执行、MCP按需挂载。记忆刻意做成可读的三层文件而非黑盒向量库L1 是原始事件轨迹L2 是按场景整理的事实L3 是跨场景综合上层引用下层任何一条它为什么这么认为都能追溯回原始记录。整体分层如下DeepTutor 系统架构图展示入口层、运行时编排、代理核心能力与工具、服务层与数据配置层新手高频问题现象 1deeptutor start后浏览器打不开页面连接被拒绝。原因访问的端口不对。前端默认端口是 3782但 init 时如果改过实际端口以终端打印的 URL 为准端口被占用时启动也会失败。 解法以终端输出的地址为准确认该端口没被其他程序占用CtrlC停掉后重启Docker 场景确认-p 127.0.0.1:3782:3782左侧的宿主机端口没有冲突改端口时左右两侧要同步改。现象 2页面能打开提问后没反应或提示模型未配置。原因跳过了 initmodel_catalog.json里没有任何 LLM profile。 解法网页 Settings → Models 里新增一条 profileBase URL / API Key / 模型名保存即生效只想用知识库 RAG 的话还需要单独加一条 embedding profile否则建库时会卡住。现象 3文档上传后解析失败整个知识库报错。原因选用的解析引擎处理不了该文档格式。解析引擎在 Settings → Knowledge Base 里选Text-only、MinerU、Docling、markitdown、PyMuPDF4LLM 等不是每种格式都通吃。 解法v1.5.1 起支持单独移除一份出错的文档不用删库重建换个引擎重新解析或对扫描件类文档改用 MinerU 这类 OCR 引擎。现象 4Docker 部署后连不上宿主机上的 Ollama。原因容器里的localhost指向容器自己不是你的机器。 解法启动时加--add-hosthost.docker.internal:host-gatewayDocker Desktop 通常自动解析Linux 需要此参数然后把 Settings 里 Base URL 写成http://host.docker.internal:11434/v1embedding 为.../api/embed。现象 5Knowledge Center 里 GraphRAG / LightRAG 显示 Not installed。原因这两个引擎是可选依赖默认不带。 解法从源码安装时分别执行pip install -e .[graphrag]或pip install -e .[lightrag]GraphRAG 建索引较耗 LLM 资源按需选择。依赖清单可对照 requirements/ 目录。适合谁不适合谁适合有自己学习资料讲义、论文、内部文档想让 AI 基于它作答的人想把笔记沉淀成带测验和交互的学习书的人小团队想部署一套按用户隔离的学习实例的人以及想把导师嵌进自己 Agent 流程的开发者。不适合想零部署注册即用、或只是偶尔问一两个通用问题的人——那用任意聊天机器人更省事本地跑大模型、不想买 API Key 的人也建议先用云端模型验证流程再考虑本地化。想动手试的话项目仓库在 GitCode 上git clone https://gitcode.com/GitHub_Trending/dee/DeepTutor然后按第一次运行一节从源码安装需要 Node.js 22 与 Python 3.11–3.13流程见 README.md 的 Option 2。贡献规范在 CONTRIBUTING.md问题可以直接提 issue。【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考