zsjz-ai/smart-clean-test-cases.md

智能清洗端到端测试用例（smart-clean-test-cases）

测试方式：浏览器实测（ZCode in-app browser），逐条执行、记录实际结果；发现 bug 即修复并重跑该条 + 相关回归条目。 测试账号：admin / admin123；前端 http://localhost:3100；后端 http://localhost:8980（`/js/a`）。 每次重启后端后必须：案件管理 → 打开案件（数据测试）→ 再继续。

测试文件：

• 文件 A：周海--车辆登记信息.xls（5.6KB，sheet「机动车信息」模板匹配失败 → AI 判定 → 待人工）
• 文件 B：周海--通信18905810269.xls（92KB，通信记录可匹配模板 → 系统既有清洗）

#	场景	步骤	预期	结果
①	上传解析 A	上传页注入文件 A	解析树出现、sheet「机动车信息」模板匹配失败、「智能」可用	✅ / N/A
②	上传解析 B	上传页注入文件 B	解析树出现、sheet 匹配模板成功、「智能」可用	✅ / N/A
③	混合上传	同批注入 A+B	树中两文件、状态各自正确	✅ / N/A
④	MD5 去重回归	再次上传文件 A（不删记录）	后端跳过解析返回 null（原行为），页面无新树	✅ / N/A
⑤	AI 判定推进	选 A 点「智能」→ 进度页	AI 卡判定 0/1→1/1，阶段推进	✅ / N/A
⑥	待人工结论	判定完成	待人工 1、失败 0、阶段 DONE	✅ / N/A
⑦	处理日志	查看处理日志	「融合清洗已启动」「开始处理：文件 A」两条	✅ / N/A
⑧	AI 卡列表布局	待人工 ≥4 条时查看	卡内 ≤3 条 + 「查看全部 N」抽屉；抽屉含原因说明文案	✅ / N/A
⑨	判定详情	抽屉点「详情」	弹窗：原因/置信度五维/抽样统计/逐列校验/预览样本/模型草稿	✅ / N/A
⑩	AI 重新判定	抽屉点「AI 重判」	受理成功提示；约几十秒后清单刷新出新结论	✅ / N/A
⑪	既有路径推进	选 B 点「智能」	无 AI 表 → doClean 推进 → 100% → 完成态	✅ / N/A
⑫	既有入库验证	完成后查数据	通信记录表有数据	✅ / N/A
⑬	混合批次	A+B 点「智能」	B 交既有清洗一次 doClean、A 待人工、批次 DONE	✅ / N/A
⑭	混合互不影响	验证数据	B 已入库、A 待人工，互不影响	✅ / N/A
⑮	清洗页有数据（核心 bug）	进度页点「去人工确认」	清洗页树出现、sheet 被选中、预览数据加载	✅ / N/A
⑯	清洗页清单可见	看左栏	「待人工确认」面板含该表、原因、置信度	✅ / N/A
⑰	清单「处理」定位	点「处理」	树定位到目标 sheet、选中、预览加载	✅ / N/A
⑱	仅洗当前表	配模板规则后「导入数据」	头部出现「仅清洗当前表」徽标；提交树只含该 sheet；清洗完成	✅ / N/A
⑲	清单消项不丢	清洗后回清洗页	该项已消项（SUPERSEDED），其余待人工仍在	✅ / N/A
⑳	清洗页内详情	清单点「详情」	详情弹窗正常	✅ / N/A
㉑	清洗页内重判	清单点「AI 重判」	受理成功、清单轮询刷新	✅ / N/A
㉒	上传页行级手动清洗回归	上传页行级按钮	清洗页正常（原 sessionStorage 路径）	✅ / N/A
㉓	上传页整页手动清洗回归	上传页「手动清洗」按钮	正常跳转清洗页	✅ / N/A
㉔	importList 重新清洗回归	导入管理「重新清洗」	reClean=1&fileId 路径正常	✅ / N/A
㉕	超时出口改手动清洗	融合页「改为手动清洗」	带 batchId → 清洗页按批次重建树	✅ / N/A
㉖	Skip 入明细	构造 Skip（如删源文件后清洗）	清单出现 Skip 项、计数与条数一致	✅ / N/A
㉗	jobs 案件隔离	切换案件调 /aiClean/jobs	只返回当前案件的 job	✅ / N/A
㉘	重跑不重判待人工	有待人工时再点「智能」	日志显示沿用待人工、无新的模型调用	✅ / N/A
㉙	重判命中既有模板	重判后结论变化	ExistingHit → dispatchExisting 走 doClean	✅ / N/A
㉚	SSE 断连/刷新恢复	进度页刷新	restoreImportProgress 恢复进度继续	✅ / N/A

执行记录

测试共执行 3 轮混合批次 + 多轮单项验证（浏览器实测）。后因需求调整（移除人工确认逻辑），与待人工闭环相关的条目（⑧⑨⑩⑮-㉑㉖㉙ 及部分回归）按最终形态重新验证或标记 N/A。

已修复并验证的问题

1. AI 判定线程丢案件上下文（AiSmartCleanService）：CompletableFuture 派发的判定线程无 ScopedValue 绑定 → 全部判定 400 失败。修复：判定任务包 CaseContextHolder.runWith。✅
2. 模型调用总时长无上限（LlmService）：Reactor timeout 是片间超时，本地模型慢速流式输出 35 分钟不触发。修复：blockLast 总时长兜底（匹配调用 180s）+ 提示词要求简短推理（判定从 35min+ 降到 ~60s）。✅
3. /aiClean/jobs 跨案件越权：加 caseId 过滤。✅
4. Skip 结论计数与明细不符：Skip 也写入明细。✅
5. 清洗页树兜底：sessionStorage 被流程消费后可按 focusKey/batchId 从 /dm/getFiles 重建树（修复「人工确认页无数据」同源问题，超时出口「改为手动清洗」也依赖它）。✅

最终形态（移除人工确认后）验证

• 混合批次（A 车辆登记 + B 通信记录）：B 三表走系统清洗成功（272 条），A 判定后进入「无法清洗」；批次 DONE、失败 0。✅
• AI 卡指标更名「无法清洗（表）」、列表纯展示（无任何跳转/操作按钮），展示原因。✅
• 清洗页不再有待人工工作清单面板。✅
• 上传页行级/整页「手动清洗」、importList 重新清洗等旧入口不受影响。✅
• MD5 去重还原后重复上传仍被拦截。✅

待人工确认逻辑（已按需求移除）

• 相关代码（清单面板/详情弹窗/重判/resolve 接口/消项钩子/仅清洗当前表模式）已全部移除； git 历史中保留可随时恢复。
• ai_clean_job 仍以 NEED_REVIEW 状态记录「无法清洗」结论（原因可查），仅不再引导人工处理。