Le Agent

小乐语言学习助手 (Le-Agent)

[视频介绍](https://www.bilibili.com/video/BV1Cru2zVERp)

📖 项目简介

小乐语言学习助手是一个基于 AI Agent 的智能语言学习平台，集成了先进的语言模型、语音技术和互动学习功能，为用户提供个性化的语言学习体验。

✨ 核心特性

• 🤖 智能AI对话：基于通义千问、DeepSeek等先进语言模型
• 🎯 个性化学习：根据用户语言水平和学习目标定制内容
• 🗣️ 语音交互：支持语音合成（朗读）和语音识别（发音练习）
• 📚 智能内容解析：自动识别句子、词汇、生成翻译
• 🎮 互动学习模式：词汇跟读、句子练习、发音评估
• 🔧 工具扩展：支持MCP协议，可集成外部工具和资源
• 🌍 多语言支持：支持英语、中文、日语、韩语、法语、德语、俄语等

🚀 快速开始

环境要求

• Node.js 18+

安装运行

# 克隆项目

# 进入项目目录
cd le-agent

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建项目
pnpm build

# 启动生产服务器
pnpm start

环境配置

创建 `.env.local` 文件：

# 模型服务配置
MODEL_SCOPE_API_KEY=your_api_key
MODEL_SCOPE_BASE_URL=https://api.modelscope.com/v1

🎯 使用指南

1. 基础对话

• 访问主页开始与小乐对话
• 直接用自然语言描述学习需求

**示例对话：**

用户: 我想学习职场英语，请给我生成一段职场交流的短文
用户：我想学习日语，请你帮我生成一篇简单的日语短文

2. 学习模式使用

激活学习模式

• 当小乐生成学习内容时，会自动打开学习模式
• 或点击内容右上角的📖图标手动打开

学习功能

• 词汇学习：鼠标悬停词汇自动朗读，显示翻译
• 发音练习：点击🎤图标进行词汇跟读练习
• 句子练习：整句发音练习和评估
• 进度追踪：系统记录学习进度，词汇掌握状态

语音功能

• 自动朗读：启用后悬停词汇自动朗读
• 发音评估：
  • 🟢 绿色：发音正确（需连续2次成功）
  • 🔴 红色：需要改进
  • 🔵 蓝色：正在监听

3. 工具集成 (@mention)

使用 `@` 符号调用特定工具：

@tool("weather") 查询今天北京天气
@mcp("BingSearch") 搜索语言学习资料

可用工具

• Bing搜索工具：网络搜索、资料查找

4. 学习内容定制

学习主题

我想学习日语，我的母语是中文，我是初学者
帮我生成关于旅游的英语对话，难度适中

难度调节

• 初学者（Level 1）：基础词汇，简单句型
• 入门级（Level 2）：常用词汇，基本对话
• 中级（Level 3）：复杂句型，话题讨论
• 高级（Level 4）：专业词汇，深度交流
• 精通级（Level 5）：母语水平，学术讨论

📱 功能详解

智能学习内容生成

小乐能够生成结构化的学习内容，包含：

{
  "type": "article",
  "target_language": "en",
  "user_language": "zh",
  "article": {
    "content": "原文内容",
    "translation": "翻译内容",
    "sentence_groups": [
      {
        "sentence": "句子",
        "translation": "句子翻译",
        "words": [
          {
            "word": "单词",
            "translations": ["翻译1", "翻译2"]
          }
        ]
      }
    ]
  }
}

语音技术支持

语音合成（TTS）

• 支持50+种语言和方言
• 可调节语速、音调、音量
• 智能语言检测和适配

语