先区分是哪一步出了问题
普通搜索、助手查找正文资料和生成回答是不同环节。搜索没有结果时，先查内容和收录；搜索能找到文章但助手没有依据时，再查正文知识资料和助手范围；引用正确但回答有误时，才重点检查文档内容和生成结果。
后台排查需要有设置管理权限的账号。服务入口在瓜奇 → 综合 → 全局基础数据 → 第三方服务 → 智能搜索；助手范围和权限在瓜奇 → AI 知识助手中。
确认文章真实可用
- 找到目标文章，确认它已发布，正文中确实写明了问题的答案。
- 打开目标前端对应语言的文章地址，确认访客能够访问。不要只依据管理员后台能看到文章来判断。
- 检查文章类型和分类是否属于当前网站的内容范围。
- 如果检查的是译文，确认译文已发布、有正确的语言及分类关联，并已收录。原文和译文是不同的文章记录。
助手正文资料只接受符合条件的公开内容。草稿、密码保护文章、需要阅读权限的正文不会成为可引用资料；当前实现还会排除含短代码标记的正文，社区回复也不作为独立正文知识来源。普通搜索能显示标题，不代表助手能够使用这篇正文。
检查搜索资料是否准备完成
- 确认智能搜索已启用，Meilisearch 连接和向量模型配置已保存。
- 打开“管理搜索与 AI 内容”，查看服务错误、准备进度和自动更新状态。
- 检查长期内容范围：目标类型是否已选择，文章是否落在被排除的分类或子分类中。
- 首次使用时完成搜索资料准备；已有资料异常时，进入管理选项，选择全部或相关类型、分类进行检查。
- 查看检查结果，再按提示更新信息、清理失效资料或补充分析。需要调用向量服务的分析可能产生费用。
面板可以保留进度。任务暂停或连接中断后，重新打开查看状态并继续，不必直接从头建立全部资料。若提示自动更新失败，先处理服务或配置错误，再使用管理选项重试。
长期内容范围改变后，需要检查并应用到已有资料；仅修改“AI 知识助手 → 知识范围”则不需要重新索引。两种范围不要混为一谈。
先测试关键词，再测试自然语言
- 在目标前端、目标语言页面中搜索文章完整标题。
- 再搜索正文中的独特词语，确认内容能被检索到。
- 最后换成自然语言问题，例如“英文首页标题在哪里改”。
标题和独特词语都找不到时，优先处理收录、范围、语言和服务问题。关键词有结果但近义问法效果不好时，再检查向量模型、分析是否完成以及语义搜索权重。
当前检索会考虑页面语言。只把中文问题翻译成英文，并不等于切换了网站语言，也不能保证中文资料会在英文页面被引用。
搜索正常，助手仍提示没有资料
- 检查正文知识资料：在内容管理面板确认“准备 AI 回答资料”已完成或目标文章已成功处理。搜索索引与助手正文资料不是同一项完成状态。
- 检查知识范围：确认目标类型允许 AI 引用，分类选择包含该文章。分类未勾选表示不额外限制；关闭类型开关才是禁止这一类。
- 检查继承：独立前端可能仍在沿用主前端知识范围，修改本地字段前先确认继承状态。
- 检查公开条件：已收录的内容在回答前仍会核对发布状态、正文访问条件、语言和当前前端范围。
如果助手根本无法开始回答，还要检查助手总开关、当前用户组或游客权限、每日额度和 AI 通道。这类错误不能靠增加知识分类解决。
引用到了文章，但回答不准确
先打开实际引用的文档，确认它确实适用于当前问题。检查文档有没有混淆首页 SEO、文章 SEO 和分类 SEO，或遗漏前置条件、默认值、操作入口与限制。
文档主题过多时，可以拆成能够独立回答问题的小篇。每篇写清适用对象和操作步骤，例如涉及画廊免费序号时，应让读者核对实际免费图片，而不是只介绍一个字段名称。
再检查问题是否含糊、回答是否超出了资料，以及回答规则是否提出了与事实冲突的要求。增加回答长度或更换模型，不能补出知识源里根本不存在的事实。
保留样本，再做一次验证
记录问题、目标前端、页面语言、登录身份、实际回答、引用文档和预期关键点。修复后开始新对话，重复这些问题，并增加一个没有资料的问题。
验收时同时检查：能否找到目标文章、引用是否相关、操作入口是否正确、必要条件是否保留。资料不足时，助手应说明无法确认或引导进一步检查，不应编造功能和配置路径。