数据维护与增量更新

企业知识资产随着制度更新与业务迭代持续变化。FastGPT 支持数据块级在线微调、文件覆盖更新与全量增量索引重建，确保知识库内容与线上生产环境保持同步。

场景一：单个数据块在线编辑与微调

当发现某一条特定条款的措辞需要小幅修订，或需要针对特定提问追加扩展问法时，使用在线数据块微调功能：

1. 进入目标知识库，点击目标集合展开数据块列表。
2. 点击需要修改的数据块卡片，打开数据块编辑弹窗。
3. 调整正文内容：直接修改数据块的主要内容。系统保存时会自动计算新的文本特征。
4. 补充扩展索引（同义问法）：在弹窗下方的 数据索引(N) 区域点击 新增，添加用户日常可能使用的其他提问方式。这些扩展文本将作为独立的检索锚点参与向量计算。
5. 保存生效：点击更新索引。等待保存与索引更新完成，再通过搜索测试核对更新后的分块。

场景二：整文件增量覆盖与哈希更新机制

按资料来源选择更新路径：

1. 上传文件：保留旧版文件备份，导入修订版，等待处理完成并通过搜索测试验收。核对标签与权限后再移除旧集合；版本重叠期间，两份资料都可能参与检索。
2. 可同步的网页或 API 来源：触发集合的同步操作。服务端读取来源正文并比对哈希，正文一致时可保留向量并更新标题。
3. 来源正文变化：已有正文哈希检测到变化时，同步逻辑删除旧集合并以新 ID 重建集合，迁移标签与权限记录。训练异步执行，需预留检索空窗并检查完成状态。

记录外部集成引用的集合 ID，替换完成后更新相关引用。

场景三：集合级停用与数据块清理

知识库支持按集合控制检索启用状态，并在集合内维护单个数据块：

• 停用集合（影响该集合内全部数据块）：在知识库的“集合列表”中切换目标集合的状态开关（需具备该集合的管理员权限）。被停用的集合及其下属全部数据块会立即从在线检索候选池中排除，同时保留原有分块记录以便后续重新启用。
• 删除单个数据块：对于彻底废弃的条款，在集合详情的数据块卡片上点击“删除”执行物理清理。系统同步从向量数据库与全文检索表中移除对应的索引记录。

场景四：重建向量与扩展索引

需要更换向量模型并全量刷新向量索引时，可在知识库详情页直接切换索引模型：

1. 打开目标知识库，在右侧信息栏中找到索引模型选择器。
2. 切换为新的目标向量模型并确认（当系统通过 DATASET_SYNONYM_ENABLED 启用同义词能力时，修改同义词配置也会自动触发同义词索引重建）。
3. 确认后，系统在后台为全库已就绪数据块生成批量消费任务。
4. Worker 按数据块重算索引，核对源内容与任务快照后逐块提交，再清理该块的旧向量。重建期间需关注部分完成状态，及时处理失败任务。

下一步

• 多维标签过滤：学习 集合标签体系。
• 团队协作保护：学习 集合权限控制。
• 常见故障恢复：查阅 知识库排障手册。