audio_codebuddy/QUICK_START.md

AI 有声书 - 快速开始指南

🎯 5 分钟快速体验

前置要求

• Node.js >= 18
• MongoDB >= 6.0
• FFmpeg（可选，用于真实音频生成）

---

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

# 进入后端目录
cd server

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

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

# 启动开发服务器
npm run dev

看到以下输出表示成功：

✅ MongoDB 连接成功
🚀 服务启动成功：http://localhost:3000

---

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

# 进入前端目录
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: 后端启动失败？

# 检查 MongoDB 是否运行
# Windows: 服务管理器查看 MongoDB 服务
# Mac: brew services list
# Linux: systemctl status mongod

Q2: 前端无法访问后端？

确保后端在 http://localhost:3000 运行，前端代理会自动转发请求。

Q3: 没有声音？

• 开发环境使用 Mock TTS，会生成静音音频
• 需要配置真实的 TTS 服务（阿里云、讯飞等）

---

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

阿里云百炼 Qwen TTS

1. 访问 https://dashscope.console.aliyun.com/
2. 创建账号并获取 API Key

3. 编辑 server/.env:

   DASHSCOPE_API_KEY=your-api-key
   

讯飞语音

1. 访问 https://www.xfyun.cn/
2. 创建应用获取 credentials

3. 编辑 server/.env:

   IFLYTEK_APP_ID=your-app-id
   IFLYTEK_API_KEY=your-api-key
   IFLYTEK_API_SECRET=your-api-secret
   

---

📱 多平台支持

H5

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

微信小程序

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

---

📚 更多文档

• 完整 API 文档
• 部署指南
• 项目总结

---

🎉 开始创作吧！

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