# 图片嵌入

读取文档视觉清单中的页面图和视觉对象图片，生成图片向量并写入图片索引表。

适用于图纸、版面和图片对象的视觉检索。输入应来自[构建文档视觉清单](../other/document-visual-manifest.md)。

## 准备视觉索引输入

使用模板时，视觉清单和索引配置由模板绑定。自行编排时，需要提供以下输入。

| 输入 | 说明 |
| --- | --- |
| 视觉清单 | 提供清单对象或清单文件引用，包含可读取的页面图和对象图片引用 |
| 图片向量表 `image_vector_table` | 写入图片向量的目标表 |
| 图片嵌入模型 `image_embedding_model` | 用于处理真实图片的模型 |
| 向量维度 `embedding_dimension` | 必须为正数，并与模型输出及目标索引一致 |
| 预处理版本 `preprocess_version` | 必须提供，用于标识图片预处理方式 |
| 距离度量 `distance_metric` | 必须提供，与图片索引配置保持一致 |

“启用”默认开启。关闭时返回 `disabled`，跳过嵌入和索引写入。嵌入来源设为 `real`，由模型处理图片本身。

## 检查索引覆盖

`written` 是写入总行数，`page_rows` 和 `visual_object_rows` 分别统计页面与视觉对象记录。

`all_source_file_ids` 表示本次考虑的来源；`indexed_source_file_ids` 仅包含实际写入图片索引的来源。结合 `file_statuses` 判断每个文件的处理结果。

对于允许空图片结果的流程，`no_indexable_images` 表示该文件没有可索引图片，该文件未写入图片向量。

## 示例：建立图纸图片索引

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

传递完整清单及图片索引配置，运行后检查图片向量维度、写入数量与逐文件状态，将已索引的源文件列表传给[血缘登记](../other/lineage-registration.md)，记录索引与源文件的关联。

## 继续阅读

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