Tolan - 语音聊天助手

语音交互英语学习应用，通过与动画IP对话练习英语口语。

技术栈

前端

React 18 + TypeScript
Zustand (状态管理)
Ant Design (UI组件)
Lottie (动画)
WebSocket (实时通信)
Web Audio API (音频处理)

后端

FastAPI (Web框架)
WebSocket (实时通信)
DashScope (阿里云Qwen模型)
STT: paraformer-realtime-v2
LLM: qwen-plus
TTS: qwen3-tts-flash

快速开始

1. 后端

cd backend
python -m pip install -r requirements.txt
cp .env.example .env  # 配置API Key
python main.py

2. 前端

cd frontend
npm install
cp .env.example .env  # 配置WebSocket地址
npm run dev

访问

前端: https://localhost:3000
后端: http://localhost:8000

核心功能

实时语音录制和传输
语音识别 (STT)
智能对话 (LLM)
语音合成 (TTS)
动画IP三状态切换（等、听、说）
情感表达

配置

API Key

在 backend/.env 中配置：

DASHSCOPE_API_KEY=your-api-key

WebSocket地址

在 frontend/.env 中配置：

VITE_WS_URL=wss://localhost:8000/ws