feat(采集页省钱线): 派发即裁剪已匹配行、候选勾选记忆、摘掉跟价旧逐行派发

代理按「提取次数」计费而不是按流量,所以把同一批店铺重复派发一次就是真花钱。三处改动的
共同口径是「用户多点一次启动,不再多买一轮」。纯逻辑各抽成一个可单测的模块,页面只接线。

- dispatch-row-prune:查 ASIN 页匹配好的店铺交给后台执行后从结果表里移除。删行本身一句 filter,
  两个坑要钉住——行键口径必须与该页 rowKeyForMatch 一致(名字带两端空格的行删不掉,就留着
  下次再买一轮);历史行明细靠本地匹配表回退(withQueryAsinFallback 读 matchedItems),直接删行
  等于把已派发店铺的历史明细一起删掉 ⇒ 移除的行进一份上限 50 的归档,继续当回退数据源。
- candidate-selection-memory:候选店铺每天重拉时保住勾选。记的是店铺名不是行 id(候选行会被
  删了再加、id 会变,店铺名才是人眼认的那个身份);键按 uid + 页签隔离;selection-change 只带
  当前渲染窗口里的行,整份覆盖会把别的页刚记住的勾选一起抹掉 ⇒ 只按本窗口可见行重算;
  店铺已被删除时不得恢复勾选(否则匹配的是不存在的店)。
- 跟价页摘掉 processMatchedQueue 这条旧逐行派发路径:入口只有 if (autoQueueEnabled),而本页
  从来没把它置 true ⇒ 永远进不去。留着不是无害死代码——它是一套能重复买提取的并行派发路径,
  谁接错一次就再花钱。用例反向钉「不得回流」,不给死代码补测试。

验证:frontend-vue 定向 29/0(dispatch-row-prune 7、candidate-selection-memory 5、
wiring 10、query-asin-dispatch-prune 5、price-track-dead-queue-removed 反向钉 2),
全量 710/0(含本会话另加的到期弹窗 9 支,那 9 支随上一笔走)。接线由 wiring 用例钉住
"纯模块真被这两个页面 import",不是只测纯函数。
This commit is contained in:
2026-10-05 11:51:53 +08:00
parent 95e2318c42
commit eea617b3e6
9 changed files with 719 additions and 125 deletions
@@ -0,0 +1,64 @@
/**
* 候选区「勾选记忆」的纯逻辑(2026-10-04 C 档,不加任何请求)。
*
* 备选店铺每天重新拉一次,勾选状态原本跟着一起清零,于是同一批店铺要重勾一遍。
* 记住的是店铺名而不是行 id —— 候选行会被删了再加、id 会变,店铺名才是人眼认的那个身份。
* 三个会静默出错的点抽在这里钉住:
* 1. 键必须按 uid + 页签隔离,否则换账号 / 换页签会串勾选;
* 2. 候选区分页,selection-change 只带当前渲染窗口里的行。直接整份覆盖会把别的页
* 刚记住的勾选一起抹掉 ⇒ 只按「本窗口的可见行」重算;
* 3. 店铺已被删除时不得恢复勾选(否则匹配的是不存在的店)。
*/
/** 记忆上限:按店铺名存,超出丢最旧的,留最近勾的 */
export const SELECTION_MEMORY_LIMIT = 200
export function selectionMemoryKey(uid: string, tab: string): string {
return `candidate-selection:${tab}:${uid}`
}
/** localStorage 读回来的可能是脏值(手改、旧结构),入口先收干净 */
export function parseRememberedNames(raw: unknown): string[] {
if (!Array.isArray(raw)) return []
const seen = new Set<string>()
const names: string[] = []
for (const item of raw) {
if (typeof item !== 'string') continue
const name = item.trim()
if (!name || seen.has(name)) continue
seen.add(name)
names.push(name)
}
return names.length > SELECTION_MEMORY_LIMIT
? names.slice(names.length - SELECTION_MEMORY_LIMIT)
: names
}
/** 当前候选里仍然存在的、且被记住的行(名字两端空格按同一口径对齐) */
export function selectableRows<T>(
rows: readonly T[],
remembered: readonly string[],
nameOf: (row: T) => string,
): T[] {
const names = new Set(remembered.map((name) => name.trim()))
return rows.filter((row) => names.has(nameOf(row).trim()))
}
/**
* 本窗口(visibleNames)的勾选由 selectedNames 说了算,窗口外的名字原样保留。
* 顺序:先窗口外的旧记忆,再本窗口勾上的。
*/
export function reconcileRememberedNames(
remembered: readonly string[],
visibleNames: readonly string[],
selectedNames: readonly string[],
): string[] {
const visible = new Set(visibleNames.map((name) => name.trim()))
const kept = remembered.map((name) => name.trim()).filter((name) => name && !visible.has(name))
return parseRememberedNames([...kept, ...selectedNames.map((name) => name.trim())])
}
export function selectionNotice(restoredCount: number): string {
if (restoredCount <= 0) return ''
return `已恢复上次勾选的 ${restoredCount} 家店铺`
}
@@ -0,0 +1,72 @@
/**
* 「派发即移除」的纯逻辑(查 ASIN 页用;跟价页在循环体里逐行裁剪,语义相同)。
*
* 匹配好的店铺交给后台执行后不从「匹配结果表」里删掉,用户再点一次启动就把同一批店铺
* 再派发一遍 —— 代理按提取次数计费,多点这一次是真花钱。删行本身只是一句 filter,
* 但两个坑要抽出来钉住:
* 1. 行键口径必须与该页 `rowKeyForMatch` 一致(店铺名 trim + shopId)。名字带两端空格
* 的行删不掉,就会留着下次再买一轮;
* 2. 查 ASIN 的历史行明细靠本地匹配表回退(`withQueryAsinFallback` 读 matchedItems),
* 直接删行等于把已派发店铺的历史明细一起删掉 ⇒ 移除的行要进一份有上限的归档,
* 继续当回退数据源。
*/
/** 归档上限。整份归档会随队列状态同步写 localStorage,行里带 ASIN 明细,压到 50 行以内 */
export const DISPATCH_ARCHIVE_LIMIT = 50
export interface PruneResult<T> {
remaining: T[]
removed: T[]
}
/**
* 把已派发的行从列表里裁掉,返回新数组(不改入参:页面直接把结果赋回 ref,
* 原地改会让 Vue 的引用比较看不到变化)。
*/
export function pruneRows<T>(
rows: readonly T[],
dispatched: readonly T[],
keyOf: (row: T) => string,
): PruneResult<T> {
const keys = new Set(dispatched.map((row) => keyOf(row)))
const remaining: T[] = []
const removed: T[] = []
for (const row of rows) {
if (keys.has(keyOf(row))) {
removed.push(row)
} else {
remaining.push(row)
}
}
return { remaining, removed }
}
/**
* 已派发行的归档:按行键覆盖(重新匹配过 ASIN 时以最新一份为准),并按上限截断。
*/
export function mergeDispatchedArchive<T>(
archive: readonly T[],
removed: readonly T[],
keyOf: (row: T) => string,
): T[] {
const byKey = new Map<string, T>()
for (const row of archive) {
byKey.set(keyOf(row), row)
}
for (const row of removed) {
byKey.set(keyOf(row), row)
}
const merged = [...byKey.values()]
return merged.length > DISPATCH_ARCHIVE_LIMIT
? merged.slice(merged.length - DISPATCH_ARCHIVE_LIMIT)
: merged
}
/** 派发后的提示:把「再点启动只跑剩余」说在前面,免得用户以为按一次跑一批。 */
export function dispatchedPruneNotice(dispatchedCount: number, remainingCount: number): string {
const head = `已派发 ${dispatchedCount} 家店铺`
if (remainingCount <= 0) {
return `${head},匹配表已清空(再点启动不会重复提取)`
}
return `${head},匹配表还剩 ${remainingCount} 家未派发(再点启动只跑剩余,不会重复提取)`
}