Files
xiaoyin-gateway/frontend/scripts/check-i18n.mjs
T
api-gateway 0bf607e35f 第三十轮: 全面体检发现项全部修 —— 下载白名单/视频归属/会话落盘/i18n 收口/口令下限
老板对上一轮「只查未改」的体检清单回「全部」,逐项修完并直接上生产验证。

P0 产物下载白名单(实测复现的真 bug)
- Agnes 水印版产物走另一个 CDN(maas-watermark-prod-new.cn-wlcb.ufileos.com),
  download.allowed_hosts 只有普通版域名 → admin 老产物点「下载」必 400。
- 补域名;yaml + README 写明这张表是出网白名单、换 CDN 要同步维护。
- 生产实测:水印图下载 200 / 129871 bytes(改前 400);非白名单域名仍 400。

视频任务归属(新增 app/video_owners.py)
- GET /v1/videos/{id} 原先不判归属,任何登录账号拿到 id 就能读别人任务状态与产物 URL。
- 创建成功时登记 video_id→账号,轮询判权:他人 404(不用 403,避免 id 变存在性探针)、
  admin 放行、无登记的老任务放行(渐进收紧)。落盘 data/video_owners.json(600/TTL 7 天)。

登录会话落盘(app/sessions.py)
- 原先纯内存 → 每次重启全体被踢;现在 data/sessions.json:只存 token 的 sha256、
  原子写 + 600、写失败只告警、载入丢过期。吊销语义不变且吊销也落盘。
- 生产实测:登录拿 token → 重启 → 同一 token 仍 200;文件里不含明文 token。

口令下限 4→8(app/users.py)
- 只作用于「显式给密码/事后改密」;登录不判长度,既有短口令账号照常登。

/config/env 值校验
- 拒绝 \n / \r / \x00 与 >4096(带换行的值能在 .env 里凭空多出几行改掉别的变量)。
- 生产实测 400 且 md5(data/.env) 未变。

其它后端/一致性
- history 四个端点补 _offload(整份读写 ≤4MB,此前是唯一还在事件循环里同步跑的 IO)。
- /health/{provider} 注释更正:一直是 require_auth(恒定鉴权、不随 health_auth 放宽)。
- GET / 导航的 docs 一行改为仅在 docs_enabled 时列出;FastAPI 描述补 OpenCode Go。
- _req_headers 陈旧注释、_media_headers 与测速探针的「有意随机 session」注明。
- app/settings.py 备份写完显式 chmod 600(copy2 会照抄源的 644)。

前端 i18n 收口
- Videos 素材摘要 / lib/upload.ts 全部报错 / charts.ts 空态 → i18n(中英 737/737)。
- 删除 router.ts 中无人消费的 meta.title(只有中文的死元数据)。
- check-i18n.mjs 新增「硬编码中文」扫描(剥注释后扫字符串字面量,允许清单只放语言自称)。

文档 / 基建
- README:.env 补 OPENCODE_API_KEY、两层 .env 的 override 关系、auth.users 死引用、
  「自动路由」措辞、下载白名单维护、密码 8 位、测试计数 165→179。
- .env.example 重写(删 B_AI_API_KEY、补 OPENCODE 与全部可覆盖路径)。
- Makefile:lint 改 compileall(原手写清单漏了 6 个模块);test 注释改实话(环境无 pytest)。
- .gitignore 补 6 项;data/gateway.yaml*.bak 三个文件 git rm --cached(本地保留)。
- 新增 scripts/ci_check.sh:一条命令跑完 compileall + 单测 + i18n/SVG 体检 + vue-tsc + build。
- flake8 --select=F,E9 清到 0。

测试
- 179 passed / 0 failed(173→179)。新增会话落盘/过期丢弃、视频归属语义 + 端点级 404、
  env 值校验 + 沙箱写、口令下限。
- 修隐患:新增 GATEWAY_ENV_FILE 覆盖 —— 此前测试若覆盖写路径会直接改生产 data/.env。

CSP 结论
- 实测(A/B):去掉 'unsafe-eval' 后登录页 #app 全空、表单不渲染;根因是 vue-i18n 运行时
  消息编译器(打包产物里唯一一处 new Function)。正解是构建期预编译文案,不是放宽 CSP。
2026-09-18 22:45:20 +08:00

172 lines
7.5 KiB
JavaScript
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.
// 文案体检(build 前置校验,第二十三轮补)
//
// 为什么需要它:vue-i18n 把文案里的 {...} 当占位符解析。踩过的坑 —— 一条提示文案写了
// `{"status":"ok"}`,编译器把它当占位符、报 "Invalid token in placeholder",而这条错误
// 是"渲染时才编译"时抛的:用到这条文案的整块界面直接不渲染,控制台里也只是一条 Vue 错误,
// 表现看起来像"这个页签/卡片挂了"(当时误判成 Element Plus 的 pane 机制问题,查了两轮)。
// 现在 build 前先把两份文案逐条过一遍,类似的写法在构建阶段就被拦下。
//
// 另外顺手核三件小事(都是会出现"界面里冒出 nav.xxx 原始键名"的原因):
// 1. 中英两份键完全对称;2. 同一个对象里没有重复键;3. 没有空文案。
//
// 第三十轮追加第四件:**源码里的硬编码中文**。
// 体检的由头是 Videos.vue 的素材摘要(`首帧:xx.png`)和 lib/upload.ts 的一串报错,
// 全都是写死的中文 —— 切到英文后这些地方照旧中文,肉眼很难在一个大页面里发现。
// 规则:src 下(locales 除外)**字符串字面量**里出现中日韩统一表意文字就报错;
// 注释里的中文不算(本项目注释大量中文,且注释本来就不该翻)、模板里的纯文字节点不算
// (那是语言切换器自己要显示的「中文」,按惯例各语言写给自己的名字)。
//
// 只依赖 Node 内置模块:不引第三方解析器,规则显式写在下面,谁都能看懂。
import fs from 'node:fs'
import path from 'node:path'
const ROOT = path.resolve(import.meta.dirname, '..')
const FILES = { zh: 'src/locales/zh.ts', en: 'src/locales/en.ts' }
// 占位符第一个字符的合法集合:{name} {0} {n} {@.upper:name} {'字面量'} {-1}
const OK_FIRST = /[A-Za-z0-9_$@'\u4e00-\u9fa5-]/
/** 逐行解析 locale 文件(2 空格缩进 + `key: '...'`)→ { `a.b.c`: [值, 行号] } */
function parseLocale(file) {
const out = new Map()
const dup = []
const stack = [] // [{ indent, key }]
const abs = path.join(ROOT, file)
const lines = fs.readFileSync(abs, 'utf8').split('\n')
lines.forEach((raw, i) => {
const line = raw.replace(/\s+$/, '')
const m = line.match(/^(\s*)([A-Za-z0-9_$]+):\s*(.*)$/)
if (!m) return
const indent = m[1].length
const key = m[2]
const rest = m[3]
while (stack.length && stack[stack.length - 1].indent >= indent) stack.pop()
if (rest === '{') { // 开一个子对象
stack.push({ indent, key })
return
}
// 字符串值(单/双引号都认;允许行尾逗号)。注意要认得"这条文案里带 {'{'} 字面量花括号时
// 只能用双引号写"的情况,否则这条文案会被跳过、体检等于没查。
const sm = rest.match(/^(['"])(.*)\1(,?)$/)
if (!sm) return // 其它形态(注释、非字符串)不检查
const full = [...stack.map((s) => s.key), key].join('.')
if (out.has(full)) dup.push(`${full}(第 ${out.get(full)[1]} 行 与 第 ${i + 1} 行)`)
else out.set(full, [unescape(sm[2]), i + 1])
})
return { map: out, dup }
}
function unescape(s) {
return s.replace(/\\(.)/g, (_, c) => (c === 'n' ? '\n' : c))
}
/** 扫一条文案里的花括号,返回问题列表 */
function checkBraces(value) {
const bad = []
for (let i = 0; i < value.length; i++) {
const ch = value[i]
if (ch === '}') { bad.push('有一个多余的 }'); continue }
if (ch !== '{') continue
const next = value[i + 1]
if (next === undefined) { bad.push('{ 没有收尾的 }'); continue }
if (!OK_FIRST.test(next)) {
bad.push(`{ 后面跟着 ${JSON.stringify(value.slice(i, i + 20))} —— vue-i18n 会把 {...} 当占位符,` +
`花括号要写成 {'{'} / {'}'} 才能当普通字符用`)
continue
}
// 找到配对的 },期间不允许再出现 {(vue-i18n 不支持嵌套占位符)
let j = i + 1
let quoted = false
for (; j < value.length; j++) {
const c = value[j]
if (c === "'") quoted = !quoted
else if (!quoted && c === '{') { bad.push(`占位符里又出现了 {(不支持嵌套):${JSON.stringify(value.slice(i, j + 10))}`); break }
else if (!quoted && c === '}') break
}
if (j >= value.length) { bad.push(`{ 没有收尾的 }:${JSON.stringify(value.slice(i, i + 20))}`); continue }
if (j === i + 1) bad.push('{} 是空占位符')
i = j
}
return bad
}
// ── 硬编码中文扫描(第三十轮)──────────────────────────────
const CJK = /[\u4e00-\u9fa5]/
/** 允许出现的硬编码中文(逐条写上理由,别用"通配"把整类放过) */
const CJK_ALLOW = new Map([
// 登录页右上角的语言切换:写的是**中文这门语言自己的名字**,切到英文界面也该显示「中文」
['views/Login.vue::中', '语言切换按钮上的语言自称(各语言写自己的名字)'],
])
function walk(dir) {
return fs.readdirSync(dir, { withFileTypes: true }).flatMap((e) => {
const p = path.join(dir, e.name)
return e.isDirectory() ? walk(p) : [p]
})
}
/** 去掉注释(块注释 / HTML 注释 / 行注释 —— 行注释要避开 `https://` 里的两个斜杠) */
function stripComments(code) {
return code
.replace(/\/\*[\s\S]*?\*\//g, ' ')
.replace(/<!--[\s\S]*?-->/g, ' ')
.split('\n')
.map((l) => l.replace(/(^|[^:])\/\/.*$/, '$1'))
.join('\n')
}
function scanHardcodedChinese() {
const found = []
const files = walk(path.join(ROOT, 'src')).filter(
(f) => /\.(vue|ts|mts|js|mjs)$/.test(f) && !f.includes(`${path.sep}locales${path.sep}`),
)
for (const abs of files) {
const rel = path.relative(path.join(ROOT, 'src'), abs).split(path.sep).join('/')
const lines = stripComments(fs.readFileSync(abs, 'utf8')).split('\n')
lines.forEach((line, i) => {
const lits = line.match(/'[^'\n]*'|"[^"\n]*"|`[^`\n]*`/g) || []
for (const lit of lits) {
const text = lit.slice(1, -1)
if (!CJK.test(text)) continue
if (CJK_ALLOW.has(`${rel}::${text}`)) continue
found.push(`src/${rel}:${i + 1} 硬编码中文:${lit}(走 i18n:中文进 zh.ts、英文进 en.ts)`)
}
})
}
return found
}
const problems = []
const parsed = {}
for (const [lang, file] of Object.entries(FILES)) {
const { map, dup } = parseLocale(file)
parsed[lang] = map
for (const d of dup) problems.push(`${file} 重复键:${d}`)
for (const [k, [v, line]] of map) {
if (!v.trim()) problems.push(`${file}:${line} ${k} 是空文案`)
for (const b of checkBraces(v)) problems.push(`${file}:${line} ${k} —— ${b}`)
}
}
// 中英对称
const zhKeys = new Set(parsed.zh.keys())
const enKeys = new Set(parsed.en.keys())
for (const k of zhKeys) if (!enKeys.has(k)) problems.push(`en 少了键:${k}(中文写好了英文没写 → 英文界面会显示这个原始键名)`)
for (const k of enKeys) if (!zhKeys.has(k)) problems.push(`zh 少了键:${k}(英文写好了中文没写 → 中文界面会显示这个原始键名)`)
// 硬编码中文
problems.push(...scanHardcodedChinese())
if (problems.length) {
console.error(`\n✗ 文案体检不通过(${problems.length} 个问题):`)
for (const p of problems) console.error(' - ' + p)
console.error('\n改完再 build。\n')
process.exit(1)
}
console.log(`✓ 文案体检通过:中 ${zhKeys.size} 条 / 英 ${enKeys.size} 条,键对称、无重复、占位符语法正常`)