ghcr.io/hkuds/deeptutor:1.4.15

DeepTutor：终身个性化辅导

功能特性 · 快速开始 · 探索DeepTutor · 命令行界面 · 生态系统 · 社区

---

📦 版本发布

[2026.7.9] https://github.com/HKUDS/DeepTutor/releases/tag/v1.5.1 — 从知识库中移除单个失败文档（即使是处于错误状态的文档），无需删除并重建整个知识库。

[2026.7.4] https://github.com/HKUDS/DeepTutor/releases/tag/v1.5.0 — LlamaIndex 数据摄入现在支持文档解析引擎的多模态图像提取，Partner 和 Soul ID 对非拉丁名称保持 URL 安全，且可选的 RAG 扩展组件可在 Python 3.14+ 上干净安装。

历史版本（超过1周前）

[2026.6.30] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.15 — 为 Partners 提供原生 Mattermost 频道，修复引导式学习选择题的评分问题，并确保配置的零块重叠设置生效。

[2026.6.29] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.14 — 点击已分配的 partner 即可一步发起聊天，深度研究功能标记部分报告，LightRAG 可在无 MinerU 的情况下建立索引，FAISS 支持非 ASCII 路径，PocketBase 会话按用户隔离。

[2026.6.27] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.13 — Partners 支持非拉丁名称并可分配给用户，登录后正确显示徽标（#599），小型知识库检索更可靠，容器可在无根 Podman 环境下干净启动。

[2026.6.24] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.12 — 新增 LightRAG Server 检索引擎、轻量级 PyMuPDF4LLM 解析引擎，以及 FAISS 向量后端，大幅提升大型知识库的检索速度。

[2026.6.23] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.11 — 原生工具调用支持所有兼容 OpenAI 的云服务提供商，重新设计的管理员用户页面，测验选项支持 LaTeX，真实的会话加载 spinner，以及可配置的容器主机绑定。

[2026.6.21] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.10 — 带头像的自助式个人资料页面，支持无根容器的单端口请求时代理指南，以及非管理员用户默认禁用的 MCP 工具。

[2026.6.19] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.9 — 设置优化：搜索仅显示提供商所需的字段，连接配置文件可重命名并按提供商自动命名，掌握路径中已评分的问题会流入题库。

[2026.6.18] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.8 — 在我的代理下连接自己的Partners，并在聊天中实时咨询——它们通过自身角色、库和技能进行回答——每个 Partner 拥有独立的私有记忆。

[2026.6.18] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.7 — 连接本地Claude Code / Codex并在对话过程中实时咨询，我的代理升级为顶级 /agents 路径，Partner 对话支持分支/恢复/删除功能及可回放轨迹。

[2026.6.17] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.6 — 四界面整合：带可导入我的代理和顶级记忆的空间学习仪表板，集成 GraphRAG / PageIndex / LightRAG / 关联知识库 / Obsidian 的知识中心，开放的设置界面，以及按模型的能力限制。

[2026.6.14] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.5 — 基于聊天代理循环重构的引导式学习（含严格的按类型掌握关卡和 /learning 仪表板），新的循环插件框架，以及 Partner 对话的 Markdown 导出/保存到笔记本功能。

[2026.6.13] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.4 — 通过安全门使用 deeptutor skill install 从 ClawHub 安装社区技能，以及知识库文件的浏览器内 DOCX/XLSX 预览。

[2026.6.12] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.3 — TutorBot 升级为生产级即时通讯管道（15个频道，实时流）上的Partners，聊天迁移至单一代理循环，实现真实的每用户隔离，以及重构的可视化功能。

[2026.5.28] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.2 — 稳定性与优化：Gemini 2.5+ 在可视化和聊天中全面支持，身份验证路由修复（#485），流畅流聊天用户体验，最近侧边栏，以及 Lemonade 本地提供商支持。

[2026.5.27] https://github.com/HKUDS/DeepTutor/releases/tag/v1.4.1 — 安全性与稳定性：TutorBot 工具沙箱锁定，每用户资源隔离，多模态图像回退，TutorBots 的 HTTP/SSE API，以及 v1.4.0 聊天回归修复。

[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 端到端加密插件。

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

[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 — 思考模型/提供商修复，可见的知识索引历史，以及更安全的协作者清除/模板编辑。

[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-05-22 🌐 官方文档网站已上线，地址：deeptutor.info — 一站式提供指南、参考资料和功能导览。
• 2026-04-19 🎉 111天内获得20k星标！感谢您对真正个性化、智能化辅导的支持。
• 2026-04-10 📄 我们的论文已在arXiv上线 — 阅读https://arxiv.org/abs/2604.26962%E4%BA%86%E8%A7%A3DeepTutor%E8%83%8C%E5%90%8E%E7%9A%84%E8%AE%BE%E8%AE%A1%E4%B8%8E%E7%90%86%E5%BF%B5%E3%80%82
• 2026-02-06 🚀 仅39天内获得10k星标！衷心感谢我们了不起的社区。
• 2025-12-29 🎓 DeepTutor正式发布！

Option 3 — Docker · 一个独立容器

一个容器包含完整Web应用。镜像位于GitHub Container Registry：

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

[!NOTE] 有关podman/无root权限/只读根文件系统部署及完整安装指南，请参见 CONTAINERIZATION.md。

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

只需发布3782端口。 浏览器仅与前端源通信；Next.js中间件（web/proxy.ts）会将/api/*和/ws/*请求转发到容器内的FastAPI后端。发布8001端口（-p 127.0.0.1:8001:8001）为可选操作，仅在需要通过curl或脚本直接调用API时有用。

打开 [***]

• 不同主机端口：修改每个-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卷会在重启间保留您的设置和工作区。

远程Docker / 反向代理：浏览器仅与前端源（:3782）通信；容器内的Next.js中间件会将/api/*和/ws/*请求转发到后端服务。对于常见的单容器场景，无需配置API基础地址——只需将反向代理/TLS终止器指向:3782即可。仅在拆分部署（后端位于单独容器/主机）时需要API基础地址：在data/user/settings/system.json中设置next_public_api_base为前端服务器用于访问后端的网络内地址（该地址在服务器端读取，不会发送到浏览器）。

{
  "next_public_api_base": "http://backend:8001"
}

next_public_api_base_external（及其别名public_api_base）可作为低优先级备选。CORS使用前端源而非API URL。禁用身份验证时，DeepTutor默认允许常规HTTP/HTTPS浏览器源。启用身份验证时，需添加确切的前端源：

{
  "cors_origins": ["https://deeptutor.example.com"]
}

代码执行沙箱（办公技能）· 运行模型生成的 docx / pdf / pptx / xlsx 代码

内置办公技能——docx / pdf / pptx / xlsx——的工作原理是让模型编写一个简短的 Python 脚本（python-docx、reportlab、openpyxl 等），通过 exec / code_execution 工具运行该脚本，并返回下载 URL。只要沙箱后端处于活动状态，这些工具就会挂载，而在所有部署形态中，沙箱后端默认处于活动状态：

• 本地（选项 1 / 2）和 Docker（选项 3，单容器）：受限的子进程沙箱运行模型代码（本地部署时在主机上，Docker 部署时在容器内——容器本身就是隔离边界）。
• docker-compose：通过 DEEPTUTOR_SANDBOX_RUNNER_URL 将代码路由到经过强化、权限最小的运行器边车（Dockerfile.runner）——这是安全性最强的方式，当边车存在时会自动优先使用。

子进程沙箱由 data/user/settings/system.json 中的 sandbox_allow_subprocess 设置控制（默认值为 true）。在主机上运行模型生成的代码是一个实际的信任决策——将其设置为 false（或导出 DEEPTUTOR_SANDBOX_ALLOW_SUBPROCESS=0）可禁用主机端执行，但代价是办公技能将无法再生成文件。

📚 Knowledge Center — Multi-Engine RAG Libraries

知识库是RAG背后的文档集合——它们为聊天轮次、协作者编辑、书籍生成和伙伴对话提供基础。其独特之处在于检索引擎的选择：LlamaIndex（默认选项，本地向量+BM25）、PageIndex（托管式，支持页面级引用的推理检索）、GraphRAG和LightRAG（知识图谱检索）、LightRAG Server（检索任务卸载到通过HTTP连接的外部LightRAG实例），或链接的Obsidian库（导师可直接读写）。每个知识库（KB）绑定一个引擎。

创建知识库时，您可以选择新建（上传文档并构建新索引）或链接现有（复用在其他位置构建的索引，直接读取无需重新索引）。重新索引会写入新的扁平version-N目录并保留之前的版本，因此工作索引在重建过程中不会被破坏。即使是处于错误状态的知识库，也可以单独删除某个文档——无需完全删除并重建，即可移除解析失败的文件。文档解析方式（纯文本、MinerU、Docling、markitdown或PyMuPDF4LLM）可在设置→知识库中选择，默认关闭本地模型下载。CLI通过deeptutor kb list、info、create、add、search、set-default和delete命令映射知识库的生命周期。

🌐 Learning Space — Skills, Personas, and Reusable Context

学习空间（Learning Space）是库和个性化层——用于存储持久化内容。对话与资料包含您的聊天历史、笔记本和题库（每个保存的问题包含您的答案、参考答案和解释）。个性化包含掌握路径、角色（行为预设，如同伴、研究助手、教师）和技能（模型按需读取的SKILL.md剧本）。此处的所有内容均可在聊天、伙伴、协作者和书籍中复用。

您无需自行编写所有技能——从EduHub导入功能可浏览社区目录，并通过安全网关将技能直接下载到您的库中（参见生态系统）。

大多数部分采用草稿-应用流程，因此您可以在提交提供程序之前对其进行测试。内置四种主题——Default（默认）、Cream（奶油色）、Dark（深色）和Glass（玻璃态）。项目根目录的 .env 文件被有意忽略；运行时配置位于 data/user/settings/*.json 下，除非 DEEPTUTOR_HOME 或 deeptutor start --home 将应用指向其他位置。

👥 多用户 — 共享部署 · 可选身份验证，隔离的每用户工作区

身份验证默认关闭——DeepTutor 以单用户模式运行。启用身份验证后，一个 data/ 目录树将同时包含管理员工作区、隔离的每用户工作区以及合作伙伴工作区：

data/
├── user/ # 管理员工作区 + 全局设置
├── users/ / # 每用户范围：聊天历史、记忆、笔记本、知识库
├── partners/ /workspace/ # 合作伙伴（合成用户）范围
└── system/ # auth/users.json · grants/ .json · audit/usage.jsonl

第一个注册用户将成为管理员，并拥有模型目录、提供程序凭据、共享知识库、技能以及每用户授权。其他所有用户将获得一个隔离的工作区和经过脱敏的设置页面——管理员分配的模型、知识库和技能显示为限定范围的只读选项，而非原始 API 密钥。

启用方法： 在 data/user/settings/auth.json 中开启身份验证，重启 deeptutor start，在 /register 注册第一个管理员，然后从 /admin/users 添加用户，并通过授权分配模型、知识库、技能、合作伙伴、工具/MCP 策略以及代码执行权限。

PocketBase 仍是单用户集成——对于多用户部署，请将 integrations.pocketbase_url 保持为空，除非您已连接外部用户存储。

⌨️ DeepTutor CLI — 智能体原生接口

一个 deeptutor 二进制文件，两种使用方式：面向终端用户的交互式 REPL，以及供其他智能体将 DeepTutor 作为工具使用的结构化 JSON。两种方式拥有相同的功能、工具和知识库。

手动操作

deeptutor chat 打开交互式 REPL；deeptutor run " " 执行单次对话并退出。两者支持相同的 --capability、--tool、--kb 和 --config 标志。

deeptutor chat # 交互式 REPL
deeptutor chat --capability deep_solve --kb my-kb --tool rag
deeptutor run chat "Explain the Fourier transform" --tool rag --kb textbook
deeptutor run deep_research "Survey 2026 papers on RAG" \
--config mode=report --config depth=standard

Web 应用的所有功能在此处均有对应——知识库（kb）、会话（session）、合作伙伴（partner）、技能（skill）、笔记本、记忆和配置。完整列表如下。

智能体驱动

DeepTutor 专为被其他智能体操作而设计。在任何 run 命令中添加 --format json，每轮对话将流式输出 NDJSON——每行一个事件（content、tool_call、tool_result、done 等），每行均标记有 session_id。运行支持无头模式安全：在无 TTY 的情况下，ask_user 暂停将自动以空回复解决，而非挂起。

# 单次对话，机器可读
deeptutor run deep_solve "Find d/dx[sin(x^2)]" --tool reason --format json

# 在一个有状态会话中链式对话 — 捕获会话 ID 并复用
SID=$(deeptutor run deep_research "Survey 2026 papers on RAG" \
--config mode=report --config depth=standard --format json \
| jq -r 'select(.type=="done").session_id')
deeptutor run deep_question "Quiz me on that survey" --session "$SID" --format json

仓库根目录包含 SKILL.md——一份约 150 行的交接文档，让任何使用工具的 LLM 只需阅读一次就能掌握全部使用方法。将其提供给 Claude Code、Codex 或 OpenCode（它们会自动获取 SKILL.md），或将 deeptutor run 包装为 LangChain / AutoGen 循环中的工具。完整指南：智能体交接。

命令参考

仅 CLI 发行版

仅 CLI 包位于 packaging/deeptutor-cli。在代码检出目录中，可从源码安装：

python -m pip install -e ./packaging/deeptutor-cli

它尚未发布到 PyPI，因此主要的快速开始部分保留源码安装路径。

🧩 生态系统 — EduHub 与技能社区

DeepTutor 技能采用开放的 Agent-Skills 格式——一个包含 SKILL.md 操作手册（YAML 前置元数据 + Markdown）和可选参考文件的文件夹。该格式并非 DeepTutor 特有，因此任何支持该格式的注册表都可成为您的技能库来源。DeepTutor 内置 EduHub——我们自己的专注于教育领域的技能注册表——作为默认中心集成。

EduHub — DeepTutor 的技能生态系统

EduHub 是 DeepTutor 推出的社区中心，用于分享面向教学的智能体技能——苏格拉底式辅导、闪卡生成器、论文反馈、考试蓝图、概念解释器等。它内置在 DeepTutor 中，因此无需配置：纯标识符或 eduhub: 前缀会解析到该中心。

查找与安装——在浏览器中，打开 学习空间 → 技能 → 从 EduHub 导入 以浏览目录并直接将技能下载到您的库中。从终端：

deeptutor skill search "socratic tutor" # 搜索 EduHub（默认中心）
deeptutor skill install socratic-tutor # 获取 → 验证 → 注册
deeptutor skill install eduhub:socratic-tutor@1.2.0 # 指定中心和版本
deeptutor skill list # 本地技能及其中心来源