Files
crawler-plugin/frontend-vue/tests/catch-silence-ratchet.test.ts
T
huangzd1997 a10aa6bda3 feat(用户端): 密钥设置面板 LLM 两卡加人民币余额行,与代理余量同形
现状纠偏(写死免得下次重研):桌面壳加载的是 frontend-vue 的 Vue SPA(app_client/blueprints/main.py:52 供产物、
config.py:96 WEB_HOME_URL 直载),所谓"客户端密钥设置"不在 Python 里;而密钥明文只在后端(前端手里只有掩码),
所以余额必须由后端查、前端不自打上游——本面只消费 GET /api/user-secrets/llm-balance。

- 新建 SecretBalanceRow.vue:根元素就是 <div class="secret-meta">,保住既有挂载测试按 .secret-meta 取数的断言不破;
  LLM 卡插一行、代理卡那 8 行 div 换成同一组件 ⇒ 两卡同形自动达成。面板 763→789 行,在 800 报警线内,
  可读棘轮基线不用动(该文件本就未点名)。
- 新建 shared/utils/llm-balance-text.ts(零依赖纯函数,node --test 直测)+ shared/composables/useLlmBalance.ts
  (按 moduleKey 存 items、三态文案、available=false 原样透出后端 message)。不引任何汇率乘算:绊线
  tests/llm-balance-text.test.ts 里钉住源码不得出现 7.2/per_usd 类字样——换算只在上游 credits.per_usd 里。
- loadLlmBalance() 移出 if (props.showProxy):原形状下 LLM 卡永远空白。刷新时机=挂载、保存该模块后、清空后、
  「检测已存值」后;⚠ 刻意不在「检测输入框未保存值」后刷——checkMyApiSecret(moduleKey,value) 探的是没落库的那把
  key,而余额读服务端已存密钥,刷出来是上一把 key 的钱挂在新渠道名下=串档形状(同一格绊线盯着这条)。
- 不动 ProxyBalanceAlert.vue / utils/proxy-balance-alert.ts:没要求告警,引阈值就是自造口径。
- 复用 jikip 那套 VO 的 surplus/scope/low 语义不 borrow 给 LLM(铁律 25):types/modules/user-secret.ts 里
  新类型与 :48-59 的 jikip VO 并置但互不相通。

测试:tests/llm-balance-text.test.ts 10 例(含源码绊线:面板行数<800、useLlmBalance 无汇率乘算、检测输入值路径
不触发 loadLlmBalance)+ tests/mount/密钥面板余额显示.mount.test.ts 11 例(两 LLM 卡各有 .secret-meta;龙抬头行
含 ¥+「龙抬头」、贞贞行含「不提供余额查询」且不含 ¥;两卡夹具给不同数字并交叉断言不互串;代理余量文案未变);
endpoints.test.ts 金样加一行;两支既有挂载夹具补 fetchLlmBalanceSafely 默认值。
catch-silence 棘轮:useLlmBalance.ts 那一枚 catch 的**首条语句是界面可见出口**(清空该 moduleKey 的展示),
console.warn 留在其后——按"首条即 log 才算静默"的口径它不该入账,实测入账了就把 blocks 311→312 如实登记并写明
理由,不删那个 catch(删了就是把失败读成"没有这一项")。vue-tsc rc=0、node --test 1018 例、vitest 66 例。
2026-11-05 12:03:14 +08:00

197 lines
14 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.
// catch 静默棘轮:只许减,不许增(四面9分口径 §2 用户端「错误静默」)。
//
// 口径与扫描器都在 tests/helpers/catch-silence-scanner.ts:按 AST 数 CatchClause,
// 静默=空块,或首条语句是 console.* 且整块没有 throw / 没有 ElMessage 这类用户可见出口。
// 与文档基线 292/81 的差别写在扫描器头注释里(grep 数不到无绑定的 `catch {`),这里钉实扫的 295/84。
// 跑法:npm test
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { fileURLToPath } from 'node:url'
import { dirname, resolve, relative, sep } from 'node:path'
import { listSourceFiles, readSource } from './helpers/task-terminal-ast-ruler.ts'
import { scanCatchSilence, toLedger, totals } from './helpers/catch-silence-scanner.ts'
const here = dirname(fileURLToPath(import.meta.url))
const root = resolve(here, '..')
const rel = (p: string) => relative(root, p).split(sep).join('/')
const SRC_FILES = listSourceFiles(resolve(root, 'src')).map(rel)
const BASELINE = {
// 296 = 实扫基线 295 + 1 处评审过的新增:
// kick-handler.ts 的 setAuthNotice()(67eb88cb)——localStorage.setItem/removeItem 在隐私模式
// 与配额满时真的会抛,兜法是先不落提示、返回「没提示」,属于可接受降级而不是吞掉错误;
// 同一批另两处(pywebview addEventListener 的外层兜底、isSessionExpiredNav 的外层兜底)挡的是
// 不可能发生的事(内层 lsGet 已自带兜底、URLSearchParams 对字符串永不抛),本轮直接摘掉,
// 所以这里只 +1 而不是 +3。静默数 silent 一格没动(仍 <=84),逐文件台账也对平。
// 299 = 298 + 桌面端铃铛 toggleGroup 的一支 try/catch(10-13 通知聚合改造):展开明细要单独发请求,
// 失败写进面板内 loadError(与列表加载同一个可见出口,不弹全局打扰),改前是"点了没反应"。
// silent 一格没涨:该支首条语句不是 console.*,且有可见出口。
// 300 = 299 + 损耗保护弹窗 resume() 的一支 try/catch(10-24 cost-guard):用户点「继续任务」
// 解闸失败时必须当场说清楚(console.warn 留链 + ElMessage.error 给用户),不能让按钮变成
// 「点了没反应」——这一支首条语句虽是 console.*,但块内有 ElMessage 用户可见出口,
// 按扫描器口径不算静默,所以 silent 一格没动、只进 blocks。
// 301 = 300 + 1 处分片上传的逐片重试(AC-17/S1-F3,src/shared/api/upload.ts::chunkedUpload):
// 单片网络抖动就地重试 2 次,仍失败就 DELETE 掉整个分片会话并把最后一次的真实错误上抛给调用方
// ——错误既没被吞也没被 console 糊过去(catch 体只做 `lastError = error`,片循环外 throw),
// 所以 silent 一格没涨,只进 blocks。断点探测那一步刻意没写 try/catch:问不到已达片号就当场
// 报错,不闷头把整包从 0 重传。
// 303 = 301 + 外观专利页恢复「本地采集」推送链(10-29 采集路由开关)新增的两支 try/catch:
// ① 外层包住取队列载荷 + 推送客户端,失败就地 ElMessage.error 报给用户;
// ② activate 被服务端拒绝(任务已被兜底拉取/Linux 领走)时 ElMessage.warning 并中止入队,
// 防同一任务执行两次。
// silent 一格没涨:两支都有用户可见出口,只进 blocks。
// 307 = 303 + 4(2026-10-31 v1.2 Phase 5.1 分片会话跨刷新续用,全部在 upload.ts):
// ① 读本地会话:JSON.parse/localStorage 抛错时按「无会话」处理;
// ② 写会话:隐私模式/配额满时放弃持久化,本次上传照常;
// ③ 清会话:清不掉只会让下次多问一次 status;
// ④ 已有会话探测失败:清状态重新 init(服务端回收后不重建会永久卡死)。
// 四支都不吞用户可见错误:失败只影响「跨刷新续传」这个可选优化,上传本身仍会抛给调用方。
// 308 = 307 + 1(2026-11-01 失败任务「重试」按钮,用户口径:失败不再自动克隆,改成
// 删除旁的重试按钮在原任务上续跑)。BrandAppearancePatentTab.vue 的 retryTaskRecord 包住
// 重试请求:失败 ElMessage.error 当场报给用户、成功 ElMessage.success 并刷新看板——不是吞错,
// silent 一格没涨,只进 blocks。
// 310 = 308 + 2(2026-11-01 失败任务重试按钮推广到同类模块):相似ASIN 与采集数据的
// retryTaskRecord 各一支 try/catch,失败 ElMessage.error 当场报给用户、成功 ElMessage.success
// 并刷新看板——与外观专利同口径,不是吞错;silent 一格没涨,只进 blocks。
// 311 = 310 + 1(2026-11-03 任务「中断」按钮):BrandAppearancePatentTab.vue 的
// interruptTaskRecord 包住中断请求,失败 ElMessage.error 当场报给用户、成功 ElMessage.success
// 并刷新看板——与 308 的 retryTaskRecord 同口径,不是吞错;两处 ElMessageBox.confirm 的
// 取消分支走 .then 两臂(确认框 reject 属正常交互),刻意不新增 catch 块。silent 一格没涨。
// 312 = 311 + 1(2026-11-05 B83 龙抬头余额进界面):useLlmBalance.ts 的 loadLlmBalance 包住
// 余额请求一支 try/catch。失败出口是**面板内那一行**(清空数字 ⇒ 渲染「这次没查到:接口没返回
// 可用值(不是欠费,也不是不支持)」),与代理余量同一口径;余额是打开面板时的附带读取,
// 弹全局打扰会把用户下一次正常操作也打断,所以刻意不 ElMessage。
// 按扫描器口径这一支不算静默(首条语句是状态写入、不是 console.*,console 只作留链),
// 所以 silent 一格没涨、逐文件台账不动,只进 blocks。
blocks: 312,
// 2026-10-30(ops Phase 6/可读棘轮):ApiSecretSettingsPanel.vue 1113→775 行,面板里那处
// 静默 catch(余额查询失败只 console.warn、界面留空)随 loadBalance 整块搬进
// useProxyPlan.ts。不是新增静默:面板 1→0、新文件记 1,silent 总数与 blocks 都一格没动,
// 属"给可读性让路"的逐条搬家记名。
// 298 = 296 + 全局错误出口 app-error.ts 的两支新 try/catch(10-09 装 app.config.errorHandler /
// window.onerror / unhandledrejection 时引入),两支都不是"吞":
// ① String(reason) 对无 toString 的对象/Symbol 会抛,兜法返回一句中文占位文本,
// 该文本随后可见(进界面提示 + 内存环 + 控制台);
// ② guardRun 挡的是"处理器自己崩了把页面带白屏",兜法是 console.error + 一次中文提示,
// 且刻意不向上重抛(重抛会让 Vue 再进一次同一个处理器)。
// silent 一格没涨(两支都有用户可见出口),台账无需新增条目。
// 83 = 10-13 面板状态机拆进 useNotificationBellPanel.ts 后的实扫值(原 84)。
// 拆分是为了 SFC 顶到可读棘轮的 800 行上限(1439 行 > 台账点名的 1318),不是冲静默来的:
// 铃铛那两处"有意静默降级"(轮询失败不亮红点、列表失败在面板内给文案)整块搬进了新文件,
// 逐文件台账跟着实况走——组件 3→0、新记 useNotificationBellPanel.ts=2,总数还比基线少 1。
// 81 = 本轮(更新客户端把在跑的任务列表抹空)修变体采集页时实扫的总数。
// 两处各减 1 的来源不同,分开记:
// ① BrandVariantTab.vue 的 loadTasks 把「桥未注入/无 uid/请求失败」四条无出口 return 与
// 那句空 catch 换成可见状态 + 首拉重试,静默 2→1(台账跟着改);
// ② 基线此前停在 83,而改动前实扫是 82——上一轮减下去没缩台账,本轮一并拉平到实扫值。
// blocks 一格没动:本轮没有新增 try/catch,只是给既有 catch 补了出口。
// 82 = 81 + 1 净增(2026-10-31 v1.2 Phase 5.1 分片会话续用):upload.ts 的 localStorage 写/清两处
// 为登记项(perFile 已记 2),另有一处分片状态探测失败改走 catch 后重建会话;同批把一处
// 分片重试 catch 改成无 catch 的直调,净 +1。三处的用户可见结果都不受影响。
silent: 82,
/** 逐文件台账:只钉总数与文件数两个标量的棘轮,会被「A 加一条 + B 减一条」整段绕过。 */
perFile: {
'src/pages/brand/components/BrandCollectDataTab.vue': 4,
'src/pages/brand/components/BrandConvertTab.vue': 1,
'src/pages/brand/components/BrandDedupeTab.vue': 1,
'src/pages/brand/components/BrandPriceTrackTab.vue': 8,
'src/pages/brand/components/BrandProductRiskTab.vue': 8,
'src/pages/brand/components/BrandPublishTab.vue': 2,
'src/pages/brand/components/BrandQueryAsinTab.vue': 1,
'src/pages/brand/components/BrandShopDataCrawlTab.vue': 1,
'src/pages/brand/components/BrandShopMatchTab.vue': 1,
'src/pages/brand/components/BrandSimilarAsinTab.vue': 1,
'src/pages/brand/components/BrandSplitTab.vue': 1,
'src/pages/brand/components/BrandVariantTab.vue': 1,
'src/pages/home/DesktopHomePage.vue': 1,
'src/pages/image-video/components/DeliveryVideoWorkspace.vue': 1,
'src/pages/login/DesktopLoginPage.vue': 12,
'src/pages/setup/DesktopSecretSetupPage.vue': 1,
'src/router/index.ts': 3,
'src/shared/api/http.ts': 1,
'src/shared/api/task-progress-polling.ts': 1,
// 2026-10-31 v1.2 Phase 5.1:分片会话跨刷新续用的 localStorage 读/写/清三处兜底。
// 隐私模式/配额满时 setItem/removeItem 会真抛,兜法是「本次上传照常、跨刷新续传降级」——
// 用户可见结果不受影响,也不该为一个可选优化打断上传。读分支自带 return 空串(扫描器不计静默),
// 写/清两支为空块,登记为 2 处;blocks 未涨过 303。
'src/shared/api/upload.ts': 2,
'src/shared/api/types/modules/permission.ts': 1,
'src/shared/auth/account-expiry.ts': 1,
'src/shared/auth/ensure-auth.ts': 1,
'src/shared/auth/kick-handler.ts': 4,
'src/shared/bridges/web-fallback.ts': 2,
'src/shared/components/ApiSecretSettingsPanel.vue': 0,
'src/shared/composables/useProxyPlan.ts': 1,
'src/shared/components/ExpiryNotice.vue': 2,
'src/shared/components/NotificationBell.vue': 0,
'src/shared/composables/useLiveTaskBoard.ts': 1,
'src/shared/composables/useNotificationBellPanel.ts': 2,
'src/shared/composables/useTaskProgressLoop.ts': 3,
'src/shared/composables/useVersionUpdate.ts': 1,
'src/shared/dispatch-guard-ui.ts': 1,
'src/shared/route-prefetch.ts': 1,
'src/shared/utils/api-secret-store.ts': 9,
'src/shared/utils/notification-bell.ts': 1,
'src/shared/utils/row-id.ts': 1,
} as Record<string, number>,
}
const scans = SRC_FILES.map((f) => scanCatchSilence(readSource(f, root), f))
const now = totals(scans)
const ledger = toLedger(scans)
test('分母自证:扫描器真的看见了整棵 src(分母塌了的话"≤基线"就是恒绿)', () => {
assert.ok(SRC_FILES.length > 100, `只扫到 ${SRC_FILES.length} 个文件,分母不对`)
assert.ok(SRC_FILES.some((f) => f.endsWith('.vue')), '.vue 没进分母就是漏扫')
assert.ok(now.blocks >= 250, `catch 块只数到 ${now.blocks} 个,与基线 ${BASELINE.blocks} 差得离谱 ⇒ 扫描器坏了,不是代码变好了`)
// 非零对照:已知藏着静默 catch 的文件必须被扫到,否则"0 处"没有意义
assert.ok(ledger['src/shared/utils/api-secret-store.ts'] > 0, 'api-secret-store.ts 的静默 catch 没被数到,扫描器口径失效')
assert.ok(ledger['src/pages/login/DesktopLoginPage.vue'] > 0, 'DesktopLoginPage.vue 的静默 catch 没被数到,扫描器口径失效')
})
test('静默 catch 只许减:总数与逐文件台账都不许超过基线', () => {
const worse: string[] = []
for (const [file, count] of Object.entries(ledger)) {
const allowed = BASELINE.perFile[file]
if (allowed === undefined) worse.push(`${file} 是新增静默 catch 的文件(${count} 处)`)
else if (count > allowed) worse.push(`${file} 从 ${allowed} 处涨到 ${count} 处`)
}
assert.deepEqual(worse, [], `新增了静默 catch,要么把错误报给用户、要么显式上抛:\n${worse.join('\n')}`)
assert.ok(now.silent <= BASELINE.silent,
`静默 catch 总数 ${now.silent} > 基线 ${BASELINE.silent};减下去了就把基线与台账一起改小`)
assert.ok(now.blocks <= BASELINE.blocks, `catch 块总数从 ${BASELINE.blocks} 涨到 ${now.blocks},新增 try/catch 要一并说明理由`)
})
test('扫描器先自证:新增一个空 catch 一定被数出来', () => {
const target = 'src/pages/brand/components/BrandCollectDataTab.vue'
const source = readSource(target, root).replace(/\r\n/g, '\n')
const anchor = 'function selectCountry(code: string) {'
assert.equal(source.split(anchor).length - 1, 1, '锚点不唯一,注入自证不作数')
const before = scanCatchSilence(source, target)
const injected = source.replace(anchor, 'function injectedProbeForRuler() {\n try { throw new Error("x") } catch { }\n}\n' + anchor)
assert.notEqual(injected, source, '注入没生效,这条自证是假的')
const after = scanCatchSilence(injected, target)
assert.equal(after.total, before.total + 1, '多出来的 catch 块没被数到分母')
assert.equal(after.silent.length, before.silent.length + 1, '多出来的空 catch 体没被数成静默')
assert.deepEqual(Object.entries(ledger).map(([f, c]) => [f, c]).filter(([f]) => f === target).map(([, c]) => c), [before.silent.length],
'台账与单文件复扫对不上')
})
test('扫描器的口径边界:console + throw、console + ElMessage 都不算静默', () => {
const cases: Array<[string, number]> = [
['try { f() } catch { }', 1],
['try { f() } catch (e) { console.log(e) }', 1],
['try { f() } catch (e) { console.error(e); throw e }', 0],
['try { f() } catch (e) { console.error(e); ElMessage.error("失败了") }', 0],
['try { f() } catch (e) { ElMessage.error(String(e)) }', 0],
['try { f() } catch (e) { retry() }', 0],
]
for (const [src, expected] of cases) {
const r = scanCatchSilence(src, '<内存口径>')
assert.equal(r.silent.length, expected, `口径判错:${src}(期望静默 ${expected},实测 ${r.silent.length})`)
assert.equal(r.total, 1, `catch 块分母判错:${src}`)
}
})