Ai_GirlFriend/快速参考.md

AI 女友项目 - 快速参考

🚀 启动命令

# 方法 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秒

请求格式

{
  "audio_data": "base64编码的音频",
  "format": "wav"
}

响应格式

ASR 模式:

{
  "code": 1,
  "msg": "ok",
  "data": {
    "text": "识别的文字"
  }
}

对话模式:

{
  "code": 1,
  "msg": "ok",
  "data": {
    "user_text": "用户说的话",
    "ai_text": "AI的回复",
    "audio_data": "base64编码的AI语音",
    "audio_format": "mp3"
  }
}

🔧 前端配置

// 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'

🔍 调试命令

# 检查端口占用
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

📋 环境变量

# .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. 错误截图

---

快速链接:

• 完整启动指南
• 语音对话功能说明
• 语音对话快速开始
• ASR问题修复总结

最后更新: 2026-03-05