# tetris-game

**Repository Path**: cailei/tetris-game

## Basic Information

- **Project Name**: tetris-game
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-20
- **Last Updated**: 2025-10-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎮 现代化俄罗斯方块游戏

<!-- 测试Webhook触发 - 2025-10-03 -->
一个使用 React + TypeScript + Vite 构建的现代化俄罗斯方块游戏，具有美观的界面和完整的游戏功能。

## ✨ 游戏特性

### 🎯 核心功能
- ✅ **完整的俄罗斯方块机制** - 7种标准方块类型（I、O、T、S、Z、J、L）
- ✅ **行消除系统** - 满行自动消除并计分
- ✅ **分数和等级系统** - 随等级提升速度递增
- ✅ **下一个方块预览** - 提前规划策略
- ✅ **暂停/继续功能** - 随时暂停游戏
- ✅ **游戏结束检测** - 智能检测游戏结束条件

### 🎮 控制方式
- **键盘控制**：
  - `←→` 左右移动
  - `↓` 软降（加速下落）
  - `↑` 旋转方块
  - `空格` 硬降（直接落到底部）
  - `ESC` 暂停/继续
- **触摸控制**：移动端专用触摸按钮

### 🎨 界面设计
- 🌈 **渐变背景** - 美丽的紫蓝色渐变
- ✨ **毛玻璃效果** - 现代化的半透明面板
- 🎭 **动画效果** - 流畅的按钮悬停和状态转换
- 📱 **响应式设计** - 完美适配桌面和移动端
- 🎪 **发光效果** - 游戏板和按钮的微妙发光

## 🚀 快速开始

### 开发环境

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

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 在浏览器中打开 http://localhost:5173
```

### 生产构建

```bash
# 构建项目
npm run build

# 预览构建结果
npm run preview
```

## 📱 响应式设计

### 桌面端 (≥768px)
- 水平布局：游戏板在左，控制面板在右
- 完整的键盘控制支持
- 详细的控制说明

### 移动端 (<768px)
- 垂直布局：所有元素垂直排列
- 触摸控制按钮
- 紧凑的信息显示
- 优化的游戏板尺寸

## 🎯 游戏规则

### 计分系统
- **单行消除**: 100 × 等级
- **双行消除**: 300 × 等级
- **三行消除**: 500 × 等级
- **四行消除**: 800 × 等级

### 等级系统
- 每消除 10 行升一级
- 等级越高，方块下落速度越快
- 最高等级无限制

## 🛠️ 技术栈

- **前端框架**: React 18
- **开发语言**: TypeScript
- **构建工具**: Vite
- **样式方案**: 内联样式 + CSS3
- **部署方式**: 静态文件部署

## 📦 部署指南

### 自动部署

```bash
# 构建并创建部署包
npm run build
./deploy.sh
```

### 手动部署

1. **构建项目**
   ```bash
   npm run build
   ```

2. **上传文件**
   将 `dist/` 目录中的所有文件上传到您的 web 服务器

3. **配置服务器**
   确保您的 web 服务器支持 SPA 路由

详细部署说明请参考 [DEPLOYMENT.md](./DEPLOYMENT.md)

## 🌐 浏览器支持

- ✅ Chrome (推荐)
- ✅ Firefox
- ✅ Safari
- ✅ Edge
- ✅ 移动端浏览器

## 📄 项目结构

```
teris/
├── src/
│   ├── App_simple.tsx    # 主游戏组件
│   ├── main.tsx         # 应用入口
│   └── index.css        # 全局样式
├── public/              # 静态资源
├── dist/               # 构建输出
├── deploy.sh           # 部署脚本
├── nginx.conf          # Nginx 配置
└── DEPLOYMENT.md       # 部署指南
```

## 🎮 游戏截图

### 桌面端
- 水平布局，游戏板和控制面板并排显示
- 完整的键盘控制和详细说明

### 移动端
- 垂直布局，适合手机屏幕
- 触摸控制按钮，操作简单直观

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📝 更新日志

### v1.0.0 (2024-01-20)
- ✨ 初始版本发布
- 🎮 完整的俄罗斯方块游戏功能
- 🎨 现代化美观界面
- 📱 响应式设计支持
- 🚀 部署脚本和文档

## 📜 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🎉 致谢

感谢所有为这个项目做出贡献的开发者！

---

**享受游戏吧！** 🎮✨
<\!-- CI/CD流程测试 - 2025-10-04 00:04:53 -->