task-101: 上传/解析/入队三道前端拦截，阻止坏数据卡死 Python 自动化

新增 shared/dispatch-guard.ts（纯 TS 校验，可单测）与 dispatch-guard-ui.ts
（ElMessageBox 弹窗层），在数据流的三个位置设闸：

- 选文件：空选择、非 xlsx/xls/csv、空路径直接拦；重复文件弹确认
- 解析结果：taskId 非法、totalRows 为 0、整批行被丢弃、需要分组却无分组直接拦；
  部分行被丢弃弹确认后才允许推送
- 入队前：结构不符、必填字段缺失、items/groups/country_codes 为空数组、
  行数页数为 0、JSON 不安全值（NaN/Infinity/BigInt/循环引用/数组洞）

覆盖 11 个推 Python 队列的 Tab 与 dedupe/split/convert 三个纯 Java Tab。
闸位按 Tab 挑选以免留下孤儿后端状态：collect-data 校验前置到
activateCollectDataTask 之前（任务保持 PENDING 无需回滚）、product-risk 的国家
检查提到建任务之前；已建任务后才拦下的复用各 Tab 原有失败补偿路径。

两处边界：对象属性 undefined 放行（taskNo 这类可选字段是惯用写法），只拦数组
元素 undefined 与数组洞；price-track 的 asin_rows_by_country 仅在 mode=asin
时要求非空，status 模式下 loadAsinRowsForAppClient 本就返回 {}。

顺带修复 similar-asin / appearance-patent 的 selectFiles 缺少 try/catch，
上传失败会残留上一批文件与解析结果。

测试：tests/dispatch-guard.test.ts 新增 37 个 test_task_101_* 用例。

frontend-vue/src/pages/brand/components/BrandAppearancePatentTab.vue

@@ -164,6 +164,13 @@ import { getTaskPollIntervalMs } from '@/shared/task-progress-config'
 import { getStoredApiSecret } from '@/shared/utils/api-secret-store'
 import { createCategorizedTimers } from '@/shared/utils/categorized-timers'
 import { saveUrlWithProgress } from '@/shared/utils/download-progress'
+import {
+  EXCEL_EXTENSIONS,
+  checkParseResult,
+  checkQueuePayload,
+  checkSelectedFiles,
+} from '@/shared/dispatch-guard'
+import { passGuard } from '@/shared/dispatch-guard-ui'
 
 const selectedFileNames = ref<string[]>([])
 const uploadedFiles = ref<UploadFileVo[]>([])
@@ -363,12 +370,23 @@ async function selectFiles() {
   }
   const paths = await api.select_brand_xlsx_files()
   if (!paths?.length) return
-  const files = await uploadAppearancePathsToJava(paths)
-  uploadedFiles.value = files
-  selectedFileNames.value = files.map((f) => f.relativePath || f.originalFilename || f.fileKey)
-  parseResult.value = null
-  queuedTaskSummary.value = null
-  queuePayloadText.value = ''
+  if (!(await passGuard(checkSelectedFiles(paths, { allowedExtensions: EXCEL_EXTENSIONS })))) return
+  try {
+    const files = await uploadAppearancePathsToJava(paths)
+    uploadedFiles.value = files
+    selectedFileNames.value = files.map((f) => f.relativePath || f.originalFilename || f.fileKey)
+    parseResult.value = null
+    queuedTaskSummary.value = null
+    queuePayloadText.value = ''
+  } catch (error) {
+    // 上传失败时清空选择，避免残留上一批文件让用户误以为新文件已就绪
+    uploadedFiles.value = []
+    selectedFileNames.value = []
+    parseResult.value = null
+    queuedTaskSummary.value = null
+    queuePayloadText.value = ''
+    ElMessage.error(error instanceof Error ? error.message : '文件上传失败')
+  }
 }
 
 async function selectFolder() {
@@ -385,6 +403,7 @@ async function selectFolder() {
       ElMessage.warning(result.error || '该文件夹下没有可用的 xlsx 文件')
       return
     }
+    if (!(await passGuard(checkSelectedFiles(result.items, { allowedExtensions: EXCEL_EXTENSIONS })))) return
     const files = await uploadAppearancePathsToJava(result.items)
     uploadedFiles.value = files
     selectedFileNames.value = result.items.map((item) => item.relativePath || item.absolutePath)
@@ -393,6 +412,9 @@ async function selectFolder() {
     queuePayloadText.value = ''
     ElMessage.success(`已选择文件夹内 ${result.items.length} 个 Excel 文件`)
   } catch (error) {
+    uploadedFiles.value = []
+    selectedFileNames.value = []
+    parseResult.value = null
     ElMessage.error(error instanceof Error ? error.message : '选择失败')
   }
 }
@@ -414,6 +436,17 @@ async function parseFiles() {
       relativePath: f.relativePath,
     }))
     const res = await parseAppearancePatent(files, effectiveAiPrompt(), effectiveLlmApiKey(), effectivePatentToken())
+    // 本模块按主 ID 分组执行，没有分组就没有可跑的批次，一并拦下
+    const guard = checkParseResult(res, {
+      requireGroups: true,
+      requiredColumnsHint: 'id / ASIN / 国家',
+    })
+    if (!(await passGuard(guard))) {
+      parseResult.value = null
+      queuedTaskSummary.value = null
+      queuePayloadText.value = ''
+      return
+    }
     parseResult.value = res
     queuedTaskSummary.value = null
     queuePayloadText.value = ''
@@ -479,6 +512,13 @@ async function pushToPythonQueue() {
       },
     }
     queuePayloadText.value = `任务 ${taskId} 已准备推送，共 ${groups.length} 组`
+    // 后端返回的 groups 为空时推送出去，Python 端没有可执行批次会一直停在执行中
+    const guard = checkQueuePayload(payload, {
+      expectedType: 'appearance-patent-run',
+      requiredDataKeys: ['taskId', 'api_key'],
+      nonEmptyArrayKeys: ['groups'],
+    })
+    if (!(await passGuard(guard))) return
     await activateAppearancePatentTask(taskId)
     const result = await api.enqueue_json(payload)
     if (!result?.success) {