当前进度卡在“处理中: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插件,否则勾选无效】


















