diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatPositionService.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatPositionService.java
index 37ab015d8..cccf33c79 100644
--- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatPositionService.java
+++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/TaskHeartbeatPositionService.java
@@ -28,6 +28,8 @@ public class TaskHeartbeatPositionService {
private static final String KEY_PREFIX = "task:heartbeat:position:";
private static final String STALL_KEY_PREFIX = "task:progress:stall:";
+ /** 影子判官的独立快照键:影子的观测时刻不得改变正式判死线的「未变化起点」。 */
+ private static final String SHADOW_STALL_KEY_PREFIX = "task:progress:shadow-stall:";
private static final Duration POSITION_TTL = Duration.ofHours(24);
private static final int POSITION_LABEL_MAX_LEN = 60;
/** 计数字符串的最长位数:9 位以内 parseInt 必不溢出,所以这一处不需要 catch。 */
@@ -303,7 +305,57 @@ public class TaskHeartbeatPositionService {
if (position == null || position.isBlank()) {
return StallState.UNKNOWN;
}
- String stallKey = STALL_KEY_PREFIX + taskId;
+ return evaluateAgainstSnapshot(taskId, STALL_KEY_PREFIX + taskId, position, staleWindowMinutes);
+ }
+
+ /**
+ * 影子判官专用:把「计数 + 文本 + 阶段」压成指纹判断推进,快照写独立键。
+ *
+ *
与正式线只比文本不同:计数变了也是推进(长页面里文本可能长时间不变),
+ * 阶段变化同样算推进。影子每 5 分钟扫一次,若与正式线共用快照键,影子可能比正式线早几分钟
+ * 看到变化,从而把正式线的未变化起点提前、间接影响封口时刻;所以这里只写 shadow 键。
+ */
+ public StallState evaluateProgressForShadow(Long taskId, long staleWindowMinutes) {
+ if (taskId == null || taskId <= 0 || staleWindowMinutes <= 0) {
+ return StallState.UNKNOWN;
+ }
+ String fingerprint = readProgressFingerprint(taskId);
+ if (fingerprint == null) {
+ return StallState.UNKNOWN;
+ }
+ return evaluateAgainstSnapshot(taskId, SHADOW_STALL_KEY_PREFIX + taskId,
+ fingerprint, staleWindowMinutes);
+ }
+
+ /**
+ * 影子判官的推进指纹:位置哈希一次读出,计数/文本/阶段任一变化都算推进。
+ * 返回 null 表示这个任务没有任何位置信息(老客户端不传位置),不能作为判死证据。
+ */
+ private String readProgressFingerprint(Long taskId) {
+ Map