Appearance
文档管理
按知识库查看文档导入和解析的运营详情：每个文档的大小、切片数、状态、错误信息。失败的文档可以一键重试重新解析。和 知识库管理 配套用——KB 列表发现异常 → 这里看具体哪些文档挂了 → 重试或上报。
进入路径
左侧菜单 知识库 → 文档管理
概念速览
| 概念 | 一句话 |
|---|---|
| 文档 | 一份上传到知识库的原始资料（PDF / Word / Markdown / 图片 / 等）。 |
| 切片 (Chunks) | 平台把文档切成的检索单元数量；切片多 = 文档长 / 内容密。 |
| 类型 | 文档的 MIME 类型，如 application/pdf、image/png。 |
| 状态 | 完成（绿色，已解析完成可用）/ 处理中（黄色，正在向量化）/ 异常（红色，解析失败）。 |
| 错误信息 | 异常状态时填，简短说明失败原因（如「格式不支持」「文件超大」「服务端错误」）。 |
| 重试 | 触发该文档重新走完整解析流程——仅对异常文档可用。 |
页面一览
截图占位:文档管理 —
> 顶部选择**知识库下拉** + **状态下拉** + **进入详情** 按钮。下方一行小统计：当前 KB 名 / 文档总数 / 本页切片数 / 本页异常数。再下面是搜索框（可按文档名、编号、类型、错误信息搜）+ 主表 8 列。 tenant-kb-documents-list.png主表字段
| 列 | 说明 |
|---|---|
| 文档 | 文档名 + 编号（mono 字体显示） |
| 类型 | MIME 类型 |
| 大小 | 自动换算 B / KB / MB |
| 切片数 | 解析完成后的切片数量；处理中或失败显示 0 |
| 状态 | 彩色标签：完成 / 处理中 / 异常 |
| 错误 | 仅异常文档显示具体错误信息 |
| 创建时间 | 文档上传到知识库的时间 |
| 操作 | 异常文档显示 重试 按钮；其它显示「已完成」灰色禁用按钮 |
操作步骤
1. 选定要看的知识库
- 顶部 知识库下拉 → 选一个本租户的知识库（默认选第一个）。
- 列表自动加载该 KB 的文档；切换知识库时筛选条件自动重置。
- 想直接进知识库详情看更多信息 → 点 进入详情。
2. 排查异常文档
- 状态下拉选 异常，过滤出所有失败的文档。
- 看「错误」列的具体原因，常见几类：
- 「格式不支持」 → 平台不识别这个 MIME 类型，让员工换格式重传（如把扫描件 PDF 换成 OCR 后的文本 PDF）。
- 「文件过大」 → 超平台限额，让员工拆分文档。
- 「服务端错误」 → 后端服务异常，先点 重试；多次失败联系 监控运维 查后端。
- 「内容为空」 → 文档解析后没有可索引内容（如纯图片但未开 OCR），需员工补充。
3. 重试解析
- 异常文档行末 重试 按钮 → 后台重新走解析流程（下载文件 → 提取文本 → 切片 → 向量化）。
- 重试期间 按钮文案变「重试中」并禁用。
- 完成后状态自动刷新成「完成」（成功）或仍为「异常」（再次失败，需进一步排查）。
- 重试不会重新上传文件，沿用原始数据。
4. 按搜索词查文档
搜索框模糊匹配文档名、编号、类型、错误信息。常见场景：
- 用户反馈某个文档查不到结果 → 用文档名搜，确认导入状态。
- 排查某类文件全军覆没 → 用类型搜（如
pdf），看是不是这一类全失败。 - 看相似错误集中在哪些文档 → 用错误关键词搜（如
timeout）。
本页不能做的事
| 操作 | 去哪做 |
|---|---|
| 上传新文档 | 员工在客户端或知识库详情页操作 |
| 删除文档 | 员工在客户端自助删除 |
| 编辑文档内容 / 元信息 | 在客户端的知识库详情页 |
| 调召回阈值 / 切片大小 | 在 知识库服务配置 改默认值（平台层），或在客户端的知识库设置里改单库 |
本页是运营 + 排障视角，重试是唯一的写操作。
字段约束
- 重试 按钮仅对异常文档可用；完成 / 处理中文档不可重试。
- 重试不消耗用户配额——同一份文件无论重试多少次，都不算新上传。
- 搜索 / 状态筛选是前端过滤，不影响实际文档总数。
相关菜单
- 看本租户所有知识库总览：知识库管理
- 后端服务（RAGFlow / Dify）连通性：监控运维
- 服务参数（Embedding 模型、切片大小默认值）：知识库服务配置
- 开发者参考（导入流程 / 状态机详细规则）：开发者文档
常见问题
Q：「重试」会重新上传文件吗？ A：不会。平台保留了原始文件的副本，重试只是重新走「下载 → 解析 → 切片 → 向量化」流程，员工无感。
Q：重试多次仍然失败怎么办？ A：先确认错误信息是否每次都一样。如果是同一种错误，多半是文件本身的问题（格式、损坏、内容空），让员工换一份重传。如果是「服务端错误」类，联系运维到 监控运维 查后端。
Q：处理中的文档要多久变完成？ A：取决于文档大小和后端负载。小文档（< 1MB）通常 30 秒内；大文档（> 50MB）可能要几分钟。超过 10 分钟还在处理中通常是后端卡了，刷新看看，或重试。
Q：「切片数」为 0 但状态是「完成」？ A：可能是文档内容被识别为「无可索引内容」（如纯图片且未开 OCR）。员工需要补充文字描述或换文件。
Q：能批量重试所有异常文档吗？ A：当前只能逐个点。如果异常数量大（如几十个），建议先看错误是不是同一种——同种错误集中处理：要么修后端、要么让用户重传，比逐个点重试效率高。
Q：删除一个文档后切片立刻消失吗？ A：是，员工在客户端删文档后，切片随之删除。本页只是只读视图，删除操作不在这里。