# 图纸解析

识别图纸页面、局部区域和文字，建立用于文字搜图或图片搜图的图纸知识。

## 开始前准备

准备图纸 PDF 或图片、可用的 CAD 主模型和视觉模型、图纸知识库与输出位置。先用一页包含文字标注和部件结构的图纸核对结果。

图纸知识库同时提供文本和图片索引配置。CAD 主模型负责分析，视觉模型用于 OCR 与视觉判断，嵌入模型用于生成索引；配置时分别确认这些用途。

## 使用模板

在创建工作流页面选择“从模板开始”，搜索“图纸解析”并载入画布。

在参数表单中填写以下必填项。

| 配置 | 用途 |
| --- | --- |
| 源图纸 | 选择要处理的图纸 PDF、图片或文件夹 |
| CAD 主模型 | 用于分析图纸结构的主模型 |
| CAD 视觉模型 | CAD OCR 与视觉判定使用的视觉模型 |
| 图纸知识库 | 选择已有图纸知识库或创建新的图纸知识库，同时绑定文本索引和图片索引 |
| 输出位置 | 保存图纸清单和处理摘要的位置 |

保存参数后发起手动运行，系统先保存当前流程，再提交执行。

## 完整处理流程

连线表示执行顺序；各步骤通过模板配置的数据绑定取得输入。

![图纸解析](../images/drawing-parsing-flow.svg)

## 配置分析与索引

| 配置 | 默认值或作用 |
| --- | --- |
| 解析模式 | 默认 `deep`，用于结构化图纸报告；`fast` 用于粗粒度检索解析 |
| CAD 分割服务地址 | 留空使用内置共享服务；使用自建服务时填写实际服务地址 |
| 三级文本索引 | 默认开启，Section 大小 5 |
| 文本嵌入维度 | 表单默认 1024；应与所选模型和目标索引匹配 |
| 文本索引写入策略 | `OVERWRITE`，覆盖同文档行 ID 的索引 |
| 图片索引写入策略 | `OVERWRITE`，按来源文件、模型及预处理等配置更新对应图片索引 |

先保留深度模式验证完整流程。切换快速模式后，检查其输出是否满足后续视觉清单要求，不要仅根据分析节点完成判断整个流程成功。

## 核对每一步的结果

1. 检查 CAD 结果中的页面、区域、部件关系和文字是否对应原图。
2. 检查视觉清单的校验结果及页面图、对象图片引用。本模板要求页面图片、对象图片与视觉上下文。
3. 分别检查文本和图片索引写入情况。它们使用同一组清单，但写入不同索引。
4. 查看输出卷中的保存结果和清单文件引用。
5. 核对来源映射与最后登记的资产关系，再验证文字搜图和图片检索结果。

修改流程时，完整保留 CAD 结果及逐来源图片映射。视觉清单不能只接收 OCR 文本；后续图片索引需要可读取的真实图片。节点详情见[CAD 图纸分割](../nodes/other/cad-segmentation.md)和[构建文档视觉清单](../nodes/other/document-visual-manifest.md)。

## 示例：处理设备装配图

选择一份装配图，配置主模型、视觉模型和图纸知识库。使用深度模式运行，先检查一个部件的文字标注与局部图片，再检查它们的来源和索引记录。最后用已知部件名称验证检索，核对命中图纸。

## 常见问题

| 现象 | 检查与处理 |
| --- | --- |
| 清单校验失败 | 检查完整 CAD 结果及页面、对象图片是否存在 |
| 文本可检索但图片不完整 | 查看图片引用、模型维度和逐文件状态 |
| 分析耗时较长 | 查看节点日志与处理范围；先用少量页面核对，不随意增加并发 |
| 重跑后索引改变 | 模板使用覆盖策略，先确认来源范围和目标知识库 |
| 不清楚该用哪种模板 | 普通图文资料用含图片索引的文档模板；需要部件和区域分析时用本模板 |

## 继续阅读

- [工作流模板](index.md)
- [运行与调试](../run-debug.md)