文档上传采用单个上传还是批量上传？

核心回答

单个上传和批量上传可以共用一条后端处理链：前台按场景选择一个或多个文件，后端按文档建任务并分别报告进度。少量资料单个上传便于即时查看，大量历史资料适合批量导入；批量并不意味着把全部文件和解析任务塞进一个长请求。

还要区分多文件上传与大文件分片：前者是多个独立文档，后者是把一个大对象拆成网络传输部分，完成后仍是一份文档。知识切片则发生在解析之后，是第三个概念。

从上传到检索怎样衔接

接收文件后先保存原始对象与文档记录，记录所属知识库、来源、版本、大小和校验信息，再交给异步处理器解析、清洗、切分、编码与入库。上传成功只代表字节或对象已接收，索引可读后才标记为可检索。

每份文件有独立doc_id和处理状态，批次ID负责汇总。部分失败时保留成功项和具体失败原因，重试失败文档即可；不应因一份坏PDF重新处理所有文件。

批量导入怎样避免资源失控

限制单文件大小、批次总量及在途处理数，使用流式或临时文件方式接收，避免全部读入内存。解析、OCR和Embedding分别按资源与供应商配额控制并发，排队时给出可查询进度，不让用户一直等一个HTTP连接。

对大文件保留上传ID、分片与校验状态，重连后续传未完成部分；完成前不当作完整文档。取消和超时清理临时对象及未完成上传，防止存储残留。

重复、更新与其他入口怎样处理

用内容哈希寻找重复候选，同时考虑来源、版本和授权；同名文件可能是新版，相同内容也可能有不同访问范围。处理幂等键和版本校验能避免重复重试与迟到结果覆盖。

链接导入、粘贴文本和文件上传可以先归一为文档对象，再共用治理流程；各入口仍保留自己的来源位置、读取权限和失败状态。接口形态与文档处理链分开后，增加新入口无需重做整套RAG。

怎样验证

覆盖单文件、多文件部分失败、重复提交、断点重传、超大文件、解析超时和取消。分别检查上传完整、处理状态正确、有效片段入库和最终可查询，不以接口返回200代替完整验收。

参考资料