# guess_number_game

**Repository Path**: CrazyRuning/guess_number_game

## Basic Information

- **Project Name**: guess_number_game
- **Description**: 学习一个游戏项目
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-08
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 猜数字游戏

一个基于Flask的Web版猜数字游戏，支持自定义游戏参数和浏览器访问。

## 功能特性

- 🎯 可自定义数字范围（最小值和最大值）
- 📊 可设置尝试次数
- 💡 提供提示功能（消耗一次机会）
- 📱 响应式设计，支持移动设备
- 🎨 现代化的UI界面
- 🏆 游戏历史记录
- 🔔 友好的提示信息

## 技术栈

- **后端**: Python 3.9 + Flask
- **前端**: HTML + CSS + JavaScript
- **容器化**: Docker
- **版本控制**: Git

## 快速开始

### 1. 本地运行

```bash
# 克隆项目
git clone <repository-url>
cd guess_number_game

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

# 运行应用
python app.py
```

然后访问 http://localhost:5000

### 2. Docker运行

```bash
# 构建镜像
docker build -t guess-number-game .

# 运行容器
docker run -p 5000:5000 guess-number-game
```

然后访问 http://localhost:5000

### 3. Docker Compose运行

```bash
# 启动服务
docker-compose up --build

# 停止服务
docker-compose down
```

## 项目结构

```
guess_number_game/
├── app.py              # Flask应用主文件
├── requirements.txt    # Python依赖
├── Dockerfile          # Docker构建文件
├── .dockerignore       # Docker排除文件
├── .gitignore          # Git排除文件
├── README.md           # 项目说明
└── templates/          # Flask模板文件
    ├── index.html      # 首页
    └── game.html       # 游戏页面
```

## 游戏规则

1. 系统会根据设定的范围随机生成一个数字
2. 玩家需要在限定次数内猜中这个数字
3. 每次猜测后会提示"猜大了"或"猜小了"
4. 使用提示会消耗一次机会
5. 猜中数字或用完所有尝试次数后游戏结束

## 开发说明

### 添加新功能

1. 修改 `app.py` 添加新的路由和逻辑
2. 在 `templates/` 目录下创建或修改HTML模板
3. 更新CSS样式增强用户体验
4. 测试功能并提交代码

### 版本控制

```bash
# 添加文件到Git
git add .

# 提交更改
git commit -m "描述你的更改"

# 推送到远程仓库
git push origin main
```

### Docker开发流程

1. 修改代码后重新构建镜像：
   ```bash
   docker build -t guess-number-game .
   ```

2. 运行新容器：
   ```bash
   docker run -p 5000:5000 guess-number-game
   ```

3. 或者使用Docker Compose：
   ```bash
   docker-compose up --build -d
   ```

## 部署说明

### 本地部署

确保安装了Python 3.9+和pip，然后按照"快速开始"部分的说明操作。

### 服务器部署

1. 将代码推送到Git仓库
2. 在服务器上克隆仓库
3. 使用Docker部署（推荐）

### Docker部署优化

```bash
# 构建优化后的镜像
docker build --no-cache -t guess-number-game:latest .

# 运行生产环境容器
docker run -d -p 5000:5000 --name guess-game guess-number-game:latest
```

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request！