Le-Agent - AI英语学习系统

一个基于AI的智能英语学习系统，提供个性化学习体验、语音交互、词汇分析和自适应提示功能。

✨ 主要特性

🎯 个性化学习

• 用户画像系统: 支持CEFR级别评估（A1-C2）
• 学习目标定制: 日常对话、商务英语、学术写作等多种目标
• 自适应提示: 根据用户水平动态调整AI教学策略
• 进度追踪: 实时监控学习进展和成就

🗣️ 语音交互

• 语音合成: 支持多语言、多语速的单词和句子朗读
• 语音识别: 发音练习和跟读功能
• 实时反馈: 发音准确度评估和纠正建议

📊 智能分析

• 词汇复杂度分析: 基于lexicalrichness和TAALED库
• 文本难度评估: 自动计算CEFR级别和蓝思值
• 学习记忆系统: 智能记录和检索学习历史

🤖 AI集成

• 多模型支持: DeepSeek、Google Gemini、OpenAI等
• 流式对话: 实时AI对话体验
• 上下文记忆: 保持长期学习上下文

🚀 快速开始

环境要求

• Node.js 18+
• Python 3.8+ (用于词汇分析)
• pnpm 或 npm

安装步骤

1. 克隆仓库

git clone https://github.com/carson-557/le-agent.git
cd le-agent

2. 安装依赖

pnpm install
# 或
npm install

3. Python依赖

pip install lexicalrichness
# 可选：安装TAALED以获得更高级的分析功能

4. 环境配置

复制 .env.example 到 .env.local 并配置API密钥：

# AI模型配置
DEEPSEEK_API_KEY=your_deepseek_key
GOOGLE_GENERATIVE_AI_API_KEY=your_gemini_key
OPENAI_API_KEY=your_openai_key

# 应用配置
NEXT_PUBLIC_APP_URL=http://localhost:3001

5. 数据库初始化

npx prisma generate
npx prisma db push

6. 启动开发服务器

pnpm dev
# 或
npm run dev

访问 http://localhost:3001 开始使用！

📁 项目结构

le-agent/
├── app/                    # Next.js 应用路由
│   ├── (chat)/            # 聊天页面
│   ├── api/               # API路由
│   ├── onboarding/        # 用户引导
│   └── profile/           # 用户画像
├── components/            # React组件
│   ├── ui/               # 基础UI组件
│   ├── chat-box.tsx      # 聊天组件
│   └── leagent-*.tsx     # 学习相关组件
├── lib/                   # 核心库
│   ├── ai/               # AI集成
│   ├── db/               # 数据库操作
│   ├── memory/           # 记忆系统
│   └── learning/         # 学习分析
├── hooks/                 # React Hooks
├── types/                 # TypeScript类型定义
├── scripts/              # Python分析脚本
└── prisma/               # 数据库模式

🔧 核心功能模块

用户画像系统

• CEFR级别管理: A1到C2的欧洲语言标准
• 学习目标设置: 个性化学习路径
• 进度跟踪: 详细的学习统计

词汇分析引擎

• 复杂度计算: TTR、MTLD等指标
• 难度评估: 自动CEFR级别判断
• Python集成: 高性能分析后端

自适应AI系统

• 动态提示: 根据用户水平调整
• 记忆集成: 利用学习历史优化教学
• 多模型支持: 灵活的AI后端选择

语音交互系统

• TTS引擎: 高质量语音合成
• STT识别: 准确的语音识别
• 发音评估: 智能发音纠正

🛠️ 技术栈

前端

• Next.js 15: React全栈框架
• TypeScript: 类型安全
• Tailwind CSS: 现代化样式
• Radix UI: 无障碍组件库
• Framer Motion: 动画效果

后端

• Prisma: 数据库ORM
• SQLite: 轻量级数据库
• Python: 词汇分析后端
• Vercel AI SDK: AI集成

AI & 分析

• 多AI模型: DeepSeek、Gemini、OpenAI
• lexicalrichness: 词汇复杂度分析
• TAALED: 高级语言分析
• 自定义算法: 个性化推荐

📊 API文档

用户画像 API

// GET /api/profile
// 获取用户画像信息

// POST /api/profile
// 更新用户画像

词汇分析 API

// POST /api/lexical-analysis
// 分析文本复杂度和CEFR级别

聊天 API

// POST /api/chat
// AI对话接口，支持流式响应

🧪 测试

项目包含完整的测试报告，详见 TEST_REPORT.md。

运行测试：

# 启动开发服务器进行功能测试
pnpm dev

# Python脚本测试
python scripts/test_lexical_analyzer.ts

🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

Apache License 2.0 - 详见 LICENSE 文件

🙏 致谢

• Next.js - React框架
• Vercel AI SDK - AI集成
• Prisma - 数据库工具
• Radix UI - 组件库
• lexicalrichness - 词汇分析
• TAALED - 语言分析工具

📞 联系方式

如有问题或建议，请通过以下方式联系：

• GitHub Issues: 提交问题
• 项目主页: https://github.com/carson-557/le-agent

---

Le-Agent - 让AI助力你的英语学习之旅！ 🚀📚