scan_date: 2026-07-29 mode: B(repo 採用健檢,鏡頭=Sys4Ethan 可借之處) tier: quick token_cost: ~10 萬 token(估)
不整套採用;以「reference + 零件引用」採用(Apache-2.0 可自由抄),並建議在 Mini 開一台實驗實例親手玩。
一句為什麼:DeepTutor 是別人已經蓋好的「Learning OS」(31k 星、月發版 4-6 次、真實下載爬升中),但它是瀏覽器優先的打字型工作台,與 Sys4Ethan 的核心差異化——Boox 手寫墨跡 → 視覺批改 → WhatsApp 老師迴路——完全不重疊;它取代不了 Magnai 鏈,卻是你規劃中的錯題閉環/Cockpit(議程①丙)最好的現成設計藍圖,且其 學習模組/Manim 動畫 agent/WhatsApp 頻道橋 都是可拆的零件。
重啟評估 gate(哪些條件成立就值得重看「整套採用」): - Ethan 的自習主場景從 Boox 手寫轉移到筆電瀏覽器(如學校要求用筆電做功課)。 - Sys4Ethan Goal 2/3(英文口說、時間規劃)動工時——DeepTutor 的 Guided Learning + scheduler 可能直接覆蓋,先重掃再自建。 - DeepTutor 出了行動端/平板原生體驗(現為 Next.js web)。
| 閘門 | 判定 | 證據 |
|---|---|---|
| License | ✅ Apache-2.0(引用、改作、商用皆可;LICENSE 檔在 root) | gh api:license: Apache-2.0 |
| 棄養風險 | ✅ 極低:2026-07-28 仍在推;7 月一個月發 6 版(v1.5.1–v1.5.6) | releases API |
| 安全 | ⚠️ 無大紅旗但兩點注意:①Scorecard 無資料(標註即可,非紅旗)②WhatsApp 頻道走 Baileys(WhatsApp Web 非官方協定),有封號風險——不要接你的老師聯絡門號 | whatsapp.py 原始碼:@whiskeysockets/baileys |
一票否決項:無。
| 維度 | 評 | 一句話 |
|---|---|---|
| 功能 | ⚠️ | 六大功能全部屬實(見下),但沒有手寫/e-ink 路徑:其批改是 learning/grading.py 的字串比對+選擇題(打字答案),取代不了 Magnai bridge 的視覺手寫批改 |
| 技術 | ✅ | Python 3.11+ + Next.js 16;pip 一鍵裝(pip install deeptutor);支援 Anthropic SDK 原生;與你的棧同族 |
| 維運 | ⚠️ | 整套跑=backend+Node 前端+(可選)Docker/PocketBase,比 Sys4Ethan 現行 FastAPI 重一級;Mini 跑得動,但 Ethan 在新加坡遠端接入需解 auth/暴露問題(有 multi-user+admin) |
| 團隊 | ✅ | HKUDS(港大實驗室,LightRAG 同門);主導者 pancacake 貢獻 557/約 860(~65%,單核心)但外部 PR 合併極快(issue 抽樣:多數 1-2 天內關單);root 有 AGENTS.md+SKILL.md——明確設計給 AI agent 讀改 |
| 生態 | ✅ | 20 個 IM 頻道(含 whatsapp.py、telegram.py)、MCP、EduHub/ClawHub skills 市集、Obsidian vault 掛載 capability(capabilities/obsidian/vault.py)——與你的 Obsidian 中心架構有現成接縫 |
| 退出成本 | ✅ | 只做 reference/零件引用=零退出成本;就算跑實驗實例,資料在本地 data/ 目錄,關掉就走 |
| 傳聞 | 核實 | 證據 |
|---|---|---|
| 丟 PDF 建知識庫 | ✅ | 多引擎 RAG:LlamaIndex/PageIndex/GraphRAG/LightRAG+可插拔解析(MinerU/Docling/PyMuPDF4LLM) |
| 對教材出題+錯題進題庫 | ✅ | Quiz+Question Bank+Mastery Path;v1.4.9「graded Mastery Path questions flow into your Question Bank」;learning/ 有 grading/mastery/scheduler/policy/storage,models.py 含 ErrorType 錯誤分類 |
| 解題拆步驟、查證、附出處 | ✅ | Solve/Deep Solve agent+v1.5.5「traceable rag citations」 |
| Manim 數學動畫 | ✅ | agents/math_animator/+requirements/math-animator.txt+book 動畫 block |
| 講義編譯互動教科書 | ✅ | Book Engine「living book」compiler(v1.2.0 起),內嵌測驗/視覺化 |
| TutorBot 有記憶人格 | ✅ | v1.4.3 起 TutorBot→Partners:persona+私有記憶+15+ IM 頻道;三層記憶 L1/L2/L3 可檢視可編輯+Memory Graph 溯源 |
learning/ 模組=直接可抄的設計藍圖(mastery gate、錯誤分類、排程複習、題庫流轉),Apache-2.0 抄 schema 與 prompt 都合法。gh topic:ai-tutor 下 DeepTutor 31,015 星,第二名 human-skill-tree 595——開源「完整學習工作台」類別中無同量級對手(其餘是 skill/單點工具:anki-mcp-server 406、universal-examprep-skill 261、Bloom 213)。採用比較題的答案:這個類別要借鏡,只有它可借。
首輪只掃 topic:ai-tutor 一個詞彙面即下「無對手」——補掃六組詞(ai tutor/tutor gpt/notebooklm/education llm/anki llm 等)+topic 交集+直接點名已知候選後,修正為:「學習閉環」軸仍無對手;「PDF→知識庫」軸有一個更大的(open-notebook);「功能形似」軸有一個小一級的(PageLM)。
| 專案 | 星/推進 | License(可抄性) | 功能軸 vs DeepTutor | 一句話定位 |
|---|---|---|---|---|
| lfnovo/open-notebook | 36,149★/07-28 | ✅ MIT | 只有 PDF→KB+內容轉換+播客;無出題/錯題/精熟/解題/動畫 | NotebookLM 開源實作的王者;KB 軸比 DeepTutor 大,學習軸是零 |
| MODSetter/SurfSense | 15,610★/07-29 | ⚠️ Apache-2.0+BSL 1.1(proprietary 目錄) | 無學習迴路;官方已宣布轉向 agent 即時資料連接器平台,離教育場景而去 | 研究代理,非家教;比較意義低 |
| JushBJJ/Mr.-Ranedeer | 29,606★/推進停 2025-09 | ❌ 無 LICENSE(全保留,不得引用) | 純 GPT-4 prompt,非系統 | 家教人格 prompt 的歷史名作;只能看不能抄 |
| CaviraOSS/PageLM | 1,697★/推進停 06-11 | ⚠️ 自訂 Community License:個人/教育可、商用擋(Magnai 商業化企圖→抄碼有雷) | 最像:quiz+字卡(間隔重複)+播客+ExamLab 模擬考+作業規劃+辯論;無動畫/教科書/IM 人格 | 功能形似但體質弱一級(星數 1/18、推進停滯 7 週) |
| plastic-labs/tutor-gpt (Bloom) | 916★/推進停 02-20 | ❌ GPL-3.0(閘門擋) | 只有 ToM 人格記憶軸(Honcho) | TutorBot 記憶設計的思想參考;code 不可抄 |
| learnhouse/ChatTutor/EduChat | 1.9k/1.3k/958★ | ❌ AGPL×2/無明確 | LMS 課程形/視覺互動家教/中文教育模型(停更) | 各缺主軸且 license 全擋 |
| TIGER-AI-Lab/TheoremExplainAgent | 1,500★/推進停 2025-07 | ✅ MIT | 只有 Manim 動畫軸(研究碼) | math_animator 之外的動畫生成第二參考 |
橫向結論:把六大功能當整體看,DeepTutor 沒有真正對手——最接近的 PageLM 差 18 倍星數且推進停滯;量級更大的 open-notebook 與 SurfSense 都不做學習迴路。裁決不變(reference+零件引用),另外兩個可用比較基準:KB/內容轉換設計看 open-notebook(MIT 可抄)、動畫生成第二參考 TheoremExplainAgent(MIT)。閉源界的真正口碑對照組是 Google NotebookLM 與 Khanmigo(無法健檢,僅作產品定位參照)。
deeptutor/learning/(grading/mastery/scheduler)、deeptutor/partners/channels/whatsapp.py(Baileys bridge)、deeptutor/capabilities/obsidian/vault.py、deeptutor/agents/math_animator/| 管道 | 狀態 |
|---|---|
| gh api/search(基本面/結構/issues/原始碼) | ✅ 掃過 |
| ecosyste.ms | ✅ 掃過 |
| Scorecard | ⚠️ 打通但無此 repo 資料(非紅旗,標註) |
| deps.dev(pypi/deeptutor) | ✅ 24 版、latest 1.5.6 |
| pypistats | ✅ 掃過 |
| HN Algolia | ✅ 掃過(含消歧) |
| WebSearch(2 發) | ⚠️ 回傳未打中 reddit 網域——Reddit 面本次失效,不代表無討論 |
| X(Hermes/Grok) | ✅ 3 則,抽 1 交叉核實 |
| AlternativeTo | ⏭️ 未跑(quick 檔位以 gh topic 同類掃補位) |
| Discord 溫度 | ❌ 無法自動化 → 手動後續 |
mkdir -p ~/lab/deeptutor && cd ~/lab/deeptutor && pip install -U deeptutor && deeptutor init && deeptutor start(接 Anthropic key;資料留在該目錄,退出零成本)。重點玩三處:Mastery Path 錯題流轉、Obsidian vault 掛載、Book Engine。deeptutor/learning/models.py(ErrorType 分類)+ scheduler.py(複習排程)讀一遍當設計輸入——這一步建議排進議程①的 spec 前置。gh:api repos/HKUDS/DeepTutor/releases/contributors/readme/issues?state=all&per_page=15&sort=updated/contents/(root、deeptutor/、partners/channels、learning、capabilities、capabilities/obsidian)/contents/...whatsapp.py/...grading.py;search repos "ai tutor agent";search repos --topic ai-tutor;search code --repo HKUDS/DeepTutor "manim"
§5 擴充補掃(gh):search repos × {"llm tutor"(1 hit>300★,教學影片誤中)、"ai tutoring platform"(0)、"personalized learning llm"(0)、"socratic tutor"(0)、"study assistant llm"(0)、"notebooklm open source"(0,多詞 AND 陷阱)、"ai tutor"、"tutor gpt"、"notebooklm"、"quiz generator"(0>500★)、"education llm"(0>500★)、"learning agent"(全是 RL 誤中)、"anki llm"(0>400★)、"flashcard ai"(0>400★)、"exam prep"};--topic education --topic llm;直接點名 api:plastic-labs/tutor-gpt、learnhouse、lfnovo/open-notebook、ECNU-ICALK/EduChat、MODSetter/SurfSense、CaviraOSS/PageLM、JushBJJ/Mr.-Ranedeer、TIGER-AI-Lab/TheoremExplainAgent;LICENSE 原文開檔:SurfSense(Apache+BSL 混合)、PageLM(自訂 Community License)
§5 擴充補掃(HN Algolia):SurfSense(5 則全 ≤3 pts)、PageLM(Show HN 2 pts)、Open Notebook NotebookLM(最高 6 pts)——三家 HN 聲量皆低,口碑主要在 GitHub 社群層
curl:Scorecard(空)/ecosyste.ms(回)/pypistats overall(回)/deps.dev pypi/deeptutor(回)/HN Algolia query=DeepTutor(8 hits,多為 knowhiz 同名品)
WebSearch:HKUDS DeepTutor reddit experience problems review(未達 reddit)/"DeepTutor" HKUDS selfhosted OR LocalLLaMA reddit 使用心得(未達 reddit)
Hermes:X 搜尋 14 天內 HKUDS DeepTutor(3 則)
0 結果查詢:無(Scorecard 無資料一則如上標註)
觸發:EverOS forge 心臟「Boox 行為遙測→縱向反思」拓撲拍板(分層分家)後,radar 針對記憶內臟補挖。快照更新:31,252★/fork 4,090/v1.5.7(07-30,兩天一發);X 輿情 3 則(07-26~30)仍全正面,@TheTechDiggest「~30K 星」與 gh 實測吻合。
核心發現:DeepTutor 記憶三層=「分層分家」的先例驗證。 services/memory/__init__.py 明文:L1=raw event capture(append-only JSONL per surface per day)→ consolidator(LLM-driven L1→L2、L2→L3)→ L2/L3 策展 md(腳註出處回鏈)。與 EverOS 07-31 拍板的「raw 事件 jsonl per-learner → 週期反思 job → learned md」逐層同構——拓撲有人走通過,直接抄結構。
偷什麼清單(Apache-2.0 全合法):
| 零件 | 位置 | 抄什麼 |
|---|---|---|
| TraceEvent 信封 | services/memory/trace.py |
id/ts/surface/kind/payload/session_id/turn_id——kind+payload 開放式 schema,先開放後收斂;ULID 式 id |
| 錄寫紀律 | 同上 | log-and-swallow:遙測寫入永不炸主流程(every append wrapped)+per-surface asyncio lock |
| consolidator 四模式 | services/memory/consolidator/modes/ |
audit/dedup/merge/update 分開建模+L2/L3 分層 prompt(en/zh 雙語 yaml)——反思引擎的現成參考實作 |
| mastery 起步式 | learning/mastery.py |
recency-weighted accuracy+confidence cap(「一次幸運答對不算精通」),48 行、明文可換 IRT/BKT——v1 不必先上重模型 |
| 錯誤/知識分類 | learning/models.py |
ErrorType 四分類(structural/deviation/application/metacognitive)+KnowledgeType 四分類,各配間隔複習序列(scheduler.py) |
| 多學習者治理 | multi_user/ |
identity/grants/knowledge_access/audit——per-learner 隔離的現成藍圖,正對試點學生治理決策點 |
| 學習迴路 | learning/models.py LearningStage |
diagnostic→explain→feynman_check→practice→error_diagnosis→review |
⚠️ 術語撞名:DeepTutor 的 L1/L2/L3(raw traces/summaries/synthesis)≠ EverOS 的 L1/L2/L3(遺忘更新層/Reasoning 層/harness 蒸餾層)。層義不同,GLOSSARY 應登錄消歧,跨文件引用必帶出處。
它沒有的(縫仍空著):無手寫/pen 遙測(§3 已判);trace 只收自家 surface 事件,無外部事件匯入 API——Boox 事件流要進它的三層得改它,不如抄結構自建。
tier: quick。升級 deep 可加掃:中文圈(V2EX/知乎/掘金)災情面、gh search issues 下游反查(誰在整合它)、awesome-education 清單定位、arXiv 論文精讀、Wayback 無需(專案存活)。本報告為 2026-07-29 時間快照(§9 增補 2026-07-31),>3 個月後引用請先重掃。