必须重建向量索引才能解决召回失败问题：先确认文档状态为“已嵌入”且向量数＞0，再通过关键词穿透测试和字段锚定反查验证检索效果，最后检查标签、时间筛选及解析文本完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用超级麦吉建完知识库后，发现搜“热处理工艺参数”却跳出三份供应商报价单，而真正该出现的《GB/T 25744-2010》规范文档根本没被召回——这说明资料虽已上传，但检索路径没打通，必须立刻验证。
确认文档是否真实入库
打开左侧「知识库」→点击目标知识库名称→右上角点「管理文档」。页面列出所有已解析文件，注意看每行末尾的状态栏：显示「已嵌入」且「向量数＞0」才算真正完成索引；若为「待处理」或「解析失败」，哪怕文件名在列表里，也不会参与任何检索。
点击任一文档右侧「详情」，查看「文本预览」区是否能正常显示正文段落。若只显示乱码、空白或大量「[图片]」「[表格]」占位符，说明清洗失败，PDF扫描件未OCR、Word含加密宏或页眉页脚干扰严重。
用最小闭环测试检索有效性
方法一：关键词穿透测试
在知识库搜索框输入文档中【唯一出现且非通用的短语】，例如某份工艺卡里写着“淬火介质：PAG-10%，温度控制±1.5℃”，就直接搜“PAG-10% ±1.5℃”。如果这条记录没出现在前3条结果里，说明分词或向量化环节丢失了关键实体。
方法二：字段锚定反查
打开原始文档，复制一个带上下文的完整句子（不少于15字），粘贴进搜索框并加英文双引号，例如：“本规范适用于碳素结构钢及低合金高强度结构钢的热轧钢板”。若返回结果中该文档未置顶，或匹配段落被截断，证明chunk切分尺寸过大或重叠率不足。
注意：不要用“热处理”“工艺”这类宽泛词测试，它们无法暴露索引缺陷。
定位召回失败的具体原因
第一步：检查文档标签与检索词是否错位
进入「管理文档」→点击问题文档→看「标签」栏是否为空或仅填了“通用”“资料”等无效标签。超级麦吉的检索会优先匹配标签，若你给《焊接评定报告》打标“材料”，却搜“焊接工艺”，系统大概率跳过该文件。
第二步：验证时间戳是否触发过滤
在搜索框输入任意词后，点右上角「筛选」→展开「时间范围」。若默认勾选了“近30天”，而你的历史规范文档年份是2021年，它会被直接排除。必须手动取消时间限制或改选“全部时间”才能暴露真实召回率。
第三步：比对原始文本与向量库实际摄入内容
在文档详情页点击「查看解析文本」，逐行对照原始文件。常见断裂点：表格跨页时丢失表头、PDF中公式转成乱码后整段被剔除、Word批注未合并到正文。这些位置一旦空白，对应的知识片段就彻底消失。
强制刷新检索链路
进入知识库设置→下滑找到「高级选项」→点击「重建向量索引」。该操作会清空当前向量库并重新解析全部文档，耗时取决于文档总页数，但【这是唯一能让清洗后文本真正生效的操作】。重建期间无法检索，建议在非工作时间触发。
重建完成后，不用重启软件，直接在搜索框输入刚验证失败的短语，观察首条结果是否变为对应文档。
