图纸来源对象与缺口

字段

类型

说明

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数组。

最后更新于