# AI 有声书 - 快速开始指南

## 🎯 5 分钟快速体验

### 前置要求
- Node.js >= 18
- MySQL >= 8.0
- FFmpeg（可选，用于真实音频生成）

---

## 🚀 步骤 1: 启动后端（2 分钟）

```bash
# 进入后端目录
cd server

# 安装依赖（首次运行）
npm install

# 复制环境配置
cp .env.example .env

# 启动开发服务器
npm run dev
```

看到以下输出表示成功：
```
✅ MySQL 连接成功
🚀 服务启动成功：http://localhost:3000
```

---

## 🎨 步骤 2: 启动前端（2 分钟）

```bash
# 进入前端目录
cd client

# 安装依赖（首次运行）
npm install

# 启动 H5 开发服务器
npm run dev:h5
```

看到以下输出表示成功：
```
  VITE v5.x.x  ready in xxx ms

  ➜  Local:   http://localhost:8080/
  ➜  Network: use --host to expose
```

---

## 🎵 步骤 3: 体验功能（1 分钟）

### 访问应用
打开浏览器访问：`http://localhost:8080`

### 快速测试流程

1. **登录**
   - 输入任意手机号（如：13800138000）
   - 验证码输入：`123456`（开发环境免密）
   - 点击登录

2. **生成音频**
   - 点击底部"+"按钮
   - 输入文本内容
   - 选择音色
   - 调节参数（可选）
   - 点击"生成音频"

3. **播放音频**
   - 自动生成后会跳转到播放页面
   - 可以播放、暂停、调节进度
   - 支持倍速播放

4. **查看历史**
   - 返回首页可以看到所有生成的音频
   - 点击卡片可以播放
   - 支持收藏、删除等操作

---

## 💡 常见问题

### Q1: 后端启动失败？
```bash
# 检查 MySQL 是否运行
# Windows: 服务管理器查看 MySQL 服务
# Mac: brew services list
# Linux: systemctl status mysql
```

### Q2: 前端无法访问后端？
确保后端在 `http://localhost:3000` 运行，前端代理会自动转发请求。

### Q3: 没有声音？
- 开发环境使用 Mock TTS，会生成静音音频
- 需要配置真实的 TTS 服务（阿里云、讯飞等）

---

## 🔧 配置真实 TTS 服务（可选）

### 阿里云百炼 Qwen TTS

1. 访问 https://dashscope.console.aliyun.com/
2. 创建账号并获取 API Key
3. 编辑 `server/.env`:
```bash
DASHSCOPE_API_KEY=your-api-key
```

### 讯飞语音

1. 访问 https://www.xfyun.cn/
2. 创建应用获取 credentials
3. 编辑 `server/.env`:
```bash
IFLYTEK_APP_ID=your-app-id
IFLYTEK_API_KEY=your-api-key
IFLYTEK_API_SECRET=your-api-secret
```

---

## 📱 多平台支持

### H5
```bash
cd client
npm run dev:h5
# 访问 http://localhost:8080
```

### 微信小程序
```bash
cd client
npm run dev:mp-weixin
# 用微信开发者工具打开 dist/dev/mp-weixin
```

---

## 📚 更多文档

- [完整 API 文档](./docs/API.md)
- [部署指南](./docs/DEPLOY.md)
- [项目总结](./PROJECT_SUMMARY.md)

---

## 🎉 开始创作吧！

现在你已经成功启动了 AI 有声书应用，开始享受文字转声音的魔法吧！✨
