diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClient.java b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClient.java index f667bee06..d4177a977 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClient.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClient.java @@ -84,6 +84,17 @@ public class AppearancePatentLlmClient { /** 连接层判定不可达时交付给行级的原因文案:说清是运维故障,不是这行数据的问题。 */ static final String REASON_LLM_UNREACHABLE = "LLM 服务不可达(连接未建立,非本行数据问题)"; private static final String APPEARANCE_ANOMALY = "外观识别异常"; + /** + * 我们根本没发出图片请求时的外观维标签(无图片/无标题,或商标维先失败跳过外观那一步)。 + * 与 {@link #APPEARANCE_ANOMALY}(发了请求、上游没给出可用结论)必须分开: + * 2026-11-12 任务 34061 的交付件里 987 行外观维写着「外观识别异常」、而「外观原因」整格空白, + * 用户只能把它读成图片识别没认出来,真实原因(LLM 上游欠费、外观那一步压根没跑)得运维去翻日志。 + */ + static final String APPEARANCE_NOT_RUN = "未执行外观检测"; + static final String APPEARANCE_SKIPPED_NO_DATA = "未执行外观检测:本行没有标题或图片链接,未发出图片识别请求"; + static final String PATENT_SKIPPED_REASON = "未执行专利检测:外观维未执行"; + /** 商标维先失败时跳过外观那一步的原因前缀,后面接商标维自己的原话。 */ + static final String APPEARANCE_SKIPPED_BY_TITLE = "未执行外观检测:商标维先失败,本行没有发出图片识别请求"; private static final String MISSING_ROW_DATA = "爬虫数据缺失"; /** 商标关键词提取系统提示词(与原 LLM 工作流一致) */ @@ -198,7 +209,8 @@ public class AppearancePatentLlmClient { String rawTitle = normalize(row.getTitle()); if (rawTitle.isBlank() || normalize(row.getUrl()).isBlank()) { llmRows.add(row); - llmResults.add(fallbackResult(row, rawTitle, firstNonBlank(rawTitle, MISSING_ROW_DATA), "")); + llmResults.add(skippedAppearanceResult(row, rawTitle, + firstNonBlank(rawTitle, MISSING_ROW_DATA), APPEARANCE_SKIPPED_NO_DATA)); } else { pending.add(results.size() - 1); } @@ -220,9 +232,10 @@ public class AppearancePatentLlmClient { } // 标题识别失败时本行必走回退分支(外观结果会被丢弃),再发外观请求只会在劣化中的上游白等一轮重试 log.warn("[appearance-patent] 标题识别失败,跳过外观识别(本行同样走回退)asin={}", rows.get(index).getAsin()); + String titleError = firstNonBlank(titleErrors.get(index), "商标识别失败"); llmRows.add(results.get(index)); - llmResults.add(fallbackResult(results.get(index), normalize(rows.get(index).getTitle()), - firstNonBlank(titleErrors.get(index), "商标识别失败"), "")); + llmResults.add(skippedAppearanceResult(results.get(index), normalize(rows.get(index).getTitle()), + titleError, skippedAppearanceReason(titleError))); } Map judgements = new LinkedHashMap<>(); Map appearanceErrors = new LinkedHashMap<>(); @@ -468,6 +481,36 @@ public class AppearancePatentLlmClient { ""); } + /** + * 外观那一步没跑的行(无图/无标题,或商标维先失败跳过):标签与原因都要说清"没跑"。 + * 三条列(外观/专利/标题原因)都不许空着交付,否则用户拿到的是"外观识别异常"四个字加一片空白。 + */ + private LlmResult skippedAppearanceResult(AppearancePatentResultRowDto row, + String title, + String titleReason, + String appearanceReason) { + return new LlmResult( + row.getGroupKey(), + row.getId(), + row.getAsin(), + row.getCountry(), + title, + APPEARANCE_NOT_RUN, + "", + "", + "", + titleReason, + appearanceReason, + PATENT_SKIPPED_REASON, + ""); + } + + /** 跳过外观那一步的原因文案:把「没跑」与「跑了没答上」分开,后者另有 appearanceErrors 的原话。 */ + private String skippedAppearanceReason(String titleError) { + String detail = abbreviate(firstNonBlank(titleError, "商标识别失败"), 160); + return APPEARANCE_SKIPPED_BY_TITLE + "(" + detail + ")"; + } + /** 一批行合并为一次文本请求;返回的行下标 → 关键词,仅包含通过字面校验的行。 */ private Map invokeTitleBatch(List rows, List chunk, diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentSheetBuilder.java b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentSheetBuilder.java index 82b86abfe..48af18fec 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentSheetBuilder.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentSheetBuilder.java @@ -162,7 +162,6 @@ public final class AppearancePatentSheetBuilder { row.createCell(1).setCellValue(resultRow == null ? missingReason : firstNonBlank(resultRow.getAppearanceReason(), missingReason)); row.createCell(2).setCellValue(resultRow == null ? missingReason : firstNonBlank(resultRow.getPatentReason(), missingReason)); row.createCell(3).setCellValue(resultRow == null ? missingReason : firstNonBlank(resultRow.getTitleReason(), missingReason)); - rowIndex++; } } diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentBrandBatchTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentBrandBatchTest.java index e84d017fa..392994362 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentBrandBatchTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentBrandBatchTest.java @@ -164,7 +164,7 @@ class AppearancePatentBrandBatchTest { .containsExactly("阿凡达 玩具 手办 正版", "小米 充电宝 20000mAh 快充"); assertThat(rows).hasSize(2); for (AppearancePatentResultRowDto row : rows) { - assertThat(row.getAppearanceRisk()).isEqualTo("外观识别异常"); + assertThat(row.getAppearanceRisk()).isEqualTo("未执行外观检测"); } assertThat(rows.get(0).getTitleRisk()).isEqualTo("侵权"); assertThat(rows.get(1).getTitleRisk()).as("回退行的归因同样停在行").isEqualTo("无侵权"); @@ -173,6 +173,51 @@ class AppearancePatentBrandBatchTest { } } + /** + * 商标维先失败的行,外观那一步**根本没发出请求**,原因列必须这么写。 + * + *

2026-11-12 任务 34061 的交付件就是反面样本:1000 行里 987 行外观维写着「外观识别异常」, + * 而「外观原因」整列只有 21 行有字——真实的 403 欠费原因在标题原因里,用户只能把那一格读成 + * 「图片识别没认出来」。标签「外观识别异常」保持不变(它本来就是"没有外观结论"的口径), + * 但原因必须把「没跑」写出来,并带上商标维的原话。 + */ + @Test + void skippedAppearanceRowsSayTheImageStepNeverRan() throws Exception { + when(brandCheckClient.checkTitleTexts(anyList(), eq("Terms"), any())).thenAnswer(invocation -> { + List titles = invocation.getArgument(0); + List results = new ArrayList<>(); + for (String title : titles) { + results.add(new BrandCheckClient.BrandCheckBatchResult(List.of(title), List.of(), List.of(), "")); + } + return results; + }); + HttpServer llmDown = startUnusableLlm(); + try { + AppearancePatentProperties properties = new AppearancePatentProperties(); + properties.setLlmHost("http://127.0.0.1:" + llmDown.getAddress().getPort()); + properties.setLlmRetryTimes(1); + properties.setLlmReadTimeoutMillis(5_000); + AppearancePatentLlmClient inspectClient = new AppearancePatentLlmClient( + properties, new ObjectMapper(), null, brandCheckClient, + mock(UserSecretUsageService.class), new UnreachableCooldown()); + + List rows = inspectClient.inspectRows( + List.of(source("1", "阿凡达 玩具 手办 正版")), null, "test-key"); + + assertThat(rows).hasSize(1); + AppearancePatentResultRowDto row = rows.get(0); + assertThat(row.getAppearanceRisk()).isEqualTo("未执行外观检测"); + assertThat(row.getAppearanceReason()) + .as("外观原因要说清「没跑」,不能空着让用户以为是图片识别失败") + .startsWith("未执行外观检测:商标维先失败") + .contains("502"); + assertThat(row.getPatentReason()).isEqualTo("未执行专利检测:外观维未执行"); + assertThat(row.getTitleReason()).as("商标维自己的原话照旧留在标题原因里").contains("502"); + } finally { + llmDown.stop(0); + } + } + /** LLM 一律回 502:让每一行都落到回退分支,只观察品牌校验的调用形状。 */ private HttpServer startUnusableLlm() throws IOException { HttpServer server = HttpServer.create(new InetSocketAddress("127.0.0.1", 0), 0); diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClientHttpTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClientHttpTest.java index 8f7ba8dff..5989761cb 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClientHttpTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClientHttpTest.java @@ -415,13 +415,15 @@ class AppearancePatentLlmClientHttpTest { } @Test - void missingUrlFallsBackToAppearanceAnomalyWithoutLlmCall() { + void missingUrlFallsBackToAppearanceNotRunWithoutLlmCall() { AppearancePatentResultRowDto row = row("4", "B004", "测试商品", "", ""); List rows = client.inspectRows(List.of(row), null, "test-key"); AppearancePatentResultRowDto result = rows.get(0); - assertThat(result.getAppearanceRisk()).isEqualTo("外观识别异常"); + assertThat(result.getAppearanceRisk()).isEqualTo("未执行外观检测"); + assertThat(result.getAppearanceReason()) + .isEqualTo("未执行外观检测:本行没有标题或图片链接,未发出图片识别请求"); assertThat(callCounts.get("deepseek-v4-flash")).isNull(); assertThat(callCounts.get("gemini-3.1-flash-lite-preview-thinking-medium")).isNull(); } @@ -465,7 +467,8 @@ class AppearancePatentLlmClientHttpTest { List rows = singleAttemptClient.inspectRows( List.of(row("7", "B007", "任意标题", "", "https://img.example.com/7.jpg")), null, "test-key"); - assertThat(rows.get(0).getAppearanceRisk()).isEqualTo("外观识别异常"); + assertThat(rows.get(0).getAppearanceRisk()).isEqualTo("未执行外观检测"); + assertThat(rows.get(0).getAppearanceReason()).startsWith("未执行外观检测:商标维先失败"); assertThat(capturedBodies).noneMatch(b -> b.contains("\"type\":\"image_url\"")); assertThat(textRequestCount.get()).isEqualTo(1); } @@ -578,7 +581,7 @@ class AppearancePatentLlmClientHttpTest { assertThat(textRequestCount.get()).isEqualTo(1); assertThat(result).hasSize(5); for (AppearancePatentResultRowDto item : result) { - assertThat(item.getAppearanceRisk()).isEqualTo("外观识别异常"); + assertThat(item.getAppearanceRisk()).isEqualTo("未执行外观检测"); } assertThat(capturedBodies).noneMatch(b -> b.contains("\"type\":\"image_url\"")); } diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentSheetBuilderTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentSheetBuilderTest.java index 3e6c42579..9f84d4571 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentSheetBuilderTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/service/support/AppearancePatentSheetBuilderTest.java @@ -10,11 +10,13 @@ import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.junit.jupiter.api.Test; import java.io.ByteArrayOutputStream; +import java.util.ArrayList; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; import static org.junit.jupiter.api.Assertions.assertNull; import static org.junit.jupiter.api.Assertions.assertTrue; @@ -242,6 +244,32 @@ class AppearancePatentSheetBuilderTest { } } + /** + * 原因 sheet 一行一个 ASIN,不许留空行:2026-11-12 任务 34061 的交付件里 1000 个 ASIN 占了 2000 行 + * (写一行自增两次),Excel 里看着就是隔行空白。 + */ + @Test + void test_sheet_builder_reason_sheet_has_no_blank_rows() throws Exception { + try (Workbook wb = new XSSFWorkbook()) { + List parsed = new ArrayList<>(); + Map byKey = new LinkedHashMap<>(); + for (String asin : List.of("B01A", "B01B", "B01C")) { + AppearancePatentParsedRowVo p = parsedRow("2_" + asin, asin, "US", "t", "", ""); + AppearancePatentResultRowDto r = resultRow("2_" + asin, asin, "US"); + parsed.add(p); + byKey.put(AppearancePatentSheetBuilder.rowKey(r), r); + } + AppearancePatentSheetBuilder.buildResultSheet(wb, parsed, byKey); + + Sheet reason = wb.getSheet("原因"); + for (int i = 1; i <= 3; i++) { + assertNotNull(reason.getRow(i), "第 " + i + " 行不许是空行"); + } + assertNull(reason.getRow(4), "三个 ASIN 只占三行"); + assertEquals(3, reason.getLastRowNum(), "行数=ASIN 数,不许夹空行"); + } + } + @Test void test_sheet_builder_writable_output_stream() throws Exception { try (Workbook wb = new XSSFWorkbook()) {