跳转到内容

DeepTutor 怎么把 Claude Code、Codex 叫进学习流程?本地部署、三层记忆与 CLI 交接

AIGoCode发布于 更新于

DeepTutor 怎么把 Claude Code、Codex 叫进学习流程?本地部署、三层记忆与 CLI 交接 封面

想让 AI 帮着啃一本书或一门课,常见做法是把 PDF 拖进对话框,问一句答一句。关掉窗口,它不记得你上次卡在哪一章,也不知道哪些知识点你已经掌握,下次打开,背景还得重讲一遍。

DeepTutor 是香港大学数据智能实验室(HKUDS)开源的一套 AI 学习系统,Apache-2.0 协议,到 2026 年 11 月 GitHub star 超过 6 万,当前版本是 v1.7.3。它是 Python 后端加 Next.js 前端,装好后用两条命令就能在本机起一个完整的 Web 应用。它没有做成单纯的聊天框,讲题、出题、写研究报告、画图、沉浸式阅读文档、闯关练习,都跑在同一个 Agent 循环上,共用一份会话上下文和记忆。

这篇适合想搭一个本地 AI 学习环境、或者想把 Claude Code、Codex 接进学习流程的开发者。下面讲它怎么调用本机的编程 Agent、三层记忆怎么查看、知识库引擎怎么选、CLI 怎么交给别的 Agent 驱动,最后是安装步骤和使用建议。

DeepTutor 原文配图 1

DeepTutor 怎么调用本机的 Claude Code 和 Codex

DeepTutor 没打算什么都自己做。Chat 里有一个 consult_subagent 工具,可以在一轮对话中间调起你本机已经装好的 Agent。按官方 README,目前支持 Claude Code、Codex、Grok CLI、Antigravity、Kimi、opencode、MiMo Code、Hermes Agent、OpenClaw、DeepSeek Harness 等,运行过程会流式显示在旁边的 Activity 面板里。

这不是包一层 API,而是在你的机器上真正启动对应的命令行工具干活,用的是这些工具各自的登录认证、工作目录和会话存储。选哪个 Agent、跑几轮,都在对话里决定。

它也能导入历史记录。以前的 Claude Code 和 Codex 对话可以导进来:Claude Code 按项目目录挑选,Codex 按日期挑选,导入后变成可以搜索、可以接着聊的命名 Agent。引用这些内容时,它会按第三方记录来处理,不会把那些话当成自己说的。讲一道题时,顺手把写代码的 Agent 拉进来看一眼实现,这是它和一般学习工具最不一样的地方。

如果你还没在本机配好 Claude Code 或 Codex,可以先按 AIGoCode 使用指南 完成接入,再回来在 DeepTutor 里连接它们。

DeepTutor 原文配图 2

三层记忆:一个能打开查看的文件夹

很多产品的记忆藏在向量库里,你只能感觉它好像记住了什么,说不清记的是哪一条,也没法修改。

DeepTutor 把记忆落成文件,分三层:

  • L1 原始轨迹:只追加写入的 jsonl 记录。
  • L2 场景事实:每个场景整理出来的事实,存成一个 md 文件,每条都带指回 L1 的引用。
  • L3 跨场景综合:同样记着自己是从哪几个 L2 汇总来的。

界面上有一张 Memory Graph 把这个金字塔画出来:L3 在中心,L2 一圈,L1 在最外层。L2 到 L1 的证据连线可以点击,一条结论是从哪次对话来的,可以一路点到底。

命令行也能查看:

bash
deeptutor memory show

deeptutor memory clear 可以清空 L1 或全部记忆,整理频率和预算在 Settings 里调整。记忆是能读也能改的文件,这在同类项目里属于少数做法。

DeepTutor 原文配图 3

知识库引擎怎么选

建知识库时先选检索引擎,每个库绑定一种:

  • LlamaIndex:默认选项,向量加 BM25 混合检索。
  • PageIndex:推理式检索,引用可以精确到页。
  • GraphRAG、LightRAG:知识图谱路线。LightRAG 本来就是同一个实验室的项目。
  • 外部知识源:可以连接自己部署的 WeKnora、腾讯 IMA 知识库、MarginNote 4,或者直接读写一个 Obsidian 仓库。

知识库还能跟踪 GitHub 仓库(按仓库、分支和 glob 指定范围)或文档站点,同步时做 hash 比对,只处理新增、修改和删除的部分。重建索引会写到新的 version-N 目录,旧版本保留,不会出现重建到一半、能用的索引反而没了的情况。

如果你关心的是代码库和文档的知识图谱,而不是学习场景,可以参考 graphify 的用法。

CLI 交接:让别的 Agent 来驱动 DeepTutor

DeepTutor 的命令行是为「被另一个 Agent 操作」设计的。deeptutor run 加上 --format json,每一轮会输出 NDJSON,一行一个事件,content、tool_call、tool_result、done 等事件都带着 session_id:

bash
deeptutor run deep_research "Survey 2026 papers on RAG" --format json

从输出里取到 done 事件中的 session_id,再用 --session 参数传给下一条命令,就能接着上一轮继续问:

bash
deeptutor run deep_question "Quiz me on that survey" --session YOUR_SESSION_ID --format json

没有终端交互时,ask_user 会自动用空回复放行,不会卡住等人。仓库根目录还有一份 SKILL.md,是写给工具型大模型读的 CLI 交接文档,让 Claude Code 或 Codex 先读这份文件,就能上手驱动 DeepTutor。

DeepTutor 安装步骤

完整 Web 应用需要 Python 3.11 到 3.14,以及 Node.js 20.9 以上。注意:从 1.7 版本开始,deeptutor[full] 才包含 Web 应用和 CLI,只装 deeptutor 得到的是核心聊天和 SDK。

bash
mkdir -p my-deeptutor
cd my-deeptutor
python -m pip install -U "deeptutor[full]"
deeptutor init
deeptutor start

init 会询问后端端口、前端端口、模型服务商和 Key,以及可选的 embedding 和搜索配置。启动后打开终端里打印的地址,默认是 http://127.0.0.1:3782,按 Ctrl+C 同时停止前后端。

不想装 Python 和 Node 的话,还有两个选择:官方 Docker 镜像只需要映射 3782 一个端口;也可以从 GitHub Release 下载打包好的桌面版 Open DeepTutor。只想在终端里用的,装核心包后执行 deeptutor init --cli 即可,不需要 Node.js。

技能默认从官方的 EduHub 安装:

bash
deeptutor skill install socratic-tutor

导入技能时有一道安全检查:解压时检查路径穿越、条目数量、压缩比和软链接,可执行权限一律去掉,frontmatter 里的 always 字段直接删除,装进来的技能没法把自己塞进每一次的系统提示词。

DeepTutor 原文配图 4

使用建议

DeepTutor 功能铺得很宽,第一次打开容易找不到重点。比较省力的上手顺序是:先在 Chat 里挂一个知识库,把 Memory 里的几个 md 文件打开看看它到底记了什么,再决定要不要用 Partner、Book 这些更重的功能。

它更新很频繁,不同版本之间的安装方式和功能入口变化较大,照着教程操作前,先看一眼 README 里当前版本的说明。

总结

DeepTutor 把学习拆成了一组能被别的 Agent 调用的能力,又把记忆摊在文件系统上,随时可以翻看和修改。能在讲题过程中直接调用本机的 Claude Code、Codex,加上可选的检索引擎和面向 Agent 的 CLI,让它不只是一个 AI 家教外壳,也是一个值得参考的 Agent 应用实现。

想在 AIGoCode 上使用 Claude Code 或 Codex,再把它们接进 DeepTutor,可以先看 AIGoCode 使用指南 完成配置。

参考来源