a10aa6bda3
现状纠偏(写死免得下次重研):桌面壳加载的是 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 例。
197 lines
14 KiB
TypeScript
197 lines
14 KiB
TypeScript
// 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}`)
|
||
}
|
||
})
|