索引中心
适用读者：Halo 站长、RAG 运维人员
索引中心管理文章切片、关键词、向量和同步状态。文章是事实来源，Lucene 索引是可以重新生成的派生数据。
状态流转
什么时候全量重建
- 第一次启用插件。
- 更换 Embedding 模型或向量维度。
- 修改切片策略并希望所有旧文章生效。
- 升级后索引结构发生变化。
- 索引统计明显与公开文章不一致。
什么时候单篇重建
- 某篇文章检索不到。
- 修改文章后自动同步未完成。
- 只调整少量文章，不希望产生全站 Embedding 成本。
自动同步与重启
- 新文章发布、已发布文章修改、可见性变更会触发单篇自动同步。
- 插件启动或 reload 不会自动全量重建，已有 Lucene 索引会直接继续使用。
- 自动同步会比较正文、切片配置和模型指纹；指纹未变时不会调用关键词或 Embedding 模型。
- 自动索引连续失败 3 次后会停止重试，避免无限模型调用；请在索引中心检查配置后手动重试。
- 如果文章在插件停用期间发生变化，重新启用后请执行单篇或全量重建。
页面检查重点
- 已索引文章数、切片数和失败文章数。
- 每篇文章的状态、切片、关键词和截断提示。
- 全量/单篇任务进度。
- 失败信息与最后更新时间。
清除索引
清除某篇文章索引后，它不会再进入 RAG 或插件关键词搜索。清除不会删除 Halo 原文章；重新执行单篇索引即可恢复。
成本控制
全量重建会批量调用 Embedding；开启自动关键词后还会增加模型调用。生产站点建议先估算文章量、切片数量和每日限额，避免重建中途被限额截断。
验证
- 打开一篇已索引文章的切片。
- 从切片中选择一个专有词。
- 在调试问答中提问。
- 检查 Trace 是否命中对应文章。
底层流程见 RAG 管线。