企业官网建设流程全解析

3 条命令完成 DeepTutor 本地部署：零基础安装完整教程与高频报错一次讲清

【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor

DeepTutor 是个 agent 原生的个性化学习平台，把答疑、解题、研究报告和知识库装进同一个本地工作区。这里只讲 DeepTutor 部署、启动和排错三件事，跑通为止。

装完就能用：3 条命令跑通 DeepTutor 安装 🚀

（前提：Python 3.11–3.14、Node.js 20+，两者都装好再往下走）

pip install -U deeptutor # 安装 DeepTutor 本体，Web 应用和 CLI 一起装齐 deeptutor init # 交互式配置端口、LLM 提供商和模型 deeptutor start # 同时拉起前后端，这个终端保持开着

deeptutor init会依次问你三件事：后端端口（默认 8001）、前端端口（默认 3782）、LLM 提供商（Base URL / API Key / 模型名），知识库要用的嵌入模型可以之后再补。deeptutor start跑起来后，浏览器打开 http://127.0.0.1:3782，看到带"How can I help you today?"输入框的 Home 界面就成功了；想停下来，在那个终端按Ctrl+C，前后端一起停。

init 也可以跳过：不配置也能以默认端口和空白模型先跑起来，之后在网页 Settings → Providers 里补模型即可，适合先看看界面再说。

另外三条路一句话带过：源码安装（clone https://gitcode.com/GitHub_Trending/dee/DeepTutor 后pip install -e .，想改代码才选它）、Docker（一个容器跑完整个应用，只发布 3782 一个端口）、纯 CLI（只装终端对话、不要网页），细节看 README.md。

一个引擎，七件事

• Chat→ 默认入口，多轮对话、自动调工具、读你挂载的上下文 → 日常提问与讨论
• Deep Solve→ 分步推导式解题 → 数学题、代码排查
• Deep Research→ 多代理协作调研报告，自动带引用 → 文献综述、技术选型
• Visualize→ 输出图表、流程图和交互演示 → 把结论画出来给人看
• Question→ 按知识点出题并批改 → 学完一轮自我检验
• Book→ 把资料编译成带测验和交互块的"活教材" → 整理课程资料
• Co-Writer→ 分屏 Markdown 写作，支持选中改写 → 写笔记、报告初稿

七个模式共用同一个对话引擎，切换的是目标不是工具，上下文跟着你走。

让 AI 真正记住你的资料：知识库与三层记忆

建知识库前先选检索引擎：LlamaIndex（默认，本地向量 + BM25）、PageIndex、GraphRAG / LightRAG（知识图谱路线）、LightRAG Server，还能直接链接一个现成的 Obsidian 库。引擎在建库时定死，之后不能换，选之前想清楚。日常两条命令就够：

deeptutor kb create my-kb --doc 线性代数教程.pdf # 建库并放入第一篇文档 deeptutor kb search "特征值" --kb my-kb # 直接检索

记忆走的是单向引用链：L1 是只增不减的原始事件流水，L2 按表面（聊天、笔记本、测验、知识库等）整理成事实文档，L3 是跨表面综合画像，上层只引下层，所以任何一条"AI 认为你懂什么"的结论都能一路回溯到原始事件。记忆图谱界面把三层画成金字塔，点任何节点都能跳到它的证据；命令行里deeptutor memory show直接看 L2 / L3 文档，deeptutor memory clear清理。

两个容易踩的点：重新索引会写出version-N新目录，正在用的旧索引原样保留，不会中途损坏；某篇文档解析失败，单独删掉那一篇即可，不用推倒整个库重建。解析引擎（MinerU、Docling、PyMuPDF4LLM 等）在 Settings → Knowledge Base 里选。

把多个代理拉进同一个对话

My Agents把你机器上现成的编程 CLI（Claude Code、Codex、Gemini、Kimi、opencode、MiMo 等）接进来，对话里用@或 Agent 标签选中它，DeepTutor 会真的把那个代理跑起来，过程流式显示在 Activity 面板里。它还能把 Claude Code、Codex 的历史对话导入成可搜索、可续聊的代理，在任意一轮对话里当第三方材料引用。

Partners是持久化的角色伙伴：有自己的 SOUL.md、模型策略和私有记忆，能挂到飞书、Telegram、Slack、Discord、钉钉、微信生态等 15 个 IM 渠道上长期运行，消息进来走的还是同一套对话引擎。渠道相关的依赖属于可选包，需要时补装：

pip install -e ".[partners]" # 补装 Partners 的 IM 渠道 SDK

DeepTutor Partners 多代理协作对话界面

四个高频坑，对号入座 🛠

想完全离线的本地模型配置，选 Ollama 就行：ollama serve跑起来后，Base URL 填http://localhost:11434/v1（/v1别漏）。常见报错基本逃不出这四个：

1. 打开 3782 显示别的网站→ 前端端口被占 → 重跑deeptutor init换个端口，或直接改system.json里的端口字段
2. 安装时报 "Requires a different Python"→ Python 版本不在 3.11–3.14 区间 → 换到 3.11–3.14 再装
3. 文档入库一直报错→ 解析引擎没选对，或嵌入模型缺失 → Settings → Knowledge Base 里换解析引擎，确认嵌入模型已配置并可用
4. Docker 里连不上宿主机的 Ollama→ 容器内的localhost是容器自己，不是宿主机 → Base URL 写host.docker.internal，Linux 上启动时再加--add-host=host.docker.internal:host-gateway

命令行能力全貌看仓库根目录的 SKILL.md，把 CLI 的全部操作一页讲完。

下一步

打开 http://127.0.0.1:3782，问它第一道题。想边改前端边看热更新，就用deeptutor start --dev起调试模式。

【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor