diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentBrandFailureText.java b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentBrandFailureText.java index 5271382ca..45b7025ce 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentBrandFailureText.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentBrandFailureText.java @@ -32,6 +32,9 @@ final class AppearancePatentBrandFailureText { static final String SERVICE_UNREACHABLE = "商标查询失败:品牌检测服务不可达(连接未建立,非本行数据问题)"; + /** 样例最多留几个字:够定位真因,又不把整段上游报错糊进交付列。 */ + static final int SAMPLE_KEEP = 80; + private AppearancePatentBrandFailureText() { } @@ -56,7 +59,28 @@ final class AppearancePatentBrandFailureText { } reasons.add(normalize(check.reason())); } - return anyChecked ? classify(reasons) : null; + return anyChecked ? describe(classify(reasons), reasons) : null; + } + + /** + * 分类文案 + 一句失败样例。 + * + *

BK B95-02 的判据是「解密失败那条要能回读到是哪一步失败」:分类只说到「解密链路」, + * 具体是 UTF-8 解不开、密钥不对还是压缩坏了,只有上游那句 reason 才知道。样例截断到 + * {@link #SAMPLE_KEEP} 字并对齐单行——它是给人看的一句话,不是堆栈搬运。 + */ + static String describe(String base, List reasons) { + String sample = ""; + if (reasons != null) { + for (String reason : reasons) { + String text = normalize(reason).replace('\n', ' ').replace('\r', ' '); + if (!text.isEmpty()) { + sample = text.length() > SAMPLE_KEEP ? text.substring(0, SAMPLE_KEEP) + "…" : text; + break; + } + } + } + return sample.isEmpty() ? base : base + ";样例=" + sample; } /** 批内 reason 全同形才分档;空 reason 或混形一律落回通用文案(不猜)。 */ diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClientTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClientTest.java index cfce94148..3d9b8a45f 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClientTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/modules/appearancepatent/client/AppearancePatentLlmClientTest.java @@ -155,13 +155,31 @@ class AppearancePatentLlmClientTest { assertThat(merged).hasSize(2); assertThat(merged).allSatisfy(r -> { - assertThat(r.getTitleRisk()).isEqualTo(AppearancePatentBrandFailureText.DECRYPT_BROKEN); + // 分类文案在前、上游那句真因作为样例在后(B95-02 判据:要能回读到是哪一步失败) + assertThat(r.getTitleRisk()).startsWith(AppearancePatentBrandFailureText.DECRYPT_BROKEN); + assertThat(r.getTitleRisk()).contains("Malformed UTF-8"); // 前缀不能变:状态列与 isBrandQueryFailed 都靠它判失败 assertThat(r.getTitleRisk()).startsWith("商标查询失败"); assertThat(r.getTitleRisk()).doesNotContain("上游整体不可用"); }); } + /** 样例只留一句、截断并压成单行;没给原因时退回纯分类文案(不凭空补样例)。 */ + @Test + void 样例只留一句且截断成单行() { + assertThat(AppearancePatentBrandFailureText.describe( + AppearancePatentBrandFailureText.DECRYPT_BROKEN, List.of(""))) + .isEqualTo(AppearancePatentBrandFailureText.DECRYPT_BROKEN); + assertThat(AppearancePatentBrandFailureText.describe( + AppearancePatentBrandFailureText.DECRYPT_BROKEN, List.of("第一行\n第二行"))) + .isEqualTo(AppearancePatentBrandFailureText.DECRYPT_BROKEN + ";样例=第一行 第二行"); + String longReason = "解".repeat(AppearancePatentBrandFailureText.SAMPLE_KEEP + 10); + assertThat(AppearancePatentBrandFailureText.describe( + AppearancePatentBrandFailureText.DECRYPT_BROKEN, List.of(longReason))) + .isEqualTo(AppearancePatentBrandFailureText.DECRYPT_BROKEN + ";样例=" + + "解".repeat(AppearancePatentBrandFailureText.SAMPLE_KEEP) + "…"); + } + /** 整批全失败且原因是「连接没建立」时,文案要指向服务不可达,而不是解密或通用文案。 */ @Test void 整批连接不上要写成服务不可达() {