# 构建文档视觉清单

把图纸或文档的页面、视觉对象、文本和图片引用组织成视觉清单，供文本与图片索引共同使用。

清单生成后，连接文档文本嵌入或图片嵌入节点建立索引。

## 使用图纸结果构建清单

默认配置档为 `industrial_drawing_v1`，该路径需要上游[CAD 图纸分割](cad-segmentation.md)的完整结果 `cad_result`。

将完整的 `cad_result` 绑定到本节点，保留其中的页面来源和产物文件引用。

处理普通图文文档时，可使用[文档知识库准备（含图片索引）](../../templates/document-image-index.md)模板，由模板提供相应的解析和清单配置。

## 配置与数据绑定

| 输入或配置 | 说明 |
| --- | --- |
| CAD 结果 `cad_result` | 默认图纸路径的上游分析结果 |
| 来源与文档 | 对应路径使用 `sources`、文件引用或 `documents`，保留来源信息 |
| 启用 `enabled` | 为 false 时跳过处理并返回禁用状态 |

## 使用输出

| 输出 | 用途 |
| --- | --- |
| `manifest` / `manifests` | 单个或多个视觉清单对象 |
| `manifest_file_id` / `manifest_file_ids` | 已保存的清单文件引用 |
| `documents` | 清单中的文档记录 |
| `derived_file_ids_by_source` | 每个原始文件对应的派生图片集合 |
| `indexed_image_file_ids` | 后续血缘登记需要覆盖的索引图片集合 |
| `status` / `validation` | 检查处理状态与清单校验信息 |

处理多个文件时，将全部 `manifest_file_ids` 及来源映射传给后续节点。仅在成功生成清单后执行索引步骤。

## 示例：连接图纸分析与检索

流程示意：CAD 图纸分割 → 构建文档视觉清单 → 文档文本嵌入与图片嵌入。

绑定完整 CAD 结果，文本和图片索引使用同一组清单。保留来源映射，供最终登记血缘使用。

## 继续阅读

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