# My Flash

**Repository Path**: heizicao/my-flash

## Basic Information

- **Project Name**: My Flash
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MyFlash - 现代 Flash 游戏集成门户

MyFlash 是一个基于 [Ruffle](https://ruffle.rs/) 模拟器的现代 Flash 游戏播放平台。它提供了一个优雅的界面来浏览、玩本地 Flash 游戏，并支持动态配置播放参数。

![Screenshot Placeholder](https://via.placeholder.com/800x450?text=MyFlash+Interface)

## ✨ 特性

- **流畅体验**：集成 Ruffle 引擎，无需 Flash 插件即可在现代浏览器运行 `.swf` 文件。
- **游戏库管理**：通过 `config.js` 轻松分类和维护你的 Flash 游戏清单。
- **自定义设置**：
  - **实时切换**：更改缩放模式、渲染质量或渲染器（WebGL/WebGPU）时，播放器会自动重载以生效。
  - **渲染器支持**：支持 WebGL, WebGPU, Canvas 等多种渲染后端。
- **本地上传**：支持将本地 `.swf` 文件拖拽或点击上传并即时播放。
- **全屏支持**：沉浸式游戏体验。
- **双色主题**：内置深色/浅色模式，适配不同审美。
- **Docker 容器化**：一键部署，原生支持 Nginx 驱动。

## 🚀 快速开始

### 方式一：直接运行
只需将整个项目文件夹部署到任何静态文件服务器（如 Nginx, Apache 或 VS Code Live Server）下访问 `index.html` 即可。

### 方式二：Docker 部署 (推荐)
1. 确保已安装 Docker 和 Docker Compose。
2. 在项目根目录下运行：
   ```bash
   docker-compose up -d
   ```
3. 访问 `http://localhost:3000` 即可开始游戏。

## ⚙️ 配置指南

### 添加新游戏
编辑根目录下的 `config.js` 文件，在 `game` 数组中添加新的条目：

```javascript
{
  name: "游戏名称",
  path: "./game/your_game.swf",
  type: "分类名称", // 如：射击类、益智类
  active: true
}
```

### 修改默认设置
在 `config.js` 的 `ruffle` 部分修改初始参数：
- `autoplay`: 自动播放 (`on`/`off`)
- `scale`: 缩放模式 (`showAll`, `exactFit`, `noBorder`)
- `quality`: 渲染质量 (`low`, `medium`, `high`, `best`)

## 🛠️ 技术栈

- **Vue 3**: 渐进式 JavaScript 框架，负责 UI 逻辑。
- **Element Plus**: 优雅的 Vue 3 组件库，用于布局和交互。
- **Ruffle**: 基于 Rust 开发的 Flash Player 模拟器。
- **Nginx**: 高性能 Web 服务器。

## 📂 项目结构

```text
├── assets/          # 静态资源 (Ruffle 核心、图标、CSS)
├── game/            # 存放 .swf 游戏文件的目录
├── config.js        # 全局配置文件 (游戏列表、默认颜色、Ruffle 参数)
├── index.html       # 主页面
├── Dockerfile       # Docker 镜像构建配置
└── docker-compose.yml # 容器编排配置
```

## ⚖️ 开源协议
本项目采用 [MIT License](LICENSE)。Flash 模拟能力归功于优秀的开源项目 [Ruffle](https://github.com/ruffle-rs/ruffle)。

---
*重温经典，重燃童年乐趣！*