Files
crawler-plugin/frontend-vue/src/shared/asin-force-throttle.ts
T
huangzd1997 3a6e6b1027 task-85: 优化 Similar ASIN 轮询与文件生成等待,避免重复 force 请求
新增纯 TS force 节流守卫 asin-force-throttle:为每个 taskId 维护 TTL
冷却窗口,窗口内不重复发 force 请求(避免反复触发后端生成文件),到期
后允许重试,任务终态后 clear 立即释放记录。BrandSimilarAsinTab 的
refreshTaskProgress 改为按 pendingFileTaskIds 逐项查守卫决定本轮是否
带 force,请求成功后整批进入冷却。8 个测试覆盖默认、批量、幂等、空、
单元素、200 任务溢出、非法输入与时钟故障恢复。
2026-08-30 22:49:45 +08:00

111 lines
3.0 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* Similar ASIN force 请求节流守卫(Task 85)。
*
* 原实现只要 pendingFileTaskIds 非空,每轮轮询都以 force=true 请求批量
* 进度,可能反复触发后端重复生成文件。本守卫为每个 taskId 维护一个 TTL
* 窗口:窗口内 shouldForce 返回 false(不重复发 force 请求),到期后
* 允许重试(文件生成可能仍在进行,但后端可再次确认);任务终态后调用
* clear 立即释放记录,窗口表不会无界增长。
*
* 纯 TS 无副作用模块:markForce 对非法 taskId fail-fast 抛错,读取路径
* (shouldForce/isThrottled/clear/stats)对非法 id 宽容;时钟抛错时
* 读取失败但记录不丢失,恢复后可继续工作。
*/
export interface AsinForceThrottleOptions {
/** force 请求的冷却窗口(毫秒),必须为正数 */
ttlMs: number
/** 时钟来源;默认 Date.now(),测试可注入虚拟时钟 */
now?: () => number
}
export interface AsinForceThrottleStats {
/** 已执行的 force 标记次数 */
forcedCount: number
/** 被节流跳过的 force 请求次数 */
skippedCount: number
/** 当前处于冷却窗口内的 taskId 数 */
activeCount: number
}
export function createAsinForceThrottle(options: AsinForceThrottleOptions) {
const ttlMs = options.ttlMs
const now = options.now ?? Date.now
if (!(ttlMs > 0)) {
throw new Error('ttlMs 必须为正数: ' + ttlMs)
}
const cooldowns = new Map<number, number>()
let forcedCount = 0
let skippedCount = 0
function validateTaskId(taskId: number): boolean {
return Number.isFinite(taskId) && taskId > 0 && Number.isInteger(taskId)
}
function isThrottled(taskId: number): boolean {
if (!validateTaskId(taskId)) return false
const at = now()
const until = cooldowns.get(taskId)
if (until == null) return false
if (at >= until) {
cooldowns.delete(taskId)
return false
}
return true
}
function shouldForce(taskId: number): boolean {
if (!validateTaskId(taskId)) return false
if (isThrottled(taskId)) {
skippedCount += 1
return false
}
return true
}
function markForce(taskId: number) {
if (!validateTaskId(taskId)) {
throw new Error('taskId 必须是正整数: ' + taskId)
}
if (isThrottled(taskId)) return
cooldowns.set(taskId, now() + ttlMs)
forcedCount += 1
}
function clear(taskId: number): boolean {
if (!validateTaskId(taskId)) return false
return cooldowns.delete(taskId)
}
function clearAll() {
cooldowns.clear()
}
function stats(): AsinForceThrottleStats {
const at = now()
for (const [taskId, until] of cooldowns) {
if (at >= until) cooldowns.delete(taskId)
}
return {
forcedCount,
skippedCount,
activeCount: cooldowns.size,
}
}
return {
get activeCount() {
stats()
return cooldowns.size
},
shouldForce,
markForce,
isThrottled,
clear,
clearAll,
stats,
}
}
export type AsinForceThrottle = ReturnType<typeof createAsinForceThrottle>