# 趣味汉字乐园 (Chinese Character Pronunciation Application)

一个结合了人工智能、语音识别和遗忘曲线算法的智能中文发音练习 Web 应用。该项目基于阿里云 DashScope AI 服务，为用户提供个性化的汉字发音学习体验。

📌 项目概述

趣味汉字乐园 旨在帮助用户掌握标准的汉字发音。通过实时语音识别 (ASR)、文本转语音 (TTS) 和 AI 发音评测，系统能够实时反馈用户的发音准确度，并结合遗忘曲线算法进行科学的复习安排。

✨ 核心特性

🤖 AI 智能评测: 使用通义千问 (Qwen) 模型进行发音准确度评估。
🎙️ 实时语音识别: 基于阿里云 DashScope 的 Paraformer 实时 ASR 引擎。
🔊 自然语音合成: 使用 CosyVoice 高质量 TTS 引擎示范正确读音。
🧠 智能复习算法: 基于遗忘曲线的间隔重复学习系统。
📊 学习追踪: 完整的用户学习进度和统计分析。
🔒 用户认证: 安全的注册和登录系统。

🛠️ 技术栈

后端: Node.js, Express.js
前端: HTML5, CSS3, JavaScript (原生)
数据库: MySQL
AI 服务: 阿里云 DashScope (ASR, TTS, LLM)
实时通信: WebSocket
音频处理: FFmpeg, Web Audio API

📋 环境要求

在开始之前，请确保您的开发环境满足以下要求：

Node.js: v14.0.0 或更高版本
MySQL: v5.7 或更高版本
FFmpeg: 必须安装并添加到系统 PATH 中（用于音频处理）
阿里云账号: 需要开通 DashScope 服务并获取 API Key

🚀 快速开始

1. 克隆仓库

git clone https://github.com/zhchoice123/ali.git
cd ali

2. 安装依赖

npm install

3. 配置环境变量

在项目根目录下创建一个 .env 文件，并添加以下内容：

# 数据库配置
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_mysql_password
DB_NAME=chinese_learning

# 阿里云 DashScope 配置
DASHSCOPE_API_KEY=your_dashscope_api_key

# 服务器端口 (可选, 默认 3000)
PORT=3000

4. 初始化数据库

确保 MySQL 服务正在运行，并且您已经创建了对应的数据库用户（或者使用 root）。运行以下命令自动创建数据库表：

npm run init-db

5. 启动应用

npm start

服务器启动后，打开浏览器访问 http://localhost:3000。

📂 项目结构

ali/
├── public/                 # 静态文件 (HTML, CSS, JS)
│   ├── index.html          # 主页 (练习界面)
│   ├── login.html          # 登录页
│   └── profile.html        # 个人中心
├── src/
│   ├── config/             # 配置文件 (数据库等)
│   ├── middleware/         # Express 中间件 (认证等)
│   ├── routes/             # API 路由
│   └── services/           # 业务逻辑服务 (AI, 遗忘曲线等)
├── scripts/                # 独立脚本 (用于测试 AI 服务)
├── init-db.js              # 数据库初始化脚本
├── server.js               # 应用入口文件
└── package.json            # 项目依赖配置