# fireworks

**Repository Path**: x-bot/fireworks

## Basic Information

- **Project Name**: fireworks
- **Description**: 一个烟花动画效果
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-17
- **Last Updated**: 2025-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fireworks 烟花效果展示

一个基于 HTML5 Canvas 的互动烟花效果展示网页应用。用户可以通过点击屏幕来在指定位置创建绚丽的烟花效果，带来视觉上的享受。

## 项目特性

- 🎆 逼真的烟花爆炸效果
- 🖱️ 支持鼠标点击触发烟花
- 🎨 丰富的色彩和粒子效果
- 🎛️ 可调节烟花触发频率
- 💻 纯前端实现，无需后端支持
- 📱 支持移动端和桌面端

## 技术栈

- HTML5 Canvas
- CSS3
- JavaScript (原生)

## 运行说明

### 环境要求

- 现代浏览器（支持 HTML5 Canvas）
- Python3（可选，用于启动本地服务器）
- 或其他任意 HTTP 服务器（可选）

### 快速开始

1. 克隆项目到本地：
   ```bash
   git clone https://gitee.com/x-bot/fireworks.git
   cd fireworks
   ```

2. 运行方式（三选一）：

   a. 直接打开（最简单）：
   ```bash
   # MacOS
   open index.html
   # Windows
   start index.html
   ```

   b. Python 启动本地服务器（推荐）：
   ```bash
   # 启动服务器
   python3 -m http.server 8000
   # 然后在浏览器访问：http://localhost:8000
   ```

   c. 使用其他开发服务器：
   - VS Code Live Server 插件
   - Node.js http-server
   - 或其他 HTTP 服务器

### 开发说明

项目结构：
```
fireworks/
├── index.html      # 主页面
├── style.css       # 样式文件
├── script.js       # 烟花效果实现
└── README.md       # 项目文档
```

## 使用说明

1. 打开网页后，会看到黑色背景的画布
2. 点击屏幕任意位置，即可在该位置触发烟花效果
3. 可以连续点击创建多个烟花
4. 使用底部的滑块可以调节烟花的触发频率（100ms-2000ms）

## 贡献指南

1. Fork 本仓库
2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交你的改动 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 发起 Pull Request

## 许可证

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