2026-02-28 09:40:18 +08:00

4.6 KiB

Raw Blame History

🎉 AI 虚拟恋人项目 - 启动总结

✅ 项目已完全配置完成

📊 项目结构

E:\Github\Ai_GirlFriend\
├── lover/                    # Python FastAPI 后端（AI 核心服务）
├── xunifriend_RaeeC/         # PHP FastAdmin 后台（管理系统）
├── xuniYou/                  # uni-app 移动端（前端应用）
├── 启动项目.bat              # 一键启动后端服务
└── 各种配置和文档...

🚀 快速启动

1. 启动后端服务

双击运行：

启动项目.bat

服务地址：

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

测试页面

数据库测试: http://192.168.1.141:30100/test_db.php
健康检查: http://192.168.1.141:30101/health

💡 开发建议

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 进程号

📞 技术支持

项目文档

查看项目根目录下的各个 .md 文件
每个文档都有详细的说明和示例

🎊 恭喜！

你的 AI 虚拟恋人项目已经完全配置完成并可以正常运行了！

现在你可以：

✅ 启动后端服务
✅ 启动移动端应用
✅ 测试所有功能
✅ 开始开发和定制

祝你开发顺利！ 🚀

4.6 KiB Raw Blame History Unescape Escape