用户端(四面9分批次): 三条全局错误出口、URL 白名单收口、令牌键单点、uid 短路进门禁

- 此前全树 0 处全局错误处理器:装 app.config.errorHandler + window error + unhandledrejection,
  每条都留可诊断记录、界面只出中文、处理器自身异常不重抛也不白屏(9 例判据)。
- safeHttpUrl 未覆盖的 3 处(两个品牌 Tab 与 useVersionUpdate 直装服务端 file_url)收口;
  令牌键 aiimage_auth_token 由 4 处各自定义 + 2 处内联收成唯一定义点。
- 「localStorage 有 uid 就免校验」改走 auth-gate 单点,剩余例外台账化且同口径必须能抓到
  评审点名的原写法(6 例);卸载配对 3 处补齐 + 全树判据(7 例)。
- task-status-text 把 CANCELLED 显示成"执行中"改对,CANCELED/CANCELLED 两拼写都映射(4 例)。
- 主审计补的四处修复:新判据里两处拿数组和 0 比(怎么写都红);静默 catch 的"用户可见出口"
  符号表认不出本仓 userNotice 与注入式 notify,把真报了用户的 catch 判成静默;
  新错误出口带来的 2 个 try/catch 按棘轮合同写理由进基线(296→298,silent 一格没涨)。
- 验收:node --test 820 例 0 红、npx vue-tsc --noEmit rc=0。
This commit is contained in:
2026-10-09 23:09:37 +08:00
parent 8776a9bf1e
commit 3987b8d7fe
27 changed files with 1701 additions and 49 deletions
@@ -1,6 +1,7 @@
import { computed, reactive } from 'vue'
import { getPywebviewApi } from '@/shared/bridges/pywebview'
import { isHttpUrl } from './safe-url'
export type DownloadProgressStatus = 'selecting' | 'running' | 'success' | 'failed' | 'cancelled'
@@ -98,7 +99,24 @@ export function ensureDownloadProgressListener() {
if (progressListenerBound || typeof window === 'undefined') return
progressListenerBound = true
window.addEventListener('pywebview-download-progress', handlePywebviewProgress)
}export function useDownloadProgress() {
}
/**
* 与 ensureDownloadProgressListener 配对的卸载出口:摘掉桥事件监听并停掉清扫定时器。
* 由根组件 App.vue 的 onBeforeUnmount 调用(判据见 tests/listener-timer-pairing.test.ts)。
*/
export function disposeDownloadProgressListener() {
if (typeof window !== 'undefined' && progressListenerBound) {
window.removeEventListener('pywebview-download-progress', handlePywebviewProgress)
progressListenerBound = false
}
if (sweepTimer !== null) {
clearInterval(sweepTimer)
sweepTimer = null
}
}
export function useDownloadProgress() {
ensureDownloadProgressListener()
const items = computed(() =>
Object.values(progressItems)
@@ -120,8 +138,26 @@ function buildDownloadId(filename: string) {
return `download:${Date.now()}:${Math.random().toString(16).slice(2)}:${safeName}`
}
/** 白名单不通过时的统一说法:进度条目与返回值都用这一句(中文,用户读得懂)。 */
const UNSAFE_DOWNLOAD_URL_TEXT = '下载地址不可用,请稍后重试或在本机客户端中打开'
export async function saveUrlWithProgress(url: string, filename: string, id = buildDownloadId(filename)) {
ensureDownloadProgressListener()
// 服务端/客户端透传的 file_url、downloadUrl 是开放字段,进桥之前先过白名单:
// 校验不过就不发起下载,原因既落进度条目也进控制台留一行可查的记录(判据:tests/url-outlet-guard.test.ts)
if (!isHttpUrl(url)) {
console.warn('[safe-url] 下载地址未通过白名单校验,已取消下载:', String(url).slice(0, 200))
upsertProgress({
id,
filename,
status: 'failed',
downloaded: 0,
total: 0,
percent: 0,
error: UNSAFE_DOWNLOAD_URL_TEXT,
})
return { success: false, error: UNSAFE_DOWNLOAD_URL_TEXT }
}
const api = getPywebviewApi()
if (!api?.save_file_from_url_new) {
upsertProgress({