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/BrandSimilarAsinTab.vue

@@ -213,6 +213,13 @@ import { createCategorizedTimers } from '@/shared/utils/categorized-timers'
 import { saveUrlWithProgress } from '@/shared/utils/download-progress'
 import { createAsinForceThrottle } from '@/shared/asin-force-throttle'
 import { toParsePreview, type ParsePreviewOptions } from '@/shared/parse-preview'
+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[]>([])
@@ -421,12 +428,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() {
@@ -443,6 +461,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)
@@ -451,6 +470,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 : '选择失败')
   }
 }
@@ -473,6 +495,14 @@ async function parseFiles() {
       relativePath: f.relativePath,
     }))
     const res = await parseSimilarAsin(files, effectiveLlmApiKey(), imgSwitch.value, categorySwitch.value)
+    // 0 有效行的任务推给 Python 只会一直停在 RUNNING，这里拦下来不写入 parseResult
+    const guard = checkParseResult(res, { requiredColumnsHint: 'id / ASIN / 国家' })
+    if (!(await passGuard(guard))) {
+      parseResult.value = null
+      queuedTaskSummary.value = null
+      queuePayloadText.value = ''
+      return
+    }
     // 只保留摘要字段与有界预览行，避免数千行 items/groups 进入响应式对象
     const previewOptions: ParsePreviewOptions = { previewRowLimit: 200 }
     parseResult.value = toParsePreview(res, previewOptions) as unknown as SimilarAsinParseVo
@@ -551,6 +581,12 @@ async function pushToPythonQueue() {
       },
     }
     queuePayloadText.value = JSON.stringify(payloadForDisplay(payload), null, 2)
+    // 入队前最后一道闸：缺字段或含 NaN 的 payload 到 Python 侧会变成 None，任务卡住
+    const guard = checkQueuePayload(payload, {
+      expectedType: 'similar-asin-run',
+      requiredDataKeys: ['taskId', 'api_key', 'aliprice_usename', 'aliprice_pwd'],
+    })
+    if (!(await passGuard(guard))) return
     await activateSimilarAsinTask(taskId)
     const result = await api.enqueue_json(payload)
     if (!result?.success) {