# 写出文档文件

将标准文档数组写成 Catalog 文件，保留文档内容、元数据及相关解析产物。

适用于保存解析或分段结果，供后续流程读取。需要同时选择保存位置并处理文本、JSON 等其它内容时，可使用[存至 MOI 卷](../data-io/save-volume.md)。

## 配置写出内容

`documents` 必须是非空文档数组。可提供 `output_file_name` 设置输出文件名；未提供时使用带时间标识的文档文件名。

绑定解析或分段节点输出的完整 `documents`，保留内容和来源信息。

## 理解文件格式与数量

普通文档可以写为 JSONL。存在 Markdown、版面等解析产物引用，或明确采用 ZIP 文件名时，会保存为 ZIP 文件。

多来源文档会按来源分组写出，因此一次执行可能返回多个文件。

## 使用输出

`count` 表示写出的文档数量；`file_ids` 和 `file_names` 表示全部结果文件。`file_id` 和 `file_name` 用于主要结果。

后续批量处理使用 `file_ids`，保留全部结果文件及其来源关系。

## 示例：保存分段结果

流程示意：文档解析 → 分段 → 写出文档文件。

绑定分段节点的完整 `documents`。完成后核对文档数量、文件列表与实际格式，再将结果文件交给后续流程。

## 继续阅读

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