老板对上一轮「只查未改」的体检清单回「全部」,逐项修完并直接上生产验证。
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。
172 lines
7.5 KiB
JavaScript
172 lines
7.5 KiB
JavaScript
// 文案体检(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} 条,键对称、无重复、占位符语法正常`)
|