文件上传与生命周期管理
职责：以静态方法封装单文件上传、危险扩展名拦截、分类扩展名白名单、 私有文件鉴权下载（回收站状态写入已归位 MaintainFileService）。
┌────────────────── 分区导航（按此顺序阅读）──────────────────┐ 分区 1 · 常量与属性 存储目录隔离 / 默认选项 / 危险扩展名 / 分类白名单 分区 2 · 类型查询（读） fileTypeLabels / fileTypes 分区 3 · 上传（写） upload 分区 4 · 查询（读） exists / missing / url 分区 5 · 下载（读） downloadResponse 分区 6 · 内部辅助 危险扩展名合并 / 用户信息解析 / 目录派生 / 落库 └────────────────────────────────────────────────────────────┘
存储策略：
调用约定：仅由 Service 层调用，Controller 不直接使用； 入参校验失败抛出 InvalidArgumentException。
$tableUserTypeMap : array<string,int>
$defaults : array<string,mixed>
$fileTypeMap : array<string,string[]>
分类扩展名白名单（小写）。
与 MaintainFileRequest::ALLOWED_MIMES 保持同一允许集：Request 是 MIME 闸门（内容嗅探），此处是所选分类的扩展名闸门（双保险）；新增可上传 格式须两处同步。
分类键为稳定码（值即契约，label 走 fileTypeLabels 展示映射）；历史中文值 为过渡值，存量数据已迁移，判定处保留双值兼容兜底（SysFile::isImageType）。
upload(\Illuminate\Http\UploadedFile $file, string $fileType, array $options = []) : array
上传单个文件。
存储至 {disk}/{user_hash}/{hash}.{ext}，可选写入 td_sys_files 表。
| \Illuminate\Http\UploadedFile | $file | 客户端上传的文件实例 |
| string | $fileType | 文件分类，必填，如 '头像'、'附件' |
| array | $options | {@see \App\Http\Helpers\self::$defaults} 中任意键值对 |
文件无效 / fileType 为空 / 存储失败
downloadResponse(string $path, string|null $disk = 'local', string|null $outputName = null, bool $inline = false) : \Symfony\Component\HttpFoundation\StreamedResponse
流式下载响应（支持 HTTP Range，206 Partial Content）。
用于 local 盘等私有文件的代理下载；Controller 中 return 此响应即可。
| string | $path | 存储相对路径 |
| string|null | $disk | 磁盘，默认 local |
| string|null | $outputName | 浏览器下载文件名，null 取存储名 |
| bool | $inline | 内联展示（图片预览/缩略图）；默认附件下载 |
文件不存在