init: api-gateway v2.4.0(Agnes/b.ai/火山方舟 三家供应商网关)

This commit is contained in:
api-gateway committed 2026-09-15 17:05:46 +08:00
commit f136c9ee81
91 files changed
+24653

No files matched your search

+114
View File
@@ -0,0 +1,114 @@
// 文案体检(build 前置校验,第二十三轮补)
//
// 为什么需要它:vue-i18n 把文案里的 {...} 当占位符解析。踩过的坑 —— 一条提示文案写了
// `{"status":"ok"}`,编译器把它当占位符、报 "Invalid token in placeholder",而这条错误
// 是"渲染时才编译"时抛的:用到这条文案的整块界面直接不渲染,控制台里也只是一条 Vue 错误,
// 表现看起来像"这个页签/卡片挂了"(当时误判成 Element Plus 的 pane 机制问题,查了两轮)。
// 现在 build 前先把两份文案逐条过一遍,类似的写法在构建阶段就被拦下。
//
// 另外顺手核三件小事(都是会出现"界面里冒出 nav.xxx 原始键名"的原因):
// 1. 中英两份键完全对称;2. 同一个对象里没有重复键;3. 没有空文案。
//
// 只依赖 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 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}(英文写好了中文没写 → 中文界面会显示这个原始键名)`)
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} 条,键对称、无重复、占位符语法正常`)
+47
View File
@@ -0,0 +1,47 @@
// 静态资源自检:把 src/assets 下的 SVG 逐个按 XML 解析一遍。
//
// 为什么需要:SVG 里只要出现一处 XML 级错误(最典型的是注释里写了 CSS 变量名,
// 也就是连续两个连字符 —— XML 注释不允许这个序列),浏览器就会整张图静默不画:
// 页面不报错、控制台没有明显线索,只表现为「改完看起来什么都没变」。
// 这个坑踩过一次,所以放进 build 前置步骤,坏了就构建失败,别再靠肉眼发现。
import { readdirSync, readFileSync } from 'node:fs'
import { join } from 'node:path'
const dir = join(process.cwd(), 'src', 'assets')
let files = []
try {
files = readdirSync(dir).filter((f) => f.toLowerCase().endsWith('.svg'))
} catch {
console.log('[check-svg] 没有 src/assets 目录,跳过')
process.exit(0)
}
const problems = []
for (const f of files) {
const text = readFileSync(join(dir, f), 'utf8')
// ① 注释里出现连续两个连字符 —— XML 规范禁止,浏览器直接放弃整张图
for (const m of text.matchAll(/<!--([\s\S]*?)-->/g)) {
if (m[1].includes('--')) problems.push(`${f}: 注释里出现了连续两个连字符(XML 注释不允许)`)
}
// ② 标签配平与属性引号这类硬伤,用一个极简栈式检查兜住
const stripped = text.replace(/<!--[\s\S]*?-->/g, '').replace(/<\?[\s\S]*?\?>/g, '')
const stack = []
for (const m of stripped.matchAll(/<(\/?)([A-Za-z][\w:.-]*)((?:"[^"]*"|'[^']*'|[^>"'])*?)(\/?)>/g)) {
const [, close, name, , selfClose] = m
if (close) {
const top = stack.pop()
if (top !== name) problems.push(`${f}: 标签不匹配(</${name}> 对应的是 <${top || '空'}>)`)
} else if (!selfClose) {
stack.push(name)
}
}
if (stack.length) problems.push(`${f}: 有未闭合的标签 ${stack.join(', ')}`)
if (!/<svg[\s>]/.test(text)) problems.push(`${f}: 找不到 <svg> 根标签`)
}
if (problems.length) {
console.error('[check-svg] 检查未通过:')
for (const p of problems) console.error(' - ' + p)
process.exit(1)
}
console.log(`[check-svg] ${files.length} 个 SVG 全部通过(${files.join(', ')})`)