From c4262bd704f83e2e8e0447224bbdffa37a04afbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com>
Date: Sat, 5 Sep 2026 17:42:12 +0800
Subject: [PATCH] =?UTF-8?q?task-137(=E8=AE=B0=E5=BD=95=E4=B8=8E=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E4=B8=AD=E5=BF=83):=20=E5=AE=9E=E7=8E=B0=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E9=A1=B5=E9=9D=A2=E7=BB=9F=E4=B8=80=E6=97=B6=E9=97=B4?=
 =?UTF-8?q?=E5=92=8C=E6=96=87=E4=BB=B6=E6=A0=BC=E5=BC=8F=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增 version-format.ts：字节数与后端时间显示归一。

TDD: task-137.test.ts 8 用例 RED→GREEN。
---
 .../src/pages/records/version-format.ts       | 24 ++++++++++
 admin-frontend-vue/tests/task-137.test.ts     | 48 +++++++++++++++++++
 2 files changed, 72 insertions(+)
 create mode 100644 admin-frontend-vue/src/pages/records/version-format.ts
 create mode 100644 admin-frontend-vue/tests/task-137.test.ts

diff --git a/admin-frontend-vue/src/pages/records/version-format.ts b/admin-frontend-vue/src/pages/records/version-format.ts
new file mode 100644
index 00000000..a13ac4d9
--- /dev/null
+++ b/admin-frontend-vue/src/pages/records/version-format.ts
@@ -0,0 +1,24 @@
+/** 版本页时间与文件格式化（任务 137）：字节数/时间显示归一；纯逻辑。 */
+
+/** 字节数 → 可读文本(B/KB/MB/GB，保留 1 位)。 */
+export function formatFileSize(value: number): string {
+  const bytes = typeof value === 'number' && Number.isFinite(value) ? Math.max(value, 0) : 0
+  if (bytes < 1024) return `${bytes} B`
+  const units = ['KB', 'MB', 'GB']
+  let amount = bytes
+  let unit = 'B'
+  for (const next of units) {
+    amount /= 1024
+    unit = next
+    if (amount < 1024 || next === 'GB') break
+  }
+  return `${amount.toFixed(1)} ${unit}`
+}
+
+const DISPLAY_DATETIME = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}(:\d{2}(\.\d+)?)?$/
+
+/** 后端时间(ISO T 或空格分隔) → 显示文本(yyyy-MM-dd HH:mm:ss)；非法回空。 */
+export function formatDisplayDateTime(value: unknown): string {
+  const text = typeof value === 'string' ? value.trim().replace('T', ' ') : ''
+  return DISPLAY_DATETIME.test(text) ? text : ''
+}
diff --git a/admin-frontend-vue/tests/task-137.test.ts b/admin-frontend-vue/tests/task-137.test.ts
new file mode 100644
index 00000000..1211d79c
--- /dev/null
+++ b/admin-frontend-vue/tests/task-137.test.ts
@@ -0,0 +1,48 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import { formatDisplayDateTime, formatFileSize } from '../src/pages/records/version-format.ts'
+
+test('test_task_137_version_format_normal_primary_path', () => {
+  // 正常主路径：字节数可读化。
+  assert.equal(formatFileSize(1024), '1.0 KB')
+  assert.equal(formatFileSize(0), '0 B')
+})
+
+test('test_task_137_version_format_normal_variant_input', () => {
+  // 正常变体：大文件 MB/GB。
+  assert.equal(formatFileSize(5 * 1024 * 1024), '5.0 MB')
+  assert.equal(formatFileSize(2 * 1024 * 1024 * 1024), '2.0 GB')
+})
+
+test('test_task_137_version_format_repeated_is_idempotent', () => {
+  // 正常重复：格式化稳定。
+  assert.equal(formatFileSize(2048), formatFileSize(2048))
+})
+
+test('test_task_137_version_format_boundary_empty_input', () => {
+  // 边界空值：无时间显示为空。
+  assert.equal(formatDisplayDateTime(''), '')
+})
+
+test('test_task_137_version_format_boundary_single_item', () => {
+  // 边界单元素：ISO 时间转可读格式。
+  assert.equal(formatDisplayDateTime('2026-01-01T10:30:00'), '2026-01-01 10:30:00')
+})
+
+test('test_task_137_version_format_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：非法时间原样或空处理。
+  assert.equal(formatDisplayDateTime('not-a-date'), '')
+})
+
+test('test_task_137_version_format_invalid_input_rejected', () => {
+  // 异常输入：非数字字节按 0 处理。
+  assert.equal(formatFileSize(Number.NaN), '0 B')
+})
+
+test('test_task_137_version_format_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败/可操作：格式化纯逻辑、无框架/http。
+  const mod = readSource('src/pages/records/version-format.ts')
+  assert.equal(/axios|http\.|vue/.test(mod), false, '格式化保持纯逻辑')
+  assert.match(mod, /formatFileSize/)
+})