4.6 KiB
4.6 KiB
🎉 AI 虚拟恋人项目 - 启动总结
✅ 项目已完全配置完成
📊 项目结构
E:\Github\Ai_GirlFriend\
├── lover/ # Python FastAPI 后端（AI 核心服务）
├── xunifriend_RaeeC/ # PHP FastAdmin 后台（管理系统）
├── xuniYou/ # uni-app 移动端（前端应用）
├── 启动项目.bat # 一键启动后端服务
└── 各种配置和文档...
🚀 快速启动
1. 启动后端服务
双击运行：
启动项目.bat
服务地址：
- PHP 后台：http://192.168.1.141:30100
- Python API：http://192.168.1.141:30101
- API 文档：http://192.168.1.141:30101/docs
2. 启动移动端
使用 HBuilderX（推荐）：
- 打开 HBuilderX
- 文件 → 打开目录 → 选择
xuniYou文件夹 - 运行 → 运行到浏览器 → Chrome
或使用命令行：
cd xuniYou
npm install
npm run dev:h5
📋 已完成的配置
✅ 数据库配置
- 数据库名：ai_friend
- 主机：localhost:3306
- 用户：root
- 密码：rootx77
- 数据表：已导入（30+ 张表）
✅ Python 依赖
所有必需的包已安装：
- fastapi, uvicorn, sqlalchemy, pymysql
- oss2, dashscope, pydantic
- python-multipart 等
✅ PHP 依赖
Composer 依赖已安装（vendor 目录）
✅ 移动端配置
- API 地址已更新为：192.168.1.141
- 配置文件：xuniYou/utils/request.js
🎯 核心功能
后端 API
- ✅ 用户认证和管理
- ✅ AI 对话（流式响应）
- ✅ 图像生成（Wan2.6）
- ✅ 视频生成（跳舞、唱歌）
- ✅ 语音合成（TTS）
- ✅ 服装换装
- ✅ 社交功能（好友、动态）
移动端
- ✅ 登录注册
- ✅ 创建虚拟恋人
- ✅ 聊天对话
- ✅ 换装系统
- ✅ 视频功能
- ✅ 社交互动
📚 重要文档
| 文档名称 | 用途 |
|---|---|
| 快速启动指南.md | 快速上手指南 |
| 运行指南.md | 详细安装教程 |
| 移动端使用指南.md | 移动端完整说明 |
| 配置总结.md | 所有配置汇总 |
| 故障排查指南.md | 问题解决方案 |
🔧 常用命令
启动服务
# 启动后端（PHP + Python）
启动项目.bat
# 启动移动端
cd xuniYou
npm run dev:h5
停止服务
- 关闭对应的命令行窗口即可
重启服务
- 关闭所有服务窗口
- 重新运行
启动项目.bat
🌐 访问地址
开发环境
- PHP 后台: http://192.168.1.141:30100
- Python API: http://192.168.1.141:30101
- API 文档: http://192.168.1.141:30101/docs
- 管理后台: http://192.168.1.141:30100/admin
- 移动端 H5: http://localhost:8080
测试页面
💡 开发建议
1. 日常开发流程
- 启动后端服务（
启动项目.bat） - 启动移动端（HBuilderX 或命令行）
- 在浏览器中测试功能
- 修改代码后自动热重载
2. API 测试
- 使用 API 文档页面：http://192.168.1.141:30101/docs
- 可以直接在浏览器中测试所有接口
3. 数据库管理
- 使用 Navicat、DBeaver 等工具
- 连接信息：localhost:3306, root/rootx77, ai_friend
⚠️ 注意事项
1. IP 地址
- 当前配置的 IP：192.168.1.141
- 如果 IP 变化，需要修改：
xuniYou/utils/request.js
2. 端口占用
- PHP：30100
- Python：30101
- 移动端：8080（H5 模式）
3. 防火墙
- 确保防火墙允许这些端口
- 或者临时关闭防火墙测试
🐛 常见问题快速解决
问题 1：后端启动失败
解决： 运行 终极修复依赖.bat
问题 2：移动端连接失败
解决： 检查 xuniYou/utils/request.js 中的 IP 地址
问题 3：数据库连接失败
解决： 确保 MySQL 服务运行：net start MySQL80
问题 4：端口被占用
解决：
netstat -ano | findstr :30100
taskkill /F /PID 进程号
📞 技术支持
相关文档
- FastAPI: https://fastapi.tiangolo.com/
- uni-app: https://uniapp.dcloud.net.cn/
- ThinkPHP: https://www.thinkphp.cn/
项目文档
- 查看项目根目录下的各个 .md 文件
- 每个文档都有详细的说明和示例
🎊 恭喜！
你的 AI 虚拟恋人项目已经完全配置完成并可以正常运行了！
现在你可以：
- ✅ 启动后端服务
- ✅ 启动移动端应用
- ✅ 测试所有功能
- ✅ 开始开发和定制
祝你开发顺利！ 🚀