问题
前端已经定义 MediaReference，但缺少可复用的真实上传适配器。Quick Start 和生成流程若各自处理 FormData、响应校验与错误，会造成重复实现，并可能把上传失败误报为成功。
目标
实现前端 Media Upload 边界，将图片文件上传到后端 POST /media/upload，返回经过运行时校验的 MediaReference。
范围
包含：
- Media 上传 API 工厂与上传输入
- multipart/form-data 请求
- 后端响应解包与运行时字段校验
- HTTP、网络、取消和非法响应错误
- 单元测试与模块说明文档
不包含：
- 资产库页面、媒体 CRUD 或文件夹管理
- Quick Start 页面改造
- 后端、对象存储配置、Mock 成功与构建产物
验收标准
- 调用方只传 File、分类和可选 AbortSignal
- 成功时返回真实后端 URL，不生成本地假 URL
- 非图片、空 URL、非法响应和请求失败明确报错
- 不在业务页面直接调用 fetch
- CI 五步通过：
format:check / lint / typecheck / test / build
问题
前端已经定义 MediaReference，但缺少可复用的真实上传适配器。Quick Start 和生成流程若各自处理 FormData、响应校验与错误，会造成重复实现，并可能把上传失败误报为成功。
目标
实现前端 Media Upload 边界，将图片文件上传到后端
POST /media/upload，返回经过运行时校验的 MediaReference。范围
包含：
不包含：
验收标准
format:check/lint/typecheck/test/build