fix(admin): 后台时间统一展示为 YYYY-MM-DD HH:mm:ss（formatDateTime 全页接入）

admin-frontend-vue/src/pages/records/RecordsDigitalHumanVersionPage.vue

@@ -0,0 +1,175 @@
+<script setup lang="ts">
+import { formatDateTime } from '@/utils/datetime'
+/** 数字人版本管理页：列表 + 上传 + 发布 + 设最新 + 下载。 */
+import { onMounted, ref } from 'vue'
+import { ElMessage, ElMessageBox } from 'element-plus'
+import { fetchDigitalHumanVersions, uploadDigitalHumanVersion, releaseDigitalHumanVersion, setLatestDigitalHumanVersion } from './digitalhuman-api.ts'
+import type { DigitalHumanVersion } from './digitalhuman-dto.ts'
+import { validateDigitalHumanUpload } from './digitalhuman-upload-model.ts'
+
+const loading = ref(false)
+const items = ref<DigitalHumanVersion[]>([])
+
+const uploadVisible = ref(false)
+const uploading = ref(false)
+const form = ref({ version: '', file: null as { name?: string; size?: number } | null, changelog: '', minClientVersion: '' })
+
+const confirming = ref<string | null>(null)
+
+function formatSize(size?: number): string {
+  if (size === undefined || size === null) return ''
+  if (size < 1024) return `${size}B`
+  if (size < 1024 * 1024) return `${(size / 1024).toFixed(1)}KB`
+  return `${(size / 1024 / 1024).toFixed(1)}MB`
+}
+
+async function load() {
+  loading.value = true
+  try {
+    items.value = (await fetchDigitalHumanVersions()).items
+  } catch (error) {
+    ElMessage.error(error instanceof Error ? error.message : '版本列表加载失败')
+  } finally {
+    loading.value = false
+  }
+}
+
+function onFileChange(file: File) {
+  form.value.file = file
+}
+
+async function submitUpload() {
+  const { valid, errors } = validateDigitalHumanUpload({ ...form.value, file: form.value.file })
+  if (!valid) {
+    ElMessage.warning(errors.version || errors.file || '请完善上传信息')
+    return
+  }
+  uploading.value = true
+  try {
+    await uploadDigitalHumanVersion(
+      { version: form.value.version, file: form.value.file, changelog: form.value.changelog, minClientVersion: form.value.minClientVersion },
+      form.value.file?.name,
+    )
+    ElMessage.success('上传成功')
+    uploadVisible.value = false
+    form.value = { version: '', file: null, changelog: '', minClientVersion: '' }
+    load()
+  } catch (error) {
+    ElMessage.error(error instanceof Error ? error.message : '上传失败')
+  } finally {
+    uploading.value = false
+  }
+}
+
+async function release(row: DigitalHumanVersion) {
+  confirming.value = row.version
+  try {
+    await ElMessageBox.confirm(`确认发布版本 ${row.version}？`, '发布版本', { type: 'warning' })
+    await releaseDigitalHumanVersion(row.version)
+    ElMessage.success('已发布')
+    load()
+  } catch (error) {
+    if (error === 'cancel' || error === 'close') return
+    ElMessage.error(error instanceof Error ? error.message : '发布失败')
+  } finally {
+    confirming.value = null
+  }
+}
+
+async function setLatest(row: DigitalHumanVersion) {
+  confirming.value = row.version
+  try {
+    await ElMessageBox.confirm(`将 ${row.version} 设为最新版本？`, '设为最新', { type: 'warning' })
+    await setLatestDigitalHumanVersion(row.version)
+    ElMessage.success('已设为最新')
+    load()
+  } catch (error) {
+    if (error === 'cancel' || error === 'close') return
+    ElMessage.error(error instanceof Error ? error.message : '操作失败')
+  } finally {
+    confirming.value = null
+  }
+}
+
+onMounted(load)
+</script>
+
+<template>
+  <div class="page-stack">
+    <div class="page-heading">
+      <div>
+        <h2>数字人版本管理</h2>
+        <p>管理数字人客户端的草稿/已发布版本。</p>
+      </div>
+      <div class="actions">
+        <el-button type="primary" @click="uploadVisible = true">上传数字人版本</el-button>
+      </div>
+    </div>
+
+    <el-card shadow="never">
+      <el-table v-loading="loading" :data="items" stripe border>
+        <el-table-column prop="version" label="版本号" min-width="150" />
+        <el-table-column label="状态" width="110">
+          <template #default="{ row }">
+            <el-tag :type="(row as DigitalHumanVersion).status === 'RELEASED' ? 'success' : 'info'" size="small">
+              {{ (row as DigitalHumanVersion).status === 'RELEASED' ? '已发布' : '草稿' }}
+            </el-tag>
+            <el-tag v-if="(row as DigitalHumanVersion).isLatest" type="primary" size="small" effect="dark" style="margin-left: 4px">最新</el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column label="大小" width="110">
+          <template #default="{ row }">{{ formatSize((row as DigitalHumanVersion).fileSize) || '—' }}</template>
+        </el-table-column>
+        <el-table-column prop="minClientVersion" label="最低客户端" width="120">
+          <template #default="{ row }">{{ (row as DigitalHumanVersion).minClientVersion || '—' }}</template>
+        </el-table-column>
+        <el-table-column prop="changelog" label="更新说明" min-width="180" show-overflow-tooltip />
+        <el-table-column prop="createdAt" label="创建时间" min-width="170">
+          <template #default="{ row }">{{ formatDateTime(row.createdAt) }}</template>
+        </el-table-column>
+        <el-table-column prop="releasedAt" label="发布时间" min-width="170">
+          <template #default="{ row }">{{ formatDateTime((row as DigitalHumanVersion).releasedAt) }}</template>
+        </el-table-column>
+        <el-table-column label="操作" width="200" fixed="right">
+          <template #default="{ row }">
+            <el-button v-if="(row as DigitalHumanVersion).status === 'DRAFT'" text type="warning" size="small" :loading="confirming === (row as DigitalHumanVersion).version" @click="release(row as DigitalHumanVersion)">发布</el-button>
+            <el-button text type="primary" size="small" :loading="confirming === (row as DigitalHumanVersion).version" @click="setLatest(row as DigitalHumanVersion)">设最新</el-button>
+            <el-button v-if="(row as DigitalHumanVersion).downloadUrl" text type="success" size="small">
+              <el-link type="success" :href="(row as DigitalHumanVersion).downloadUrl" target="_blank">下载</el-link>
+            </el-button>
+          </template>
+        </el-table-column>
+      </el-table>
+    </el-card>
+
+    <el-dialog v-model="uploadVisible" title="上传数字人版本" width="560px">
+      <el-form label-width="110px">
+        <el-form-item label="版本号" required>
+          <el-input v-model="form.version" placeholder="如 1.0.2" />
+        </el-form-item>
+        <el-form-item label="压缩包" required>
+          <el-upload :auto-upload="false" :limit="1" accept=".zip,.rar,.7z" :on-change="(file: any) => onFileChange(file.raw)" :on-remove="() => (form.file = null)">
+            <el-button>选择文件</el-button>
+          </el-upload>
+          <div v-if="form.file" class="dim">{{ form.file.name }}</div>
+        </el-form-item>
+        <el-form-item label="最低客户端">
+          <el-input v-model="form.minClientVersion" placeholder="可选，客户端最低版本要求" />
+        </el-form-item>
+        <el-form-item label="更新说明">
+          <el-input v-model="form.changelog" type="textarea" :rows="3" placeholder="可选" />
+        </el-form-item>
+      </el-form>
+      <template #footer>
+        <el-button @click="uploadVisible = false">取消</el-button>
+        <el-button type="primary" :loading="uploading" @click="submitUpload">上传</el-button>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<style scoped>
+.page-heading { display: flex; justify-content: space-between; align-items: flex-start; }
+.actions { display: flex; align-items: center; gap: 10px; }
+.dim { color: var(--el-text-color-secondary); font-size: 12px; }
+</style>

admin-frontend-vue/src/pages/records/RecordsHistoryPage.vue

@@ -0,0 +1,157 @@
+<script setup lang="ts">
+import { formatDateTime } from '@/utils/datetime'
+/** 历史生成记录页：分页 + 时间/用户筛选 + 结果大图预览。 */
+import { onMounted, reactive, ref } from 'vue'
+import { ElMessage } from 'element-plus'
+import { fetchHistoryList } from './history-api.ts'
+import type { HistoryRecordItem } from './history-dto.ts'
+
+const loading = ref(false)
+const rows = ref<HistoryRecordItem[]>([])
+const total = ref(0)
+const page = ref(1)
+const pageSize = 15
+const filter = reactive({ userId: '', dateRange: [] as string[] })
+
+const previewVisible = ref(false)
+const previewItem = ref<HistoryRecordItem | null>(null)
+
+function imageUrls(item: HistoryRecordItem): string[] {
+  const urls: string[] = []
+  for (const url of item.resultUrls || []) urls.push(url)
+  if (item.longImageUrl) urls.push(item.longImageUrl)
+  return urls
+}
+
+async function load() {
+  loading.value = true
+  try {
+    const userId = filter.userId.trim()
+    const result = await fetchHistoryList({
+      page: page.value,
+      pageSize,
+      userId: userId ? Number(userId) : undefined,
+      timeStart: filter.dateRange?.[0] || '',
+      timeEnd: filter.dateRange?.[1] || '',
+    })
+    rows.value = result.items
+    total.value = result.total
+    page.value = result.page
+  } catch (error) {
+    ElMessage.error(error instanceof Error ? error.message : '历史记录加载失败')
+  } finally {
+    loading.value = false
+  }
+}
+
+function apply() {
+  page.value = 1
+  load()
+}
+
+function reset() {
+  filter.userId = ''
+  filter.dateRange = []
+  page.value = 1
+  load()
+}
+
+function openPreview(item: HistoryRecordItem) {
+  previewItem.value = item
+  previewVisible.value = true
+}
+
+onMounted(load)
+</script>
+
+<template>
+  <div class="page-stack">
+    <div class="page-heading">
+      <div>
+        <h2>生成记录</h2>
+        <p>查看各用户在后台生成的历史记录与结果图。</p>
+      </div>
+    </div>
+
+    <el-card shadow="never" style="margin-bottom: 14px">
+      <div class="filter-grid">
+        <div class="f-item">
+          <label>用户ID</label>
+          <el-input v-model="filter.userId" placeholder="按用户ID筛选" clearable @keyup.enter="apply" />
+        </div>
+        <div class="f-item wide">
+          <label>生成时间</label>
+          <el-date-picker v-model="filter.dateRange" type="daterange" range-separator="至" start-placeholder="开始" end-placeholder="结束" value-format="YYYY-MM-DD" unlink-panels />
+        </div>
+        <div class="f-item btn-row">
+          <el-button type="primary" @click="apply">查询</el-button>
+          <el-button @click="reset">重置</el-button>
+        </div>
+      </div>
+    </el-card>
+
+    <el-card shadow="never">
+      <el-table v-loading="loading" :data="rows" stripe border>
+        <el-table-column prop="id" label="ID" width="90" />
+        <el-table-column prop="username" label="用户" width="140" />
+        <el-table-column prop="panelType" label="记录类型" min-width="150" />
+        <el-table-column label="结果数" width="90" align="center">
+          <template #default="{ row }">{{ (row as HistoryRecordItem).resultUrls.length }}</template>
+        </el-table-column>
+        <el-table-column prop="createdAt" label="生成时间" min-width="180">
+          <template #default="{ row }">{{ formatDateTime(row.createdAt) }}</template>
+        </el-table-column>
+        <el-table-column label="缩略图" min-width="200">
+          <template #default="{ row }">
+            <el-image
+              v-for="(url, index) in ((row as HistoryRecordItem).resultUrls.slice(0, 4))"
+              :key="index"
+              :src="url"
+              :preview-src-list="(row as HistoryRecordItem).resultUrls"
+              preview-teleported
+              fit="cover"
+              style="width: 56px; height: 56px; margin-right: 6px; border-radius: 4px"
+            />
+            <span v-if="(row as HistoryRecordItem).resultUrls.length > 4" class="dim">+{{ (row as HistoryRecordItem).resultUrls.length - 4 }}</span>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" width="110" fixed="right">
+          <template #default="{ row }">
+            <el-button text type="primary" size="small" @click="openPreview(row as HistoryRecordItem)">查看大图</el-button>
+          </template>
+        </el-table-column>
+      </el-table>
+      <div class="table-footer">
+        <span>共 <b>{{ total.toLocaleString() }}</b> 条</span>
+        <el-pagination background layout="prev, pager, next, jumper" :total="total" :page-size="pageSize" :current-page="page" @current-change="(p: number) => { page = p; load() }" />
+      </div>
+    </el-card>
+
+    <el-dialog v-model="previewVisible" :title="previewItem ? `记录 #${previewItem.id} 结果图` : '结果图'" width="820px" top="6vh">
+      <div v-if="previewItem" class="preview-meta">
+        <el-tag size="small">{{ previewItem.username }}</el-tag>
+        <span>{{ previewItem.panelType }}</span>
+        <span>{{ formatDateTime(previewItem.createdAt) }}</span>
+      </div>
+      <div v-if="previewItem && imageUrls(previewItem).length" class="preview-grid">
+        <el-image v-for="(url, index) in imageUrls(previewItem)" :key="index" :src="url" :preview-src-list="imageUrls(previewItem)" :initial-index="index" preview-teleported fit="contain" style="max-width: 100%" class="preview-img" />
+      </div>
+      <el-empty v-else description="无结果图片" />
+    </el-dialog>
+  </div>
+</template>
+
+<style scoped>
+.filter-grid { display: flex; flex-wrap: wrap; gap: 12px 18px; }
+.f-item { display: flex; flex-direction: column; gap: 6px; width: 180px; }
+.f-item label { color: var(--el-text-color-secondary); font-size: 12px; }
+.f-item.wide { width: 320px; }
+.f-item.btn-row { flex-direction: row; align-items: flex-end; gap: 8px; width: auto; }
+.table-footer { display: flex; justify-content: space-between; align-items: center; padding-top: 14px; }
+.table-footer span { color: var(--el-text-color-secondary); font-size: 12.5px; }
+.table-footer b { color: var(--el-text-color-primary); }
+.dim { color: var(--el-text-color-secondary); font-size: 12px; }
+.preview-meta { display: flex; align-items: center; gap: 12px; color: var(--el-text-color-secondary); font-size: 12px; margin-bottom: 12px; }
+.preview-grid { display: flex; flex-direction: column; gap: 12px; }
+.preview-img { width: 100%; border: 1px solid var(--el-border-color-lighter); border-radius: 6px; }
+</style>

admin-frontend-vue/src/pages/records/RecordsSoftwareVersionPage.vue

@@ -0,0 +1,111 @@
+<script setup lang="ts">
+import { formatDateTime } from '@/utils/datetime'
+/** 软件版本管理页：客户端版本列表 + 上传新版本。 */
+import { onMounted, ref } from 'vue'
+import { ElMessage } from 'element-plus'
+import { fetchSoftwareVersions, uploadSoftwareVersion } from './version-api.ts'
+import type { SoftwareVersionItem } from './version-dto.ts'
+import { isNonEmptyVersion } from './version-dto.ts'
+
+const loading = ref(false)
+const items = ref<SoftwareVersionItem[]>([])
+
+const uploadVisible = ref(false)
+const uploading = ref(false)
+const newVersion = ref('')
+const pickedFile = ref<File | null>(null)
+
+async function load() {
+  loading.value = true
+  try {
+    items.value = (await fetchSoftwareVersions()).items
+  } catch (error) {
+    ElMessage.error(error instanceof Error ? error.message : '版本列表加载失败')
+  } finally {
+    loading.value = false
+  }
+}
+
+function onFileChange(file: File) {
+  pickedFile.value = file
+}
+
+async function submitUpload() {
+  if (!isNonEmptyVersion(newVersion.value)) {
+    ElMessage.warning('版本号不能为空')
+    return
+  }
+  if (!pickedFile.value) {
+    ElMessage.warning('请选择程序压缩包')
+    return
+  }
+  uploading.value = true
+  try {
+    await uploadSoftwareVersion(newVersion.value.trim(), pickedFile.value, pickedFile.value.name)
+    ElMessage.success('上传成功')
+    uploadVisible.value = false
+    newVersion.value = ''
+    pickedFile.value = null
+    load()
+  } catch (error) {
+    ElMessage.error(error instanceof Error ? error.message : '上传失败')
+  } finally {
+    uploading.value = false
+  }
+}
+
+onMounted(load)
+</script>
+
+<template>
+  <div class="page-stack">
+    <div class="page-heading">
+      <div>
+        <h2>软件版本管理</h2>
+        <p>管理客户端更新包版本（用于 /api/version/latest 下发）。</p>
+      </div>
+      <div class="actions">
+        <el-button type="primary" @click="uploadVisible = true">上传新版本</el-button>
+      </div>
+    </div>
+
+    <el-card shadow="never">
+      <el-table v-loading="loading" :data="items" stripe border>
+        <el-table-column prop="version" label="版本号" min-width="180" />
+        <el-table-column label="下载" min-width="260">
+          <template #default="{ row }">
+            <el-link v-if="(row as SoftwareVersionItem).fileUrl" type="primary" :href="(row as SoftwareVersionItem).fileUrl" target="_blank">{{ (row as SoftwareVersionItem).fileUrl }}</el-link>
+            <span v-else class="dim">—</span>
+          </template>
+        </el-table-column>
+        <el-table-column prop="createdAt" label="创建时间" min-width="190">
+          <template #default="{ row }">{{ formatDateTime(row.createdAt) }}</template>
+        </el-table-column>
+      </el-table>
+    </el-card>
+
+    <el-dialog v-model="uploadVisible" title="上传软件版本" width="520px">
+      <el-form label-width="110px">
+        <el-form-item label="版本号" required>
+          <el-input v-model="newVersion" placeholder="如 1.0.2" />
+        </el-form-item>
+        <el-form-item label="程序压缩包" required>
+          <el-upload :auto-upload="false" :limit="1" accept=".zip,.rar,.7z,.exe" :on-change="(file: any) => onFileChange(file.raw)" :on-remove="() => (pickedFile = null)">
+            <el-button>选择文件</el-button>
+          </el-upload>
+          <div v-if="pickedFile" class="dim">{{ pickedFile.name }}</div>
+        </el-form-item>
+      </el-form>
+      <template #footer>
+        <el-button @click="uploadVisible = false">取消</el-button>
+        <el-button type="primary" :loading="uploading" @click="submitUpload">上传</el-button>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<style scoped>
+.page-heading { display: flex; justify-content: space-between; align-items: flex-start; }
+.actions { display: flex; align-items: center; gap: 10px; }
+.dim { color: var(--el-text-color-secondary); font-size: 12px; }
+</style>