主站

知识库

DeepTutor — 港大 Agent-native 学习伴侣，统一运行时

Properties1
tagsagent, anet, cross-platform, hkuds, memory, multi-agent, open-source

3分钟阅读

DeepTutor — 港大 Agent-native 学习伴侣，统一运行时

概览

  • 开源方：香港大学 HKUDS Group（Bingxi Zhao）
  • GitHub：https://github.com/HKUDS/DeepTutor
  • Star：25.9k（2026-07-15）
  • 协议：Apache-2.0
  • 定位：Agent-native 学习伴侣，统一运行时，解决工具割裂、上下文丢失
  • 文档：https://deeptutor.info
  • 部署端口：3782（本地运行，不上云）

核心架构

AgenticChatPipeline（智能体聊天流水线）

UnifiedContext (User Message + Session History + Memory + Persona + Skills)
    ↓
Think → Act → Call Tool → Observe → Respond (循环)
    ↓
StreamBus (事件实时推送到 Web UI / CLI / SDK)
  • Think：规划下一步行动
  • Act：决定直接回答或调用工具
  • Call Tool：从 ToolRegistry 调用工具（RAG / Memory / Web / Exec / MCP / Ask User）
  • Observe：读取工具返回结果
  • Respond：整合信息，生成最终答案或继续下一轮

三层 Memory

  • L1：工作区镜像 + 事件追踪（trace//.jsonl）
  • L2：分面摘要（L2/.md）
  • L3：跨面综合（L3/.md）

Memory Graph：可追溯 AI 结论来源（如“第 23 次对话的 L2 摘要”），提升可靠性。

多入口

  • CLI（命令行工具）
  • WebSocket API
  • REST API
  • Python SDK

多渠道接入（15+ channels）

Telegram / Slack / 飞书 / Discord / Email / WhatsApp 等

九大界面

Home / Partners / My Agents / Co-Writer / Book / Learning Space / Memory / Knowledge Center / Settings

本地部署

pip 安装

mkdir -p my-deeptutor && cd my-deeptutor
pip install -U deeptutor
deeptutor init && deeptutor start

打开：http://${LOCALIP}:3782

Docker 安装（Linux）

docker run --rm --name deeptutor \
  -p ${LOCALIP}:3782:3782 \
  --add-host=host.docker.internal:host-gateway \
  ghcr.io/hkuds/deeptutor:latest

注意：Linux 用户必须加 --add-host=host.docker.internal:host-gateway 才能连接本地模型。

依赖要求

  • Python ≥ 3.11
  • Node.js ≥ 20

版本

  • v1.5.0（2026-07-04，Python 3.14 兼容）
  • v1.0.0-beta.1：约 20 万行代码重写，从“工具集合”转向“Agent原生架构”

评价

优点

  • 活跃维护（55 release，3-5天一版）
  • 开源可审计（Apache-2.0）
  • 多IM渠道接入（15+ channels）
  • 底层重构（Agent Loop 写在底层，而非功能叠加）
  • 记忆溯源（Memory Graph 可查证据）

缺点

  • 迭代太快，文档有时比代码慢半拍
  • RAG 引擎有 4-5 个选项（LlamaIndex / PageIndex / GraphRAG / LightRAG / Obsidian），官方没明确推荐优先级
  • Embedding 模型选错会报“知识库错误”，Settings 文档不够细
  • 长期用 L3 提炼是否丢细节待验证

与现有系统的关联

  • Anet：跨平台消息投递、store-and-forward、共享 carrier（相关）
  • Agent 系统：NATS、multi-agent、peer-to-peer（相关）
  • gbrain：L3 知识库、记忆溯源（相关）

论文

arXiv 2604.26962（2026-04-10），维护团队：HKUDS Group

关键标语

“One runtime for every mode. 换目标，不换引擎。上下文跟着你走。”

关系图谱