☰
DeepTutor 快速上手:三条命令跑通本地 AI 学习助手
2026/9/29 6:52:12 网站建设 项目流程

DeepTutor 快速上手:三条命令跑通本地 AI 学习助手

【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor

问 AI 一道题,它答得头头是道,翻遍全文却找不到一句出自你喂过的讲义。DeepTutor 是开源的本地 AI 学习助手:资料喂进去,它建好知识库,回答只认你的材料。学习过程它也在后台替你记着。全程数据留在本机,不出机器。

⚡ 三条命令跑起来

前提只有两样:Python 3.11 以上、Node.js 20 以上。

pip install -U deeptutor # 装完整包:Web 应用加 CLI deeptutor init # 问答式配置端口、模型、嵌入,不手改文件 deeptutor start # 后端和前端一起拉起

init 会问端口、LLM 提供商、嵌入模型,答完配置就落在data/user/settings/里。几秒后浏览器自动打开127.0.0.1:3782,终端按 Ctrl+C 全停。

逛一遍首屏布局

落地页分三块。左边一列是入口:Chat、知识中心、Book、Memory、Settings 都在这。中间是对话工作区,历史会话收在侧栏。输入框旁的「+」能临时挂文件、笔记或旧会话,只影响当前这一轮。先记住这几处位置,后面每个功能都从这里进。第一次别急着喂资料,先去 Settings 把模型配上,建库才不卡。

建知识库,让答案只出自你的资料

常识题靠模型自己答,"讲义第 43 页那个公式"这种问题得靠 RAG(检索增强:先在你的文档里查,再照着回答)。DeepTutor 建库时让你挑引擎:LlamaIndex 默认,还能选 GraphRAG、LightRAG 或直接挂一个 Obsidian 库,各配不同形态的资料。

deeptutor kb create notes --doc 线性代数.pdf # 建库并导入文档 deeptutor chat --kb notes --tool rag # 开一轮只依据该库的对话

建完库用deeptutor kb list能看见状态;索引失败的那份文档可以单独移除,不用整个库推倒重建。做完会发生什么:回答开始带引用,你能逐条对回原文页码。这就是 PDF 知识库问答的核心。

接上本地 Ollama 模型

想连 API 账单都省掉,就先把ollama serve跑起来并拉一个模型,然后在 Settings → Models 里指向它:

{ "llm_provider": "ollama", "llm_model": "llama3", "llm_base_url": "http://localhost:11434/v1", "embedding_model": "all-minilm" }

保存后切换即时生效:先拿轻量模型把流程走一遍,再换更强的。用云端提供商同理,填 Key 就行。

🧠 翻一翻它的记忆文件

聊天助手的记忆多是黑盒,DeepTutor 的三层全是明文文件:L1 记原始事件,L2 按领域整理要点,L3 做跨领域合成。Memory 图谱里,任何一条"对你的结论"都能点回它的出处;记错了就去改,不想要就删,deeptutor memory clear --force可以一键清空。

整合节奏在 Settings → Memory 里调,更新、审计、去重的预算都看得见。

📚 装技能,把资料编成交互书籍

社区教法学法用deeptutor skill search "socratic tutor"搜,装进来一条命令的事;自己写的 SKILL.md 也能 publish 出去。Book 则把知识库编译成带章节、测验卡和数学动画的交互教材,而不是一份静态 PDF,编完还能导出 Markdown。

deeptutor skill install socratic-tutor # 装一个社区技能 deeptutor book health <book_id> # 检查书的源资料是否更新

排障速查

现象原因处理
本地模型连不上Ollama 没启动运行ollama serve,确认 11434 端口
前端打不开端口被占重新deeptutor init改端口再启动
索引一直卡住嵌入模型没配在 Settings → Models 检查嵌入状态
容器里连不到宿主机 Ollama容器内 localhost 指向容器自己Base URL 换成host.docker.internal

命令细节对照 deeptutor_cli/README.md,容器部署细节看 docs-for-user/CONTAINERIZATION.md。

今晚就做一件事:把那份拖了最久的教材丢给知识库(deeptutor kb create calc --doc 微积分.pdf),再在网页输入框点「+」挂上它,问一道卡了半学期的题。回答里落出具体页码,这套流程就算走通了。

【免费下载链接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询