# 数据维护与增量更新

> 掌握数据块在线微调、整文件替换、基于正文哈希的内容比对更新与批量向量索引重建。

Source: https://doc.fastgpt.cn/zh-CN/guide/dataset/update-data

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

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

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

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

![编辑单个数据块内容与扩展索引](/imgs/optimized/current/citation-edit-data.png.webp)

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

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

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

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

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

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

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

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

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

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

## 下一步

* 多维标签过滤：学习 [集合标签体系](/zh-CN/guide/dataset/collection_tags)。
* 团队协作保护：学习 [集合权限控制](/zh-CN/guide/dataset/collection_permission)。
* 常见故障恢复：查阅 [知识库排障手册](/zh-CN/guide/dataset/faq)。