RomM项目中的目录排除配置技巧：解决@eaDir扫描问题

问题背景

在使用RomM游戏库管理工具时，许多Synology DSM用户会遇到一个常见问题：系统自动生成的@eaDir目录会被错误地扫描并显示在游戏平台列表中。这些目录实际上是Synology系统用于存储缩略图和元数据的隐藏文件夹，不应该被当作游戏平台处理。

常见误区

许多用户会尝试在配置文件的platforms部分添加排除规则，例如：

exclude:
  platforms:
  - '@eaDir'
  - ' @eaDir'
  - '@eadir'

然而这种方法并不奏效，因为@eaDir本质上不是一个游戏平台，而是文件系统层面的干扰项。正确的做法应该是在roms扫描配置中进行排除。

正确配置方法

RomM提供了精细的文件排除机制，主要通过roms配置节实现。针对Synology系统的完整排除方案应包含以下内容：

roms:
    multi_file:
      names:
      - _hidden
      - images
      - '@eaDir'
      - '!images'
      - '!orphaned'
      - '!downloading'
      parts:
        extensions:
        - txt
        - xml
        - jpg
        - jpeg
        names:
        - data.xml
        - ._*
        - multidisc
    single_file:
      extensions:
      - xml
      - txt
      - jpg
      - jpeg
      names:
      - info.txt
      - ._*
      - '*.nfo'
      - '@eaDir'
      - '*.xml'
      - '!info.txt'

配置详解

1. multi_file部分：处理多文件游戏时使用的排除规则

   • names：排除特定名称的目录
   • parts：排除特定扩展名或名称的文件

2. single_file部分：处理单文件游戏时使用的排除规则

   • extensions：排除特定扩展名的文件
   • names：排除特定名称的文件

最佳实践建议

1. 对于Synology用户，建议始终包含@eaDir和._*的排除规则
2. 可以同时排除其他常见干扰项，如临时文件(*.nfo)、图片文件(*.jpg)等
3. 配置完成后，建议执行完整扫描以验证效果
4. 定期检查日志文件，确认排除规则是否生效

技术原理

RomM的扫描机制分为多个层级：

1. 首先识别平台目录
2. 然后扫描平台内的文件和子目录
3. 最后对找到的内容进行分类处理

@eaDir等干扰项应该在第二层级就被过滤掉，而不是等到平台识别阶段。这就是为什么需要在roms配置节而非platforms配置节中进行排除的原因。

通过正确配置这些排除规则，可以显著提高RomM的扫描效率和准确性，确保游戏库只包含真正需要管理的内容。