Ventoy 文件列表 插件

• 背景

默认情况下，Ventoy 会遍历第1个分区（镜像分区）中的所有目录及其子目录，搜索出所有的ISO/IMG等支持的文件。
通过 全局控制插件 你还可以指定搜索的根目录 VTOY_DEFAULT_SEARCH_ROOT ，这样Ventoy就不会遍历所有的目录了， 而只会从你设定的这个目录开始搜索（包含其子目录）。
另外，你还可以在某个目录下放一个名为 .ventoyignore 的文件（文件内容无所谓、空文件也行，只要名字对就可以，注意大小写），这样Ventoy就会跳过这个目录及其子目录的搜索。
最后，Ventoy会把所有搜索出来的文件排序之后显示在启动界面上。（通过 全局控制插件 可以控制排序时是否区分大小写）

• 新需求

虽然Ventoy提供了比较灵活的搜索镜像文件的配置。但还是会有一些特殊需求。比如：
1、我只想显示出某个目录下的某几个ISO文件，而不是这个目录下的全部ISO文件
2、我不想按照字母排序，而是希望按照自己指定的顺序来显示启动菜单
3、我只想在 Ventoy 搜索结果的基础上，过滤掉几个特殊的文件

因此，这里提供了一个文件列表的插件。有 白名单 和 黑名单 两种模式。
在白名单模式下
由用户自己列出文件列表，Ventoy 不再搜索而是直接使用你给出的文件列表。 同时 Ventoy 也不再对文件进行排序，而是直接按照这里给出的文件顺序来显示启动菜单。
在黑名单模式下
Ventoy 首先还是像原来一样搜索，最后再从搜索结果中剔除这个列表中的文件。

但记住，99%的情况下，你都不需要使用这个插件，让 Ventoy 去搜索即可。

• Json 定义

推荐使用 VentoyPlugson 工具进行配置，无需手动创建、编辑json文件。请参考 VentoyPlugson
关于 ventoy.json 的位置以及相关说明，请首先参考 插件入口 （*必读）
在镜像分区 /ventoy/ventoy.json 中定义了一个 image_list/image_blacklist 的字符串数组来描述相关设置，分别对应白名单模式和黑名单模式。
注意，image_list 和 image_blacklist 是互斥的，只能使用其中一种，不能同时使用。

{
    "image_list": [
        "/ISO/Linux/archlinux-2020.10.01-x86_64.iso",
        "/ISO/cn_windows_10_enterprise_ltsc_2019_x64_dvd_9c09ff24.iso",
        "/ISO/Win10PE.iso"
    ]
}

• 多模式选项

支持。可以分别针对 x86 Legacy BIOS、IA32 UEFI、x86_64 UEFI 和 ARM64 UEFI 模式做不同的设置。详细说明请参考 多模式选项

• 注意

1. 本插件和 菜单别名 插件没有依赖关系，不管有没有设置菜单别名，这里只需要列出实际镜像文件的路径即可。
2. 如果同时设置了全局控制插件中的 VTOY_DEFAULT_SEARCH_ROOT 选项，则列表中的文件必须都位于对应的目录或子目录下。