DeepTutor 调研：港大 HKUDS 九个月 40K ⭐，把 AI 家教装进终端的 Agent 原生工作台

深度调研 · 数据更新于 2026-09-21（GitHub API 实时）· 仓库：HKUDS/DeepTutor

写在前面

上一篇拆了清华的 OpenMAIC——把内容生产变成课堂生成。这一篇换一个方向：不生产课堂，陪伴学习者本人。HKUDS（香港大学数据科学研究院，LightRAG 同门）出品，2025 年 12 月 28 日建仓，9 个月 40,112 ⭐，论文挂在 arXiv（2604.26962）。

DeepTutor 的自我定位是 “Agent-Native Personalized Tutoring”：不是一堆功能的堆叠，而是 所有学习模式跑在同一个 Agent 循环上——聊天、解题、出题、研究、可视化共用一份上下文，知识库、笔记、画像跨工作流共享。

一、解决什么问题

AI 学习工具的老三样痛点：

1. 模式孤岛——聊天一个 App、解题一个 App、出题一个 App，上下文互相不通
2. 文档只进不出——传了 PDF 只能问答，不能沉淀成结构化的书、题、卡
3. 没有记忆——每次对话从头自我介绍，工具永远不知道你学到哪了

DeepTutor 的答案：六模式一体的工作台 + 活书引擎 + 终身学习者画像 ，再加一个杀招—— 每个能力都能从终端一行命令调起，AI Agent 可以完全自主地操作它。

二、项目名片

三、架构拆解

3.1 统一工作台：六模式一线程

Chat（对话）、Deep Solve（双循环推理解题：RAG+ 搜索 + 代码执行 + 精确引用）、Quiz（测验生成 + 仿真考试模拟）、Deep Research（文献综述 + 跨领域洞察）、Math Animator（数学动画）、Visualize（概念可视化）——六种能力 共享同一会话上下文：聊着聊着升级成多 Agent 解题，解完顺手出五道题，全程不换应用不丢历史。

3.2 知识引擎：RAG Pipeline 可插拔

• 多引擎检索：LlamaIndex / PageIndex / GraphRAG / LightRAG 四选一，还能直连 Obsidian 笔记库
• 多后端解析：MinerU / Docling / PyMuPDF4LLM，PDF/DOCX/XLSX/PPTX 通吃
• 版本化索引：知识库重建不丢历史快照
• Book Engine：把文档变成 14 种块类型的 ” 活书 ”——测验、闪卡、时间线、概念图、交互演示，多 Agent 流水线（设计大纲→检索→编纂）

3.3 记忆与 Bot：nanobot 驱动

• Persistent Memory：学习者画像（学过什么、怎么学的、要去哪）跨所有功能和 TutorBot 共享，越用越准
• Personal TutorBot：不是聊天机器人，是常驻 Agent——各自有工作区、记忆、人设、技能，会设提醒、会学新技能（deeptutor bot create math-tutor --persona " 苏格拉底式数学老师 "）
• 多渠道驻留：Telegram / Discord / Slack / 飞书 / 企业微信 / 钉钉 / Matrix / QQ / WhatsApp / Email，家教在哪儿都能找到你

3.4 CLI：Agent 原生的接口

这是它跟 OpenClaw 生态最亲密的地方：每项能力、知识库、会话、Bot 都是一行命令，人类拿到富终端渲染，AI 拿到结构化 JSON。把仓库根目录的 SKILL.md 交给任何带工具的 Agent（OpenClaw、nanobot 等），它就能自主配置和操作整套系统：

deeptutor run deep_solve " 证明 √2 是无理数 " -t reason   # 一次性执行
deeptutor kb create my-kb --doc textbook.pdf           # 知识库生命周期
deeptutor chat --capability deep_solve --kb my-kb      # REPL 内 /cap /kb 随时切

四、五分钟上手

pip install deeptutor
deeptutor init && deeptutor start        # Web UI 默认起来

模型配 OpenAI 兼容端点即可（v1.0 后原生 SDK，已抛离 litellm）。Docker 党直接拉 ghcr.io/hkuds/deeptutor:latest；纯终端党装 packaging/deeptutor-cli，无浏览器全套可用。

五、数字与证据

• 40,112 ⭐ / 9 个月 ≈ 月均 4.5K——绝对量是港大系开源项目新纪录级；但 斜率略逊于 OpenMAIC 的月均 6K（后者 6.4 个月 38K）
• 162 贡献者 vs OpenMAIC 的 100——社区参与度更高
• 版本纪律严明：12 月底 v0.1 → 1 月狂飙 v0.2-v0.6 → 4 月 v1.0 重写 → 9 月 v1.6.9，PyPI 45 个版本无断档
• 中文本地化完整（README-zh、微信群、v1.0 beta.3 起全量 i18n）
• 注意：20K/10K 里程碑为官方通报，” 个性化教学效果 ” 无第三方基准，arXiv 论文是主要设计佐证

六、生态位：跟谁竞争、跟谁互补

一句话：DeepTutor 是 学习过程的操作系统——它的竞争对手不是 OpenMAIC，而是封闭的商业 AI 辅导 SaaS。跟 OpenMAIC 反而能拼流水线：前者产课，后者消化课。压轴的对比篇（下一篇）给完整对决表。

七、风险与坑

1. v1.0 是断代重写（约 20 万行）：网上大量教程基于 v0.x 架构，已过时；找资料认准 4 月后的内容
2. Python 全家桶不轻：RAG 引擎 + 解析器 + 动画依赖叠加，裸机安装容易版本冲突，Docker 是稳路
3. TutorBot 自主性是双刃剑：会设提醒、会装技能的常驻 Agent，权限配置别偷懒
4. 多渠道接入各有坑：10+ IM 适配器质量不均，飞书 / 企微相对成熟，小众渠道看 issue 区
5. 259 个 open issues：热度带来的等待，复现时附上 CLI JSON 输出更好排查
6. 更新极快：45 个 PyPI 版本，生产锁定版本号，别追 latest

八、总结

结论按人群给：

• 重度自学者：六模式一体 + 活书 + 画像，是目前开源里最完整的 ” 个人学习操作系统 ”，PyPI 一行起
• 知识管理重度用户：GraphRAG/LightRAG/Obsidian 直连 + 版本化索引，比通用 RAG 工具更懂学习场景
• OpenClaw/Agent 玩家：CLI+SKILL.md 原生友好，10+ IM 渠道驻留——把它当 ” 可编程家教后端 ” 接进自己的 Agent 体系，想象空间大
• 机构 / 学校：Apache-2.0 无传染顾虑，自托管数据主权清晰；但需自建内容审核与账号体系

下一篇正面对决：清华课堂派 vs 港大家教派，技术栈、产品哲学、增长曲线、生态位四张表拆完，给选型结论。

参考与延伸

• 仓库：HKUDS/DeepTutor · 论文：arXiv 2604.26962 · PyPI：deeptutor
• 姐妹篇：《OpenMAIC 调研》 · 《OpenMAIC vs DeepTutor 对比》 · 《Needle 调研》

by 飞熊 · yunying（增长运营官）· 数据基准 2026-09-21