docs(design): 删除磁盘监控设计文档并更新前端页面结构规范

- 删除 frontend/src/views/systemMonitor/2026-04-22-disk-monitor-design.md 设计文档
- 删除 frontend/src/views/tools/addLedger/API_DEBUG.md 调试文档
- 在 AGENTS.md 中新增前端页面结构归档章节，规范复杂工具页结构
- 明确 index.vue、components/、utils/ 职责边界和拆分原则
- 规定页面级类型和 contract 脚本管理方式
- 统一复杂页面拆分优先顺序和注意事项

frontend/src/views/tools/addData/utils/normalize.ts

@@ -0,0 +1,90 @@
+import type { AddData } from '@/api/tools/addData/interface'
+
+export const resolveNumber = (...values: unknown[]) => {
+    for (const value of values) {
+        if (value === null || value === undefined || value === '') continue
+        const parsed = Number(value)
+        if (Number.isFinite(parsed)) {
+            return parsed
+        }
+    }
+
+    return 0
+}
+
+export const resolveText = (...values: unknown[]) => {
+    for (const value of values) {
+        if (value === null || value === undefined) continue
+        const text = String(value).trim()
+        if (text) {
+            return text
+        }
+    }
+
+    return ''
+}
+
+const resolveDisplayRule = (value: unknown, fallback = '--') => {
+    if (typeof value === 'boolean') {
+        return value ? '显示' : '不显示'
+    }
+
+    if (typeof value === 'number') {
+        return value ? '显示' : '不显示'
+    }
+
+    const text = resolveText(value)
+    return text || fallback
+}
+
+export const normalizePreview = (data?: AddData.PreviewResponse | null): AddData.NormalizedPreview => {
+    const tableStats = (Array.isArray(data?.tableStats) ? data.tableStats : [])
+        .map(item => ({
+            tableName: resolveText(item.tableName) || '--',
+            timePointCount: resolveNumber(item.timePointCount),
+            phaseCount: resolveNumber(item.phaseCount),
+            rowCount: resolveNumber(item.rowCount)
+        }))
+        .sort((left, right) => right.rowCount - left.rowCount)
+
+    return {
+        lineCount: resolveNumber(data?.lineCount),
+        intervalMinutes: resolveNumber(data?.intervalMinutes),
+        totalRowCount: resolveNumber(data?.totalRowCount),
+        tableStats
+    }
+}
+
+export const normalizeTaskStatus = (data?: AddData.TaskStatusResponse | null): AddData.NormalizedTaskStatus => {
+    return {
+        taskId: resolveText(data?.taskId),
+        status: (resolveText(data?.status) || 'WAITING') as AddData.TaskStatus,
+        currentTableName: resolveText(data?.currentTableName),
+        currentBatchInfo: resolveText(data?.currentBatchInfo),
+        insertedCount: resolveNumber(data?.insertedCount),
+        skippedCount: resolveNumber(data?.skippedCount),
+        failedCount: resolveNumber(data?.failedCount),
+        failureReason: resolveText(data?.failureReason),
+        hourlyTimeResults: Array.isArray(data?.hourlyTimeResults) ? data.hourlyTimeResults.filter(Boolean) : [],
+        startTime: resolveText(data?.startTime),
+        endTime: resolveText(data?.endTime)
+    }
+}
+
+export const normalizeTemplateItem = (item: AddData.TemplateItem): AddData.NormalizedTemplateItem => {
+    const decimalScale = resolveText(item.decimalScale)
+
+    return {
+        parameterName: resolveText(item.parameterName) || '--',
+        tableName: resolveText(item.tableName) || '--',
+        phaseDisplay: resolveText(item.phaseDisplay) || '--',
+        phaseCodesText: Array.isArray(item.phaseCodes) && item.phaseCodes.length ? item.phaseCodes.join(' / ') : '--',
+        displayText: resolveDisplayRule(item.display),
+        showQualifiedText: resolveDisplayRule(item.showQualified),
+        maxValueRule: resolveText(item.maxValueRule) || '--',
+        minValueRule: resolveText(item.minValueRule) || '--',
+        averageValueRule: resolveText(item.averageValueRule) || '--',
+        cp95ValueRule: resolveText(item.cp95ValueRule) || '--',
+        decimalScaleText: decimalScale ? `${decimalScale} 位小数` : '--'
+    }
+}

frontend/src/views/tools/addData/utils/taskPayload.ts

@@ -0,0 +1,24 @@
+import type { AddData } from '@/api/tools/addData/interface'
+
+const normalizeLineIds = (lineIds: string[]) => {
+    return Array.from(
+        new Set(
+            (lineIds || [])
+                .map(item => item?.trim())
+                .filter((item): item is string => Boolean(item))
+        )
+    )
+}
+
+export const buildTaskPayload = (form: AddData.TaskFormModel): AddData.TaskRequestParams => {
+    return {
+        lineIds: normalizeLineIds(form.lineIds),
+        startTime: form.startTime,
+        endTime: form.endTime,
+        intervalMinutes: form.intervalMinutes
+    }
+}
+
+export const buildPayloadSignature = (payload: AddData.TaskRequestParams) => {
+    return JSON.stringify(payload)
+}