feat: 完善媒体管理与备份迁移流程

- 视频上传生成缩略图并提供占位封面和失败原因展示
- 支持 HLS 按需重新封装 MP4，并限制临时文件生命周期与访问权限
- 完善视频、文件 API 文档、搜索、批量删除和单次转码质量参数
- 修复备份恢复与跨后端迁移遗漏缩略图、HLS 清单和分片的问题
- 将备份任务、归档和下载权限按用户隔离
- 增加仅清理当前用户数据的高危存储清空流程和二次文字确认
- 修复 S3 中文文件名元数据及 CLI 数据库连接问题
- 补充备份恢复、用户隔离、媒体资源和转码相关测试

server/utils/storage/s3.ts

@@ -38,6 +38,15 @@ function contentTypeFromKey(key: string): string {
   }
 }
 
+function decodeMetadata(value: string | undefined): string | undefined {
+  if (!value) return value
+  try {
+    return decodeURIComponent(value)
+  } catch {
+    return value
+  }
+}
+
 export function buildObjectKey(prefix: string | undefined, key: string): string {
   const trimmed = prefix?.replace(/^\/+|\/+$/g, '') ?? ''
   return trimmed ? `${trimmed}/${key}` : key
@@ -125,7 +134,8 @@ export class S3StorageBackend implements StorageBackend {
       Body: bytes,
       ContentType: meta.contentType,
       Metadata: {
-        originalName: meta.originalName,
+        // S3 metadata headers must be ASCII-safe.
+        originalName: encodeURIComponent(meta.originalName),
         uploadedAt: meta.uploadedAt,
         userId: meta.userId != null ? String(meta.userId) : ''
       }
@@ -144,7 +154,7 @@ export class S3StorageBackend implements StorageBackend {
       const uploadedAt = response.Metadata?.uploadedat
         ?? response.LastModified?.toISOString()
         ?? new Date().toISOString()
-      const originalName = response.Metadata?.originalname
+      const originalName = decodeMetadata(response.Metadata?.originalname)
         ?? key.split('/').pop()
         ?? 'image'
       const userIdRaw = response.Metadata?.userid