# 我画你猜

**Repository Path**: feiniuzai/guess

## Basic Information

- **Project Name**: 我画你猜
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-31
- **Last Updated**: 2026-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 你画我猜 - AI 图像识别应用

这是一个基于 AI 视觉识别的 "你画我猜" Web 应用。用户可以在画板上自由绘制，AI 会实时识别出画作内容。

## ✨ 功能特性

*   **实时绘画**：提供一个简洁的在线画板，支持调整画笔颜色和粗细、撤销、清空等功能。
*   **AI 识别**：集成 Gemini AI 模型，能够识别物体、动物、人物、文字等多种类型的简笔画。
*   **即时反馈**：AI 会以 JSON 格式返回识别结果，包括猜测的物体、类别、置信度和一句有趣的评语。
*   **前后端分离**：采用现代化的前后端分离架构，便于开发和部署。

## 🛠️ 技术栈

*   **前端**:
    *   [Vue.js 3](https://vuejs.org/) (使用组合式 API)
    *   [Vite](https://vitejs.dev/)
    *   JavaScript
*   **后端**:
    *   [Python 3](https://www.python.org/)
    *   [FastAPI](https://fastapi.tiangolo.com/)
    *   [Google Generative AI (Gemini)](https://ai.google.dev/)

## 📂 项目结构

```
.
├── backend/         # 后端 FastAPI 项目
│   ├── main.py      # FastAPI 应用主文件
│   └── requirements.txt
├── frontend/        # 前端 Vue.js 3 项目
│   ├── src/
│   └── package.json
└── README.md
```

## 🚀 快速开始

### 1. 环境配置

在项目根目录下创建一个 `.env` 文件，并配置您的 Gemini API 密钥：

```
GEMINI_API_KEY="YOUR_API_KEY"
```
请将 `YOUR_API_KEY` 替换为您自己的密钥。

### 2. 后端启动

```bash
# 1. 进入后端目录
cd backend

# 2. (推荐) 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # on Windows, use `venv\Scripts\activate`

# 3. 安装依赖
pip install -r requirements.txt

# 4. 启动开发服务器
uvicorn main:app --reload
```
后端服务将在 `http://127.0.0.1:8000` 启动。

### 3. 前端启动

```bash
# 1. 进入前端目录
cd frontend

# 2. 安装依赖
npm install

# 3. 启动开发服务器
npm run dev
```
前端应用将在 `http://localhost:5173` (或另一个可用端口) 启动。打开浏览器访问该地址即可开始使用。