query,\s*\n?\s*AccessScope scope, Long groupId, boolean groupPrevalidated\)\s*\{[\s\S]*?\n \}/
+ .exec(backend)
+ assert.ok(readSide, 'applyGroupScope 不在了:读侧裁剪改写法了,本用例要重读')
+ assert.match(readSide[0], /scope\.wholeCompany\(\)/, '读侧不再有 wholeCompany 分支:这条不对称可能已被收口')
+ assert.match(readSide[0], /getCompanyId, scope\.companyId\(\)/,
+ '读侧已不按 company_id 给整家公司放行:请重判前端入口是否还需要收窄')
+ const writeSide = /private void ensureRecordAccess\([\s\S]*?\n \}/.exec(backend)
+ assert.ok(writeSide, 'ensureRecordAccess 不在了:写侧改判据了,本用例要重读')
+ assert.match(writeSide[0], /scope\.groupIds\(\)\.contains/, '写侧不再按 groupIds 拒人')
+ assert.equal(/scope\.wholeCompany\(\)/.test(writeSide[0]), false,
+ '写侧也开始认 wholeCompany:读写字面口径一致了,可以把"能点但拒"这条台账关掉')
+})
+
+test('不许用客户端猜测禁用行内入口:那会误伤真能改的行', () => {
+ const src = readSource(PAGE)
+ const opsCell = /[\s\S]*?<\/td>/.exec(src)
+ assert.ok(opsCell, '行内操作列结构变了:这条判据要重写')
+ assert.equal(/:disabled=|v-if=/.test(opsCell[0]), false,
+ '行内编辑/删除上加了客户端权限闸——但前端拿不到后端写侧的 companyGroupIds,'
+ + '按分组下拉收窄会把同事名下"看得见也改得动"的行一起禁掉(静默删功能)。'
+ + '要收窄请先让后端在列表响应里下发可写标志(先例:用户菜单授权树的 grantable)。')
+ assert.match(opsCell[0], /@click="removeRow\(row\)"/, '删除入口本身不在了:本用例失效')
+})
diff --git a/admin-frontend-vue/tests/error-feedback-exit-ledger.test.ts b/admin-frontend-vue/tests/error-feedback-exit-ledger.test.ts
new file mode 100644
index 000000000..71f8b7a1b
--- /dev/null
+++ b/admin-frontend-vue/tests/error-feedback-exit-ledger.test.ts
@@ -0,0 +1,143 @@
+/**
+ * 统一提示出口的收口台账(四面9分口径 · 后管「复用 6.0」)。
+ *
+ * 评审实测:`showAdminFeedback` 只有 17 处调用,而裸 `ElMessage.error` **92 处**——同一件事
+ * (把后端或本地的错误文本弹给用户)有两种写法,新页面跟着抄哪一种全看运气,文案与时长也无从统一。
+ * 这一支把 92 处机械可换的全部换成 `showAdminFeedback(msg, 'error')`,然后把「还剩哪几处裸调用」
+ * 落成一张显式名单:
+ * ① 名单外的任何裸 `ElMessage.error(` 一律红(新增拦在提交前,而不是等下轮评审再数一遍);
+ * ② 名单里每一条都必须在文件里仍然成立(防止台账烂成没人删的历史账);
+ * ③ 名单本身只许减(BARE_SITE_LEDGER_CAP=0)。
+ *
+ * 判据不锚行号:锚的是「哪个文件里还有裸调用」与「出口调用行的形状」。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readdirSync, statSync } from 'node:fs'
+import { join } from 'node:path'
+import { occurrences, readSource } from './helpers.ts'
+
+const EXIT_MODULE = 'src/components/admin-feedback-ui.ts'
+/** 例外名单只许减:收口批次结束时是 0 处(出口实现自己那一处不算名单,另用例单独钉)。 */
+const BARE_SITE_LEDGER_CAP = 0
+/** 出口实现里那一处 `ElMessage.error(m)` 是这条出口的本体。 */
+const EXIT_MODULE_CALLS = 1
+/** 分母硬钉:2026-10-10 实测走统一出口的 error 行 ≥ 92(92 处收口 + 批次前已有的几处)。 */
+const EXIT_ERROR_LINES_FLOOR = 92
+
+/** 名单:不机械替换的裸调用,逐条给理由。新增一条 = 本用例红(超上限),且必须仍能对上实际代码。 */
+const BARE_SITE_LEDGER: Array<{ file: string; reason: string }> = []
+
+function blankComments(src: string): string {
+ return src
+ .replace(/\/\*[\s\S]*?\*\//g, (block) => block.replace(/[^\n]/g, ' '))
+ .replace(/^[ \t]*\/\/[^\n]*/gm, (line) => ' '.repeat(line.length))
+}
+
+/** 剥掉注释与字符串字面量的内容:字符串里的 "ElMessage.error(" 字样不能算调用点。 */
+function stripNonCode(src: string): string {
+ const out: string[] = []
+ let i = 0
+ const n = src.length
+ while (i < n) {
+ const two = src.slice(i, i + 2)
+ if (two === '/*') {
+ const close = src.indexOf('*/', i + 2)
+ const end = close < 0 ? n : close + 2
+ for (let k = i; k < end; k++) out.push(src[k] === '\n' ? '\n' : ' ')
+ i = end; continue
+ }
+ if (two === '//') {
+ const nl = src.indexOf('\n', i + 2)
+ const end = nl < 0 ? n : nl
+ for (let k = i; k < end; k++) out.push(src[k] === '\n' ? '\n' : ' ')
+ i = end; continue
+ }
+ const q = src[i]
+ if (q === '"' || q === "'" || q === '`') {
+ let k = i + 1
+ out.push(' ')
+ while (k < n) {
+ if (src[k] === '\\') { out.push(' ', src[k + 1] === '\n' ? '\n' : ' '); k += 2; continue }
+ if (src[k] === q) { out.push(' '); k++; break }
+ out.push(src[k] === '\n' ? '\n' : ' ')
+ k++
+ }
+ i = k; continue
+ }
+ out.push(src[i]); i++
+ }
+ return out.join('')
+}
+
+/** 在一个源码文本里数裸 ElMessage.error(注释与字符串里的字样不算)。 */
+export function bareErrorCount(src: string): number {
+ return occurrences(stripNonCode(src), 'ElMessage.error(')
+}
+
+/**
+ * 数「走统一出口的 error 行」:一行里同时出现 `showAdminFeedback(` 与 `, 'error')`。
+ * 用整行而不是 `showAdminFeedback\([^)]*, 'error'\)`——参数里带函数调用(`errorText(error, '…')`)时
+ * `[^)]*` 会在第一个右括号处收口,分母会凭空少一截,把"扫不到"读成"没有"。
+ */
+export function exitErrorLineCount(src: string): number {
+ return blankComments(src).split('\n')
+ .filter((line) => line.includes('showAdminFeedback(') && line.includes(", 'error')")).length
+}
+
+function sourceFiles(): string[] {
+ const out: string[] = []
+ const walk = (dir: string): void => {
+ for (const name of readdirSync(dir)) {
+ const abs = join(dir, name)
+ if (name.endsWith('.d.ts')) continue
+ if (statSync(abs).isDirectory()) walk(abs)
+ else if (name.endsWith('.vue') || name.endsWith('.ts')) out.push(abs.split(/[\\/]+/).join('/'))
+ }
+ }
+ walk('src')
+ return out
+}
+
+const FILES = sourceFiles()
+/** 出口实现之外,全树仍然裸打 ElMessage.error 的文件。 */
+const offenders = FILES.filter((rel) => rel !== EXIT_MODULE && bareErrorCount(readSource(rel)) > 0)
+
+test('分母硬钉:扫描真的覆盖整棵 src,统一出口的 error 也确实被数到', () => {
+ // 2026-10-10 实测 src 下 212 个 .vue/.ts;掉一档说明 walk 或后缀判据坏了。
+ assert.ok(FILES.length >= 180, `只扫到 ${FILES.length} 个源文件,扫描规则可能已失效`)
+ const viaExit = FILES.reduce((sum, rel) => sum + exitErrorLineCount(readSource(rel)), 0)
+ assert.ok(viaExit >= EXIT_ERROR_LINES_FLOOR,
+ `走统一出口的 error 只有 ${viaExit} 处:92 处收口没落地,或被整体扫漏了("扫不到"不等于"没有")`)
+})
+
+test('出口实现里那一处 ElMessage.error 是出口本体,恰好一处', () => {
+ assert.equal(bareErrorCount(readSource(EXIT_MODULE)), EXIT_MODULE_CALLS,
+ 'admin-feedback-ui.ts 是唯一允许裸 ElMessage.error 的地方,且只能有出口那 1 处')
+})
+
+test('名单外的裸 ElMessage.error 一律点名;名单只许减、每条必须仍然成立', () => {
+ assert.ok(BARE_SITE_LEDGER.length <= BARE_SITE_LEDGER_CAP,
+ `例外名单从 ${BARE_SITE_LEDGER_CAP} 涨到 ${BARE_SITE_LEDGER.length}:这条口径只许减`)
+ assert.deepEqual(offenders.slice().sort(), BARE_SITE_LEDGER.map((e) => e.file).sort(),
+ `裸调用文件与名单不等值。名单外新增=${offenders.filter((f) => !BARE_SITE_LEDGER.some((e) => e.file === f))},`
+ + `名单里已消失(该删掉这条登记)=${BARE_SITE_LEDGER.filter((e) => !offenders.includes(e.file)).map((e) => e.file)}`)
+ // 登记的每一条都得真的还有裸调用:烂账(登记了但代码里已经没有了)同样算破口。
+ for (const entry of BARE_SITE_LEDGER) {
+ assert.ok(bareErrorCount(readSource(entry.file)) > 0, `${entry.file} 已无裸调用,这条登记该删`)
+ assert.ok(entry.reason.trim().length >= 8, `${entry.file} 的例外理由没写清楚`)
+ }
+})
+
+test('非零对照:扫描会抓到裸调用,也不会把统一出口误报成裸调用', () => {
+ const injected = "try { await x() } catch (e) { ElMessage.error('店铺列表加载失败') }\n"
+ assert.equal(bareErrorCount(injected), 1, '扫不出注入的裸调用 ⇒ 上面那条"名单外点名"是恒绿的')
+ assert.equal(exitErrorLineCount(injected), 0)
+ const migrated = "try { await x() } catch (e) { showAdminFeedback('店铺列表加载失败', 'error') }\n"
+ assert.equal(bareErrorCount(migrated), 0)
+ assert.equal(exitErrorLineCount(migrated), 1, '统一出口的 error 支必须被分母数到')
+ // 参数里再套一层函数调用时,分母仍然数得到(这条正是 `[^)]*` 写法会静默漏掉的那种)。
+ assert.equal(exitErrorLineCount("showAdminFeedback(errorText(error, '任务列表加载失败'), 'error')"), 1)
+ assert.equal(bareErrorCount('// ElMessage.error( 只是注释里的字样'), 0, '注释里的字样算进来会让本用例永远红')
+ assert.equal(bareErrorCount("const doc = 'ElMessage.error( 出现在字符串里'"), 0)
+})
diff --git a/admin-frontend-vue/tests/load-failure-visibility.test.ts b/admin-frontend-vue/tests/load-failure-visibility.test.ts
new file mode 100644
index 000000000..30a0c0ed3
--- /dev/null
+++ b/admin-frontend-vue/tests/load-failure-visibility.test.ts
@@ -0,0 +1,178 @@
+/**
+ * 失败态可见 + 重试真能跑(四面9分口径 · 后管「交互 6.0:模板内失败态只有 4/24 页、重试按钮 2」)。
+ *
+ * 一条列表页的硬规矩(本仓界面铁律):**撤入口/重试入口必须同时是一条真能办成事的出口**。
+ * 所以这里不数「有没有红色文案」,而是逐页判三件事:
+ * ① 请求失败的 catch 真的把原因写进一个失败 ref(`[.value =` 落在 catch 窗口里);
+ * ② 那个 ref 被模板 `v-if` 出来(不是一闪而过的 toast);
+ * ③ 页面上有一个重试入口,且它绑的函数在同一个文件里真的定义着(`@retry="load"` 指向不存在的
+ * 函数、或者只有「知道了」这种清掉红条的假出口,都算没过)。
+ *
+ * 名单(只许减):确实不该有重试按钮的页登记理由——登录页的出口是「再按一次登录」。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readdirSync } from 'node:fs'
+import { readSource } from './helpers.ts'
+import {
+ LOAD_FAILURE_RETRY_LABEL,
+ failureDetail,
+ loadFailureMessage,
+ scopeRefusalNote,
+} from '../src/components/load-failure-model.ts'
+
+/** 分母硬钉:2026-10-10 实测「有 *Loading = ref(false) 且 onMounted 取数」的页面 23 个。 */
+const UNIVERSE_FLOOR = 20
+/** 例外名单只许减:本轮只有登录页不进这条口径。 */
+const LEDGER_CAP = 1
+
+const LEDGER: Array<{ file: string; reason: string }> = [
+ {
+ file: 'src/pages/login/LoginPage.vue',
+ reason: '登录不是取数页:失败原因已由 errorMessage 的 role="alert" 说出,'
+ + '重试入口就是那张表单上的「登录」按钮本身,再加一个重试按钮是重复入口',
+ },
+]
+
+function pageFiles(): string[] {
+ const out: string[] = []
+ for (const domain of readdirSync('src/pages')) {
+ for (const name of readdirSync(`src/pages/${domain}`)) {
+ if (name.endsWith('.vue')) out.push(`src/pages/${domain}/${name}`)
+ }
+ }
+ return out.sort()
+}
+
+function templateOf(src: string): string {
+ const at = src.indexOf('')
+ return at < 0 ? '' : src.slice(at)
+}
+
+/** 页面的失败态判定:返回缺了哪几条(空数组 = 过)。 */
+export function failureGaps(src: string): string[] {
+ const tmpl = templateOf(src)
+ const refs = [...src.matchAll(/const (\w*(?:[Ff]ailure|[Ee]rror)\w*) = ref\(/g)].map((m) => m[1])
+ const missing: string[] = []
+ const rendered = refs.filter((r) => new RegExp(`v-if="[^"]*\\b${r}\\b`).test(tmpl))
+ const writtenInCatch = refs.filter((r) => new RegExp(`catch[\\s\\S]{0,320}?${r}\\.value\\s*=`).test(src))
+ if (rendered.length === 0) missing.push(`失败原因没被模板 v-if 出来(refs=${refs.join('/')})`)
+ if (writtenInCatch.length === 0) missing.push('catch 里没有把失败原因写进任何失败 ref')
+ const candidates = [...tmpl.matchAll(/@retry="(\w+)"|@click="(\w+)"[^>]*>\s*重试/g)]
+ .map((m) => m[1] || m[2])
+ .filter((fn): fn is string => Boolean(fn))
+ const real = candidates.filter((fn) => new RegExp(`(?:function|const)\\s+${fn}\\s*[(=]`).test(src))
+ if (real.length === 0) missing.push(`没有真能重跑的入口(重试绑的函数须在页内定义;候选=${candidates.join('/')})`)
+ return missing
+}
+
+const UNIVERSE = pageFiles().filter((rel) => {
+ const src = readSource(rel)
+ return /\w*[Ll]oading = ref\(false\)/.test(src) && src.includes('onMounted(')
+})
+const ledgerHas = (rel: string) => LEDGER.some((e) => e.file === rel)
+const offenders = UNIVERSE.filter((rel) => !ledgerHas(rel) && failureGaps(readSource(rel)).length > 0)
+const staleLedger = LEDGER.filter((e) => !UNIVERSE.includes(e.file) || failureGaps(readSource(e.file)).length === 0)
+
+test('分母硬钉:整棵 pages 都扫到,取数页数量不像被过滤掉', () => {
+ assert.ok(pageFiles().length >= 24, `只扫到 ${pageFiles().length} 个页面文件,扫描规则可能已失效`)
+ assert.ok(UNIVERSE.length >= UNIVERSE_FLOOR,
+ `首屏取数的页面只认出 ${UNIVERSE.length} 个(阈值 ${UNIVERSE_FLOOR}):判据漏了,"没有缺口"就读成了"没有请求"`)
+})
+
+test('每个取数页都要有可见失败态 + 真能重跑的入口(名单外点名,名单只许减)', () => {
+ assert.ok(LEDGER.length <= LEDGER_CAP, `例外名单从 ${LEDGER_CAP} 涨到 ${LEDGER.length}:这条口径只许减`)
+ assert.deepEqual(offenders, [], `失败态缺失的页面:\n${offenders
+ .map((f) => `${f}\n - ${failureGaps(readSource(f)).join('\n - ')}`).join('\n')}`)
+ assert.deepEqual(staleLedger.map((e) => e.file), [],
+ '名单里的页面已经补齐失败态(或已不是取数页),这条登记该删掉')
+ for (const entry of LEDGER) assert.ok(entry.reason.length >= 12, `${entry.file} 的例外理由没写清楚`)
+})
+
+test('失败文案模型:后端的中文原因进得来,英文原文进不来,取不到就只留兜底句', () => {
+ const forbidden403 = { response: { status: 403, data: { message: '无权操作该总数据' } } }
+ assert.equal(failureDetail(forbidden403), '无权操作该总数据')
+ assert.equal(loadFailureMessage(forbidden403, '删除失败'),
+ `删除失败:无权操作该总数据(${scopeRefusalNote('无权操作该总数据')})`)
+ // unwrap 抛出来的 Error(BusinessException 走 HTTP 200 + body)同样要能带出原因
+ assert.equal(loadFailureMessage(new Error('本公司已存在该数据'), '保存失败'), '保存失败:本公司已存在该数据')
+ // 后端把底层英文拼进 message:界面只留中文主干
+ assert.equal(loadFailureMessage(new Error('Internal Server Error'), '导出失败,请重试'), '导出失败,请重试')
+ assert.equal(loadFailureMessage(undefined, '数据加载失败'), '数据加载失败')
+ assert.equal(loadFailureMessage('网关超时', '数据加载失败'), '数据加载失败:网关超时')
+ // 兜底句里已经含原因时不重复拼一遍
+ assert.equal(loadFailureMessage(new Error('去重数据加载失败'), '去重数据加载失败'), '去重数据加载失败')
+})
+
+test('范围拒绝要给出路,不是只说"失败了"', () => {
+ assert.match(scopeRefusalNote('无权操作该分组数据'), /平台超级管理员/)
+ assert.match(scopeRefusalNote('缺少归属公司:请先在页面上方选择公司'), /平台超级管理员/)
+ assert.equal(scopeRefusalNote('本公司已存在该数据'), '', '普通业务校验不该被加成越权文案')
+ assert.equal(LOAD_FAILURE_RETRY_LABEL, '重试', '按钮字样必须是能办成事的「重试」,不是「知道了」')
+})
+
+test('重试入口的失败态组件本身不是占位:它把点击回抛给页面', () => {
+ const bar = readSource('src/components/LoadFailureBar.vue')
+ assert.match(bar, /\$emit\('retry'\)/, '按钮必须把动作交回页面的取数函数')
+ assert.match(bar, /defineEmits<\{\s*\(event: 'retry'\): void\s*\}>\(\)/)
+ assert.match(bar, /role="alert"/, '失败要对读屏与低视力用户可见')
+})
+
+test('非零对照:造一个"loading 结束但没有失败分支"的页面会被点名', () => {
+ const placeholder = `
+
+
+
+`
+ const gaps = failureGaps(placeholder)
+ assert.equal(gaps.length, 3, `缺口应当被逐条点名,实测=${JSON.stringify(gaps)}`)
+ assert.match(gaps.join(' '), /v-if/)
+ assert.match(gaps.join(' '), /重试/)
+
+ const dismissed = `
+
+ ]
+ {{ loadError }}
+
+
+
+`
+ assert.equal(failureGaps(dismissed).length, 1, '只有「知道了」这种清条按钮 = 撤入口不是出口,必须被点名')
+ assert.match(failureGaps(dismissed)[0], /重试/)
+
+ const wired = `
+
+
+
+`
+ assert.deepEqual(failureGaps(wired), [], '补齐形态必须判成过,否则上面那条"名单外点名"没有区分力')
+})
diff --git a/admin-frontend-vue/tests/task-3.test.ts b/admin-frontend-vue/tests/task-3.test.ts
index 5fd0c9954..3aca2a957 100644
--- a/admin-frontend-vue/tests/task-3.test.ts
+++ b/admin-frontend-vue/tests/task-3.test.ts
@@ -47,7 +47,9 @@ test('test_task_003_layout_contract_boundary_single_item', () => {
test('test_task_003_layout_contract_boundary_limit_or_missing_field', () => {
// 边界上限:Element Plus 交互能力按需命名导入,不整包拖入壳层。
const layout = readSource(LAYOUT)
- assert.match(layout, /import\s*\{\s*ElMessage(?:,\s*\w+)*\s*\}\s*from\s*['"]element-plus['"]/)
+ assert.match(layout, /import\s*\{\s*ElMessageBox(?:,\s*\w+)*\s*\}\s*from\s*['"]element-plus['"]/)
+ assert.doesNotMatch(layout, /import\s*\{[^}]*\bElMessage\b[^}]*\}\s*from\s*['"]element-plus['"]/,
+ '壳层提示走 showAdminFeedback 统一出口,不再直接命名导入 ElMessage')
assert.equal(occurrences(layout, 'import ElementPlus'), 0, '壳层不得整包导入 ElementPlus')
})
diff --git a/admin-frontend-vue/tests/task-center-board.test.ts b/admin-frontend-vue/tests/task-center-board.test.ts
index ab264daf6..b3063e8ab 100644
--- a/admin-frontend-vue/tests/task-center-board.test.ts
+++ b/admin-frontend-vue/tests/task-center-board.test.ts
@@ -281,7 +281,7 @@ test('task_center_page_handles_empty_and_error_states', () => {
const page = readSource(PAGE)
assert.match(page, /暂无符合条件的任务/, '任务空态')
assert.match(page, /暂无变体采集任务/, '变体空态:四态口径下不再限定「在跑」')
- assert.match(page, /ElMessage\.error/, '接口失败提示')
+ assert.match(page, /showAdminFeedback\([^\n]*, 'error'\)/, '接口失败提示走统一出口')
assert.match(page, /resetFilter/, '筛选重置接线')
assert.match(page, /@size-change="changeTaskSize"/, '分页每页条数切换')
assert.match(page, /@size-change="changeVariantSize"/, '变体分页每页条数切换')
diff --git a/admin-frontend-vue/tests/timer-cleanup-pairing.test.ts b/admin-frontend-vue/tests/timer-cleanup-pairing.test.ts
new file mode 100644
index 000000000..0f2f89a27
--- /dev/null
+++ b/admin-frontend-vue/tests/timer-cleanup-pairing.test.ts
@@ -0,0 +1,199 @@
+/**
+ * 定时器 / 事件监听的清理配对(四面9分口径 · 后管「稳定 7.0:定时器清理配对只有 2/4」)。
+ *
+ * 评审点名:`DedupeRegistryPage.vue`(导出秒表 setInterval + 导入轮询)与 `DuplicateCheckPage.vue`
+ * (toast 收尾 setTimeout)**没有 `onUnmounted`**——离开页面后定时器还在跑,每秒改一个没人看的 ref,
+ * 而导入轮询最多还会再打 300 拍。这一支把配对关系落成判据:
+ * ① 有 `setInterval(` 的文件必须同时有 `clearInterval(` 和一个卸载钩子;
+ * ② 有 `addEventListener(` 的文件必须同时有 `removeEventListener(` 和一个卸载钩子;
+ * ③ 一次性 `setTimeout(` 也要有配对,除非落在下面这张例外名单里(名单只许减,锚构造名不锚行号)。
+ * 光有 clearInterval 不算过:只在"用户点了取消"那条路径清理,页面被路由切走时照样漏。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readdirSync, statSync } from 'node:fs'
+import { join } from 'node:path'
+import { readSource } from './helpers.ts'
+
+/** 分母硬钉:2026-10-10 实测 setInterval 3 处、addEventListener 4 处、setTimeout 5 处。 */
+const REPEATING_SITE_FLOOR = 7
+/** 例外名单只许减:三条 sleep() 节拍原语。 */
+const LEDGER_CAP = 3
+
+const LEDGER: Array<{ file: string; construct: string; token: string; reason: string }> = [
+ {
+ file: 'src/pages/asin/DedupeRegistryPage.vue',
+ construct: 'function sleep(',
+ token: 'setTimeout(',
+ reason: 'sleep() 是导入进度轮询的一次性节拍原语,不重复自持;跨卸载的泄漏由本页 pageDisposed '
+ + '闸门收口(onUnmounted 里置位,pollImport 下一拍直接抛),所以这一处不需要 clearTimeout',
+ },
+ {
+ file: 'src/pages/asin/QueryAsinPage.vue',
+ construct: 'function sleep(',
+ token: 'setTimeout(',
+ reason: '同 DedupeRegistryPage 的轮询节拍原语;本页 importProgress 轮询用完后自行走完,'
+ + '未接卸载中断(本批次只登记不扩改),名单只许减',
+ },
+ {
+ file: 'src/pages/asin/SkipPricePage.vue',
+ construct: 'function sleep(',
+ token: 'setTimeout(',
+ reason: '同上:sleep() 节拍原语,卸载中断未接,登记在案等下一批收口',
+ },
+]
+
+const REPEATING: Array<{ token: string; mate: string; what: string }> = [
+ { token: 'setInterval(', mate: 'clearInterval(', what: '重复定时器' },
+ { token: 'addEventListener(', mate: 'removeEventListener(', what: '事件监听' },
+ { token: 'setTimeout(', mate: 'clearTimeout(', what: '一次性定时器' },
+]
+
+function codeOf(src: string): string {
+ return src.split('\n').filter((line) => !/^\s*(\/\/|\*|\/\*)/.test(line)).join('\n')
+}
+
+function hasHook(code: string): boolean {
+ return code.includes('onUnmounted(') || code.includes('onBeforeUnmount(')
+}
+
+/** 一个文件里未配对的定时器/监听(返回缺哪几条,空 = 过)。 */
+export function cleanupGaps(code: string, ledgerTokens: string[] = []): string[] {
+ const gaps: string[] = []
+ for (const { token, mate, what } of REPEATING) {
+ if (!code.includes(token)) continue
+ if (ledgerTokens.includes(token)) continue
+ if (!code.includes(mate)) gaps.push(`${what}:有 ${token} 却没有 ${mate}`)
+ if (!hasHook(code)) gaps.push(`${what}:${token} 所在文件没有 onUnmounted/onBeforeUnmount`)
+ }
+ return gaps
+}
+
+function sourceFiles(): string[] {
+ const out: string[] = []
+ const walk = (dir: string): void => {
+ for (const name of readdirSync(dir)) {
+ const abs = join(dir, name)
+ if (name.endsWith('.d.ts')) continue
+ if (statSync(abs).isDirectory()) walk(abs)
+ else if (name.endsWith('.vue') || name.endsWith('.ts')) out.push(abs.split(/[\\/]+/).join('/'))
+ }
+ }
+ walk('src')
+ return out
+}
+
+const FILES = sourceFiles()
+/** 例外只在「登记的那个构造确实还在文件里」时生效:删掉了 sleep 也等于删掉了这条豁免。 */
+const ledgerTokensFor = (rel: string, code: string): string[] =>
+ LEDGER.filter((e) => e.file === rel && code.includes(e.construct)).map((e) => e.token)
+const offenders = FILES
+ .map((rel) => {
+ const code = codeOf(readSource(rel))
+ return { rel, gaps: cleanupGaps(code, ledgerTokensFor(rel, code)) }
+ })
+ .filter((x) => x.gaps.length > 0)
+
+test('分母硬钉:重复定时器/监听的数量像被真的数到了', () => {
+ assert.ok(FILES.length >= 180, `只扫到 ${FILES.length} 个源文件`)
+ const sites = FILES.reduce((sum, rel) => {
+ const code = codeOf(readSource(rel))
+ return sum + (code.match(/setInterval\(/g) || []).length + (code.match(/addEventListener\(/g) || []).length
+ }, 0)
+ assert.ok(sites >= REPEATING_SITE_FLOOR,
+ `setInterval+addEventListener 只数到 ${sites} 处(阈值 ${REPEATING_SITE_FLOOR}):判据扫空了会把"漏清理"读成"没有定时器"`)
+})
+
+test('每处定时器/监听都有配对的清理 + 卸载钩子(名单外点名,名单只许减)', () => {
+ assert.ok(LEDGER.length <= LEDGER_CAP, `例外名单从 ${LEDGER_CAP} 涨到 ${LEDGER.length}:这条口径只许减`)
+ assert.deepEqual(offenders.map((x) => `${x.rel} -> ${x.gaps.join(';')}`), [],
+ `清理没配对的页面:\n${offenders.map((x) => `${x.rel}: ${x.gaps.join(';')}`).join('\n')}`)
+ // 名单里的每一条都要仍然成立:构造还在、文件确实还有裸 setTimeout。
+ for (const entry of LEDGER) {
+ const code = codeOf(readSource(entry.file))
+ assert.ok(code.includes(entry.construct), `${entry.file} 里已经找不到 ${entry.construct},这条登记该删`)
+ assert.ok(code.includes('setTimeout('), `${entry.file} 已无 setTimeout,这条登记该删`)
+ assert.ok(entry.reason.length >= 16, `${entry.file} 的例外理由没写清楚`)
+ }
+})
+
+/** 取 `onUnmounted(() => { ... })` 的钩子体(到配对的右括为止,最多 400 字符)。 */
+export function unmountHookBody(code: string): string {
+ const at = code.search(/on(?:Before)?Unmounted\(\s*\(\s*\)\s*=>\s*\{/)
+ if (at < 0) return ''
+ const open = code.indexOf('{', at)
+ let depth = 0
+ for (let i = open; i < code.length && i - open < 400; i++) {
+ if (code[i] === '{') depth += 1
+ else if (code[i] === '}') {
+ depth -= 1
+ if (depth === 0) return code.slice(open + 1, i)
+ }
+ }
+ return code.slice(open + 1, open + 400)
+}
+
+/** 找到某个本地函数体的文本(够用到 clearInterval 那一层即可)。 */
+function localFnBody(code: string, name: string): string {
+ const at = code.search(new RegExp(`function\\s+${name}\\s*\\(`))
+ if (at < 0) return ''
+ const open = code.indexOf('{', at)
+ let depth = 0
+ for (let i = open; i < code.length; i++) {
+ if (code[i] === '{') depth += 1
+ else if (code[i] === '}') {
+ depth -= 1
+ if (depth === 0) return code.slice(open + 1, i)
+ }
+ }
+ return ''
+}
+
+/** 卸载钩子真的把定时器收掉了?直接 clear 或调一个内部会 clear 的本地函数都算。 */
+export function hookClearsTimer(code: string): boolean {
+ const body = unmountHookBody(code)
+ if (!body) return false
+ if (/clear(Interval|Timeout)\(/.test(body)) return true
+ return [...body.matchAll(/(\w+)\(\)/g)]
+ .some((m) => /clear(Interval|Timeout)\(/.test(localFnBody(code, m[1])))
+}
+
+test('评审点名的两个文件确实补上了卸载钩子', () => {
+ for (const rel of ['src/pages/asin/DedupeRegistryPage.vue', 'src/pages/tasks/DuplicateCheckPage.vue']) {
+ const code = codeOf(readSource(rel))
+ assert.ok(hasHook(code), `${rel} 仍无 onUnmounted/onBeforeUnmount`)
+ assert.ok(hookClearsTimer(code), `${rel} 的卸载钩子里没有真的清定时器(直接 clear 或调会 clear 的本地函数都算)`)
+ }
+ // 去重页另外半边:离开页面后导入轮询必须自己收口,不然还会再打 300 拍。
+ const dedupe = codeOf(readSource('src/pages/asin/DedupeRegistryPage.vue'))
+ assert.match(dedupe, /pageDisposed = true/)
+ assert.match(dedupe, /if \(pageDisposed\) throw/)
+})
+
+test('非零对照:钩子只置个标志位、没清定时器,会被判不过', () => {
+ const fakeHook = `function stop() { /* 这里没清 */ }\n`
+ + `onUnmounted(() => { stop() })\n`
+ assert.equal(hookClearsTimer(fakeHook), false, '钩子调了个不清定时器的方法也算过 ⇒ 这条判据是软的')
+ const indirect = `function stop() { clearInterval(t) }\n`
+ + `onUnmounted(() => { stop() })\n`
+ assert.equal(hookClearsTimer(indirect), true, '间接清理要认:不然 stopExportWait() 那种写法会被误判')
+})
+
+test('非零对照:造一个只 setInterval 不清理的文件会被点名', () => {
+ const leaked = `const t = setInterval(() => tick(), 1000)\n`
+ assert.deepEqual(cleanupGaps(leaked), [
+ '重复定时器:有 setInterval( 却没有 clearInterval(',
+ '重复定时器:setInterval( 所在文件没有 onUnmounted/onBeforeUnmount',
+ ], '漏清理扫不出来 ⇒ 上面那条断言恒绿')
+
+ const hookless = `let t = null\nfunction go() { t = setInterval(() => tick(), 1000) }\nfunction stop() { clearInterval(t) }\n`
+ assert.deepEqual(cleanupGaps(hookless), ['重复定时器:setInterval( 所在文件没有 onUnmounted/onBeforeUnmount'],
+ '只在"点取消"那条路径清理、路由切走仍会漏,这种形态必须判不过')
+
+ const paired = `let t = null\nfunction go() { t = setInterval(() => tick(), 1000) }\n`
+ + `onUnmounted(() => { clearInterval(t) })\n`
+ assert.deepEqual(cleanupGaps(paired), [])
+
+ const listenerLeak = `window.addEventListener('resize', onResize)\n`
+ assert.equal(cleanupGaps(listenerLeak).length, 2, 'addEventListener 不配对同样要被抓到')
+})
|