release: v1.3.0 — 整站备份恢复、跨后端同步与任务中心

server/api/admin/backup/jobs/[id].get.ts

@@ -0,0 +1,19 @@
+import { requireAdminAuth } from '../../../../utils/access'
+import { createApiError } from '../../../../utils/api-error'
+import { serializeBackupJob } from '../../../../utils/backup/api'
+import { getBackupJob } from '../../../../utils/backup/jobs'
+
+export default defineEventHandler(async (event) => {
+  await requireAdminAuth(event)
+  const id = getRouterParam(event, 'id')
+  if (!id) {
+    createApiError(event, 'INVALID_REQUEST', '缺少任务 ID', 400)
+  }
+
+  const job = getBackupJob(id)
+  if (!job) {
+    createApiError(event, 'INVALID_REQUEST', '任务不存在', 404)
+  }
+
+  return { job: serializeBackupJob(job) }
+})

server/api/admin/backup/jobs/[id]/cancel.post.ts

@@ -0,0 +1,20 @@
+import { requireAdminAuth } from '../../../../../utils/access'
+import { createApiError } from '../../../../../utils/api-error'
+import { serializeBackupJob } from '../../../../../utils/backup/api'
+import { getBackupJob } from '../../../../../utils/backup/jobs'
+import { cancelBackupJob } from '../../../../../utils/backup/runner'
+
+export default defineEventHandler(async (event) => {
+  await requireAdminAuth(event)
+  const id = getRouterParam(event, 'id')
+  if (!id) {
+    createApiError(event, 'INVALID_REQUEST', '缺少任务 ID', 400)
+  }
+
+  if (!cancelBackupJob(id)) {
+    createApiError(event, 'INVALID_REQUEST', '只能取消进行中的任务', 400)
+  }
+
+  const job = getBackupJob(id)
+  return { job: job ? serializeBackupJob(job) : null }
+})

server/api/admin/backup/jobs/[id]/download.get.ts

@@ -0,0 +1,29 @@
+import { createReadStream } from 'node:fs'
+import { basename } from 'node:path'
+import { requireAdminAuth } from '../../../../../utils/access'
+import { createApiError } from '../../../../../utils/api-error'
+import { getBackupJob } from '../../../../../utils/backup/jobs'
+import { BACKUP_ARCHIVE_EXT } from '../../../../../utils/backup/paths'
+
+export default defineEventHandler(async (event) => {
+  await requireAdminAuth(event)
+  const id = getRouterParam(event, 'id')
+  if (!id) {
+    createApiError(event, 'INVALID_REQUEST', '缺少任务 ID', 400)
+  }
+
+  const job = getBackupJob(id)
+  if (!job || job.type !== 'full_export' || job.status !== 'done' || !job.outputPath) {
+    createApiError(event, 'INVALID_REQUEST', '可下载的备份不存在', 404)
+  }
+
+  const filename = basename(job.outputPath)
+  if (!filename.endsWith(BACKUP_ARCHIVE_EXT)) {
+    createApiError(event, 'INVALID_REQUEST', '备份文件无效', 404)
+  }
+
+  setResponseHeader(event, 'Content-Type', 'application/gzip')
+  setResponseHeader(event, 'Content-Disposition', `attachment; filename="${filename}"`)
+
+  return sendStream(event, createReadStream(job.outputPath))
+})

server/api/admin/backup/jobs/[id]/retry.post.ts

@@ -0,0 +1,28 @@
+import { requireAdminAuth } from '../../../../../utils/access'
+import { createApiError } from '../../../../../utils/api-error'
+import { retryFailedBackendSync } from '../../../../../utils/backup/backend-sync'
+import { serializeBackupJob } from '../../../../../utils/backup/api'
+import { getBackupJob } from '../../../../../utils/backup/jobs'
+
+export default defineEventHandler(async (event) => {
+  await requireAdminAuth(event)
+  const id = getRouterParam(event, 'id')
+  if (!id) {
+    createApiError(event, 'INVALID_REQUEST', '缺少任务 ID', 400)
+  }
+
+  const job = getBackupJob(id)
+  if (!job || job.type !== 'backend_sync') {
+    createApiError(event, 'INVALID_REQUEST', '任务不存在', 404)
+  }
+
+  try {
+    await retryFailedBackendSync(id)
+  } catch (error) {
+    const message = error instanceof Error ? error.message : '重试失败'
+    createApiError(event, 'INVALID_REQUEST', message, 400)
+  }
+
+  const updated = getBackupJob(id)
+  return { job: updated ? serializeBackupJob(updated) : null }
+})

server/api/admin/backup/jobs/index.get.ts

@@ -0,0 +1,36 @@
+import { requireAdminAuth } from '../../../../utils/access'
+import { serializeBackupJob } from '../../../../utils/backup/api'
+import {
+  getActiveBackupJob,
+  getRunningBackupJob,
+  listBackupJobsPage,
+  recoverInterruptedBackupJobs
+} from '../../../../utils/backup/jobs'
+import { isBackupRunnerBusy } from '../../../../utils/backup/runner'
+
+export default defineEventHandler(async (event) => {
+  await requireAdminAuth(event)
+  if (getRunningBackupJob() && !isBackupRunnerBusy()) {
+    recoverInterruptedBackupJobs()
+  }
+  const query = getQuery(event)
+  const pageSize = Math.min(50, Math.max(1, Number(query.pageSize) || 10))
+  const pageNum = Math.max(1, Number(query.pageNum) || Number(query.page) || 1)
+  const { jobs, total } = listBackupJobsPage(pageNum, pageSize)
+  const totalPages = Math.max(1, Math.ceil(total / pageSize))
+  const page = total > 0 ? Math.min(pageNum, totalPages) : 1
+  const slice = page === pageNum
+    ? jobs
+    : listBackupJobsPage(page, pageSize).jobs
+
+  const activeJob = getActiveBackupJob()
+
+  return {
+    jobs: slice.map(serializeBackupJob),
+    total,
+    page,
+    pageSize,
+    totalPages,
+    activeJob: activeJob ? serializeBackupJob(activeJob) : null
+  }
+})