# 图纸来源对象与缺口

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| knowledge_base_id | integer | 本次知识库。 |
| source_file_id | string | 查询的来源文件标识。 |
| external_source_uri | string 或 null | 来源URI；缺少可信值返回null，不是公网下载保证。 |
| visual_manifest_file_id | string 或 null | 视觉清单文件ID；缺少时null。 |
| provenance_status | string | ready或legacy_unmigrated。 |
| gaps | string（字符串数组） | 已发现的来源缺口；没有返回[]。 |
| pages | object（对象数组） | 完整有效页面映射；缺少时[]，不虚构预览页。 |
| pages[].page_number | integer | 正数页码。 |
| pages[].page_image_file_id | string | 完整页面图文件ID。 |
| pages[].preview_url | string | 受鉴权的相对API预览路径，用同环境网关和工作区凭据读取。 |

ready要求已有有效页面及视觉清单；external_source_uri缺失时仍可ready，同时gaps包含external_origin_missing。legacy_unmigrated可能表示旧schema/未迁移或部分缺口，不能用单一状态代替字段检查。未加载证据、字段null、空数组不是同一件事；检索结果中的来源字段还可能省略，独立溯源对象则显式返回null/数组。

| gaps值 | 含义 |
| --- | --- |
| drawing_provenance_schema_missing | 来源表/列尚缺，返回legacy，不当404 |
| drawing_provenance_unmigrated | 没有文件记录及页面映射 |
| drawing_page_missing | 没有有效正页码和页面图ID组合 |
| visual_manifest_missing | 缺视觉清单ID |
| external_origin_missing | 缺原始来源URI |

源表缺失优先报告schema缺口，不一定同时枚举所有空字段。未知source_file_id在可访问知识库中也可返回legacy/空页面，不能从200证明文件存在。指定不存在的page_number则返回404/ErrDrawingPageUnavailable。page_number只校验存在，不缩小pages数组。
