187 lines
3.9 KiB
Markdown
187 lines
3.9 KiB
Markdown
|
# AI 女友项目 - 快速参考
|
|||
|
|
|
|||
|
|
## 🚀 启动命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 方法 1：使用启动脚本（推荐）
|
|||
|
|
双击 "启动项目.bat"
|
|||
|
|
|
|||
|
|
# 方法 2：手动启动
|
|||
|
|
# PHP 服务器
|
|||
|
|
cd xunifriend_RaeeC/public
|
|||
|
|
php -S 0.0.0.0:30100 router.php
|
|||
|
|
|
|||
|
|
# Python 后端
|
|||
|
|
python -m uvicorn lover.main:app --host 0.0.0.0 --port 30101 --reload
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🌐 服务地址
|
|||
|
|
|
|||
|
|
| 服务 | 地址 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| PHP 后台 | http://127.0.0.1:30100/admin | 用户管理、后台管理 |
|
|||
|
|
| Python API | http://127.0.0.1:30101/docs | AI 功能、API 文档 |
|
|||
|
|
| 健康检查 | http://127.0.0.1:30101/health | 服务状态检查 |
|
|||
|
|
|
|||
|
|
## 📡 API 端点
|
|||
|
|
|
|||
|
|
### 语音对话
|
|||
|
|
|
|||
|
|
| 端点 | 方法 | 功能 | 响应时间 |
|
|||
|
|
|------|------|------|---------|
|
|||
|
|
| `/voice/call/asr` | POST | 仅 ASR 识别 | 3-5秒 |
|
|||
|
|
| `/voice/call/conversation` | POST | 完整对话（ASR+LLM+TTS） | 7-15秒 |
|
|||
|
|
|
|||
|
|
### 请求格式
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"audio_data": "base64编码的音频",
|
|||
|
|
"format": "wav"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 响应格式
|
|||
|
|
|
|||
|
|
**ASR 模式**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 1,
|
|||
|
|
"msg": "ok",
|
|||
|
|
"data": {
|
|||
|
|
"text": "识别的文字"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**对话模式**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 1,
|
|||
|
|
"msg": "ok",
|
|||
|
|
"data": {
|
|||
|
|
"user_text": "用户说的话",
|
|||
|
|
"ai_text": "AI的回复",
|
|||
|
|
"audio_data": "base64编码的AI语音",
|
|||
|
|
"audio_format": "mp3"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🔧 前端配置
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
// xuniYou/utils/request.js
|
|||
|
|
|
|||
|
|
// 本地开发
|
|||
|
|
export const baseURL = 'http://127.0.0.1:30100'
|
|||
|
|
export const baseURLPy = 'http://127.0.0.1:30101'
|
|||
|
|
|
|||
|
|
// 局域网测试（替换为你的电脑 IP）
|
|||
|
|
export const baseURL = 'http://192.168.1.141:30100'
|
|||
|
|
export const baseURLPy = 'http://192.168.1.141:30101'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🔍 调试命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 检查端口占用
|
|||
|
|
netstat -ano | findstr :30100
|
|||
|
|
netstat -ano | findstr :30101
|
|||
|
|
|
|||
|
|
# 测试健康检查
|
|||
|
|
curl http://127.0.0.1:30101/health
|
|||
|
|
|
|||
|
|
# 查看进程
|
|||
|
|
tasklist | findstr php.exe
|
|||
|
|
tasklist | findstr python.exe
|
|||
|
|
|
|||
|
|
# 停止进程
|
|||
|
|
taskkill /F /IM php.exe
|
|||
|
|
taskkill /F /IM python.exe
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📋 环境变量
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# .env 文件
|
|||
|
|
|
|||
|
|
# DashScope API Key（必需）
|
|||
|
|
DASHSCOPE_API_KEY=sk-xxx
|
|||
|
|
|
|||
|
|
# OSS 配置（语音功能必需）
|
|||
|
|
ALIYUN_OSS_ACCESS_KEY_ID=xxx
|
|||
|
|
ALIYUN_OSS_ACCESS_KEY_SECRET=xxx
|
|||
|
|
ALIYUN_OSS_BUCKET_NAME=xxx
|
|||
|
|
ALIYUN_OSS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com
|
|||
|
|
ALIYUN_OSS_CDN_DOMAIN=https://xxx.oss-cn-hangzhou.aliyuncs.com
|
|||
|
|
|
|||
|
|
# 数据库
|
|||
|
|
DATABASE_URL=mysql+pymysql://root:password@localhost:3306/fastadmin
|
|||
|
|
|
|||
|
|
# LLM 配置
|
|||
|
|
LLM_MODEL=qwen-plus
|
|||
|
|
LLM_TEMPERATURE=0.8
|
|||
|
|
LLM_MAX_TOKENS=2000
|
|||
|
|
|
|||
|
|
# TTS 配置
|
|||
|
|
VOICE_CALL_TTS_MODEL=cosyvoice-v2
|
|||
|
|
VOICE_CALL_TTS_VOICE=longxiaochun_v2
|
|||
|
|
|
|||
|
|
# ASR 配置
|
|||
|
|
VOICE_CALL_ASR_MODEL=paraformer-v2
|
|||
|
|
VOICE_CALL_ASR_SAMPLE_RATE=16000
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🐛 常见错误
|
|||
|
|
|
|||
|
|
| 错误 | 原因 | 解决方案 |
|
|||
|
|
|------|------|---------|
|
|||
|
|
| 端口被占用 | 服务已在运行 | 使用启动脚本自动清理 |
|
|||
|
|
| ModuleNotFoundError | Python 依赖缺失 | `pip install -r lover/requirements.txt` |
|
|||
|
|
| 连接失败 | 前端配置错误 | 检查 `request.js` 中的 IP 和端口 |
|
|||
|
|
| ASR 识别失败 | 音频格式错误 | 使用 WAV 格式，16kHz，单声道 |
|
|||
|
|
| OSS 上传失败 | OSS 配置错误 | 检查 `.env` 中的 OSS 配置 |
|
|||
|
|
|
|||
|
|
## 📊 性能指标
|
|||
|
|
|
|||
|
|
| 步骤 | 时间 |
|
|||
|
|
|------|------|
|
|||
|
|
| 录音 | 2-5秒 |
|
|||
|
|
| ASR 识别 | 2-5秒 |
|
|||
|
|
| LLM 生成 | 1-3秒 |
|
|||
|
|
| TTS 合成 | 1-2秒 |
|
|||
|
|
| **总计** | **7-15秒** |
|
|||
|
|
|
|||
|
|
## 🎯 测试流程
|
|||
|
|
|
|||
|
|
1. 双击 `启动项目.bat`
|
|||
|
|
2. 等待两个窗口启动完成
|
|||
|
|
3. 访问 http://127.0.0.1:30101/docs 验证
|
|||
|
|
4. 打开前端应用
|
|||
|
|
5. 进入语音通话页面
|
|||
|
|
6. 按住说话按钮
|
|||
|
|
7. 说话 2-3 秒
|
|||
|
|
8. 松开按钮
|
|||
|
|
9. 等待 AI 回复
|
|||
|
|
10. 听到 AI 语音
|
|||
|
|
|
|||
|
|
## 📞 技术支持
|
|||
|
|
|
|||
|
|
遇到问题时提供：
|
|||
|
|
1. 前端控制台日志
|
|||
|
|
2. Python 后端窗口日志
|
|||
|
|
3. PHP 服务器窗口日志
|
|||
|
|
4. 环境配置信息
|
|||
|
|
5. 错误截图
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**快速链接**:
|
|||
|
|
- [完整启动指南](完整启动指南.md)
|
|||
|
|
- [语音对话功能说明](语音对话功能说明.md)
|
|||
|
|
- [语音对话快速开始](语音对话快速开始.md)
|
|||
|
|
- [ASR问题修复总结](ASR问题修复总结.md)
|
|||
|
|
|
|||
|
|
**最后更新**: 2026-03-05
|