225 lines
4.6 KiB
Markdown
225 lines
4.6 KiB
Markdown
# 🎉 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（推荐）：**
|
||
1. 打开 HBuilderX
|
||
2. 文件 → 打开目录 → 选择 `xuniYou` 文件夹
|
||
3. 运行 → 运行到浏览器 → Chrome
|
||
|
||
**或使用命令行：**
|
||
```cmd
|
||
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 | 问题解决方案 |
|
||
|
||
---
|
||
|
||
## 🔧 常用命令
|
||
|
||
### 启动服务
|
||
```cmd
|
||
# 启动后端（PHP + Python）
|
||
启动项目.bat
|
||
|
||
# 启动移动端
|
||
cd xuniYou
|
||
npm run dev:h5
|
||
```
|
||
|
||
### 停止服务
|
||
- 关闭对应的命令行窗口即可
|
||
|
||
### 重启服务
|
||
1. 关闭所有服务窗口
|
||
2. 重新运行 `启动项目.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
|
||
|
||
### 测试页面
|
||
- **数据库测试**: http://192.168.1.141:30100/test_db.php
|
||
- **健康检查**: http://192.168.1.141:30101/health
|
||
|
||
---
|
||
|
||
## 💡 开发建议
|
||
|
||
### 1. 日常开发流程
|
||
1. 启动后端服务（`启动项目.bat`）
|
||
2. 启动移动端（HBuilderX 或命令行）
|
||
3. 在浏览器中测试功能
|
||
4. 修改代码后自动热重载
|
||
|
||
### 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：端口被占用
|
||
**解决：**
|
||
```cmd
|
||
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 虚拟恋人项目已经完全配置完成并可以正常运行了！
|
||
|
||
**现在你可以：**
|
||
1. ✅ 启动后端服务
|
||
2. ✅ 启动移动端应用
|
||
3. ✅ 测试所有功能
|
||
4. ✅ 开始开发和定制
|
||
|
||
**祝你开发顺利！** 🚀
|