DeepTutor 完整指南用智能體循環(huán)搭建你的 AI 學(xué)習(xí)伙伴【免費(fèi)下載鏈接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutorDeepTutor 是一個(gè)開源的 AI 學(xué)習(xí)伙伴平臺(tái)它把你的教材、筆記和提問歷史變成一位記得住你的個(gè)性化導(dǎo)師。這篇文章從安裝講到進(jìn)階幫你在 5 分鐘內(nèi)用一條命令跑起服務(wù)并配好知識(shí)庫(kù)和記憶讓它真正基于你自己的資料作答。讓通用聊天機(jī)器人教你學(xué)習(xí)的三個(gè)坑問通用聊天機(jī)器人學(xué)習(xí)問題你很快會(huì)遇到三件事它不知道你正在學(xué)什么只能根據(jù)提問的字面意思猜你上傳的教材和它的回答之間沒有關(guān)聯(lián)每輪對(duì)話都要重新粘貼上下文第二天接著問它把你當(dāng)完全沒聽過的新手。再疊加一個(gè)更實(shí)際的麻煩——學(xué)習(xí)資料散落在瀏覽器八個(gè)標(biāo)簽頁(yè)里等你整理完學(xué)習(xí)的興致也沒了。DeepTutor 針對(duì)的就是這些問題資料上傳一次建庫(kù)系統(tǒng)把你學(xué)過的內(nèi)容寫進(jìn)可審計(jì)的記憶回答落到你的材料上而不是泛泛的網(wǎng)上信息。下面拆開看它怎么做到以及怎么把整套東西跑起來。它是怎么工作的整體上是三層結(jié)構(gòu)。最上層是交互層Next.js 做的 Web 應(yīng)用和deeptutor命令行工具走同一套后端中間層是一個(gè)單一的智能體循環(huán)聊天、出題、研究、解題全部跑在它上面最下層是data/目錄知識(shí)庫(kù)、記憶、會(huì)話、設(shè)置全落盤在這里配置統(tǒng)一放在data/user/settings/下的 JSON/YAML 文件。一個(gè)循環(huán)跑所有功能deeptutor/agents/chat/ 里的循環(huán)邏輯很克制模型按輪次思考需要時(shí)調(diào)用工具觀察工具返回的結(jié)果最后用一條不帶工具調(diào)用的消息收尾。特殊的是ask_user工具——它不硬猜而是暫停這一輪、向你提一個(gè)結(jié)構(gòu)化的澄清問題你答完再繼續(xù)。聊天循環(huán)思考、行動(dòng)、工具調(diào)用、觀察、響應(yīng)五個(gè)環(huán)節(jié)Quiz、Research、Solve 等能力都是同一循環(huán)上的不同目標(biāo)為什么堅(jiān)持單一循環(huán)切換功能時(shí)你換的是目標(biāo)不是引擎于是知識(shí)庫(kù)、人物設(shè)定、模型這些上下文能跟著學(xué)習(xí)者一起移動(dòng)而不是每進(jìn)一個(gè)模塊重新配置一遍。多引擎知識(shí)庫(kù)deeptutor/knowledge/ 負(fù)責(zé)知識(shí)庫(kù)的生命周期deeptutor/services/rag/ 是檢索層。每個(gè)庫(kù)綁定一個(gè)檢索引擎默認(rèn)的 LlamaIndex本地向量 BM25、PageIndex頁(yè)面級(jí)引用的推理檢索、GraphRAG、LightRAG或者直接掛一個(gè)現(xiàn)成的 Obsidian 倉(cāng)庫(kù)原地讀寫。重建索引時(shí)寫入新的version-N目錄舊索引完整保留不會(huì)出現(xiàn)重建到一半全沒了。三層文件記憶deeptutor/services/memory/ 把記憶做成你能直接打開的文件L1 是只追加的事件流水L2 是按場(chǎng)景整理的要點(diǎn)L3 是跨場(chǎng)景的綜合畫像。L2 引用 L1、L3 引用 L2意味著你畫像里的每條結(jié)論都能追溯回那條原始記錄?？桃獠挥秒[蔽的向量庫(kù)存記憶原因就一條個(gè)性化必須可審計(jì)、可編輯。工具與能力都是插件deeptutor/tools/ 里躺著 web_search、paper_search、rag、web_fetch、exec 等幾十個(gè)工具當(dāng)一輪對(duì)話具備對(duì)應(yīng)上下文時(shí)自動(dòng)掛載不用你手動(dòng)挑選capabilities/目錄則封裝 Deep Research、Solve 這類高層能力。加新工具不需要?jiǎng)又餮h(huán)這是它迭代快的原因之一。功能模塊拆解Chat每天用得最多的入口定位主要學(xué)習(xí)交互入口一條線程里正常聊天、調(diào)工具、掛知識(shí)庫(kù)、讀附件、生成圖片上下文跨輪持續(xù)。會(huì)話上下文分兩種工具欄上的是粘住的知識(shí)庫(kù)、人物設(shè)定、模型菜單里的是只供本輪引用的文件、書籍、筆記回答過程中能看到模型思考與工具調(diào)用的完整軌跡答案不是黑盒同一入口能切到 Quiz 出題、Research 出帶引用的報(bào)告、Visualize 畫圖表動(dòng)畫卡住時(shí)可以觸發(fā)ask_user讓代理反過來向你確認(rèn)細(xì)節(jié)DeepTutor 聊天界面輸入?yún)^(qū)上方是工具與知識(shí)庫(kù)掛載位右側(cè)是活動(dòng)面板Knowledge Center把資料變成檢索地基定位RAG 背后的文檔集合支撐 Chat、Co-Writer、Book、Partner 所有場(chǎng)景的有據(jù)可依。建庫(kù)時(shí)二選一上傳文檔新建索引或鏈接一個(gè)在別處建好的索引原地讀取解析引擎可選 Text-only、MinerU、Docling、PyMuPDF4LLM 等在設(shè)置里切換單個(gè)解析失敗的文件可以單獨(dú)移除不用刪庫(kù)重建CLI 同步支持deeptutor kb list / create / add / search全套操作DeepTutor 知識(shí)中心每個(gè)知識(shí)庫(kù)顯示引擎類型、文檔狀態(tài)與索引版本Memory學(xué)過的東西留得下來定位跨場(chǎng)景追蹤你在 chat、quiz、book、notebook 各處的痕跡并沉淀成可編輯的畫像。三層結(jié)構(gòu)對(duì)應(yīng)文件L1 事件流水JSONL、L2 要點(diǎn)Markdown、L3 綜合Markdown記憶圖譜按中心是 L3、中環(huán) L2、外圈 L1的金字塔展示點(diǎn)開任一結(jié)論能看到背后的原始事件整合器的更新、去重預(yù)算在設(shè)置里可調(diào)嫌它記得太勤或太懶都有開關(guān)deeptutor memory show一條命令在終端查看 L2/L3 內(nèi)容DeepTutor 記憶概覽L3 綜合畫像居中L2 事實(shí)與 L1 軌跡層層可追溯Book把資料編譯成活書定位從知識(shí)庫(kù)、筆記、題庫(kù)或聊天歷史生成一本交互式活書而不是靜態(tài) PDF。生成前先給你一份章節(jié)大綱確認(rèn)結(jié)構(gòu)后再寫內(nèi)容避免一次性盲輸出每章編譯成類型化塊正文、測(cè)驗(yàn)卡、閃卡、代碼、圖表、動(dòng)畫、交互式 HTML每個(gè)塊可單獨(dú)插入、移動(dòng)、重生成或換類型不必重寫整章每頁(yè)自帶 Page Chat讀到哪問到哪DeepTutor 書籍庫(kù)章節(jié)結(jié)構(gòu)與生成狀態(tài)一覽測(cè)驗(yàn)卡、數(shù)學(xué)動(dòng)畫都是其中的塊類型Co-Writer選中一段再?zèng)Q定怎么改定位雙欄 Markdown 工作區(qū)寫報(bào)告、教程、長(zhǎng)文筆記數(shù)學(xué)公式 KaTeX 實(shí)時(shí)渲染。自動(dòng)保存 右側(cè)實(shí)時(shí)預(yù)覽草稿成熟后一鍵存回筆記本核心玩法是外科手術(shù)式編輯選中一段讓它改寫、擴(kuò)寫或壓縮每次修改以 accept/reject 的差異呈現(xiàn)你點(diǎn)頭之前內(nèi)容不會(huì)落盤改寫可以掛知識(shí)庫(kù)或網(wǎng)絡(luò)證據(jù)工具調(diào)用過程全程留痕DeepTutor Co-Writer左側(cè)編輯、右側(cè)預(yù)覽選區(qū)改寫結(jié)果以待確認(rèn)差異展示快速上手四條命令完成 DeepTutor 安裝推薦 PyPI 路線無(wú)需克隆源碼前置要求 Python 3.11–3.13 和 Node.js 20mkdir -p my-deeptutor cd my-deeptutor # 先建工作區(qū)目錄配置都落在這里 pip install -U deeptutor # 安裝后端 CLI 打包好的前端 deeptutor init # 交互式設(shè)置端口、LLM 提供商、API key deeptutor start # 同時(shí)拉起前后端保持終端不關(guān)啟動(dòng)后打開終端里打印的前端地址默認(rèn)是http://127.0.0.1:3782CtrlC一次停掉前后端。想跑 Docker 也可以只需發(fā)布 3782 一個(gè)端口容器內(nèi)的 Next.js 中間件會(huì)把 API 請(qǐng)求轉(zhuǎn)發(fā)給后端。首次配置三件必做項(xiàng)填 LLMSettings → Models 里加一個(gè) LLM 配置Base URL、API key、模型名沒有它任何功能都跑不動(dòng)。需要知識(shí)庫(kù)就加 embedding 模型同一頁(yè)面補(bǔ)一個(gè) embedding 配置RAG 檢索全靠它純聊天可以跳過?？礌顟B(tài)條再開干Settings 頂部的 Backend / LLM / Embedding 狀態(tài)全部就緒后再開始第一輪對(duì)話。用一次對(duì)話驗(yàn)證跑通在聊天框問一句用一句話解釋向量檢索并說明它和關(guān)鍵詞搜索的區(qū)別觀察活動(dòng)面板把思考、工具調(diào)用、結(jié)果逐步展示出來接著追問一句確認(rèn)上下文還在然后到會(huì)話列表確認(rèn)歷史已持久化。跑通這三步服務(wù)、模型、會(huì)話存儲(chǔ)就都驗(yàn)證完了可以放心開始建知識(shí)庫(kù)。進(jìn)階技巧與高頻卡點(diǎn)RAG 查不到內(nèi)容多半是 embedding 沒配場(chǎng)景教材已經(jīng)傳進(jìn)知識(shí)庫(kù)提問時(shí)回答卻仍然不引用資料檢索結(jié)果空。 解法rag工具依賴 embedding profile先回 Settings → Models 補(bǔ)上 embedding 模型解析結(jié)果不對(duì)的話去 Settings → Knowledge Base 換解析引擎文本型資料選 Text-only 即可掃描件換 MinerU 或 Docling。Docker 里連不上宿主機(jī)上的 Ollama場(chǎng)景模型跑在宿主機(jī)容器內(nèi)配置http://localhost:11434/v1一直連不上。 解法容器里的 localhost 指向容器自己。啟動(dòng)命令加--add-hosthost.docker.internal:host-gateway把 Base URL 改成http://host.docker.internal:11434/v1即可macOS/Windows 的 Docker Desktop 通常不需要這個(gè)參數(shù)。改了 .env 卻不生效場(chǎng)景照著別人的.env模板放進(jìn)項(xiàng)目根目錄重啟后配置紋絲不動(dòng)。 解法DeepTutor 有意不讀項(xiàng)目根的.env運(yùn)行期配置全部在data/user/settings/*.json或DEEPTUTOR_HOME指定的位置最省事的編輯入口就是瀏覽器里的 Settings 頁(yè)面改完即寫盤。收尾DeepTutor 把問一句答一句升級(jí)成知道你在學(xué)什么、記得你學(xué)過什么、答案落在你自己的資料上。裝好之后先跑通一次對(duì)話再按本文順序配置知識(shí)庫(kù)和記憶是最短的上手路徑。遇到卡點(diǎn)直接在項(xiàng)目里提 Issue想補(bǔ)的功能也可以去 Roadmap 投票或提新條目社區(qū)對(duì)反饋的響應(yīng)速度不慢。【免費(fèi)下載鏈接】DeepTutorDeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考