RomM项目中Sega Master System游戏元数据抓取问题解析

问题背景

在RomM 3.7.3版本中，用户报告了一个关于Sega Master System(SMS)游戏元数据抓取失败的问题。具体表现为：系统能够正常扫描其他平台游戏，但在处理SMS游戏时，自动抓取功能失效，只能通过手动输入IGDB ID才能获取正确的元数据信息。

问题根源分析

经过技术团队调查，发现该问题的根本原因在于平台文件夹命名规范。RomM支持两种不同的SMS平台标识：

1. sega-master-system - 该标识对应MobyGames数据源
2. sms - 该标识对应IGDB数据源

当用户启用了IGDB API密钥但使用sega-master-system作为文件夹名称时，系统会尝试从MobyGames获取数据，而由于用户配置的是IGDB服务，导致抓取失败。

解决方案

要解决这个问题，用户需要：

1. 将存放SMS游戏的文件夹名称从sega-master-system改为sms
2. 执行快速扫描操作

这一变更将使RomM正确识别平台类型并使用IGDB作为数据源进行元数据抓取。

技术细节

RomM的平台识别机制基于文件夹名称与数据源的映射关系。系统内置了多个平台的标准化命名规范，每个名称对应特定的数据源：

• sms → IGDB
• sega-master-system → MobyGames

这种设计允许用户根据自己使用的数据源API来选择相应的文件夹命名方式。当用户配置了IGDB密钥但使用MobyGames对应的文件夹名称时，就会出现数据源不匹配的问题。

最佳实践建议

1. 一致性原则：确保文件夹命名与所使用的数据源API保持一致
2. 迁移建议：如果从其他前端(如RetroArch)迁移游戏库，需要检查并调整平台文件夹名称
3. 故障排查：当遇到元数据抓取问题时，首先检查平台文件夹名称是否符合规范

总结

这个案例展示了RomM平台识别机制的工作原理，也提醒用户在配置游戏库时需要注意平台标识的标准化。理解RomM的数据源与文件夹名称的对应关系，可以帮助用户更好地管理系统并解决类似问题。

对于使用IGDB数据源的用户，记住Sega Master System的正确标识是sms，这可以确保元数据抓取功能正常工作。