# 猜拳游戏Web版

**Repository Path**: yan_jidao/guessing-game---web-version

## Basic Information

- **Project Name**: 猜拳游戏Web版
- **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-04-09
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎮 猜拳游戏 Web 版

一个基于 Flask 的在线猜拳游戏，支持多种游戏模式和实时对战功能。

## ✨ 功能特性

- 🔐 **用户系统**：注册、登录、排行榜
- 🤖 **机器人对战**：与 AI 进行单人练习赛，支持多种难度和模式
  - 🎯 **局数模式**：3/5/7/9/11/13 局可选，平局不计入
  - 🏆 **抢 N 模式**：抢 5/7/9/11/13/17 分，需领先 3 分获胜
  - 🧠 **难度系统**：入门（随机）、普通（基础策略）、困难（预测招式）
- 👥 **实时匹配**：根据段位自动匹配对手，支持局数/抢 N 模式配置
- 🏠 **私人房间**：创建/加入房间与好友对战
- 🎯 **技能系统**：洞察、双倍、护盾、预知、抽奖，灵力不足时按钮自动禁用
- 🏆 **段位系统**：青铜 → 白银 → 黄金 → 铂金 → 钻石 → 大师 → 王者
- 🎖️ **成就系统**：多种成就等你解锁
- 📊 **数据统计**：实时查看游戏记录
- 🌙 **主题切换**：支持暗色/亮色主题切换

## 🛠️ 技术栈

- **后端**：Flask + Flask-SQLAlchemy + Flask-SocketIO
- **数据库**：SQLite
- **前端**：HTML/CSS/JavaScript + Socket.IO Client
- **部署**：Docker + Docker Compose

## 📦 快速开始

### 本地开发

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

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

访问 `http://localhost:5000`

### Docker 部署（推荐）

#### Windows

```bash
# 双击运行部署脚本
deploy.bat
```

#### Linux/Mac

```bash
# 赋予执行权限并运行
chmod +x deploy.sh
bash deploy.sh
```

#### 手动部署

```bash
# 构建并启动
docker-compose up -d

# 查看日志
docker logs -f guessing-game-web
```

访问 `http://<服务器IP>:5000`

## 🚀 云端部署指南

### 1. 准备服务器

- 腾讯云 / 阿里云 / AWS 等云服务器
- 系统要求：Ubuntu 20.04+ / CentOS 8+
- 最低配置：1核 1G

### 2. 安装 Docker

```bash
# Ubuntu/Debian
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# CentOS
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl enable docker
sudo systemctl start docker
```

### 3. 配置镜像源（加速）

脚本已自动配置，也可手动添加：

```json
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}
```

保存到 `/etc/docker/daemon.json`，然后重启 Docker：

```bash
sudo systemctl daemon-reload
sudo systemctl restart docker
```

### 4. 部署项目

```bash
# 克隆项目
git clone https://gitee.com/yan_jidao/guessing-game---web-version.git
cd guessing-game---web-version

# 运行部署脚本
bash deploy.sh
```

### 5. 开放防火墙端口

```bash
# Ubuntu/Debian
sudo ufw allow 5000/tcp

# CentOS
sudo firewall-cmd --permanent --add-port=5000/tcp
sudo firewall-cmd --reload

# 云服务器安全组
# 需在云控制台开放 5000 端口
```

## 📁 项目结构

```
.
├── app.py                 # 主应用文件
├── requirements.txt       # Python 依赖
├── Dockerfile            # Docker 镜像构建文件
├── docker-compose.yml    # Docker Compose 配置
├── deploy.sh             # Linux 部署脚本
├── deploy.bat            # Windows 部署脚本
├── .dockerignore         # Docker 忽略文件
├── instance/             # 数据库目录
│   └── game.db
├── static/               # 静态文件
│   ├── script.js
│   └── style.css
└── templates/            # HTML 模板
    ├── index.html
    ├── login.html
    ├── register.html
    ├── leaderboard.html
    ├── achievements.html
    └── skills.html
```

## 🎮 游戏规则

### 基础规则（扩展版石头剪刀布）

- ✊ 石头 > ✌️ 剪刀, 🦎 蜥蜴
- ✌️ 剪刀 > 📄 布, 🦎 蜥蜴
- 📄 布 > ✊ 石头, 🖖 斯波克
- 🦎 蜥蜴 > 🖖 斯波克, 📄 布
- 🖖 斯波克 > ✌️ 剪刀, ✊ 石头

### 技能说明

| 技能 | 消耗 | 效果 |
|------|------|------|
| 🔍 洞察 | 1 | 提示电脑不会出的招式 |
| ⚡ 双倍 | 2 | 获胜获得 2 分 |
| 🛡️ 护盾 | 1 | 输了电脑不得分 |
| 👁️ 预知 | 2 | 透视电脑下一局招式 |
| 🎲 抽奖 | 1 | 随机获得 0~3 点灵力 |

## 🔧 常用命令

```bash
# 查看容器状态
docker-compose ps

# 查看日志
docker logs -f guessing-game-web

# 重启服务
docker-compose restart

# 停止服务
docker-compose down

# 重新构建并启动
docker-compose up -d --build

# 进入容器
docker exec -it guessing-game-web /bin/bash
```

## 📝 注意事项

- 数据库文件存储在 `instance/game.db`，部署时会自动挂载
- 首次运行会自动创建数据库表
- 生产环境建议修改 `SECRET_KEY`

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License

## 👨‍💻 作者

 Yan Jidao

---

**祝你游戏愉快！** 🎉