Handheld Game Console Database

这是一个手持游戏机数据库，包含游戏、平台和系统的详细信息，包括图像和数据文件。

This is a database of handheld game consoles, containing detailed information on games, platforms and systems, along with image and data files.

原始信息汇总

手持数据库贡献指南

数据集结构

游戏数据

1. 游戏图像

   • 封面图像：存储在 commons/images/games/ 目录下，格式为 [gamename].cover.webp。
   • 图标图像：存储在 commons/images/games/ 目录下，格式为 [gamename].icon.webp。

2. 游戏概览

   • 概览文件：存储在 commons/overviews/ 目录下，格式为 [gamename].md。

3. 游戏数据

   • 游戏目录：存储在 platforms/ 目录下相应的平台和系统子目录中，例如 platforms/tsp/systems/ports/[gamename]/。
   • 数据文件：格式为 [gamename].json。
   • 平台游戏说明文件：格式为 [gamename].md，使用 %game_overview% 标记概览文件的插入位置。

平台数据

1. 平台图像

   • 图像文件：存储在 commons/images/platforms/ 目录下，格式为 [platformname].webp。

2. 平台数据

   • 平台目录：存储在 platforms/ 目录下。
   • 数据文件：格式为 index.json。

系统数据

1. 系统图像

   • 图像文件：存储在 commons/images/systems/ 目录下，格式为 [systemname].webp。

2. 系统数据

   • 系统目录：存储在 platforms/ 目录下相应的平台子目录中，例如 platforms/[platformname]/systems/[systemname]/。
   • 数据文件：格式为 index.json。

自动化脚本

前提条件

• Python 3.x
• JSON 模块
• OS 模块
• SYS 模块
• RE 模块
• BeautifulSoup 模块
• PIL 模块

使用方法

• 运行脚本并使用适当的命令来创建平台、系统和游戏。

命令

• new platform [platform_name]：创建新平台。
• new system [platform_name] [system_name]：在指定平台下创建新系统。
• new game [platform_name] [system_name] [game_name]：在指定平台和系统下创建新游戏。
• help：显示帮助信息。

可选参数

• --steamgrid-key [your_api_key]：提供 API 密钥进行身份验证。

示例

• 创建新平台： bash python tools/new_file.py new platform myplatform

• 创建新系统： bash python tools/new_file.py new system myplatform mysystem

• 创建新游戏： bash python tools/new_file.py new game myplatform mysystem mygame

• 创建新游戏并自动获取图像： bash python tools/new_file.py new game myplatform mysystem mygame --steamgrid-key myapikey

提交指南

• 编写清晰、简洁的提交信息。
• 在提交正文中详细描述更改内容。

拉取请求流程

1. 分叉仓库。
2. 创建新分支 (git checkout -b feature/your-feature-name)。
3. 进行更改。
4. 提交更改 (git commit -am Add new feature)。
5. 推送到分支 (git push origin feature/your-feature-name)。
6. 发起拉取请求。

媒体规范

1. WebP 格式使用

   • 确保在网页应用中使用 WebP 格式以优化性能。

2. 图标规格

   • 图标尺寸应为 512x512 像素。

3. 横幅要求

   • 横幅尺寸应为 1050x380 像素。

评级标准

PLATINUM

• 图形：卓越，无故障或视觉问题，细节出众。
• 游戏性：极其稳定，高帧率（60 或更高），无掉帧或卡顿。
• 加载：即时加载，完全无崩溃或影响用户体验的问题。

GOLD

• 图形：优秀，无重大故障或视觉问题。
• 游戏性：非常稳定，高帧率（30 或更高），无明显掉帧或卡顿。
• 加载：快速加载，无崩溃或影响用户体验的问题。

SILVER

• 图形：良好，有一些小故障但不严重影响游戏体验。
• 游戏性：大部分时间稳定，偶尔有小掉帧或卡顿。
• 加载：相对快速加载，有一些慢速或小问题可绕过。

BRONZE

• 图形：可接受，但有明显视觉故障影响游戏体验。
• 游戏性：不稳定，频繁明显掉帧和偶尔卡顿。
• 加载：慢速加载，有可能崩溃或影响可用性的问题。

FAULTY

• 图形：差，严重故障和视觉问题妨碍游戏体验。
• 游戏性：非常不稳定，持续掉帧和严重卡顿，影响可玩性。
• 加载：严重加载问题，频繁崩溃和妨碍正常使用的问题。

搜集汇总

数据集介绍

构建方式

该手持游戏机数据库的构建方式主要依赖于社区贡献。具体而言，贡献者通过创建Markdown文件来添加新的游戏评论，并将平台和系统的图像以WebP格式存储在相应的目录中。每个平台和系统都有其独立的`index.json`文件，用于存储相关数据。游戏索引和排名是自动生成的，基于评论文件的内容。这种分布式的构建方式确保了数据集的持续更新和扩展，同时保持了结构的清晰和易于导航。

特点

该数据集的一个显著特点是其高度模块化和自动化的结构。通过使用WebP格式的图像，数据集在保持高质量的同时，实现了高效的压缩和传输。此外，自动化的游戏索引和排名系统减少了手动干预的需求，提高了数据处理的效率。数据集还提供了详细的评级标准，从PLATINUM到FAULTY，涵盖了从图形质量到加载速度等多个维度，为使用者提供了全面的评估参考。

使用方法

使用该数据集时，用户可以通过访问相应的Markdown文件来获取游戏评论和评级信息。平台和系统的图像存储在`commons/images/`目录下，用户可以根据需要下载和使用。对于开发者，数据集提供了详细的贡献指南，包括如何添加新游戏、平台和系统，以及如何提交更改。此外，数据集推荐使用WebP格式的图像以优化网页应用的性能，并提供了图标和横幅的具体尺寸要求，确保兼容性和清晰度。

背景与挑战

背景概述

手持游戏机数据库（Handheld Game Console Database）是一个专注于记录和评估手持游戏机兼容性的项目。该项目由一群热衷于复古游戏和手持设备的研究人员和爱好者共同创建，旨在为玩家提供一个详尽的资源库，帮助他们了解不同游戏在各种手持设备上的表现。该数据库不仅收录了游戏的基本信息，还通过详细的评级系统对游戏的图形、游戏性和加载速度进行评估，从而为玩家提供决策支持。自创建以来，该项目已成为手持游戏社区的重要参考，推动了手持游戏文化的传承与发展。

当前挑战

尽管手持游戏机数据库在提供游戏兼容性信息方面取得了显著成效，但其构建和维护过程中仍面临诸多挑战。首先，数据集的扩展依赖于社区贡献，如何确保新增数据的质量和一致性是一个持续的挑战。其次，自动化的游戏索引和排名系统虽然提高了效率，但也需要不断优化以应对多样化的游戏和设备。此外，图像和媒体文件的标准化处理，特别是WebP格式的应用，对技术实现和用户体验提出了更高的要求。最后，随着手持游戏设备的不断更新，如何保持数据库的时效性和全面性，是该项目未来需要重点解决的问题。

常用场景

经典使用场景

在手持游戏机数据库中，经典的使用场景包括游戏兼容性测试和性能评估。通过创建游戏评论文件和平台数据文件，研究人员和开发者可以系统地记录和分析不同游戏在各种手持游戏机上的表现。这种系统化的方法不仅有助于识别游戏在特定平台上的兼容性问题，还能为优化游戏性能提供宝贵的数据支持。

解决学术问题

该数据集解决了手持游戏机领域中常见的学术研究问题，如游戏兼容性和性能优化。通过详细记录和自动生成游戏排名，研究人员可以深入分析不同游戏在不同平台上的表现，从而为游戏开发和优化提供科学依据。这种数据驱动的研究方法显著提升了学术界对手持游戏机性能的理解和应用。

衍生相关工作

基于手持游戏机数据库，衍生了许多经典工作，包括游戏兼容性测试工具和性能优化算法。这些工具和算法通过分析数据集中的游戏评论和平台数据，自动生成游戏排名和性能报告，极大地简化了游戏开发和测试流程。此外，相关研究还推动了手持游戏机硬件和软件的协同优化，提升了整体用户体验。