先判断问题发生在权限、导出过程、文件结果还是迁移验收，不要一上来更换工具或重导全部内容。用一篇不含敏感信息的测试文档复现，记录现象和所在层，处理后再做离线打开、搜索和附件检查。
导出失败时，“工具坏了”通常不是最准确的判断。按钮不可用、正文只出来一半、图片断链、附件不见、迁移后目录乱掉，可能分别发生在权限、网页抓取、文件转换和迁移验收四个不同环节。
先定位问题在哪一层，再选对应做法。否则一开始就换工具、清缓存或重导整个知识库，往往只是把同一批文件再做一遍。
先做三个固定动作
用一篇测试文档复现
测试文档最好包含标题、正文、列表、表格、图片和一个附件，并且不包含敏感信息。换一个页面或换一种导出格式，看看问题是否仍然出现。
记录问题现象
写下你看到的原文、导出结果和出错位置。只写“内容不全”很难定位，写“导出后的第二级标题之后少了三张图”才能缩小范围。
不要马上批量重导
先用单篇确认根因。单篇都不稳定时，批量只会放大问题，也会让失败文件更难追踪。
四层排查表
| 所在层 | 常见现象 | 第一步检查 | 下一步 |
|---|---|---|---|
| 权限和入口 | 能看但不能导出、下载按钮灰掉、扩展没有反应 | 是否网页版、当前账号是否有复制或下载权限 | 让所有者开放所需权限，或改用企业允许的流程 |
| 抓取和转换 | 正文只有前半段、折叠内容缺失、图片没有进入结果 | 页面是否滚动加载、内容是否展开、切换标签后是否仍正常 | 用测试文档确认抓取范围，再处理批量和图片 |
| 文件结果 | Markdown 图片裂图、Word 排版变化、PDF 分页异常、附件独立缺失 | 文件里还有没有在线链接，附件是否单独下载 | 选择合适格式，把图片和附件落到本地 |
| 迁移和验收 | 数量对得上，但目录、链接、重复项或权限关系不对 | 源范围、目标目录和迁移截止时间是否明确 | 按风险抽样比对，登记问题后只重跑失败项 |
权限层：先确认你是否有权处理
“能阅读”和“能下载”是两件事。企业可能对导出、复制、附件下载或外部共享设置额外限制。
先确认三件事：
- 文档是在浏览器网页版打开，不是只在桌面客户端里显示。
- 当前账号确实拥有需要的查看和下载权限。
- 企业策略允许把这份内容保存到本地。
浏览器扩展只能整理当前页面已经允许你看到的内容。它不应该也通常不能绕过权限、下载限制或账号策略。遇到这类问题，正确入口是文档所有者或组织管理员，而不是反复更换工具。
抓取层：为什么正文只出来一部分
飞书等在线文档会按视口加载内容。页面当前没显示的长文、折叠块、评论或附件区域，可能还没有进入可读取状态。
排查时把测试集中在一个问题上：
- 先在页面上完整展开需要保存的内容。
- 从头到尾滚动一次，确认长文确实可以加载。
- 导出后再搜索文章中间的关键词，不要只看开头。
- 换一篇短文档测试，区分“抓取范围不足”和“整份文件没生成”。
如果短文档正常、长文档稳定缺失，就应该围绕长页面和滚动加载处理，而不是继续调整图片或格式。
文件层：文件生成了，为什么还是不能用
文件存在不等于可以长期使用。最常见的四个缺口是：
| 结果 | 问题 | 检查重点 |
|---|---|---|
| Markdown | 图片显示为空 | 图片是否仍指向飞书临时链接 |
| Word | 标题、表格或分页变化 | 原文档结构和导出格式是否兼容 |
| 内容被分页切断 | 页面是否需要调整打印版式 | |
| 附件包 | 正文有名字，文件找不到 | 附件是否被当成独立文件下载 |
图片、附件和正文应该一起移动。把整个目录换一个位置，再断网打开，才能确认文件不是只在原电脑和原登录状态下可用。
迁移层：数量对了，为什么知识库还是乱
批量迁移后常见的问题不是少了几篇，而是目录关系、内部链接、重复页面和权限边界发生了变化。
先冻结源范围和目标目录，再抽样检查：
- 目录能不能照原路径找到资料。
- 正文中间的关键词能不能搜到。
- 图片、表格和附件能不能打开。
- 内部链接和跨页面引用是否仍然可达。
- 没迁移的权限内容有没有留下记录。
发现问题后先登记，不要立即重跑全部页面。把问题按单篇、单批或格式差异分组，只补导失败项，再做第二轮复验。
一张问题记录表就够用
每次排查至少记录：
- 源文档地址或唯一标题
- 使用的导出方式
- 实际结果和预期结果
- 出错步骤或文件位置
- 是否只在某一篇、某一批或某种格式出现
- 修复后的复验结果
记录的作用不是留档好看，而是让你下一次遇到同类问题时，不必从“工具是不是坏了”重新开始。
什么时候才需要整批重做
只有在源范围、账号权限或导出规则整体发生变化时，整批重做才可能合理。单篇内容缺失、图片断链或附件遗漏，通常应该先做小范围修复和复验。
一次可靠的导出或迁移，最后要同时满足：正文能搜索、图片能显示、附件能打开、目录能理解、权限有记录。四层排查的目的，就是尽快找到哪一项没有通过。