# 读取 MOI 卷

从 Catalog 卷或所选文件中取得文件引用，供解析、导入和其它文件处理节点使用。

本节点负责确定文件集合，不把文件内容直接解析成文档正文。

## 选择来源

| 配置 | 说明 |
| --- | --- |
| 数据源 | 选择 Catalog 卷或文件来源，运行输入为 `source_ref` |
| 文件类型 | 可选扩展名筛选，用于从卷中选择文件；留空读取卷内全部文件 |

选择具体文件与选择整个卷会影响输入范围。先确认数量和文件类型，再连接解析或导入节点。

## 根据下游选择输出

| 输出 | 下游用途 |
| --- | --- |
| `sources` | 连接文档、图片、音频或视频解析 |
| `files` | 文件元数据数组，包含 `file_id`、`name`、`file_name`，可供信息提取等节点使用 |
| `file_ids` | 仅文件 ID 的数组，适用于文件导入等输入 |
| `count` | 当前选中的文件或资源数量 |
| `resource` | 解析后的来源资源引用 |

这些字段对应同一批文件。按下游输入选择 `sources`、`files` 或 `file_ids`；下游只接收单个文件时，取出对应的 `file_id`。

## 示例：处理卷中的 PDF

流程示意：读取 MOI 卷 → 文档解析。

选择资料卷，按 PDF 扩展名筛选，将 `sources` 绑定到文档解析。运行后先检查文件数量，再检查解析输出。

## 继续阅读

- [变量与数据传递](../../variables-and-data.md)
- [运行与调试](../../run-debug.md)