TutorClaw: Agent-Native 个性化学习助手

✨ 主要功能

• 统一聊天工作区 — 六种模式，一个线程。聊天、深度解题、智能出题、深度研究、数学动画生成、可视化共享同一上下文。
• AI 协作写作 — 多文档 Markdown 工作区，AI 作为第一类协作者。选择文本进行重写、扩展或摘要。
• 知识中心 — 上传 PDF、Markdown 和文本文件构建 RAG 就绪的知识库。
• 自进化记忆 — 设计 Agent 学习策略沉淀机制，对复杂解题、资料研读与错误纠正过程进行自动总结；结合 Tool Trace、任务结果评估与用户确认，将高价值学习路径封装为可复用 Skill，提升后续相似任务的辅导效率。
• 个人 TutorBot — 集成常驻型 TutorBot 机制，为每个 Bot 提供独立工作区、人格模板、技能扩展能力，并支持基于心跳机制的主动提醒与任务触发，使系统从被动问答升级为持续陪伴式学习 Agent。

---

📖 项目架构

💬 聊天 — 统一智能工作区

五种模式共处同一工作区，由统一上下文管理串联：历史、知识库与引用跨模式保留，同一主题下可随时切换。

模式	作用
聊天	工具增强对话：RAG、联网搜索、代码执行、深度推理、头脑风暴、论文检索，按需组合。
深度解题	多智能体解题：规划、检索、求解与验证，步步可溯源引用。
智能出题	基于知识库出题，内置校验。
深度研究	主题拆解、并行调研 RAG/网络/论文，输出带引用报告。
数学动画	基于 Manim 将数学概念可视化为动画与分镜。
可视化	数据与概念的可视化展示。

✍️ Co-Writer — 编辑器里的 AI

Co-Writer 把聊天的智能放进写作界面：完整 Markdown 编辑器，AI 是一等协作者，而非侧栏挂件。

🎓 引导式学习 — 可视化、分步掌握

将个人材料变成结构化、多步学习路径。

📚 知识管理 — 学习基础设施

🧠 记忆 — 与你一同成长

🦞 TutorBot — 持久、自主的 AI 导师

⌨️ CLI — 智能体原生界面

---

🚀 快速开始

前置要求

需求	版本	检查命令
Git	任意	git --version
Python	3.11+	python --version
Node.js	18+	node --version
npm	9+	npm --version

安装步骤

# 克隆项目
git clone https://github.com/Young-Allen/TutorClaw.git
cd TutorClaw

# 创建并激活 Python 虚拟环境
conda create -n tutorclaw python=3.11 && conda activate tutorclaw
# 或使用 venv
python -m venv .venv && source .venv/bin/activate  # macOS/Linux
python -m venv .venv && .venv\Scripts\activate       # Windows

# 安装依赖
pip install -e ".[server]"

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件填入你的 API key

# 启动服务
python scripts/start_web.py

使用 Docker

cp .env.example .env
# 编辑 .env 填入 API key
docker compose up -d

---

📖 项目说明

本项目是对 DeepTutor 的学习研究副本。

原始项目特点：

• 基于 Agent 原生架构的多智能体协作系统
• 集成 RAG、深度推理、多模态学习能力
• 支持 TutorBot 持久化自主学习助手
• CLI 和 Web 双界面

本项目基于原始版本进行了以下研究性修改：

• 增加自进化记忆，实现学习知识的沉淀并复用为 Skill
• 混合检索实现，
• 部分功能调整

---

📋 环境变量配置

# 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

---

🙏 致谢

本项目 Fork 自 HKUDS/DeepTutor，本人出于学习目的对其进行了一定的研究和修改，感谢原始作者的出色工作！

原始项目致谢：

项目	角色
nanobot	超轻量级 Agent 引擎
LlamaIndex	RAG 管道和文档索引
ManimCat	数学动画生成

---

📄 许可证

本项目遵循 Apache License 2.0 许可证。

⚠️ 本项目仅供学习研究使用，不得用于商业目的。如有侵权请联系删除。