用户端(四面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
+57
View File
@@ -0,0 +1,57 @@
/**
* 登录态门禁判定(收口 2026-10-09 评审「只要 localStorage 里有 uid 就短路免校验」)。
*
* 原写法:`if (rawUid && Number(rawUid) > 0) return true`——uid 是本机唯一的登录证据时,
* 令牌没了、令牌过期了都能直接进页面,直到某个接口 401 才被踢回去;界面上的表现是"页面打开后一片报错"。
*
* 但不能硬删:桌面端与线上 Web 同源,`http.ts` 里 `withCredentials: true`,
* Java 侧的同源会话 cookie 仍然算登录(注释原话"桌面端同源 cookie 仍可用"),
* 这种形态本地只有 uid、没有 JWT。直接改成"无令牌即拒"会把这类合法入口锁在登录页外。
*
* 所以收窄而不是删除:**只有 uid + 令牌同时存在**才免掉一次 `/newApi/check_login`
* (令牌本身每次请求都要过后端,门禁这里省的只是那一次往返);
* 只有 uid(cookie 形态)或只有令牌 → 一律走服务端校验;两者都没有 → 拒。
*
* 判据:tests/uid-bypass-ledger.test.ts(真值表行为钉子 + 免校验例外名单 + 新增例外就红)。
*/
/** 'pass-local'=本机证据齐、免一次服务端校验;'restore'=要问服务端;'deny'=直接回登录页。 */
export type AuthGateDecision = 'pass-local' | 'restore' | 'deny'
export interface AuthGateState {
/** localStorage 里的 uid 原值 */
uid?: string | null
/** localStorage 里的登录令牌原值 */
token?: string | null
}
/** uid 是否成形:非空且是正整数('0'、''、'abc'、NaN 都不算登录过)。 */
export function hasUsableUid(uid?: string | null): boolean {
const raw = typeof uid === 'string' ? uid.trim() : ''
if (!raw) return false
const value = Number(raw)
return Number.isFinite(value) && value > 0
}
/** 令牌是否成形:非空字符串。是否有效不由这里判(后端才是唯一裁判)。 */
export function hasUsableToken(token?: string | null): boolean {
return typeof token === 'string' && token.trim() !== ''
}
/** 门禁判定:唯一致力于"能不能不进登录页"的函数,别处不许再自己拼 uid 条件。 */
export function decideAuthGate(state: AuthGateState): AuthGateDecision {
const uidOk = hasUsableUid(state.uid)
const tokenOk = hasUsableToken(state.token)
if (uidOk && tokenOk) return 'pass-local'
if (uidOk || tokenOk) return 'restore'
return 'deny'
}
/**
* 已登录用户访问登录页要不要送回首页(main.ts 的第二处 uid 判断)。
* 送回的条件与门禁同源:本机证据齐才拦;只有 uid(要问服务端)时把登录页留给用户,
* 否则令牌一丢就永远点不开登录页,只能靠 URL 上的 logout/switch 参数自救。
*/
export function shouldBounceToHome(state: AuthGateState): boolean {
return decideAuthGate(state) === 'pass-local'
}
+17 -17
View File
@@ -3,18 +3,18 @@
*
* SPA 化后由 src/main.ts 的路由守卫调用;本模块只做检查与 uid/username 恢复,
* 不主动跳转(跳转统一由 router.beforeEach 返回 { name: 'login' })。
* - localStorage.uid 已存在(桌面注入 / 登录页已写入)→ 直接放行,零额外请求;
* - 无 uid 但有 JWT → 调 /newApi/check_login 恢复 uid/username;
* - 无 token 或校验失败 → 返回 false,由守卫跳转登录页。
* 放行条件由 shared/auth/auth-gate.ts 单点判定,不再"看见 uid 就免校验":
* - uid 与令牌都在(登录页 / 上一次校验已写全)→ 直接放行,零额外请求;
* - 只有 uid(桌面端同源 cookie 形态)或只有 JWT → 调 /newApi/check_login 校验并恢复 uid/username;
* - 两者都没有或校验失败 → 返回 false,由守卫跳转登录页。
*/
import { get } from '@/shared/api/http'
import { decideAuthGate } from './auth-gate.ts'
import { AUTH_TOKEN_KEY, UID_KEY } from './session-keys.ts'
import { writeCompanyIdentity } from './company-identity'
import { writeAccountExpiry } from './account-expiry'
const AUTH_TOKEN_KEY = 'aiimage_auth_token'
const UID_KEY = 'uid'
interface CheckLoginData {
userId?: number | string
username?: string
@@ -26,12 +26,14 @@ interface CheckLoginData {
export async function ensureAuth(): Promise<boolean> {
if (typeof window === 'undefined') return true
try {
const rawUid = window.localStorage.getItem(UID_KEY) || ''
if (rawUid && Number(rawUid) > 0) {
const decision = decideAuthGate({
uid: window.localStorage.getItem(UID_KEY),
token: window.localStorage.getItem(AUTH_TOKEN_KEY),
})
if (decision === 'pass-local') {
return true
}
const token = window.localStorage.getItem(AUTH_TOKEN_KEY) || ''
if (!token) {
if (decision === 'deny') {
return false
}
const response = await get<{ success: boolean; data?: CheckLoginData }>('/newApi/check_login')
@@ -63,13 +65,11 @@ export async function ensureAuth(): Promise<boolean> {
export async function restoreLoginUser(): Promise<{ username?: string } | null> {
if (typeof window === 'undefined') return null
try {
const rawUid = window.localStorage.getItem(UID_KEY) || ''
if (rawUid && Number(rawUid) > 0) {
// 已有 uid(桌面端注入或登录页已写)无需再查
return null
}
const token = window.localStorage.getItem(AUTH_TOKEN_KEY) || ''
if (!token) {
const decision = decideAuthGate({
uid: window.localStorage.getItem(UID_KEY),
token: window.localStorage.getItem(AUTH_TOKEN_KEY),
})
if (decision === 'pass-local' || decision === 'deny') {
return null
}
const response = await get<{ success: boolean; data?: CheckLoginData }>('/newApi/check_login')
+1 -5
View File
@@ -10,11 +10,7 @@
import { COMPANY_NAME_STORAGE_KEY } from './company-identity.ts'
import { ACCOUNT_EXPIRY_STORAGE_KEY } from './account-expiry.ts'
const AUTH_TOKEN_KEY = 'aiimage_auth_token'
const UID_KEY = 'uid'
const USERNAME_KEY = 'username'
const AUTO_LOGIN_KEY = 'aiimage_auto_login'
import { AUTH_TOKEN_KEY, UID_KEY, USERNAME_KEY, AUTO_LOGIN_KEY } from './session-keys.ts'
/** 登录页据此标记显示"已被顶下线"警示(路由守卫会吞掉 query,故用 localStorage 兜底)。 */
export const KICK_NOTICE_KEY = 'aiimage_kick_notice'
@@ -0,0 +1,21 @@
/**
* 登录态存储键的唯一出处(收口 2026-10-09 评审「令牌键名 4 处各自定义 + 2 处内联」)。
*
* 令牌键名以前散在 DesktopLoginPage / ensure-auth / kick-handler / user-token-sync 四份常量与
* http.ts / permission.ts 两处内联字符串里:改名要同时命中 6 处,漏一处就是"登了又没完全登"
* (拦截器读不到令牌、下线收口清不掉旧键)。这里只留一份定义,其余一律 import。
*
* 判据:tests/auth-token-key-single-source.test.ts(全树字面量清零 + 非零对照 + 分母自证)。
*/
/** 登录令牌(JWT)在 localStorage 里的键名。 */
export const AUTH_TOKEN_KEY = 'aiimage_auth_token'
/** 当前登录用户 id;Java 侧按它选代理池、拼公开直链的 user_id。 */
export const UID_KEY = 'uid'
/** 当前登录用户名,仅用于界面展示。 */
export const USERNAME_KEY = 'username'
/** 是否自动登录('0' = 关)。被顶下线/登录失效时必须关掉,否则两台机器互踢不停。 */
export const AUTO_LOGIN_KEY = 'aiimage_auto_login'
@@ -1,5 +1,6 @@
import { getPywebviewApi } from '@/shared/bridges/pywebview'
import { setUserTokenPushTarget, syncUserTokenToBridge } from '@/shared/auth/user-token-bridge'
import { AUTH_TOKEN_KEY } from '@/shared/auth/session-keys.ts'
/**
* 把登录态令牌持续同步给桌面端 Python(A1/A3)。
@@ -7,12 +8,18 @@ import { setUserTokenPushTarget, syncUserTokenToBridge } from '@/shared/auth/use
* 触发点:应用启动(桥可能未就绪,监听 pywebviewready 后补推)、localStorage 变化(登录/登出)、
* 以及每 60 秒兜底轮询(同标签页内 localStorage 变化不触发 storage 事件)。
* 网页形态(无桥)静默跳过。
*
* 卸载配对:三个注册点(2 个 window 监听 + 1 个轮询定时器)的句柄都留在模块里,
* `uninstallUserTokenSync()` 逐个摘掉;由根组件 App.vue 的 onBeforeUnmount 调用,
* 判据见 tests/listener-timer-pairing.test.ts。
*/
const AUTH_TOKEN_KEY = 'aiimage_auth_token'
const POLL_INTERVAL_MS = 60_000
let installed = false
let readyHandler: (() => void) | null = null
let storageHandler: ((event: StorageEvent) => void) | null = null
let pollTimer: ReturnType<typeof setInterval> | null = null
function readToken(): string {
try {
@@ -50,11 +57,34 @@ export function installUserTokenSync(): void {
// 桥可能晚于脚本就绪:先尝试一次,再在 ready 事件与轮询里补
apply()
window.addEventListener('pywebviewready', apply)
window.addEventListener('storage', (event) => {
readyHandler = apply
window.addEventListener('pywebviewready', readyHandler)
storageHandler = (event: StorageEvent) => {
if (!event.key || event.key === AUTH_TOKEN_KEY) {
pushNow()
}
})
window.setInterval(pushNow, POLL_INTERVAL_MS)
}
window.addEventListener('storage', storageHandler)
pollTimer = window.setInterval(pushNow, POLL_INTERVAL_MS)
}
/** 卸载:摘掉两个监听并停掉兜底轮询(与 installUserTokenSync 配对,可重复调用)。 */
export function uninstallUserTokenSync(): void {
if (typeof window === 'undefined') {
return
}
if (readyHandler) {
window.removeEventListener('pywebviewready', readyHandler)
readyHandler = null
}
if (storageHandler) {
window.removeEventListener('storage', storageHandler)
storageHandler = null
}
if (pollTimer !== null) {
window.clearInterval(pollTimer)
pollTimer = null
}
setUserTokenPushTarget(null)
installed = false
}