# language-tutor

**Repository Path**: xiaohaoxing96/language-tutor

## Basic Information

- **Project Name**: language-tutor
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-01
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🌍 外语陪练

通过和 AI 进行外语对话来练习语言的应用。

## 功能

- 选择目标语言（英语、日语、西班牙语、法语、韩语、德语）
- 选择感兴趣的话题
- 智能对话练习
- 简洁的界面设计

## 快速开始

### 方式一：本地开发（推荐）

**后端**:
```bash
cd server
cp .env.example .env
# 编辑 .env 添加你的 MiniMax API Key 和 Group ID
npm install
npm run dev
```

**前端**:
```bash
cd client
npm install
npm run dev
```

访问 http://localhost:3000

### 方式二：Docker 部署（生产环境）

```bash
# 1. 设置 API Key
cp server/.env.example server/.env
# 编辑 server/.env 添加你的 MiniMax API Key 和 Group ID

# 2. 构建并启动
docker compose up -d --build

# 3. 访问
# 前端: http://localhost:3000
# 后端 API: http://localhost:4000
```

### 方式三：Docker 开发模式

```bash
docker compose -f docker-compose.dev.yml up -d
```

## Docker 部署说明

| 模式 | 命令 | 访问地址 | 说明 |
|------|------|----------|------|
| 生产 | `docker compose up -d --build` | http://localhost:3000 | 构建镜像，部署生产版 |
| 开发 | `docker compose -f docker-compose.dev.yml up -d` | http://localhost:3000 | 热重载开发模式 |

## 停止服务

```bash
# 生产模式
docker compose down

# 开发模式
docker compose -f docker-compose.dev.yml down
```

## 项目结构

```
language-tutor/
├── client/              # 前端 (React + Vite)
│   ├── Dockerfile
│   ├── nginx.conf
│   └── src/
├── server/              # 后端 (Node.js + Express)
│   ├── Dockerfile
│   └── index.js
├── docker-compose.yml        # 生产部署
├── docker-compose.dev.yml   # 开发环境
├── .dockerignore
└── REQUIREMENTS.md           # 需求文档
```

## 技术栈

- **前端**: React, Vite, CSS
- **后端**: Node.js, Express
- **AI**: MiniMax (abab6.5s-chat)

## 未来功能

详见 [REQUIREMENTS.md](./REQUIREMENTS.md)

- 语法纠错
- 生词本
- 语音输入/输出
- 场景化对话（餐厅、机场等）
- 用户系统