建立更新、删除
和备份闭环

先理解今天的原理

更新不是简单上传新文件。新版本进入后，旧版本需要标记关系或退出检索；删除授权后，原件、处理文本、片段、索引和缓存都要同步处理。

可恢复备份至少包含原件、清单、处理规则、索引配置和评测集。备份文件存在只说明保存过，实际恢复演练才能证明它可用。

为什么今天要做这件事

1. 版本关系可以避免新旧规则同时被召回。
2. 完整删除可以满足授权撤回和隐私要求。
3. 回归与恢复能验证维护动作没有破坏现有能力。

开始前检查

这是第 07 天。先完成下面的检查，再开始操作。缺少关键材料时，先补材料，不要让 Agent 猜。

1. 原件、片段、索引和评测集均有版本记录。
2. 准备一份新增资料、一份替换资料和一份待删除测试资料。
3. 准备独立恢复目录，不覆盖当前知识库。

一步一步完成

第 1 步：新增资料：更新清单、处理、索引并运行回归

这一步会让环境或项目发生变化。开始前先保存当前状态，执行时记录真实入口、参数和输出，出现异常就停在当前步骤排查。

1. 新增资料：更新清单、处理、索引并运行回归。
2. 保存执行命令、输入参数、开始前状态和结束后的输出。
3. 重新运行一次最小检查，确认结果可以稳定复现。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 2 步。

完成这一步后，你应该看到：新增资料：更新清单、处理、索引并运行回归，执行过程与可复现结果已经记录。

第 2 步：替换资料：记录版本关系并让旧版退出默认检索

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚，让第二天重新打开项目时仍然知道它的用途。

1. 替换资料：记录版本关系并让旧版退出默认检索。
2. 打开新材料逐项检查，删除示例占位内容，补上本次真实信息。
3. 记录保存路径，并确认关闭页面或重新打开项目后仍能找到。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 3 步。

完成这一步后，你应该看到：替换资料：记录版本关系并让旧版退出默认检索，产物内容完整并且可以重新找到。

第 3 步：删除资料：移除原件授权对应的全部副本与索引

这一步会让环境或项目发生变化。开始前先保存当前状态，执行时记录真实入口、参数和输出，出现异常就停在当前步骤排查。

1. 删除资料：移除原件授权对应的全部副本与索引。
2. 保存执行命令、输入参数、开始前状态和结束后的输出。
3. 重新运行一次最小检查，确认结果可以稳定复现。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 4 步。

完成这一步后，你应该看到：删除资料：移除原件授权对应的全部副本与索引，执行过程与可复现结果已经记录。

第 4 步：备份原件、清单、配置和评测集

这一步要用证据判断结果。先写预期，再执行测试，最后分别记录实际结果与结论；失败项保留原样，便于定位原因。

1. 备份原件、清单、配置和评测集。
2. 记录测试条件、预期结果、实际结果和是否通过。
3. 失败时保存复现步骤与证据，修复后重新执行同一项检查。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 5 步。

完成这一步后，你应该看到：备份原件、清单、配置和评测集，每一项都有预期、实际结果和明确结论。

第 5 步：在独立目录恢复并运行同一组评测

这一步会让环境或项目发生变化。开始前先保存当前状态，执行时记录真实入口、参数和输出，出现异常就停在当前步骤排查。

1. 在独立目录恢复并运行同一组评测。
2. 保存执行命令、输入参数、开始前状态和结束后的输出。
3. 重新运行一次最小检查，确认结果可以稳定复现。
4. 对照今天的目标完成最后检查，确认所有证据已经保存。

完成这一步后，你应该看到：在独立目录恢复并运行同一组评测，执行过程与可复现结果已经记录。

## 变更编号 KB-2026-08-19-01
- 类型：新增 / 替换 / 删除
- source_id：
- 原版本：
- 新版本：
- 处理文件：
- 片段数量：
- 索引更新时间：
- 缓存处理：
- 回归结果：
- 操作者：

## 恢复演练
- 备份位置：
- 恢复位置：
- 恢复耗时：
- 评测通过：
- 缺失项：

# 第 07 天操作记录

## 今天使用的入口与版本

## 实际完成的步骤
- [ ] 1. 新增资料：更新清单、处理、索引并运行回归。
- [ ] 2. 替换资料：记录版本关系并让旧版退出默认检索。
- [ ] 3. 删除资料：移除原件授权对应的全部副本与索引。
- [ ] 4. 备份原件、清单、配置和评测集。
- [ ] 5. 在独立目录恢复并运行同一组评测。

## 保存的证据
- 文件：
- 截图：
- 命令或测试结果：

## 与文章不同的地方

## 下一步

这次真实操作得到了什么

1. 第一次发现派生目录残留旧副本；修复后退役 sourceId 会消失，恢复后重新出现且 SHA-256 一致。

本次实际结果：备份与 manifest 保留，原件最终恢复，版本冻结为 1.0.0。

正确结果长什么样

完成操作后，用结果来判断今天是否学会。页面能打开或命令能运行，只能说明流程启动了；下面这些证据同时出现，今天才算完成。

1. 新增、替换和删除各完成一次测试并留下日志。
2. 旧版本与已删除资料不会进入默认检索。
3. 备份在独立目录成功恢复。
4. 恢复后的系统通过同一组核心评测。

常见错误与恢复

留给明天的材料

结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料，保存清楚可以减少重复说明和错误猜测。

1. 可用的个人知识库第一版。
2. 维护日志和版本关系。
3. 已验证的备份、恢复与回归记录。