[Open Source] AI 學習夥伴 DeepTutor，現在就開始！

打造你的專屬 AI 學習夥伴：DeepTutor 深度體驗與上手指南（繁體中文）

哈囉，台灣的學習者們！ 你是否厭倦了傳統的學習方式，希望能擁有一個更個人化、更智能的學習體驗？ 讓我來介紹一款由香港大學數據科學實驗室開發的開源專案：DeepTutor。 它不僅僅是一個聊天機器人，更是一個Agent-Native 個人化輔導系統，能讓你打造專屬的 AI 學習夥伴，深入探索各種知識領域。

什麼是 DeepTutor？ 為什麼值得你關注？

DeepTutor 顛覆了我們對 AI 輔導系統的想像。它不是簡單的問答機器人，而是將多種 AI 輔助功能整合到一個統一的工作空間中。 你可以在同一個介面下，進行聊天、深度解題、測驗生成、深度研究，甚至利用數學動畫來學習。 更棒的是，DeepTutor 支援你建立個人化的 TutorBot，讓 AI 成為你持續學習的夥伴，陪伴你成長。

DeepTutor 的核心功能： 讓你愛不釋手的功能亮點

• 統一的聊天工作空間： 告別多個視窗切換的煩惱！ 在 DeepTutor 中，聊天、深度解題、測驗生成、深度研究和數學動畫全都整合在一個介面。 你可以在同一主題下自由切換模式，靈活運用各種工具，讓學習流程更順暢。

• 個人化的 TutorBot： 這不是一般的聊天機器人，而是自主的 AI 輔導員。 每個 TutorBot 都有自己的工作空間、記憶、個性及技能。 你可以打造一位蘇格拉底式的數學老師、一位耐心細心的寫作導師，或是嚴謹的研究顧問。 這些 TutorBot 會不斷學習、進化，成為你學習路上的最佳夥伴。

• AI Co-Writer： 想像一下，你的文字編輯器內建了 AI 助手！ Co-Writer 是一款功能齊全的 Markdown 編輯器，讓你可以在文章中輕鬆地重寫、擴展或簡短文字。 它能從你的知識庫和網路上獲取資訊，編輯後的內容也可以直接儲存到你的筆記本中， 完美融入你的學習生態。

• 引導式學習： 將你的學習資料轉化為結構化、視覺化的學習旅程。 DeepTutor 會為你設計多步驟的學習計畫， 建立互動式的網頁，讓你輕鬆掌握每個知識點， 並且在學習過程中進行討論與互動。 學習結束後，還能獲得學習摘要， 幫助你釐清學習重點。

• 知識中心： 上傳 PDF、Markdown 或純文字檔案， 建立 RAG (Retrieval-Augmented Generation) 知識庫。 你可以將不同主題的見解儲存在彩色筆記本中， 讓你的學習資料不再只是靜態儲存，而是積極地參與每一次的對話、研究與學習。

• 持久記憶： DeepTutor 會建立你的學習檔案， 記錄你的學習內容、學習方式及學習方向， 並在所有功能和 TutorBot 之間共享。 你的學習檔案會隨著你的每一次互動而變得更加完善， 讓你的學習體驗更加個人化且有效。

• Agent-Native CLI： 所有功能、知識庫、對話記錄、TutorBot 都可以透過指令列來操作。 DeepTutor 提供豐富的終端輸出，方便你理解。 更棒的是， 只要給 DeepTutor 一個 SKILL.md 檔案， 你的 AI 助手就能夠自主地操作它， 實現自動化學習。

快速上手 DeepTutor： 兩種安裝方式， 讓你輕鬆開始

DeepTutor 提供了多種安裝方式， 讓你可以依照自己的需求選擇：

A. 推薦方案： 互動式安裝導覽 (Setup Tour)

這是最簡單也最推薦的方式。 它提供了一個單一的互動式腳本， 引導你完成所有步驟： 安裝相依性、設定環境、測試連線、啟動。 不需要手動編輯 .env 檔案。

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

# 建立 Python 環境
conda create -n deeptutor python=3.11 && conda activate deeptutor
# 或者: python -m venv .venv && source .venv/bin/activate

# 啟動導覽
python scripts/start_tour.py

導覽會詢問你想要如何使用 DeepTutor：

• Web 模式 (推薦)： 選擇相依性配置檔，安裝所有東西 (pip + npm)， 然後啟動一個臨時伺服器， 並且在你的瀏覽器中開啟 Settings 頁面。 一個四步驟的導覽將引導你完成 LLM、Embedding 和 Search 提供者的設定， 並且進行即時連線測試。 完成後， DeepTutor 會自動重新啟動， 並套用你的設定。
• CLI 模式： 一個完全互動式的終端流程： 選擇相依性配置檔、安裝相依性、 設定提供者、 驗證連線、 並應用， 所有的操作都不需要離開 shell。

無論哪種方式， 你最終都會在 http://localhost:3782 看到運作中的 DeepTutor。

B. 手動本地安裝

如果你喜歡完全掌控，可以自己安裝並設定所有東西：

1. 安裝相依性

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor

conda create -n deeptutor python=3.11 && conda activate deeptutor
pip install -e ".[server]"

# 前端
cd web && npm install && cd ..

2. 設定環境

cp .env.example .env

編輯 .env 檔案， 至少填寫必填欄位：

# LLM (必填)
LLM_BINDING=openai
LLM_MODEL=gpt-4o-mini
LLM_API_KEY=sk-xxx
LLM_HOST=https://api.openai.com/v1

# Embedding (知識庫必填)
EMBEDDING_BINDING=openai
EMBEDDING_MODEL=text-embedding-3-large
EMBEDDING_API_KEY=sk-xxx
EMBEDDING_HOST=https://api.openai.com/v1
EMBEDDING_DIMENSION=3072

3. 啟動服務

# 後端 (FastAPI)
python -m deeptutor.api.run_server

# 前端 (Next.js) — 在另一個終端機
cd web && npm run dev -- -p 3782

在瀏覽器中開啟 http://localhost:3782， 就可以開始使用了。

C. Docker 部署

Docker 將後端和前端打包到一個容器中， 不需要本地安裝 Python 或 Node.js。 有兩種選擇， 取決於你的偏好：

1. 設定環境變數 (兩種選項都需要)

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor
cp .env.example .env

編輯 .env 檔案， 至少填寫必填欄位 (與 選項 B 相同)。

2a. 提取官方映像檔 (推薦)

官方映像檔發佈在 GitHub Container Registry， 每次發佈都會建立 linux/amd64 和 linux/arm64 版本。

docker compose -f docker-compose.ghcr.yml up -d

如果要釘選特定版本， 請在 docker-compose.ghcr.yml 中編輯映像檔標籤：

image: ghcr.io/hkuds/deeptutor:1.0.0  # 或者 :latest

2b. 從原始碼建置

docker compose up -d

這會從 Dockerfile 在本地建置映像檔， 並啟動容器。

3. 驗證與管理

一旦容器健康， 在 http://localhost:3782 開啟。

docker compose logs -f   # 追蹤日誌
docker compose down       # 停止並移除容器

D. 僅限 CLI

如果你只想要 CLI， 不需要 web 前端：

pip install -e ".[cli]"
deeptutor chat                                   # 互動式 REPL
deeptutor run chat "解釋傅立葉轉換"   # 單次執行功能
deeptutor run deep_solve "解 x^2 = 4"         # 多代理人解題
deeptutor kb create my-kb --doc textbook.pdf     # 建立知識庫

參閱 DeepTutor CLI， 瞭解完整的特性指南和命令參考。

深入探索 DeepTutor： 功能一覽， 打造你的專屬學習環境

以下提供你更深入的了解：

• Chat 聊天模式： 結合 RAG 檢索、 網路搜尋、程式碼執行、深度推理，甚至論文搜尋。 你可以隨時切換這些工具， 讓學習更具彈性。
• Co-Writer 協同寫作模式： 在 Markdown 編輯器中， AI 就像你的專屬助手。 你可以重寫、擴展、或是簡短你的文字， 並從你的知識庫或網路上獲取資訊。
• Guided Learning 引導式學習： 將你的學習資料轉化為結構化、視覺化的學習旅程。 逐步探索知識點， 並且在學習過程中進行討論。
• Knowledge Management 知識管理： 透過上傳檔案， 建立你的知識庫。 你可以將你的學習內容儲存在彩色筆記本中， 並且在每次對話、研究和學習中被主動利用。
• Memory 記憶功能： DeepTutor 具有持久記憶功能， 記錄你的學習進度、學習方式和學習方向， 並且在所有功能之間共享。
• TutorBot 你的專屬 AI 導師： 建立你的個人化 TutorBot， 讓 AI 成為你的長期學習夥伴。

開始使用 DeepTutor 後， 你可以這樣做：

• 透過互動式導覽， 快速安裝並啟動 DeepTutor。
• 上傳你的學習資料， 建立你的個人知識庫。
• 嘗試使用 Chat 模式， 與 AI 聊天、 提問， 探索不同工具。
• 使用 Co-Writer 功能， 在寫作時獲得 AI 協助。
• 建立你的個人 TutorBot， 並開始與它一起學習。

關於 DeepTutor CLI

DeepTutor 的 CLI 是它強大的核心。 你可以透過 CLI 來操作一切功能， 包括知識庫的管理、 TutorBot 的建立和啟動、 以及各種功能的執行。

DeepTutor CLI 的指令範例：

# 建立新的知識庫
deeptutor kb create my-knowledge-base --doc my-document.pdf

# 查詢知識庫
deeptutor kb search my-knowledge-base "線性代數"

# 啟動與知識庫關聯的聊天
deeptutor chat --kb my-knowledge-base

# 建立你的個人數學 TutorBot
deeptutor bot create my-math-tutor --persona "一位使用探究式問題的蘇格拉底數學老師"

# 啟動 TutorBot
deeptutor bot start my-math-tutor

DeepTutor 帶給你的不僅僅是學習

DeepTutor 是一款強大的工具， 它可以幫助你：

• 提升學習效率： 透過整合多種 AI 功能， 節省時間， 更專注於學習內容。
• 加深理解： 透過互動式聊天、引導式學習， 更深入地理解知識。
• 打造個人化學習體驗： 建立自己的 TutorBot， 打造專屬的學習夥伴。
• 探索更多可能性： 透過 CLI 介面， 整合 DeepTutor 到你的工作流程中。

DeepTutor 是一個不斷成長的專案

DeepTutor 仍在不斷發展， 未來的發展方向包括：

• 使用者認證與登入
• 主題與外觀
• LightRAG 整合
• 更完善的文檔

加入 DeepTutor 社群

如果你覺得 DeepTutor 對你有幫助， 歡迎到 GitHub 上給我們一個 star， 幫助我們不斷前進！ 遇到任何問題， 也可以在 GitHub Discussions 提出。 讓我們一起打造更美好的學習體驗！

參考閱讀

https://github.com/HKUDS/DeepTutor

About the Author

n8n n8n

Administrator

View All Posts