fix(appearance-patent): 外观维把「没跑」写成「外观识别异常」且原因列空白(B96-09)

34061 交付件实测:1000 行里 987 行外观维=外观识别异常、外观原因/专利原因只有 21 行有字,而零行真的跑过外观。根因是 LLM 上游 01:01-01:06 全程 403 欠费(用户[155933] 剩 0.0305 < 单次 0.0324)→ 标题维先失败 → 跳过外观那一步,跳过分支把标签写死成外观识别异常、原因留空。

改:新增 APPEARANCE_NOT_RUN(未执行外观检测)+ 两条原因文案(无标题/无图、商标维先失败带原话),专利原因同步;APPEARANCE_ANOMALY 只留给发了请求没答上的行。顺带修原因 sheet 每行自增两次(1000 ASIN 占 2000 行)。

门禁:外观专利包 364 例全绿;后端整量 mvn -o test 5435 例/0 失败/0 错误/19 skip/BUILD SUCCESS(7:50)。
This commit is contained in:
2026-11-12 15:53:35 +08:00
parent ad33b7d54c
commit f5f40cd2ea
5 changed files with 127 additions and 9 deletions
@@ -84,6 +84,17 @@ public class AppearancePatentLlmClient {
/** 连接层判定不可达时交付给行级的原因文案:说清是运维故障,不是这行数据的问题。 */
static final String REASON_LLM_UNREACHABLE = "LLM 服务不可达(连接未建立,非本行数据问题)";
private static final String APPEARANCE_ANOMALY = "外观识别异常";
/**
* 我们<b>根本没发出图片请求</b>时的外观维标签(无图片/无标题,或商标维先失败跳过外观那一步)。
* 与 {@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<Integer, AppearanceJudgement> judgements = new LinkedHashMap<>();
Map<Integer, String> appearanceErrors = new LinkedHashMap<>();
@@ -468,6 +481,36 @@ public class AppearancePatentLlmClient {
"");
}
/**
* 外观那一步<b>没跑</b>的行(无图/无标题,或商标维先失败跳过):标签与原因都要说清"没跑"。
* 三条列(外观/专利/标题原因)都不许空着交付,否则用户拿到的是"外观识别异常"四个字加一片空白。
*/
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<Integer, String> invokeTitleBatch(List<AppearancePatentResultRowDto> rows,
List<Integer> chunk,
@@ -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++;
}
}