当前进度卡在“处理中：37%”，需查任务详情页“执行日志”末条状态；若为⚠分块超时，须15分钟内续传——可api直连或点【重新处理未完成项】；启用自动续传策略需开启开关、设重试3次、冷却180秒，并启用pdfminer插件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你上传一份包含2000页PDF的采购合同合集到Dify知识库，系统卡在“处理中：37%”已超过40分钟，此时你既不确定是否还能恢复，也不敢关闭页面重试——你需要立刻知道当前进度在哪、失败点在哪、能否从中断处继续。
查看当前任务实时进度
打开Dify控制台 → 点击左侧导航栏【知识库】→ 找到对应知识库 → 点击右侧操作列的【文档】按钮。
在文档列表页顶部，找到灰色小字标注的“最近处理任务”区域，点击右侧的【详情】链接。
进入任务详情页后，滚动到“执行日志”区块，每条日志末尾都带有时间戳和状态标记（如✓ 提取完成、⚠ 分块超时、✗ OCR失败）。最新一条即为当前卡点位置。
注意：若日志最后一条是⚠ 分块超时，说明系统已在该文件处暂停，但尚未标记为失败——这是断点续传的关键窗口期，【必须在15分钟内触发续传，否则任务将被自动清理】。
手动触发断点续传
方法一：通过任务ID直连续传接口（推荐给运维人员）
复制当前任务详情页URL中的task_id（形如task_abc123xyz），在浏览器新标签页中访问：
https://your-dify-domain/api/v1/tasks/{task_id}/resume
发送POST请求（需携带管理员Token），响应体返回{"status":"resumed","next_file_index":42}即表示从第43个文件开始继续处理。
方法二：前端界面一键续传（适用于普通用户）
回到任务详情页 → 滚动到底部 → 点击【重新处理未完成项】按钮 → 系统自动跳过已成功解析的前42个文件，直接加载第43个PDF并启动Tesseract OCR流程。
这一步操作起来很简单，直接点击就行。但要注意：如果该文件本身是扫描件且未配置OCR密钥，续传会立即再次失败，不会自动降级为文本提取模式。
配置自动断点续传策略
第一步：进入Dify后台管理界面（需Super Admin权限）→ 点击【系统设置】→ 选择【知识库处理策略】。
第二步：开启“异常中断自动续传”开关，并设置重试次数上限为3次。
第三步：在“续传冷却时间”栏填入“180”，单位为秒——这意味着单个文件连续失败3次后，系统将暂停整个任务，并保留现场状态供人工介入。
第四步：勾选“OCR失败时启用备用文本提取通道”，此项启用后，当Tesseract识别置信度低于65%时，自动切换为PDFMiner纯文本抽取路径，避免整批卡死。
【关键前提：必须提前在【插件管理】中启用PDFMiner插件，否则勾选无效】
