DeepTutor:把提问、笔记和复习放进同一个学习工作台

项目简介

自学一门课，麻烦往往不只是“这道题不会”。讲义放在文件夹里，解释散落在聊天记录里，笔记又在另一个软件中；过几天想复习，还得重新找出当时哪里没懂。DeepTutor 想承担的角色，是一个围绕学习材料持续工作的 AI 学习工作台，而不只是回答完就结束的聊天窗口。

它按学科或项目组织工作区，把对话、学习活动和资料放在相应位置。例如复习统计学时，可以围绕课程材料追问概念，把自己的理解写进笔记，再用题库练习检查薄弱处。这是它已有功能可以串起来的一条使用路线，不代表打开后就会自动替你安排好整门课程。项目 README⁠^[2]

核心特性

一、围绕材料追问，而不是每次从头交代背景。

当你已经有教材或讲义，最需要的常常不是一篇泛泛的介绍，而是“这段话为什么这样说”。DeepTutor 的 Chat 可以读取附件、结合选定的知识库回答，并在同一对话中继续追问。这里的知识库，可以简单理解为供回答查找依据的资料集合。

例如先要求解释某个定义，再追问它与前一章概念的关系，就不必把整个问题拆成互不相干的问答。需要注意，单次附加的参考材料与持续保留的会话设置并不是一回事；不要把上传一次文件理解成所有后续任务都会自动使用它。回答涉及课程结论时，也仍应对照原材料检查。对话与上下文说明⁠^[3]

二、把自己的理解写成笔记，再针对具体段落讨论。

看懂解释与能自己讲清楚，是两件事。它的 Learning notebook 可以组织页面、子页面和内容块，也支持导入 Word 文档。你可以先写出自己的理解，再针对其中一段请 Dito 解释、举例、改写或出练习题；讨论会关联到对应页面和行。

更值得关注的是，修改建议需要你审阅后接受，而不是让生成内容直接取代原稿。笔记还能导出为 Markdown 或 Word，适合逐步积累课程总结、读书记录和工作知识；导出 Word 时，交互内容会变为静态内容。笔记功能⁠^[4]

三、从“我好像懂了”，走到实际练习。

复习最容易省略的一步，是重新做题。DeepTutor 的资源区包含带答案和解释的题库，可以从所选题目或 Learning → Practice 进入练习，支持复习、错题追踪和定期重复。

它的意义不在于多放了一个做题入口，而在于让练习与前面的阅读、讨论、记录出现在同一个学习环境里。对于总是收藏很多资料、却很少回头验证理解的人，这比继续堆积新解释更有针对性。练习与资源说明⁠^[5]

快速开始

第一次体验，推荐官方的 Docker 单容器路径。先只完成一次普通对话，不急着上传整本教材或配置知识库。

1. 准备运行环境和模型接入信息。

在一台已经安装并能正常运行 Docker 的电脑上操作。同时准备可用模型服务的 Base URL、API key 和模型名称，稍后填入网页设置。启动应用与接通模型是两个步骤：能打开页面，不等于已经能得到模型回答。

2. 在电脑的终端中启动应用。

执行下面这段官方命令。它使用发布的容器镜像运行应用，将网页端口绑定到本机，并挂载用于保留数据的命名数据卷；不是只安装依赖或下载文件。

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

保持该终端运行，在浏览器打开本机页面⁠^[6]。设置、API 密钥、日志、工作区文件和知识库等会保存在命名数据卷中，因此这份本机数据也需要妥善保管。容器启动指南⁠^[7]

3. 在网页中连接模型。

进入 Settings → Providers，保存服务地址和密钥；然后在 Language models 中添加并选中要使用的语言模型。首次普通对话无需先配置知识库；以后使用知识库检索时，再补充 embedding 配置，也就是把资料转成可供检索表示的模型设置。模型配置说明⁠^[8]

4. 用一个小问题检查完整流程。

进入 Chat，输入：“用日常例子解释平均数和中位数的区别。”收到回答后，再追问：“沿用刚才的例子，加入一个特别大的数，会发生什么？”检查是否收到回复，以及第二次回答是否沿用了前面的例子。完成这一步，才算验证了页面、模型接入和连续对话这条最小路径；知识库、笔记和练习可以之后逐项尝试。

为什么火了

DeepTutor 的吸引力，在于它瞄准的不是“再多回答一个问题”，而是学习过程中反复出现的断点：解释看过了却没留下自己的理解，笔记写好了却没有复习，资料存下了却用不上。

把这些环节放到同一处，比单独展示一个生成答案的功能更容易让人理解用途。它也没有要求所有人一开始就搭建复杂的资料系统：可以先聊天，再逐步用笔记和练习；Docker 路径则提供了尝试完整网页应用的明确入口。对想寻找长期学习环境的人，这种从小处开始、按需要展开的方式，是值得关注的具体理由。

适合谁

正在自学或备考的人：如果你有明确课程、讲义和需要反复练习的知识点，可以尝试把解释、笔记和复习串起来。采用前先判断自己是否愿意持续整理材料，而不只是期待一次提问就掌握全部内容。

需要长期积累知识的职场学习者：学习新领域、阅读专业资料时，可以利用段落讨论和可导出的笔记，把零散问答变成自己的记录。涉及重要判断时，仍应保留核对原文的习惯。

愿意做少量配置的个人用户：这条体验路径需要 Docker 和可用的模型接入信息。若你只想偶尔问一个常识问题，现成聊天服务可能更省事；若你希望把学习过程留下来，再考虑这个工作台，会更符合它的用途。

引用链接