企业官网建设流程全解析

EmulationStation游戏库刮削完整指南：3步快速批量补全封面与游戏简介

【免费下载链接】EmulationStationA flexible emulator front-end supporting keyboardless navigation and custom system themes.项目地址: https://gitcode.com/gh_mirrors/em/EmulationStation

EmulationStation 是一款支持无键盘导航和自定义主题的模拟器前端，它的核心价值之一，是能把一堆只有文件名的 ROM 变成带封面、简介、评分的"数字游戏柜"。本指南面向新手，从使用场景讲起，带你用内置刮削功能快速批量补齐游戏元数据，再进阶掌握多数据源切换与常见问题排查。

为什么你的游戏库总是"光秃秃"的

很多玩家把几十上百个 ROM 拷进目录后，打开 EmulationStation 看到的是一排毫无生气的文件名，比如Super_Mario_Bros_3.zip。想找某款游戏只能靠猜，朋友来家里演示时也毫无观赏性。

这个痛点的根源在于：EmulationStation 本身只负责"读取游戏"，而封面、简介、发售年份这些信息，都需要一份名为gamelist.xml的元数据文件来承载。它按系统目录存放，记录每款游戏的名称、图片、描述、评分等信息。更关键的是，官方在README.md中明确提到：只要某个系统里有一款游戏带上了图片，EmulationStation 就会自动切换成显示元数据的详细视图，游戏库从此从"文件管理器"变成"游戏商店"。

手工写 XML 显然不现实，好在 EmulationStation 内置了刮削（Scraping）工具，可以自动从网络数据库抓取这些信息。下面我们按"先解决最紧急的需求，再优化细节"的顺序，一步步来。

首选方案：用内置刮削器批量补齐封面和描述

这是绝大多数用户的第一步，全程在图形界面内完成，不需要碰任何代码。以想要为某个机种的游戏批量补图为例，操作如下：

第一步：进入刮削设置在系统主界面按下手柄的 Start 键呼出主菜单，找到SCRAPER（刮削器）选项进入。

第二步：配置抓取范围与来源在设置界面里你会看到几个关键选项：

• SCRAPE THESE GAMES（抓取哪些游戏）：建议保持默认的"Only missing image"，这样只处理还没有封面的游戏，避免覆盖已手动整理过的数据；如果想让全部游戏重新抓取，再改为"All Games"。
• SCRAPE THESE SYSTEMS（抓取哪些机种）：默认会预选所有已配置平台的系统，你可以取消勾选暂时不想处理的。
• SCRAPE FROM（数据来源）：在 TheGamesDB 和 TheArchive 两个数据库之间切换，详见下文进阶部分。

第三步：开始刮削确认无误后按下START，EmulationStation 会逐款游戏向数据库发起查询并下载图片。抓取过程中若遇到同名游戏有多个匹配结果，你可以开启"User decides on conflicts"让系统停下来询问你选哪一个，避免张冠李戴。

这一套流程的实现逻辑可以对照源码es-app/src/guis/GuiScraperStart.cpp：它先按你选的过滤条件筛选游戏，再通过es-app/src/scrapers/Scraper.cpp中的startScraperSearch发起异步请求，结果会写回gamelist.xml。跑完一轮，你的游戏列表就会自动变成带封面和简介的详细视图，效果立竿见影。

只补一款游戏？用单游戏刮削更精准

批量刮削适合大扫除，但如果你只是新下载了一款游戏，或某款游戏被刮错了，没必要跑完整轮。在游戏列表中找到目标游戏，按下手柄的Select 键，选择EDIT THIS GAME'S METADATA（编辑此游戏元数据），再点击底部的SCRAPE按钮，就能单独为这一款游戏重新抓取。这种方式精度更高，也方便你在抓取后手动微调描述文字。

进阶玩法：多数据源切换与平台映射调优

当你对基础刮削得心应手后，可能会遇到两个进阶问题：抓到的封面不合口味，或者某些游戏在默认数据库里完全搜不到。这时就该动用下面两个技巧。

1. 切换数据源，扩大命中率EmulationStation 同时内置了 TheGamesDB 和 TheArchive 两个刮削器，注册关系就定义在es-app/src/scrapers/Scraper.cpp中。两个库的收录范围各有侧重，在刮削设置或主菜单的SCRAPE FROM选项里切换即可。如果 TheGamesDB 查不到的冷门游戏，换到 TheArchive 往往就有结果；反之亦然。注意，切换后记得重新触发刮削，因为刮削动作本身是按当前选中的数据源执行的。

2. 设置正确的平台标识，让结果更准刮削的准确度高度依赖平台信息。在系统的配置文件es_systems.cfg中，每个系统都有<platform>标签，它告诉刮削器"这是 SFC 还是 GBA"。如果平台没设置或设置错误，搜索结果会偏差很大——源码es-app/src/scrapers/GamesDBScraper.cpp在遇到无法识别的平台时会直接打印警告日志并跳过搜索。所以，在开始批量刮削前，最好先核对es_systems.cfg里各系统的平台标识是否填写正确（完整清单见es-app/src/PlatformId.cpp）。

3. 顺手把评分也抓回来在刮削设置里有一个SCRAPE RATINGS（抓取评分）开关，默认关闭。打开后，刮削器会连同游戏评分一起写入元数据，这样游戏列表还能按评分排序，方便你快速找出口碑佳作。

4. 命令行刮削：实验性功能慎用对于想脚本化批量处理的高级用户，EmulationStation 提供了--scrape命令行参数（入口在es-app/src/main.cpp和es-app/src/ScraperCmdLine.cpp）。不过要提醒你：该功能目前在官方文档中被标注为"开发中（currently broken）"，核心流程在源码里仍是 TODO 状态，不建议新手依赖它完成正式工作。想稳定批量刮削，老老实实用图形界面才是正解。

常见问题排查与选择建议

最后整理几个新手最容易踩的坑，对照检查能省下大量时间：

• 刮出来的结果牛头不对马嘴：九成是平台标识缺失或写错，去es_systems.cfg检查<platform>标签，或在 GUI 中触发警告提示时先补全配置。
• 封面抓到了但游戏列表还是纯文字：重启 EmulationStation 让它重新读取gamelist.xml；只要系统内有一款游戏带图片，就会自动切到详细视图。
• 某款游戏怎么都搜不到：切换数据源再试，或者在单游戏刮削时手动输入英文原名——使用 ROM 文件名直搜往往不如规范名称命中率高。
• 抓错的内容不想留：用"编辑元数据"界面逐项修正，或直接改gamelist.xml里对应字段，改动会自动保存。

给你的选择建议：游戏库刚建立、成百上千款游戏待处理时，直接走"内置刮削器批量抓取"，这是性价比最高的路线；日常零星新增游戏，用单游戏刮削保持精准；追求更全的收录范围，就在 TheGamesDB 与 TheArchive 之间来回切换互补。把这三招用熟，你的 EmulationStation 游戏库就能从"光秃秃的文件列表"升级成"带封面、有简介、可排序的私人游戏档案馆"，这才是这个前端真正该有的样子。

【免费下载链接】EmulationStationA flexible emulator front-end supporting keyboardless navigation and custom system themes.项目地址: https://gitcode.com/gh_mirrors/em/EmulationStation