媒体上传：功能概述与上传会话

概述

媒体上传模块的职责是管理数据上传与处理进度（页面副标题原文）。本地采集的照片和视频通过该模块进入平台（当前仅照片和视频的上传有效），并在此跟踪从上传、校验到后台处理的完整过程。

页面由五个区域构成，先通过下表建立整体印象：

日常使用遵循“视图选择 → 条件筛选 → 记录核对 → 状态跟踪”的结构；发起上传通过“选择数据、确认清单与意图、确认位置、上传”四步向导完成。

提示

核心认识：一条记录（一张卡片或一行列表）不是单个文件，而是一个上传会话——一批文件在“上传 → 校验 → 处理”多个阶段上的状态投影。理解会话与状态机，是用好本模块的前提。

媒体上传是照片和视频进入平台的入口 ：当前仅照片和视频的上传有效；模块为每批数据建立上传会话，跟踪上传、校验与处理的全过程。
上传后的照片和视频被所有成果探索会话共享 ：照片和视频进入平台后，可以在成果探索中查看，且不属于某一个会话；这与成果探索中“照片、全景和视频可跨会话查看”的规则一致。
两个模块的分工 ：媒体上传回答“数据是否进入平台、当前处于哪个处理阶段”；成果探索回答“内容本身的查看与使用”。在成果探索中查看已上传的照片和视频时，不需要切换到某个特定会话。

每一次新建上传（无论一次选择多少个文件）都会在平台生成一个上传会话，它是记录列表展示与跟踪的基本单位。一个会话聚合以下信息：

同一批文件共享同一条上传、校验与处理流程，以会话为单位跟踪可以一次掌握整批进展；文件数字段保留了规模信息。当前页面不支持查看单文件的成功/失败结果，出现“处理结束（含部分失败）”时按“存在一个失败就全部失败”的口径处理。跨人员、跨页面沟通时，应使用唯一标识指认会话，名称可能重复。

从发起上传到最终结果，会话经历三个后台阶段：

提示

上传（文件传输到平台） ➔ 校验（平台对已上传文件进行检查） ➔ 处理（后台对该批数据进行处理）

新建上传向导步骤4的“文件上传完成”只代表上传阶段完成；校验与处理在后台继续推进，并逐一投影为列表状态。因此列表状态是判断会话进展的唯一依据，而不是向导是否关闭、文件是否传完。

状态筛选的可选值即完整状态集合：全部状态、待上传、上传中、校验中、等待处理、处理中、处理结束（含部分失败）、失败、正在取消、已取消。逐条解读：

两点需要特别说明：

“处理结束（含部分失败）”按整会话失败处理 ：“结束”只说明流程走完，其中可能包含个别文件失败；当前页面不支持查看哪些文件失败，暂按“存在一个失败就全部失败”的口径对待。
取消不是用户发起的 ：页面不提供用户主动取消入口，正在取消与已取消由系统触发，具体触发条件页面未直接说明；已取消的会话不会自行恢复，不能等待其继续。

状态推进通常伴随更新时间变化。两种信号值得关注：