先冻结源知识库范围和目标目录,再选高、中、低风险样本逐项比对。重点检查目录层级、正文结构、图片附件、内部链接、重复缺失和权限边界;发现问题先记录清单和批次,不要一边验收一边大批量重导。
迁移结束后最容易看到的是“导出了多少篇”,但数量只能说明任务跑过,不能说明内容完整。真正需要确认的是:原来能看的内容,现在还能不能按同样的关系阅读。
验收不是再从头导出一次,而是用一套固定标准找出具体差异。先发现问题,再决定哪些需要补导、哪些只是格式变化,才能避免把整个知识库反复重跑。
先冻结验收基线
开始检查前,先写清楚这次验收到底对应哪一份迁移:
| 项目 | 需要记录什么 |
|---|---|
| 源范围 | 哪些空间、文件夹和页面属于本次迁移 |
| 目标目录 | 文件实际落在哪个本地或目标平台目录 |
| 迁移日期 | 导出和导入分别发生在什么时候 |
| 排除项 | 哪些内容因权限或规则没有迁移 |
| 负责人 | 谁处理、谁验收、谁确认例外 |
如果源知识库仍在持续修改,验收期间先冻结目标版本,或者记录一个明确的截止时间。否则后出现的差异,可能只是源文档又更新了。
六项一致性检查
1. 目录和层级
检查顶层目录、父子关系和页面顺序是否可理解。重点看中文名称、同名页面、空文件夹和跨空间页面。
层级允许因为平台模型不同而调整,但接手的人应该能沿目录找到原文,而不是面对一堆平铺文件。
2. 正文结构
对照标题、列表、引用、代码块、表格和折叠内容。随机搜索正文中的关键词,确认不是只保留了开头。
格式变化和内容缺失要分开处理。一个列表变成普通段落可能是转换损耗;整段消失则属于内容完整性问题。
3. 图片和媒体
检查图片是否仍指向飞书临时链接,视频、音频和附件是否能离线打开。图片文件名可以不同,但正文中的顺序和对应关系不能丢。
4. 独立附件
文档里提到了附件,不代表附件已经一起迁移。逐个打开最关键的表格、PDF、压缩包和源文件,确认不是只有文件名或下载链接。
5. 内部链接
内部链接最容易在迁移后失效。选取跳转较多的页面,检查目录链接、同文档锚点和跨页面引用。目标平台无法保留原链接时,至少要提供可搜索的页面标题。
6. 权限和归属
确认导出和导入范围没有超过你的权限。迁移后的目录里,敏感附件、客户资料和内部讨论应该继续受到相应访问控制,不能因为换了一个载体就变成公开文件。
怎么抽样才有效
全量逐字比对通常不现实。更实用的做法是按风险分层:
| 风险 | 典型内容 | 检查方式 |
|---|---|---|
| 高 | 图片多、表格多、附件多、层级深、跨页面链接多 | 全部或大比例检查 |
| 中 | 常见项目文档、会议记录、操作说明 | 随机抽查 |
| 低 | 短文本、单一说明、长期只读资料 | 检查标题和可打开性 |
样本数量按知识库规模决定,但高风险管理页面不应该只靠随机命中。验收记录里要写清楚抽了哪些、为什么抽这些,以及没检查的范围。
把问题变成可执行的清单
发现问题后,不要立刻重新导出全部内容。先按下面的字段登记:
- 源页面地址或唯一标题
- 目标文件路径
- 问题类型:缺失、重复、乱序、图片失效、附件缺失、链接错误
- 严重程度
- 负责人
- 修复批次和复验结果
批量修复时只重跑失败页面,再对修复项做二次检查。这样既能保留成功结果,也能知道问题集中在哪个转换环节。
最后做一次独立可用性测试
把验收目录移动到另一个位置,断网打开抽中的页面;搜索正文关键词;打开图片、表格和附件;再点几次内部跳转。
还可以让一位没有参与迁移的人按目录找三篇资料。他能顺利找到并打开,比验收人自己反复检查更接近真实使用。
验收通过的标准
验收不是要求所有格式和原平台一模一样,而是确认四项核心结果:
- 目录能理解。
- 正文能搜索。
- 图片和附件能打开。
- 权限和例外有记录。
迁移任务真正的完成标志,不是导出进度到 100%,而是有人能确认哪些内容已经可靠到达,哪些还需要处理,以及下一次复查由谁负责。