Files
crawler-plugin/frontend-vue/tests/auth-token-key-single-source.test.ts
huangzd1997 3987b8d7fe 用户端(四面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。
2026-10-09 23:09:37 +08:00

111 lines
6.8 KiB
TypeScript
Raw Permalink 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.
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { readdirSync, readFileSync } from 'node:fs'
import { fileURLToPath } from 'node:url'
import { dirname, join, resolve, relative, sep } from 'node:path'
import { AUTH_TOKEN_KEY, AUTO_LOGIN_KEY, UID_KEY, USERNAME_KEY } from '../src/shared/auth/session-keys.ts'
/**
* 令牌键名收成 1 个常量(2026-10-09 评审安全面:`aiimage_auth_token` 有 4 处各自定义 + 2 处内联字符串)。
*
* 散着的键名不是风格问题:改名要同时命中 6 处,漏一处的表现是"登录成功但请求不带令牌"
* 或"下线了但旧键还留着令牌"。这里钉三件事:值本身、唯一定义点、以及每个消费点确实 import 它。
*
* 键值改动要连着后端与已发布客户端一起改,所以值也钉住(不是恒绿断言,是防手滑)。
*/
const here = dirname(fileURLToPath(import.meta.url))
const ROOT = resolve(here, '..')
const SRC = resolve(ROOT, 'src')
/** 令牌键的字面量写法(单/双引号都算,反引号也算)。 */
const TOKEN_LITERAL = /['"`]aiimage_auth_token['"`]/
/** 定义点:`const|export const 名字 = 'aiimage_auth_token'`。 */
const TOKEN_DEFINITION = /\b(?:export\s+)?const\s+[A-Za-z0-9_]+\s*=\s*['"`]aiimage_auth_token['"`]/
/** 应当引用统一常量的消费点(构造名做锚点,不锚行号)。 */
const CONSUMERS: Array<{ file: string; importOf: RegExp; construct: RegExp }> = [
{ file: 'src/shared/api/http.ts', importOf: /import\s*\{[^}]*AUTH_TOKEN_KEY[^}]*\}\s*from\s*'\.\.\/auth\/session-keys\.ts'/, construct: /localStorage\.getItem\(AUTH_TOKEN_KEY\)/ },
{ file: 'src/shared/api/types/modules/permission.ts', importOf: /import\s*\{[^}]*AUTH_TOKEN_KEY[^}]*\}\s*from\s*'\.\.\/\.\.\/\.\.\/auth\/session-keys\.ts'/, construct: /function getAuthToken\(\)/ },
{ file: 'src/shared/auth/ensure-auth.ts', importOf: /import\s*\{[^}]*AUTH_TOKEN_KEY[^}]*\}\s*from\s*'\.\/session-keys\.ts'/, construct: /export async function ensureAuth\(\)/ },
{ file: 'src/shared/auth/kick-handler.ts', importOf: /import\s*\{[^}]*AUTH_TOKEN_KEY[^}]*\}\s*from\s*'\.\/session-keys\.ts'/, construct: /function clearLocalSession\(\)/ },
{ file: 'src/shared/auth/user-token-sync.ts', importOf: /import\s*\{[^}]*AUTH_TOKEN_KEY[^}]*\}\s*from\s*'@\/shared\/auth\/session-keys\.ts'/, construct: /function readToken\(\)/ },
{ file: 'src/pages/login/DesktopLoginPage.vue', importOf: /import\s*\{[^}]*AUTH_TOKEN_KEY[^}]*\}\s*from\s*'@\/shared\/auth\/session-keys'/, construct: /async function submitLogin|void loginWithDevice|setItem\(AUTH_TOKEN_KEY/ },
]
function sourceFiles(dir: string): string[] {
const out: string[] = []
for (const entry of readdirSync(dir, { withFileTypes: true })) {
const full = join(dir, entry.name)
if (entry.isDirectory()) out.push(...sourceFiles(full))
else if (entry.name.endsWith('.vue') || entry.name.endsWith('.ts')) out.push(full)
}
return out
}
function read(relFromRoot: string): string {
return readFileSync(join(ROOT, ...relFromRoot.split('/')), 'utf-8')
}
/** 找出"字面量出现在统一出口之外"的文件(判据与注入自证共用同一个函数)。 */
function literalOutsideSingleSource(entries: Array<{ rel: string; source: string }>): string[] {
return entries
.filter(({ rel, source }) => rel !== 'src/shared/auth/session-keys.ts' && TOKEN_LITERAL.test(source))
.map(({ rel, source }) => `${rel}: ${source.split(/\r?\n/).find((line) => TOKEN_LITERAL.test(line))?.trim().slice(0, 100)}`)
}
const ENTRIES = sourceFiles(SRC).map((file) => ({
rel: relative(ROOT, file).split(sep).join('/'),
source: readFileSync(file, 'utf-8'),
}))
test('键名常量本身:值与形状钉住(改名要连着后端和已发布客户端,不是随手能动的)', () => {
assert.equal(AUTH_TOKEN_KEY, 'aiimage_auth_token')
assert.equal(UID_KEY, 'uid')
assert.equal(USERNAME_KEY, 'username')
assert.equal(AUTO_LOGIN_KEY, 'aiimage_auto_login')
})
test('全树只有 session-keys.ts 一处定义令牌键名,内联字面量清零', () => {
const definitions = ENTRIES.filter(({ source }) => TOKEN_DEFINITION.test(source))
assert.deepEqual(definitions.map(({ rel }) => rel), ['src/shared/auth/session-keys.ts'],
`令牌键名的定义点应当只有一个,实测:${definitions.map(({ rel }) => rel).join(', ')}`)
assert.deepEqual(literalOutsideSingleSource(ENTRIES), [], '这些地方还在自己写令牌键名')
})
test('分母自证:扫描器真的在扫整棵树(命中数塌了就不许报"清零")', () => {
const literalSites = ENTRIES.filter(({ source }) => TOKEN_LITERAL.test(source)).length
assert.ok(literalSites >= 1, `全树连一处令牌键名字面量都没扫到——扫描器或目录树坏了,"零违规"不作数`)
assert.ok(ENTRIES.length > 100, `只扫到 ${ENTRIES.length} 个源文件,分母不对`)
const importSites = ENTRIES.filter(({ source }) => /AUTH_TOKEN_KEY/.test(source)).length
assert.ok(importSites >= 7, `只有 ${importSites} 个文件提到 AUTH_TOKEN_KEY(定义 + 6 个消费点,下限 7)——引用没接上`)
// 定义点自己必须带着那个值(防止有人把 session-keys 掏空来"清零"字面量)
const sessionKeys = read('src/shared/auth/session-keys.ts')
assert.match(sessionKeys, /export const AUTH_TOKEN_KEY = 'aiimage_auth_token'/)
})
test('6 个消费点确实 import 统一常量,没有本地副本', () => {
const problems: string[] = []
for (const { file, importOf, construct } of CONSUMERS) {
const source = read(file)
if (!importOf.test(source)) problems.push(`${file} 没有 import 统一的 AUTH_TOKEN_KEY`)
if (!construct.test(source)) problems.push(`${file} 的锚点构造没找到(改形状了,判据要跟着改)`)
if (/\bconst\s+AUTH_TOKEN_KEY\s*=/.test(source)) problems.push(`${file} 还留着自己的 AUTH_TOKEN_KEY 定义`)
}
assert.deepEqual(problems, [], problems.join('\n'))
})
test('注入自证:往消费点塞一条内联字面量一定被判红', () => {
const target = ENTRIES.find(({ rel }) => rel === 'src/shared/api/http.ts')
assert.ok(target, 'http.ts 没进分母')
const anchor = 'const token = window.localStorage.getItem(AUTH_TOKEN_KEY) || \'\''
assert.equal(target.source.split(anchor).length - 1, 1, '锚点不唯一,注入自证不作数')
const injected = target.source.replace(anchor, "const token = window.localStorage.getItem('aiimage_auth_token') || ''")
assert.notEqual(injected, target.source, '注入没生效,这条自证是假的')
assert.deepEqual(literalOutsideSingleSource([{ rel: target.rel, source: injected }]), [`${target.rel}: ${injected.split(/\r?\n/).find((l) => TOKEN_LITERAL.test(l))?.trim().slice(0, 100)}`],
'内联字面量没被抓出来')
// 合法写法(引用常量)必须放得过
assert.deepEqual(literalOutsideSingleSource([{ rel: target.rel, source: target.source }]), [])
})