pixivflow 2.27.0 → 2.28.0

package/dist/delivery/HttpMultipartDelivery.js

@@ -171,6 +171,11 @@ class HttpMultipartDelivery {
                         work_type: t.workType,
                         status: t.status,
                         work_id: t.workId ?? null,
+                        terminal_reason_code: t.terminal_reason_code ?? null,
+                        reason: t.reason ?? null,
+                        stage: t.stage ?? null,
+                        retryable: t.retryable ?? null,
+                        operator_hint: t.operator_hint ?? null,
                     })),
                 }
                 : { text: request.text, idempotency_key: request.idempotencyKey };

package/dist/delivery/types.d.ts

@@ -142,6 +142,10 @@ export interface DeliveryNotificationRequest {
             terminal_reason_code?: string | null;
             /** User-facing business reason message for the failure. */
             reason?: string | null;
+            stage?: string | null;
+            /** Whether a later/manual attempt may succeed; terminal does not mean auto-retry pending. */
+            retryable?: boolean | null;
+            operator_hint?: string | null;
         }>;
     };
 }

package/dist/notification/NotificationPolicy.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotificationPolicy = void 0;
 const DeliveryService_1 = require("../delivery/DeliveryService");
+const TargetOutcome_1 = require("../scheduler/TargetOutcome");
 const SlotCoordinator_1 = require("../scheduler/SlotCoordinator");
 const logger_1 = require("../logger");
 /**
@@ -130,15 +131,22 @@ class NotificationPolicy {
                         },
                     }
                     : {}),
-                targets: rows.map((r) => ({
-                    targetId: r.targetId,
-                    workType: r.workType,
-                    status: r.status,
-                    workId: r.workId,
-                    error: r.error,
-                    terminal_reason_code: r.terminal_reason_code ?? null,
-                    reason: r.reason ?? null,
-                })),
+                targets: rows.map((r) => {
+                    const code = r.terminal_reason_code;
+                    const operational = code ? (0, TargetOutcome_1.operationalReasonForCode)(code, r.reason) : null;
+                    return {
+                        targetId: r.targetId,
+                        workType: r.workType,
+                        status: r.status,
+                        workId: r.workId,
+                        error: r.error,
+                        terminal_reason_code: code ?? null,
+                        reason: operational?.message ?? r.reason ?? null,
+                        stage: operational?.stage ?? null,
+                        retryable: operational?.retryable ?? null,
+                        operator_hint: operational?.operatorHint ?? null,
+                    };
+                }),
             });
         }
     }
@@ -179,6 +187,8 @@ class NotificationPolicy {
                 ...cell, label: cell.targetId,
                 workType: targets.find((target) => target.id === cell.targetId)?.type ?? 'unknown',
                 error: cell.error ?? null,
+                terminal_reason_code: cell.terminalReasonCode ?? null,
+                reason: cell.terminalReasonMessage ?? null,
             })));
         }
     }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow",
-  "version": "2.27.0",
+  "version": "2.28.0",
   "private": true
 }

package/dist/scheduler/TargetOutcome.d.ts

@@ -277,6 +277,19 @@ export interface TerminalReason {
     /** Business-language message an operator/reviewer reads directly. */
     message: string;
 }
+/** Operator-facing recovery semantics derived from the stable reason code.
+ *
+ * These fields are deliberately derived instead of persisted as a second
+ * failure record.  The durable SSOT remains the cell's terminal reason code;
+ * wording and policy can evolve without rewriting historical slot rows.
+ */
+export interface OperationalReason extends TerminalReason {
+    stage: 'acquisition' | 'download' | 'delivery' | 'execution' | 'configuration';
+    /** A later/manual attempt may succeed; this does not mean auto-retry is pending. */
+    retryable: boolean;
+    operatorHint: string;
+}
+export declare function operationalReasonForCode(code: string, message?: string | null): OperationalReason | null;
 /** User-facing business messages — never stack traces, paths, SQL or tokens. */
 export declare const TERMINAL_REASON_MESSAGES: Record<TerminalReasonCode, string>;
 /**

package/dist/scheduler/TargetOutcome.js

@@ -11,6 +11,7 @@ exports.hasTransientFailure = hasTransientFailure;
 exports.mergeScanSummaries = mergeScanSummaries;
 exports.classifyCandidateFailure = classifyCandidateFailure;
 exports.classifyJobLevelOutage = classifyJobLevelOutage;
+exports.operationalReasonForCode = operationalReasonForCode;
 exports.terminalReasonFor = terminalReasonFor;
 /**
  * A scan that attempted nothing. The real pipeline always reports its own scan;
@@ -226,6 +227,34 @@ function classifyJobLevelOutage(error) {
     const failure = classifyCandidateFailure(error, '');
     return failure.scope === 'job' ? failure.outage : null;
 }
+const OPERATIONAL_REASON_POLICY = {
+    no_candidate: { stage: 'acquisition', retryable: true, operatorHint: '可等待下次任务，或使用“放宽条件重试”。' },
+    duplicate_exhausted: { stage: 'acquisition', retryable: true, operatorHint: '候选均已处理，可等待新作品或放宽条件重试。' },
+    filter_exhausted: { stage: 'acquisition', retryable: true, operatorHint: '检查筛选条件，或使用“放宽条件重试”。' },
+    download_timeout: { stage: 'download', retryable: true, operatorHint: '可稍后重试；若持续发生，请检查 Pixiv 连接。' },
+    download_failed: { stage: 'download', retryable: true, operatorHint: '可稍后重试；若持续发生，请检查网络与存储空间。' },
+    metadata_failed: { stage: 'acquisition', retryable: true, operatorHint: '可稍后重试；若只影响单个作品，请检查作品是否已删除或转为私密。' },
+    rate_limited: { stage: 'acquisition', retryable: true, operatorHint: '等待限流窗口结束后再重试。' },
+    auth_failed: { stage: 'acquisition', retryable: false, operatorHint: '检查并刷新对应 Pixiv 账号的认证状态。' },
+    remote_http_error: { stage: 'acquisition', retryable: true, operatorHint: '可稍后重试；若持续发生，请检查 Pixiv 服务状态。' },
+    delivery_failed: { stage: 'delivery', retryable: true, operatorHint: '检查 TelePost 可达性与投稿接口状态后重试。' },
+    telepost_rejected: { stage: 'delivery', retryable: false, operatorHint: '检查投稿内容和 TelePost 接口契约。' },
+    telegram_failed: { stage: 'delivery', retryable: true, operatorHint: '检查 Telegram 可达性与 Bot 权限后重试。' },
+    network_error: { stage: 'execution', retryable: true, operatorHint: '检查执行端网络；恢复后可重试。' },
+    execution_timeout: { stage: 'execution', retryable: true, operatorHint: '检查执行耗时和资源使用后重试。' },
+    configuration_error: { stage: 'configuration', retryable: false, operatorHint: '修正配置并完成校验后再重试。' },
+    internal_error: { stage: 'execution', retryable: false, operatorHint: '查看对应执行记录；若重复发生，请提交诊断信息。' },
+};
+function operationalReasonForCode(code, message) {
+    if (!(code in OPERATIONAL_REASON_POLICY))
+        return null;
+    const knownCode = code;
+    return {
+        code: knownCode,
+        message: message?.trim() || exports.TERMINAL_REASON_MESSAGES[knownCode],
+        ...OPERATIONAL_REASON_POLICY[knownCode],
+    };
+}
 /** User-facing business messages — never stack traces, paths, SQL or tokens. */
 exports.TERMINAL_REASON_MESSAGES = {
     no_candidate: '没有找到合适的新作品',
@@ -317,6 +346,9 @@ function classifyFailedReason(message, scan) {
             ? { code: 'download_timeout', message: exports.TERMINAL_REASON_MESSAGES.download_timeout }
             : { code: 'execution_timeout', message: exports.TERMINAL_REASON_MESSAGES.execution_timeout };
     }
+    if (/\b(?:download|image fetch|image write)\b.{0,80}\b(?:fail|failed|error|unable)\b|\b(?:failed|unable)\b.{0,40}\b(?:download|fetch image|write image)\b/i.test(text)) {
+        return { code: 'download_failed', message: exports.TERMINAL_REASON_MESSAGES.download_failed };
+    }
     if (/502|503|504|bad gateway|service unavailable|server error|5\d\d/i.test(text)) {
         return { code: 'remote_http_error', message: exports.TERMINAL_REASON_MESSAGES.remote_http_error };
     }

package/dist/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BUILD = void 0;
 // GENERATED by scripts/write-version.js — do not edit manually.
-exports.BUILD = { version: '2.27.0', commit: '491a2a8f7abd' };
+exports.BUILD = { version: '2.28.0', commit: 'baec8d0803d6' };
 //# sourceMappingURL=version.js.map

package/dist/webui/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow-webui-backend",
-  "version": "2.27.0",
+  "version": "2.28.0",
   "description": "PixivFlow WebUI Backend - CommonJS module"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixivflow",
-  "version": "2.27.0",
+  "version": "2.28.0",
   "description": "🎨 Pixiv 下载、筛选与自动收集工具 - 批量下载插画和小说、按标签/热度/日期筛选、定时任务与可靠 HTTP 交付 | Pixiv downloader and automation toolkit with filtering, scheduling and reliable HTTP delivery",
   "repository": {
     "type": "git",