Frontend Killer - 复古游戏列表管理工具

fansmall

# Frontend Killer - 复古游戏列表管理工具
---
## 软件简介
我用人话说一下软件的功能：可以在nas上运行，用于整理、规范导入怀旧游戏平台的游戏集合。比如你搞到了一个pegasus前端（国内一般叫天马）的gba集合，你可以用导入功能把游戏集合数据导入到平台。然后就可以进行再加工，比如翻译、合盘、分离想要的游戏等操作。最后再把这个集合导出成其他平台比如retrobat、esde等前端的格式。本软件的亮点：1可以在nas上运行，适合进行大批量的导入、导出以及翻译的操作.2可以规范自己手中的游戏集合。3 可以使用自定义json模板，理论上可以实现所有的平台的导入导出。现阶段软件属于测试阶段，如果遇到问题请在此贴留言或者前往github。fansmall2008/webGamelistOper
```
## 功能特性
- 游戏扫描和导入
- 平台管理
- 游戏信息编辑
- 查看游戏媒体文件
- 多语言翻译（需要自行写入翻译api的key）
- 数据导出（支持多种格式）
- 数据库备份和恢复
- 系统设置管理
```
---
## ✨ 核心亮点：模板驱动的通用架构
### 为什么说“理论上支持所有系统”？
通过 JSON 模板配置文件，定义任意格式的解析和生成规则，无需修改代码即可适配新系统。
###  游戏扫描与导入
* 递归扫描 ROM 目录，自动识别元数据文件
* **模板驱动**：通过 JSON 模板适配任意前端格式
* 多线程并发导入，大幅提升处理效率
###  平台管理
* 完整的平台增删改查功能
* 支持平台间游戏合并（移动/复制）
* 平台统计信息展示
### ✏️ 游戏信息编辑
* 游戏元数据可视化编辑
* 多维度筛选（平台、日期、开发商、类型）
* 刮削状态跟踪
###  多语言翻译
* 集成 Google、微软、DeepSeek 翻译引擎支持通过json扩展
* 批量翻译游戏名称和描述
* 异步处理，实时查看进度
###  数据导出
* **模板驱动**：通过 JSON 模板适配任意前端格式
* 支持游戏文件、媒体文件、数据文件的分别导出
* M3U 播放列表自动处理
###  数据库备份与恢复
* 一键备份/恢复 H2 数据库
* 游戏元文件备份与恢复
---
## 适用人群
* **复古游戏收藏爱好者**：整理跨越多个前端平台的游戏库
* **多前端使用者**：在不同前端系统间无缝迁移数据
* **模拟器整合包制作者**：统一管理多平台、多格式的元数据
* **汉化组/ROM 打包者**：批量处理游戏元数据和翻译
* **开源社区贡献者**：为新前端编写模板配置

fansmall

## 11. 如何启动

### 11.1 使用 Docker Compose（推荐）

**前提条件：**
- Docker 已安装
- Docker Compose 已安装

**步骤：**

1. **创建 docker-compose.yml 文件**

   ```yaml
   version: '3'

   services:
     webgamelistoper:
       image: fansmall/webgamelistoper:latest
       container_name: webgamelistoper
       ports:
         - "8080:8080"
       volumes:
         - ./logs:/app/logs
         - /path/to/roms:/data/roms
         - /path/to/output:/data/output
         - /path/to/rules:/data/rules
         - /path/to/input:/data/input
       environment:
         - SPRING_PROFILES_ACTIVE=default
         - SERVER_TOMCAT_BASEDIR=/data
         - SPRING_RESOURCES_STATIC_LOCATIONS=classpath:/static/,file:/data,file:/data/roms,file:/data/output,file:/data/input
       restart: unless-stopped
   ```

2. **替换目录路径**
   - 将 `/path/to/roms` 替换为您的实际游戏 ROM 目录
   - 将 `/path/to/output` 替换为您的导出输出目录
   - 将 `/path/to/rules` 替换为您的规则目录
   - 将 `/path/to/input` 替换为您的输入文件目录

3. **启动容器**

   ```bash
   docker-compose up -d
   ```

4. **访问应用**
   打开浏览器访问：`http://localhost:8080`

### 11.2 使用 Docker Run 命令

**前提条件：**
- Docker 已安装

**步骤：**

1. **直接运行容器**

   ```bash
   docker run -d \
     --name webgamelistoper \
     -p 8080:8080 \
     -v ./logs:/app/logs \
     -v /path/to/roms:/data/roms \
     -v /path/to/output:/data/output \
     -v /path/to/rules:/data/rules \
     fansmall/webgamelistoper:latest
   ```

2. **替换目录路径**
   - 将 `/path/to/roms` 替换为您的实际游戏 ROM 目录
   - 将 `/path/to/output` 替换为您的导出输出目录
   - 将 `/path/to/rules` 替换为您的规则目录
   - 将 `/path/to/input` 替换为您的输入文件目录

3. **访问应用**
   打开浏览器访问：`http://localhost:8080`

### 11.3 直接运行 JAR 文件

**前提条件：**
- JDK 17 或更高版本已安装
- 足够的内存（至少 2GB）

**步骤：**

1. **下载 JAR 文件**
   - 从 distribution 目录获取 `webGamelistOper-1.0-beta.jar`

2. **创建必要的目录**

   ```bash
   mkdir -p data/roms data/output data/rules data/input data/backup data/database logs
   ```

3. **运行 JAR 文件**

   ```bash
   java -jar webGamelistOper-1.0-beta.jar
   ```

4. **访问应用**
   打开浏览器访问：`http://localhost:8080`