获取文件列表¶

节点类型为 file.list，位于 Shift+A → 工具。填写文件或目录路径，或连接“路径”字符串输入；执行后输出文件路径数组、文件数量和成功布尔值。单个文件同样经过筛选，符合时输出一项，不符合时输出空数组。节点只枚举路径，不读取或处理文件正文。

路径连线优先于节点中保存的路径；连线值为空或类型不符时，不会改读未连接时的备用路径。枚举状态显示在任务运行提示中，没有独立的“状态”输出端口。

筛选与排序¶

配置	行为
后缀	例如 `mp4,mkv`；也接受 `.mp4`、`*.mp4`，空白表示不限。
包含子文件夹	默认关闭；开启后递归枚举，不跟随枚举过程中遇到的文件或目录链接。
文件名前缀	多项之间用逗号、分号或换行分隔；任意一项符合即可。
包含关键词	默认需要包含全部关键词，可改为任意关键词；只匹配文件名。
排除关键词	文件名包含任意排除词时跳过。
文件大小	可填写最小、最大字节数，包含边界；空白表示不限。
修改时间	支持 `YYYY-MM-DD` 或 `YYYY-MM-DD HH:mm:ss`，包含边界；仅日期表示当天零点。
排序	默认按文件名自然升序，例如 `2.mp4` 在 `10.mp4` 前；也可按修改时间或大小排序，并选择降序。

不同筛选项同时生效；例如后缀为 mp4、前缀为 课程，会保留同时符合这两项的文件。文件名筛选不区分大小写。

将“文件路径数组”连接数组循环，每轮将当前路径传给后续读取或处理节点。数组顺序就是本节点的排序结果；后续节点仍需满足自己的资源、组件和运行条件。

先检查“成功”布尔：路径不可读、筛选格式无效或枚举中途失败时，节点返回失败和空数组，不把已经列出的一部分文件当作完整结果。没有匹配文件也会得到空数组，应结合成功和运行提示区分。任务取消不会被当作成功结果。