fix(appearance-patent): 上游余额欠费即判任务终态,停止为空转的行烧出口

B46 那一笔(f3445c21)只做到「行级一次就停、归因写对」:撞上上游 403
insufficient_user_quota 后不再跑满 3 次重试,任务本身仍停在 RUNNING/WAIT_LLM
等 Python 继续回传分片。采集端(maixiang ap_worker)只看 /task/heartbeat 的
alive,读不到终态就继续为剩下的行按次付费买出口 IP——而那些行永远进不了 LLM,
钱白花。这一笔补上 Java 侧缺的那半步:欠费即把任务落终态 FAILED,心跳随即
回 alive=false,worker 下一跳收手。

- 判据只认 TaskRetryEligibility 的 BALANCE 类(欠费 + 密钥失效),复用现成分类器
  而非再抄一份字面量表;连接不可达 / 5xx / 429 / 抓取缺口一律照旧继续或按已有
  结果交付,判宽了就是拿用户整单给一次网络抖动陪葬。
- 停手点放在批管线的作业执行线程(LLM 批次就在这里跑),不在心跳线程;识别到
  欠费即停止后续批次,并回调宿主落终态(FileTaskMapper 与收尾口径在宿主手里)。
- 写终态前重读库里现状态:已 SUCCESS/COMPLETED/CANCELLED/FAILED 的一律不动,
  因此可重入,多入口命中也只写一次。
- 终态文案 = 生产者原文(客户端欠费归因 + 上游 lastErr)+ 可执行动作,原文一个
  字都不重写;不出现「请稍后重试」,不把欠费说成临时抖动。
This commit is contained in:
2026-10-27 15:53:10 +08:00
parent 07f973d9df
commit e08b5369d7
7 changed files with 605 additions and 5 deletions
@@ -18,6 +18,18 @@ public final class LlmBalanceGuard {
/** 行级/任务级统一归因文案:说清是上游账户欠费,不是这行数据的问题。 */
public static final String REASON_LLM_BALANCE_DUE = "LLM 服务余额欠费(上游账户额度不足,非本行数据问题)";
/**
* 任务级终态文案(2026-10-27 用户口径:「提示语要纠正一下,不能误导用户」)。
*
* <p>欠费与密钥失效都是外部条件坏了:既不能写成「请稍后重试」(把欠费说成临时抖动,
* 用户会干等),也不能让人以为是自己那张表格的问题。这里只说三件事——
* 谁的问题(上游账户/密钥)、已经做了什么(任务终止、停止继续消耗采集出口)、
* 下一步做什么(充值或换密钥后重新发起)。
*/
public static final String TASK_TERMINAL_GUIDANCE =
"任务已终止:上游 LLM 账户欠费或密钥失效,不是你本次上传表格的数据问题;"
+ "已停止后续检测与采集,以免继续消耗代理出口额度。请充值或更换有效密钥后重新发起检测。";
private static final String[] MARKERS = {
"insufficient_user_quota",
"insufficient_quota",