# 图纸检索输入与模式

| 字段 | JSON类型/表单值 | 必填 | 说明 |
| --- | --- | --- | --- |
| knowledge_base_id | integer / 十进制文本 | 是 | 正整数知识库ID。 |
| drawing_number | string | 条件 | 业务图号；非空时优先精确查询，不再做query或图片相似召回。 |
| query | string | 条件 | 文字查询；与file可组合。仅在没有drawing_number时走语义多通道。 |
| file | multipart文件 | 条件 | 图片二进制，JSON不支持此字段；不是已上传file_id或query_image_file_id。 |
| top_k | integer / 十进制文本 | 否 | 省略/0默认8，语义最多50，负数拒绝。精确版本查询不按top_k截断。 |

drawing_number、query、file至少有一种。JSON仅接受knowledge_base_id/query/drawing_number/top_k，未知字段拒绝；multipart使用file字段。首尾空白会修剪，图号还按共享业务图号规则规范化。图号无法规范化/没有精确匹配时返回空exact，不自动回退相似结果；图号和图片同时给时，请求边界仍可能校验图片/限额，不能据精确优先绕过上传检查。

请求体上限33MiB，图片文件不超过32MiB且必须非空、内容识别为image/*。单文件过大与整体请求过大可能映射不同错误；32MiB不是保证可执行嵌入的大小。图片转换为data URI，超预算时可能压缩，仍受4MiB嵌入请求预算和实际模型/绑定预处理约束，失败返回ErrPayloadTooLarge；不会改为公网URL绕过限制。

语义分支在知识库授权来源范围内融合文件名/编号提示、文本和图片召回，按source_file_id聚合，一个best_hit和最多三个supporting_hits。overwrite_current知识库限定当前指针来源，keep_versions则允许所有仍发布的有效版本；历史缺drawing_current schema的库可回退索引检索，但图号精确查询缺当前索引会失败关闭。keep_versions图号查询可返回全部有效版本并用default_version标记当前指针，不把所有命中都当当前版本。

top_k不是分页大小，没有offset/cursor；count不是可继续翻页的总数。编号提示的identifier_route_used也不等于match_mode=exact。来源未解析、索引尚未可用与有效空库是不同结果，不把503当零命中。

JSON可选query/drawing_number为null时按空字符串处理，top_k=null也用默认值，仍须满足至少一种查询条件。表单文本null不是JSON空值。
