核心功能可用2026-03-29
处理状态详解：从上传到完成
DocPurify 任务会经历上传中、等待中、处理中、已完成、失败或已取消几个清晰阶段。
状态与适用范围
当前状态：可用。这里会直接说明怎么接入、现在能做什么，以及当前限制。
状态标签的作用是帮你快速判断下一步该做什么，而不是暴露所有内部细节。
核心状态说明
| 状态 | 含义 | 建议操作 |
|---|---|---|
| uploading | 文件正在上传。 | 保持页面打开，等待上传完成并确认。 |
| waiting | 上传已确认，任务进入排队。 | 可以等待，也可以先去处理其他工作。 |
| processing | 任务正在处理中。 | 关注进度，等待完成后检查结果。 |
| completed | 结果文件已就绪。 | 下载结果并核对内容。 |
| failed | 任务未能成功完成。 | 查看错误提示，调整输入后重试。 |
| cancelled | 任务已被取消。 | 需要时重新发起一次处理。 |
说明
只有上传确认成功后，任务才会进入真正的处理阶段。
当前限制
状态推进速度受文件大小、处理选项和排队情况影响。最终请以任务的最终状态和结果是否可下载为准。
常见问题
等待状态一般会持续多久？
取决于当前队列长度和你选择的具体处理选项。
显示 completed 后可以立即使用结果吗？
可以。completed 表示处理已完成，结果链接通常立即可用。
相关文档
最后更新：2026-03-29