AI 虚拟女友 — 一个全栈 AI 陪伴聊天应用
- 💬 多角色 AI 对话 — 流式输出，支持自定义角色人设
- 🎨 AI 绘画生成 — 集成豆包 Seedream，聊天中可生成图片
- 🖼️ 多模态图片识别 — 支持发送图片让 AI 理解
- 👤 用户系统 — 注册/登录、JWT 认证、角色权限
- 📝 聊天记录持久化 — SQLite / PostgreSQL，长期记忆
- 📊 管理后台 — 用户管理、系统配置
- 🐳 Docker 一键部署 — 含 Nginx + Let's Encrypt HTTPS
— 樱花粉色调、柔和圆角、温暖治愈
git clone https://github.com/314159ctl/virtual-gf.git
cd virtual-gfcp .env.example .env编辑 .env，填入你的 API Key：
DEEPSEEK_API_KEY=sk-your-deepseek-key
PAINTING_API_KEY=your-painting-api-keyDocker 部署（推荐）
# 完整生产环境（后端 + 前端 + Nginx + HTTPS）
docker compose -f docker-compose.prod.yml up -d本地开发
后端 (FastAPI 新版):
cd backend
pip install -e .
uvicorn app.main:app --reload --port 8000前端:
cd frontend
npm install
npm run dev后端 (Flask 旧版):
pip install -r requirements.txt
python app.py然后访问 http://localhost:5173（前端）或 http://localhost:8000（后端 API）。
virtual-gf/
├── backend/ # FastAPI 新版后端
│ ├── app/
│ │ ├── api/v1/ # RESTful API 路由
│ │ ├── models/ # SQLAlchemy 数据模型
│ │ ├── schemas/ # Pydantic 验证模型
│ │ ├── services/ # 业务逻辑层
│ │ └── core/ # 配置、安全、依赖注入
│ └── alembic/ # 数据库迁移
├── frontend/ # Vue 3 前端 (TypeScript)
│ └── src/
│ ├── views/ # 页面组件
│ ├── components/ # 通用组件
│ ├── composables/ # 组合式函数
│ └── stores/ # Pinia 状态管理
├── static/ # Flask 旧版前端静态文件
├── characters/ # 角色定义 (JSON)
├── app.py # Flask 旧版入口
├── ai_engine.py # AI 对话引擎
├── memory.py # 记忆系统 (SQLite)
├── config.py # 全局配置
├── DESIGN.md # UI 设计规范
└── docker-compose.prod.yml # 生产环境编排
| 层 | 技术 |
|---|---|
| 后端 | Python 3.12+, FastAPI, Flask, SQLAlchemy |
| 前端 | Vue 3, TypeScript, Vite, Pinia |
| AI | DeepSeek API, 豆包 Seedream (火山引擎) |
| 数据库 | PostgreSQL / SQLite, Redis |
| 部署 | Docker, Nginx, Let's Encrypt |
| 认证 | JWT + bcrypt |
欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建你的功能分支 (
git checkout -b feat/amazing-feature) - 提交你的修改 (
git commit -m 'feat: add amazing feature') - 推送到分支 (
git push origin feat/amazing-feature) - 打开一个 Pull Request
MIT License — 详见 LICENSE 文件
Made with 💕 by 314159ctl