From a1e466030b7f90c8c5378bbfe43c14295a43642a 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:11:47 +0800
Subject: [PATCH] =?UTF-8?q?task-107(=E4=BB=BB=E5=8A=A1=E4=B8=8E=E9=87=8D?=
 =?UTF-8?q?=E5=A4=8D=E5=88=86=E6=9E=90=E4=B8=AD=E5=BF=83):=20=E5=AE=9E?=
 =?UTF-8?q?=E7=8E=B0=E8=A7=86=E9=A2=91=E4=BB=BB=E5=8A=A1=E4=B8=8B=E8=BD=BD?=
 =?UTF-8?q?=E5=A4=B1=E8=B4=A5=E6=91=98=E8=A6=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增 image-video-download-feedback.ts：zip 文件名 Content-Disposition 解析与
按成功/失败计数生成下载结果摘要(全失败/部分失败提示)。

TDD: task-107.test.ts 8 用例先 RED 后 GREEN。
---
 .../tasks/image-video-download-feedback.ts    | 34 +++++++++++++
 admin-frontend-vue/tests/task-107.test.ts     | 51 +++++++++++++++++++
 2 files changed, 85 insertions(+)
 create mode 100644 admin-frontend-vue/src/pages/tasks/image-video-download-feedback.ts
 create mode 100644 admin-frontend-vue/tests/task-107.test.ts

diff --git a/admin-frontend-vue/src/pages/tasks/image-video-download-feedback.ts b/admin-frontend-vue/src/pages/tasks/image-video-download-feedback.ts
new file mode 100644
index 00000000..02be0fac
--- /dev/null
+++ b/admin-frontend-vue/src/pages/tasks/image-video-download-feedback.ts
@@ -0,0 +1,34 @@
+/** 视频批量下载反馈（任务 107）：zip 文件名解析与下载失败摘要，纯逻辑。 */
+
+/** 从 Content-Disposition 解析下载文件名(rfc5987 优先)，失败回默认名。 */
+export function zipFilenameFromDisposition(disposition: string | undefined): string {
+  const text = typeof disposition === 'string' ? disposition : ''
+  const encoded = /filename\*=UTF-8''([^;]+)/i.exec(text)
+  if (encoded) {
+    try {
+      const decoded = decodeURIComponent(encoded[1])
+      if (decoded.trim()) return decoded.trim()
+    } catch {
+      // 回退到普通 filename
+    }
+  }
+  const plain = /filename="?([^";]+)"?/i.exec(text)
+  return plain && plain[1] ? plain[1].trim() : 'video-tasks.zip'
+}
+
+function finiteCount(value: number | undefined): number {
+  return typeof value === 'number' && Number.isFinite(value) && value > 0 ? Math.floor(value) : 0
+}
+
+/** 依据服务端成功/失败计数生成下载结果摘要文案。 */
+export function downloadResultSummary(counts: { fileCount?: number; errorCount?: number; selected?: number }): string {
+  const fileCount = finiteCount(counts.fileCount)
+  const errorCount = finiteCount(counts.errorCount)
+  const selected = finiteCount(counts.selected)
+  if (fileCount === 0 && errorCount === 0) return '未产生下载结果'
+  if (errorCount === 0) return `已下载 ${fileCount} 个视频`
+  const allFailed = fileCount === 0 || (selected > 0 && errorCount >= selected)
+  return allFailed
+    ? `全部 ${errorCount} 个视频下载失败，详见打包中的错误清单`
+    : `打包完成：成功 ${fileCount} 个，失败 ${errorCount} 个，详见打包中的错误清单`
+}
diff --git a/admin-frontend-vue/tests/task-107.test.ts b/admin-frontend-vue/tests/task-107.test.ts
new file mode 100644
index 00000000..2d6dc536
--- /dev/null
+++ b/admin-frontend-vue/tests/task-107.test.ts
@@ -0,0 +1,51 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import {
+  downloadResultSummary,
+  zipFilenameFromDisposition,
+} from '../src/pages/tasks/image-video-download-feedback.ts'
+
+test('test_task_107_download_feedback_normal_primary_path', () => {
+  // 正常主路径：无失败时给出成功数量文案。
+  assert.equal(downloadResultSummary({ fileCount: 18, errorCount: 0 }), '已下载 18 个视频')
+})
+
+test('test_task_107_download_feedback_normal_variant_input', () => {
+  // 正常变体：部分失败给出成功/失败摘要。
+  assert.match(downloadResultSummary({ fileCount: 16, errorCount: 2 }), /成功 16/)
+  assert.match(downloadResultSummary({ fileCount: 16, errorCount: 2 }), /失败 2/)
+})
+
+test('test_task_107_download_feedback_repeated_is_idempotent', () => {
+  // 正常重复：同一输入摘要稳定。
+  assert.equal(downloadResultSummary({ fileCount: 0, errorCount: 3, selected: 3 }), downloadResultSummary({ fileCount: 0, errorCount: 3, selected: 3 }))
+})
+
+test('test_task_107_download_feedback_boundary_empty_input', () => {
+  // 边界空值：无任何计数回空态文案。
+  assert.equal(downloadResultSummary({}), '未产生下载结果')
+})
+
+test('test_task_107_download_feedback_boundary_single_item', () => {
+  // 边界单元素：全部失败给出明确失败提示。
+  assert.match(downloadResultSummary({ fileCount: 0, errorCount: 3, selected: 3 }), /全部 3 个.*失败/)
+})
+
+test('test_task_107_download_feedback_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：file_count 缺失但错误大于 0 按全失败提示。
+  assert.match(downloadResultSummary({ errorCount: 1, selected: 1 }), /全部 1 个.*失败/)
+})
+
+test('test_task_107_download_feedback_invalid_input_rejected', () => {
+  // 异常输入：Content-Disposition 解析失败回默认 zip 名。
+  assert.equal(zipFilenameFromDisposition(''), 'video-tasks.zip')
+  assert.equal(zipFilenameFromDisposition('attachment'), 'video-tasks.zip')
+})
+
+test('test_task_107_download_feedback_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败/可操作：下载反馈纯逻辑、无框架/http。
+  const mod = readSource('src/pages/tasks/image-video-download-feedback.ts')
+  assert.equal(/axios|http\.|vue/.test(mod), false, '下载反馈保持纯逻辑')
+  assert.match(mod, /zipFilenameFromDisposition/)
+})