火山引擎文档更新后搜索仍显示旧内容，说明知识索引未完成刷新；需先核查文档更新日志时间是否晚于新文档发布时间，再手动触发全量重建索引或调用openapi验证状态，并检查排除规则、yaml元信息及文档发布状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎文档更新后搜索仍显示旧内容，说明知识索引未完成刷新，新文档尚未被检索系统收录，此时直接重试搜索或清理浏览器缓存无效。
确认当前知识索引是否已更新
登录火山引擎控制台 → 进入【文档中心】→ 点击右上角【帮助与支持】→ 选择【文档更新日志】。页面顶部显示的最新更新时间必须晚于你看到的新文档实际发布时间（例如新文档标注“2026年10月20日发布”，而日志最新条目为“2026年10月19日”），则索引尚未同步。
若日志中已存在对应日期的更新记录，继续执行下一步。
手动触发知识库索引重建
方法一：通过文档管理后台强制重建
进入【文档中心】→ 左侧导航栏点击【知识库管理】→ 找到目标文档空间（如“火山引擎内容云 SaaS 文档”）→ 点击右侧【更多操作】→ 选择【重建索引】→ 在弹窗中勾选【全量重建】→ 点击【确认】。
【全量重建会清空当前索引并重新抓取全部文档，耗时约5–15分钟，期间搜索将返回空结果】
方法二：使用 OpenAPI 快速验证索引状态
调用火山引擎 OpenAPI：DescribeKnowledgeIndexStatus，传入参数 DocSpaceId（可在知识库管理页 URL 中提取）和 RegionId=cn-beijing。检查响应字段 IndexStatus 值：若为 Building，说明正在重建；若为 Active 但 LastBuildTime 滞后于文档发布时间，则需人工介入。
检查文档是否被正确纳入索引范围
第一步：确认文档所在目录未被排除索引
回到【知识库管理】→ 点击目标文档空间【配置】→ 查看【索引排除规则】列表。若存在类似 /draft/、/temp_、*_old.md 的正则规则，检查新文档路径是否意外匹配其中任意一条——匹配即被跳过，不会进入索引流程。
第二步：验证文档元信息是否合规
打开新文档原始 Markdown 文件 → 检查文件头部 YAML Front Matter 是否包含 searchable: true 字段。若缺失或值为 false，该文档默认不参与索引，即使路径合法也不会被收录。
第三步：确认文档未处于草稿或私密状态
在文档编辑界面右上角查看状态标签：若显示【草稿】或【仅限指定成员可见】，则不会触发索引任务，必须先点击【发布】并设置为【公开】或【团队可见】。
