# 魔镜

**Repository Path**: puJones/magic-mirror

## Basic Information

- **Project Name**: 魔镜
- **Description**: 基于Vue 3 + TypeScript + Python Flask + 七牛云AI的智能心理陪伴应用，以"魔法魔镜"为角色形象，为用户提供温暖、专业的心理支持服务。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-22
- **Last Updated**: 2025-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 心灵魔镜 - AI心理陪伴角色扮演网页

## 🔍 项目简介
基于Vue 3 + TypeScript + Python Flask + 七牛云AI的智能心理陪伴应用，以"魔法魔镜"为角色形象，为用户提供温暖、专业的心理支持服务。

## 🌟 核心特色
- **🤖 智能对话**：集成七牛云通义千问大模型，提供有温度的心理陪伴
- **🎤 语音交互**：支持语音输入输出，实现自然流畅的对话体验
- **💫 情绪识别**：智能分析用户情绪状态，提供个性化回应
- **🛡️ 隐私安全**：对话数据本地存储，保障用户隐私安全
- **📱 响应式设计**：完美适配桌面端和移动端

## 🏗️ 技术架构
### 前端技术栈
- **框架**：Vue 3 + TypeScript + Composition API
- **UI组件**：Element Plus
- **构建工具**：Vite
- **样式预处理器**：Sass
- **语音交互**：Web Speech API

### 后端技术栈
- **框架**：Python Flask
- **AI服务**：七牛云AI推理平台（兼容OpenAI API）
- **部署**：Docker容器化

### AI能力
- **大模型**：七牛云通义千问（Qwen-Plus）
- **语音识别**：Web Speech API（浏览器端）
- **语音合成**：Web Speech API（浏览器端）

## 🚀 快速开始

### 环境要求
- Node.js 16+
- Python 3.8+
- Docker Desktop（推荐）

### 使用Docker一键部署（推荐）
 ```bash
# 克隆项目
git clone <您的仓库地址>
cd magic_mirror

# 一键启动
./start.bat  # Windows
# 或
chmod +x start.sh && ./start.sh  # Linux/Mac
```
# 手动启动
### 后端服务
 ```bash
cd backend
pip install -r requirements.txt
python app.py
```
### 前端服务
 ```bash
cd frontend
npm install
npm run serve
```
# 访问地址
 ```bash
前端应用：http://localhost:8080

后端API：http://localhost:5000

健康检查：http://localhost:5000/api/health
```
# 📁 项目结构
```text
magic_mirror/
├── frontend/                 # Vue 3前端项目
│   ├── src/
│   │   ├── api/             # API接口封装
│   │   ├── components/      # 组件库
│   │   ├── layouts/         # 布局组件
│   │   ├── views/           # 页面视图
│   │   ├── utils/           # 工具函数
│   │   └── types/           # TypeScript类型定义
│   └── vite.config.ts       # Vite配置
├── backend/                 # Python Flask后端
│   ├── app.py              # Flask主应用
│   ├── qiniu_service.py    # 七牛云AI服务封装
│   ├── mirror_service.py   # 魔镜业务逻辑
│   └── requirements.txt    # Python依赖
├── docker-compose.yml      # Docker编排配置
├── Dockerfile.frontend     # 前端Dockerfile
├── Dockerfile.backend      # 后端Dockerfile
└── README.md              # 项目说明
```
# 🎯 核心功能
1. 智能心理陪伴
情绪识别与回应：自动识别用户情绪状态，提供共情式回应

正向心理引导：基于积极心理学原理，帮助用户转换视角

安全树洞倾听：提供非评判性的倾听空间

2. 语音交互体验
语音唤醒：支持"魔镜魔镜"语音唤醒

实时对话：流畅的语音输入输出体验

多模态交互：支持语音和文字两种输入方式

3. 心理支持工具
呼吸练习指导：引导用户进行放松呼吸练习

心理小贴士：推送积极心理学建议

 

#🔧 API接口文档
主要接口
接口地址	方法	描述	参数
```
/api/chat	POST	与魔镜对话	{message: string}
/api/psychological-tip	GET	获取心理贴士	-
/api/breathing-guide	GET	获取呼吸练习	-
/api/health	GET	健康检查	-
```
# 请求示例
```javascript
// 与魔镜对话
const response = await fetch('/api/chat', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({message: '我今天感觉有点焦虑'})
});
```
# 🎨 界面预览
欢迎界面：温馨的魔镜欢迎页面，展示核心功能

对话界面：仿聊天应用界面，区分用户和魔镜消息

响应式设计：自适应不同屏幕尺寸

# 视频
frontend/public/演示视频.mp4
https://gitee.com/puJones/magic-mirror/blob/master/frontend/public/%E6%BC%94%E7%A4%BA%E8%A7%86%E9%A2%91.mp4