DeepTutor：原生智能体个性化辅导

功能特性 · 快速开始 · 探索 · TutorBot · CLI · 多用户 · 社区

---

📦 版本发布

[2026.5.22] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.0 — v1.4正式发布版本：自动模式、三层记忆、智能体化深度研究/解决/提问、LlamaIndex RAG重构、可视化/动画器合并，以及推理努力标准化、工具模式回退和重启安全的轮次运行时。

[2026.5.21] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.0-beta — 三层记忆工作台（L1/L2/L3），所有聊天功能基于单一智能体引擎重建，仅LlamaIndex的RAG，以及统一的设置+功能界面。

[2026.5.10] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.10 — 远程Docker CORS恢复、跨SDK提供商的DISABLE_SSL_VERIFY、更安全的代码块引用，以及可选的Matrix E2EE附加组件。

[2026.5.9] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.9 — TutorBot Zulip和NVIDIA NIM支持、更安全的思考模型路由、deeptutor start、侧边栏工具提示，以及会话存储一致性。

历史版本（超过2周前）

[2026.5.8] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.8 — 具有隔离用户工作区的可选多用户部署、管理员权限、认证路由和范围化运行时访问。

[2026.5.4] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.7 — 思考模型/提供商修复、可见的知识库索引历史，以及更安全的协作者（Co-Writer）清除/模板编辑。

[2026.5.3] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.6 — 基于目录的聊天和TutorBot模型选择、更安全的RAG重新索引、OpenAI响应令牌限制修复，以及技能编辑器验证。

[2026.5.2] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.5 — 更流畅的本地启动设置、更安全的RAG查询、更清晰的本地嵌入认证，以及设置深色模式优化。

[2026.5.1] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.4 — 书籍页面聊天持久性和重建流程、聊天到书籍引用、更强的语言/推理处理、RAG文档提取强化。

[2026.4.30] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.3 — NVIDIA NIM + Gemini嵌入支持、统一的聊天历史/技能/记忆空间上下文、会话快照、RAG重新索引恢复能力。

[2026.4.29] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.2 — 透明的嵌入端点URL、针对无效持久向量的RAG重新索引恢复能力、思考模型输出的内存清理、深度解决（Deep Solve）运行时修复。

[2026.4.28] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.1 — 稳定性：更安全的RAG路由和嵌入验证、Docker持久性、IME安全输入、Windows/GBK鲁棒性。

[2026.4.27] https://github.com/HKUDS/DeepTutor/releases/tag/v1.3.0 — 带重新索引工作流的版本化知识库索引、重建的知识工作区、具有新适配器的嵌入自动发现、空间中心（Space hub）。

[2026.4.25] https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.5 — 带文件预览抽屉的持久聊天附件、附件感知功能管道、TutorBot Markdown导出。

[2026.4.25] https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.4 — 文本/代码/SVG附件、一键式设置向导（Setup Tour）、Markdown聊天导出、紧凑的知识库管理界面。

[2026.4.24] https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.3 — 文档附件（PDF/DOCX/XLSX/PPTX）、推理思考块显示、灵魂模板（Soul template）编辑器、协作者（Co-Writer）保存到笔记本。

[2026.4.22] https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.2 — 用户编写的技能系统、聊天输入性能全面改进、TutorBot自动启动、书籍库界面、可视化全屏。

[2026.4.21] https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.1 — 每阶段令牌限制、所有入口点的重新生成响应（Regenerate response）、RAG和Gemma兼容性修复。

[2026.4.20] https://github.com/HKUDS/DeepTutor/releases/tag/v1.2.0 — 书籍引擎（Book Engine）“活书”编译器、多文档协作者（Co-Writer）、交互式HTML可视化、问题库@提及。

[2026.4.18] https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.2 — 基于模式的频道（Channels）标签页、RAG单管道整合、外部化聊天提示。

[2026.4.17] https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.1 — 通用“立即回答（Answer now）”、协作者（Co-Writer）滚动同步、统一设置面板、流式停止按钮。

[2026.4.15] https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.0 — LaTeX块数学全面改进、LLM诊断探针、Docker + 本地LLM指南。

[2026.4.14] https://github.com/HKUDS/DeepTutor/releases/tag/v1.1.0-beta — 可收藏会话、雪花主题（Snow theme）、WebSocket心跳和自动重连、嵌入注册表全面改进。

[2026.4.13] https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.3 — 带书签和类别的问题笔记本、可视化（Visualize）中的Mermaid、嵌入不匹配检测、Qwen/vLLM兼容性、LM Studio和llama.cpp支持，以及玻璃主题（Glass theme）。

[2026.4.11] https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.2 — 带SearXNG回退的搜索整合、提供商切换修复，以及前端资源泄漏修复。

[2026.4.10] https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.1 — 可视化功能（Visualize capability）（Chart.js/SVG）、测验重复预防，以及o4-mini模型支持。

[2026.4.10] https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.4 — 带速率限制重试的嵌入进度跟踪、跨平台依赖修复，以及MIME验证修复。

[2026.4.8] https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.3 — 原生OpenAI/Anthropic SDK（移除litellm）、Windows数学动画器（Math Animator）支持、健壮的JSON解析，以及完整中文国际化（i18n）。

[2026.4.7] https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.2 — 热设置重载、MinerU嵌套输出、WebSocket修复，以及Python 3.11+最低要求。

[2026.4.4] https://github.com/HKUDS/DeepTutor/releases/tag/v1.0.0-beta.1 — 原生智能体架构重写（约20万行）：工具+功能插件模型、CLI和SDK、TutorBot、协作者（Co-Writer）、引导式学习（Guided Learning），以及持久记忆。

📰 新闻

[2026.5.22] 🌐 我们的官方文档网站已上线：deeptutor.info — 指南、参考资料和功能导览一应俱全。

[2026.4.19] 🎉 111天后，我们的星标数达到了20k！感谢大家的大力支持——我们将持续迭代，致力于为每个人提供真正个性化、智能化的辅导体验。

[2026.4.10] 📄 我们的论文已在arXiv上线！阅读预印本了解DeepTutor背后的设计理念和思路。

[2026.4.4] 好久不见！✨ DeepTutor v1.0.0终于发布——这是一次原生智能体的进化，包括全新架构重写、TutorBot以及Apache-2.0许可下的灵活模式切换。新的篇章已经开启，我们的故事继续！

[2026.2.6] 🚀 仅用39天，我们的星标数就达到了10k！非常感谢了不起的社区给予的支持！

[2025.12.29] DeepTutor正式发布！

选项 3 — Docker

完整Web应用的单容器方案。镜像位于GitHub Container Registry：

• ghcr.io/hkuds/deeptutor:latest — 稳定版
• ghcr.io/hkuds/deeptutor:pre — 预发布版（如有）

docker run --rm --name deeptutor \
-p 127.0.0.1:3782:3782 \
-p 127.0.0.1:8001:8001 \
-v deeptutor-data:/app/data \
ghcr.io/hkuds/deeptutor:latest

[!WARNING] 需同时映射 3782 和 8001 端口。3782 用于提供Web UI；8001 是FastAPI后端，浏览器会直接调用该端口——容器内无代理。若跳过 8001 映射，页面虽能加载，但设置会显示“后端不可达”且无法使用。

打开 [***] /app/data/user/settings/*.json；可从Web设置页面配置模型提供商。配置、API密钥、日志、工作区文件、记忆和知识库均持久化存储在 deeptutor-data 卷中。

• 不同主机端口：修改每个 -p host:container 映射的左侧部分（例如 -p 127.0.0.1:8088:3782）。若在 /app/data/user/settings/system.json 中修改了容器侧端口，需重启容器并更新映射右侧部分以保持一致。
• 后台运行：添加 -d 参数，然后使用 docker logs -f deeptutor 跟踪日志，docker stop deeptutor 停止容器，重用名称前需执行 docker rm deeptutor。deeptutor-data 卷会在重启间保留您的设置和工作区。

连接主机上的Ollama / LM Studio / llama.cpp / vLLM

在Docker内部，localhost 指容器本身，而非您的主机。要访问主机上运行的模型服务，建议使用主机网关：

docker run --rm --name deeptutor \
-p 127.0.0.1:3782:3782 -p 127.0.0.1:8001:8001 \
--add-host=host.docker.internal:host-gateway \
-v deeptutor-data:/app/data \
ghcr.io/hkuds/deeptutor:latest

然后在设置 → 模型中，将提供商的基础URL指向 host.docker.internal：

• Ollama LLM：http://host.docker.internal:11434/v1
• Ollama 嵌入：http://host.docker.internal:11434/api/embed
• LM Studio：http://host.docker.internal:1234/v1
• llama.cpp：http://host.docker.internal:8080/v1

Docker Desktop（macOS/Windows）通常无需 --add-host 即可解析 host.docker.internal。在Linux上，该标志是在现代Docker Engine上创建该主机名的可移植方式。

🌐 Space — 个人学习图书馆

Space 是活跃界面的 阅读/复习 对应模块。如果说 Chat / Co-Writer / Book 是你的 创作 场所，那么 Space 就是所有创作内容的存放地，支持搜索和回放。

• 聊天历史 — 所有模式下的每一次对话，支持重命名标题、删除和继续；每个入口点都支持删除单个对话轮次。
• 笔记本 — 将 Chat、Research 和 Co-Writer 的输出保存到分类的、彩色编码的笔记本中；每条记录都链接回原始会话和界面。
• 题库 — 所有自动生成的测验问题，可添加书签并在聊天中通过 @ 提及，以便分析过往表现。
• 技能 — 用户编写的 SKILL.md 文件，用于定义教学角色（名称、描述、触发条件、内容）。激活后，技能会注入聊天系统提示中 — 将 DeepTutor 转变为苏格拉底式导师、研究助手或任何你设计的角色。

🦞 TutorBot — 持久化、自主化AI导师

TutorBot 不是聊天机器人——它是一个基于 https://github.com/HKUDS/nanobot 构建的持久化、多实例智能体。每个 TutorBot 运行独立的智能体循环，拥有独立的工作空间、内存和个性。你可以创建苏格拉底式数学导师、耐心的写作教练和严谨的研究顾问——所有这些都能同时运行，每个都随你一起成长。

• 灵魂模板 — 通过可编辑的灵魂文件定义导师的个性、语气和教学理念。从内置原型（苏格拉底式、鼓励式、严谨式）中选择，或创建自己的模板——灵魂塑造每一次回应。
• 独立工作空间 — 每个机器人都有自己的目录，包含独立的内存、会话、技能和配置——完全隔离，同时能够访问 DeepTutor 的共享知识层。
• 主动心跳机制 — 机器人不只是被动响应——它们会主动发起互动。内置的心跳系统支持定期学习检查、复习提醒和计划任务。即使你没有主动联系，导师也会主动出现。
• 完整工具访问 — 每个机器人都能使用 DeepTutor 的全套工具：RAG 检索、代码执行、网络搜索、学术论文搜索、深度推理和头脑风暴。
• 技能学习 — 通过向机器人的工作空间添加技能文件，教它新能力。随着你的需求变化，导师的能力也会随之进化。
• 多渠道存在 — 将机器人连接到 、、Slack、飞书、企业微信、钉钉、Matrix、QQ、***、电子邮件等。导师会在你所在的任何平台与你见面。
• 团队与子智能体 — 生成后台子智能体，或在单个机器人内编排多智能体团队，以处理复杂、长期运行的任务。

deeptutor bot create math-tutor --persona "Socratic math teacher who uses probing questions"
deeptutor bot create writing-coach --persona "Patient, detail-oriented writing mentor"
deeptutor bot list # 查看所有活跃导师

---

⌨️ DeepTutor CLI — 智能体原生界面

DeepTutor 完全基于 CLI。所有功能、知识库、会话、内存和 TutorBot 都只需一个命令即可访问——无需浏览器。CLI 同时服务于人类（提供丰富的终端渲染）和 AI 智能体（提供结构化 JSON 输出）。

将项目根目录下的 SKILL.md 交给任何使用工具的智能体（https://github.com/HKUDS/nanobot 或任何具有工具访问权限的 LLM），它就能自主配置和操作 DeepTutor。

示例命令——单次运行、REPL、知识库生命周期、JSON 输出、会话恢复

单次执行 — 直接从终端运行任何功能：

deeptutor run chat "Explain the Fourier transform" -t rag --kb textbook
deeptutor run deep_solve "Prove that √2 is irrational" -t reason
deeptutor run deep_question "Linear algebra" --config num_questions=5
deeptutor run deep_research "Attention mechanisms in transformers"
deeptutor run visualize "Draw the architecture of a transformer"

交互式 REPL — 具有实时模式切换的持久聊天会话：

deeptutor chat --capability deep_solve --kb my-kb
# 在 REPL 中：/cap、/tool、/kb、/history、/notebook、/config 可实时切换

知识库生命周期 — 完全从终端构建、查询和管理 RAG 就绪的集合：

deeptutor kb create my-kb --doc textbook.pdf # 从文档创建
deeptutor kb add my-kb --docs-dir ./papers/ # 添加论文文件夹
deeptutor kb search my-kb "gradient descent" # 直接搜索
deeptutor kb set-default my-kb # 设置为所有命令的默认知识库

双输出模式 — 为人类提供丰富渲染，为管道提供结构化 JSON：

deeptutor run chat "Summarize chapter 3" -f rich # 彩色格式化输出
deeptutor run chat "Summarize chapter 3" -f json # 行分隔 JSON 事件

会话连续性 — 从上次中断的地方恢复任何对话：

deeptutor session list # 列出所有会话
deeptutor session open # 在 REPL 中恢复

完整 CLI 命令参考

顶层命令

deeptutor bot

deeptutor kb

deeptutor memory

deeptutor session

deeptutor notebook

deeptutor book

deeptutor config / plugin / provider

---

👥 多用户 — 带用户隔离工作区的共享部署

启用认证后，DeepTutor 会转变为多租户部署，具备用户隔离工作区和管理员管理资源功能。首位注册用户将成为管理员，代表其他用户配置模型、API 密钥和知识库。后续账户需由管理员创建（仅邀请制），每个账户拥有独立的聊天历史/记忆/笔记本/知识库，且只能看到管理员分配的 LLM、知识库和技能。

快速开始（5 步）：

# 1. 在 data/user/settings/auth.json 中启用认证：
# {"enabled": true, "token_expire_hours": 24, "cookie_secure": false}

# 2. 重启 Web 服务栈。
deeptutor start

# 3. 打开 http://localhost:3782/register 创建首个账户。
# 首次注册是唯一公开注册；该用户将成为管理员，之后 /register 端点会自动关闭。

# 4. 以管理员身份导航至 /admin/users → "添加用户" 为团队成员创建账户。

# 5. 为每个用户点击滑块图标 → 分配 LLM 配置文件、知识库和技能。保存后，用户即可登录开始使用。

管理员可见内容：

• 完整设置页面（位于 /settings）— 管理 LLM/嵌入/搜索提供方、API 密钥、模型目录及运行时“应用”操作。
• 用户管理（位于 /admin/users）— 创建、提升、降级和删除账户。首个管理员创建后，公开 /register 端点会自动关闭；后续账户需通过 POST /api/v1/auth/users（仅管理员可用）创建。
• 权限分配 — 为每个非管理员用户选择其可使用的模型配置文件、知识库和技能。权限仅包含逻辑 ID；API 密钥绝不会跨权限边界共享。
• 审计跟踪 — 所有权限变更和资源访问记录会追加至 multi-user/_system/audit/usage.jsonl。

普通用户权限：

• 隔离工作区（位于 multi-user/<username>/）— 包含个人聊天历史（chat_history.db）、记忆（SUMMARY.md / PROFILE.md）、笔记本和个人知识库。默认无共享内容。
• 只读访问 — 管理员分配的知识库和技能会在个人资源旁显示，并带有“管理员分配”标记。
• 精简设置页面 — 仅显示主题、语言和已分配模型摘要。非管理员请求绝不会返回 API 密钥、基础 URL 和提供方端点。
• 限定 LLM — 聊天轮次通过管理员分配的模型路由。若未分配 LLM，轮次会直接被拒绝（不会静默回退至管理员密钥）。

工作区布局：

multi-user/
├── _system/
│ ├── auth/users.json # 哈希凭证、角色
│ ├── auth/auth_secret # JWT 签名密钥（自动生成）
│ ├── grants/<user_id>.json # 每用户资源权限（管理员管理）
│ └── audit/usage.jsonl # 审计跟踪
└── <username>/
├── user/
│ ├── chat_history.db
│ ├── settings/interface.json
│ └── workspace/{chat,co-writer,book,...}
├── memory/{SUMMARY.md,PROFILE.md}
└── knowledge_bases/...

配置参考：

[!WARNING] PocketBase 模式（integrations.pocketbase_url 已设置）仅支持单用户。 默认 PocketBase 架构的 users 表无 role 字段（所有登录用户角色均为 user，无法创建管理员），且 sessions/messages/turns 查询未按 user_id 过滤。多用户部署必须保持 integrations.pocketbase_url 为空，并使用默认 JSON/SQLite 后端。

[!WARNING] 推荐单进程部署。 “首用户成为管理员”的晋升逻辑受进程内 threading.Lock 保护。多工作节点部署应离线配置首个管理员（先设置 auth.json.enabled=false，通过引导流程注册管理员，再设置 auth.json.enabled=true），或使用外部系统作为用户存储后端。

🌐 社区与生态系统

DeepTutor 基于优秀开源项目构建：

HKUDS 生态系统相关项目：

|:---:|:---:|:---:|:---:| | 简单快速的 RAG | 零代码智能体框架 | 自动化研究工具 | 超轻量级 AI 智能体 |

🤝 贡献指南

我们希望 DeepTutor 能成为社区的一份礼物。🎁

详见 CONTRIBUTING.md 了解开发环境搭建、代码规范和拉取请求流程指南。

⭐ 星标历史

https://github.com/HKUDS

---

根据 Apache License 2.0 许可。