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

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

server/cli/backup-export.mjs

@@ -11,9 +11,12 @@ import { readFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { loadServerModule } from './backup-cli-loader.mjs'
 
-const { ensureBackupSchema } = loadServerModule('utils/backup/schema.ts')
-const { createBackupJob, getBackupJob } = loadServerModule('utils/backup/jobs.ts')
-const { runFullExportJob } = loadServerModule('utils/backup/full-export.ts')
+const {
+  ensureBackupSchema,
+  createBackupJob,
+  getBackupJob,
+  runFullExportJob
+} = loadServerModule('cli/backup-runtime.ts')
 
 function readAppVersion() {
   try {

server/cli/backup-restore.mjs

@@ -11,10 +11,13 @@ import { access } from 'node:fs/promises'
 import { resolve } from 'node:path'
 import { loadServerModule } from './backup-cli-loader.mjs'
 
-const { ensureBackupSchema } = loadServerModule('utils/backup/schema.ts')
-const { createBackupJob, getBackupJob } = loadServerModule('utils/backup/jobs.ts')
-const { previewFullRestore } = loadServerModule('utils/backup/full-restore.ts')
-const { runFullRestoreJob } = loadServerModule('utils/backup/full-restore.ts')
+const {
+  ensureBackupSchema,
+  createBackupJob,
+  getBackupJob,
+  previewFullRestore,
+  runFullRestoreJob
+} = loadServerModule('cli/backup-runtime.ts')
 
 function usage() {
   console.error('Usage: backup-restore <archive-path> [--overwrite]')
@@ -41,7 +44,7 @@ async function main() {
 
   ensureBackupSchema()
   const preview = await previewFullRestore(archivePath)
-  console.log(`[PicHost] Preview: ${preview.imageCount} images, ${preview.newImages} new, ${preview.conflictingImages} conflicts`)
+  console.log(`[PicHost] Preview: ${preview.imageCount} media items, ${preview.newImages} new files, ${preview.conflictingImages} conflicting files`)
 
   const job = createBackupJob({
     type: 'full_restore',

server/cli/backup-runtime.ts

@@ -0,0 +1,5 @@
+export { ensureBackupSchema } from '../utils/backup/schema'
+export { createBackupJob, getBackupJob } from '../utils/backup/jobs'
+export { runFullExportJob } from '../utils/backup/full-export'
+export { previewFullRestore, runFullRestoreJob } from '../utils/backup/full-restore'
+export { previewBackendSync, runBackendSyncJob } from '../utils/backup/backend-sync'

server/cli/storage-sync.mjs

@@ -1,5 +1,5 @@
 /**
- * Sync images between storage backends.
+ * Sync media files between storage backends.
  *
  * Usage:
  *   node server/cli/storage-sync.mjs --from <id> --to <id> [--delete-source] [--set-default] [--dry-run]
@@ -9,9 +9,13 @@
  */
 import { loadServerModule } from './backup-cli-loader.mjs'
 
-const { ensureBackupSchema } = loadServerModule('utils/backup/schema.ts')
-const { createBackupJob, getBackupJob } = loadServerModule('utils/backup/jobs.ts')
-const { previewBackendSync, runBackendSyncJob } = loadServerModule('utils/backup/backend-sync.ts')
+const {
+  ensureBackupSchema,
+  createBackupJob,
+  getBackupJob,
+  previewBackendSync,
+  runBackendSyncJob
+} = loadServerModule('cli/backup-runtime.ts')
 
 function usage() {
   console.error('Usage: storage-sync --from <backend-id> --to <backend-id> [--delete-source] [--set-default] [--dry-run]')
@@ -45,7 +49,7 @@ async function main() {
 
   if (dryRun) {
     const preview = previewBackendSync(options)
-    console.log(`[PicHost] Dry run: ${preview.imageCount} images, ${preview.imageBytes} bytes`)
+    console.log(`[PicHost] Dry run: ${preview.imageCount} media items, ${preview.imageBytes} bytes`)
     console.log(`[PicHost] From ${preview.fromBackendId} → ${preview.toBackendId}`)
     return
   }