fix(通知): 麦象不可读不再折叠成「无异常」、探活 4xx 不冒充正常、交付不完整独立成 scene,前端入队拒绝按机器码决定重试

- MaixiangConsoleClient 新增 probeReadable/classifyReadout,把四种「读不出来」的形状与
  「确实无异常」分开;MaixiangAnomalyScanner 在六项扫描前先过这道闸,读不通就喊一条
  天级去重的管理员异常并退出本轮——此前后台挂掉时六项一致报「无异常」,服务探测还是绿的。
- NotificationScanScheduler 的探活改三态 ALIVE/UNVERIFIED/DOWN:401/403/404 说明请求被
  挡在业务之外,拿不到健康证据,不能再按 <500 判成「服务正常」。
- task_partial(交付不完整)从 task_failed 里拆出来独立成 scene,仍归任务异常大类;
  NotificationDispatchService 的管理员行改用 SCENE_TASK_PARTIAL。
- 前端 dispatch-guard 用机器码 shop_busy/queue_full 判定「等一会儿再推就会成」,
  暂缓 20s×15 封顶;此前页面靠 includes('当前店铺正在执行中') 匹配中文,而文案中间
  插了店铺名,永远匹配不到⇒同店互斥被写成任务失败。

护栏:后端 notification 六支用例(含 MaixiangConsoleClientTest 15 例、
MaixiangAnomalyScannerTest 24 例)、前端 dispatch-guard 与 enqueue-rejection-wiring 两支;
后端全量 3827 例 0 红、前端 717 例 0 失败;变异 M1-M7、M12-M14 共 10/10 杀。
This commit is contained in:
2026-10-06 11:46:54 +08:00
parent 4596e7d840
commit 7887e7ee37
18 changed files with 545 additions and 47 deletions
@@ -2,11 +2,12 @@ import { get, post, type JavaApiResponse, unwrapJavaResponse } from '../../http.
import { buildJavaUrl } from '../../url.ts'
import { API_ENDPOINTS } from '../../endpoints.ts'
/** 通知场景:密钥欠费 / 密钥失效 / 任务失败 / 服务异常 / 麦象异常 / 系统。 */
/** 通知场景:密钥欠费 / 密钥失效 / 任务失败 / 交付不完整 / 服务异常 / 麦象异常 / 系统。 */
export type NotificationScene =
| 'secret_balance'
| 'secret_invalid'
| 'task_failed'
| 'task_partial'
| 'service_down'
| 'maixiang_anomaly'
| 'system'
+1 -1
View File
@@ -170,7 +170,7 @@ export interface PywebviewApi {
}>;
enqueue_json?: (
data: unknown,
) => Promise<{ success: boolean; queue_size?: number; error?: string }>;
) => Promise<{ success: boolean; queue_size?: number; error?: string; code?: string }>;
// —— ASIN 变体采集(VariantCollectionAPI,vc_* 前缀)——
vc_select_input_files?: () => Promise<string[]>;
vc_start_collect?: (params: {
+48
View File
@@ -694,3 +694,51 @@ export function findUnsafeJsonPaths(root: unknown): UnsafeJsonPath[] {
walk(root, 'payload', 0, false)
return found
}
/** 客户端 enqueue_json 拒绝原因的分类。见 {@link classifyQueueRejection}。 */
export type QueueRejectionKind = 'shop_busy' | 'queue_full' | 'other'
export interface QueueRejection {
kind: QueueRejectionKind
/** 等一会儿再推就可能成功(店铺跑完 / 队列腾出位置),不该落「任务失败」。 */
deferrable: boolean
}
/**
* 把 enqueue_json 的失败返回分成「可以等」和「真失败」。
*
* 为什么要有这一步:三条推送路径过去只看 `success===false`,一律按失败收尾(后端标 FAILED、
* 扣掉的次数不再回来),可「当前店铺 X 正在执行中」只是同店互斥——稍后重试就会成功。
* 跟价页一度想按中文文案识别互斥,但用的是 `includes('当前店铺正在执行中')`,
* 客户端的文案在中间插了店铺名(`当前店铺 鲍丽明-US 正在执行中`),永远匹配不到,
* 于是那个"重试"闸门形同虚设。
*
* 判定顺序:新版客户端直接给 `code`(不依赖文案),老客户端没有 code 只能按文案兜底——
* app-web 是服务端加载的,页面新版与客户端旧版会长期共存。文案匹配放宽中间内容,
* 但不放宽到整段自由匹配,避免把「Excel 解析失败」这类真失败误判成可等待。
*/
export function classifyQueueRejection(
result: { code?: unknown; error?: unknown } | null | undefined,
): QueueRejection {
const code = typeof result?.code === 'string' ? result.code : ''
const message = typeof result?.error === 'string' ? result.error : ''
let kind: QueueRejectionKind = 'other'
if (code === 'shop_busy' || /当前店铺[\s\S]{0,200}正在执行中/.test(message)) {
kind = 'shop_busy'
} else if (code === 'queue_full' || message.includes('任务队列已满')) {
kind = 'queue_full'
}
return { kind, deferrable: kind !== 'other' }
}
/** 可等待拒绝的重试预算:20 秒一次、最多 15 次(约 5 分钟),用尽后按失败收尾。 */
export const ENQUEUE_DEFERRAL_RETRY_MS = 20000
export const ENQUEUE_DEFERRAL_ATTEMPTS = 15
/**
* 「这次先等一等、别把任务判死」的判定:可等待 且 还没用尽预算。
* 预算用尽后照旧落失败并带上原因——同店一直不放行不能无限期吊着页面。
*/
export function shouldDeferQueuePush(rejection: QueueRejection, attempt: number, maxAttempts: number): boolean {
return rejection.deferrable && attempt < maxAttempts
}