107 lines
5.7 KiB
JavaScript
107 lines
5.7 KiB
JavaScript
#!/usr/bin/env node
|
||
/**
|
||
* verify-static.mjs —— 静态页不变量校验（2026-09-13 新增）
|
||
*
|
||
* 为什么需要：平台有 9 个静态页，其中 wake.html 承担"启动过渡页"（有 5 个 id 被内联 JS 依赖），
|
||
* 而"去平台痕迹"（用户可见面不得出现 dshs）是个**容易回归**的约束 ——
|
||
* 新人加个页面忘了改名就会漏出去。把它变成 CI 可跑的判据。
|
||
*
|
||
* 用法：node scripts/verify-static.mjs 退出码 0=全绿 / 1=有违规
|
||
*/
|
||
import { readFileSync, readdirSync } from 'node:fs'
|
||
import { join, dirname } from 'node:path'
|
||
import { fileURLToPath } from 'node:url'
|
||
|
||
const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
|
||
const WEB = join(ROOT, 'web')
|
||
const BANNED = 'dshs' // 用户可见面不得出现的平台内部名
|
||
const WAKE_IDS = ['spin', 'step', 'acts', 'retry', 'note'] // wake.html 内联 JS 依赖的 id
|
||
// 档案 81 · R5：已完成多语言迁移的页面（**迁移一页加一个**）。这些页不得再出现裸中文文案。
|
||
const I18N_PAGES = ['login.html', 'register.html', 'wake.html', 'index.html']
|
||
|
||
let bad = 0
|
||
const pages = readdirSync(WEB).filter((f) => f.endsWith('.html'))
|
||
console.log('=== 静态页不变量（' + pages.length + ' 页）===')
|
||
|
||
for (const f of pages) {
|
||
const s = readFileSync(join(WEB, f), 'utf8')
|
||
const problems = []
|
||
const title = /<title[^>]*>([^<]*)<\/title>/.exec(s)
|
||
if (!title || title[1].trim() === '') problems.push('缺 <title> 或为空')
|
||
else if (title[1].includes(BANNED)) problems.push('title 含内部平台名: ' + title[1])
|
||
if (s.includes(BANNED)) problems.push('页面正文含内部平台名（去痕迹约束）')
|
||
|
||
// 档案 81 · R5：**已迁移多语言的页面不得再出现裸中文文案** —— 用户可见文案必须走词条
|
||
// （`data-i18n` / `I18N.t`）。注释不算文案，故先剥掉 HTML 与 JS 注释再判。
|
||
// 只对白名单页生效 ⇒ 未迁移页仍允许中文，不会误拦（迁移一页就往 I18N_PAGES 加一个）。
|
||
if (I18N_PAGES.includes(f)) {
|
||
const stripped = s
|
||
.replace(/<!--[\s\S]*?-->/g, '')
|
||
.replace(/\/\*[\s\S]*?\*\//g, '')
|
||
.replace(/^[ \t]*\/\/.*$/gm, '')
|
||
.replace(/[ \t]\/\/[^\n]*/g, '') // 行尾注释（`code // 说明`）也要剥（`https://` 不会被误伤：左邻是 `:` 不是空格）
|
||
const cjk = stripped.split('\n').map((l, i) => [i + 1, l]).filter(([, l]) => /[\u4e00-\u9fa5]/.test(l))
|
||
if (cjk.length) {
|
||
problems.push('已迁移多语言但仍有裸中文文案（行 ' + cjk.slice(0, 3).map(([n]) => n).join('/') + '…）')
|
||
}
|
||
if (!s.includes('/i18n.js')) problems.push('已迁移多语言但未引入 /i18n.js')
|
||
}
|
||
|
||
if (f === 'wake.html') {
|
||
for (const id of WAKE_IDS) {
|
||
if (!new RegExp('id="' + id + '"').test(s)) problems.push('缺 id="' + id + '"（内联 JS 依赖）')
|
||
}
|
||
if (!s.includes('instance_circuit_open')) problems.push('缺档案 78 的熔断提示分支')
|
||
}
|
||
|
||
if (problems.length) { bad++; console.log(' ✗ ' + f + '：' + problems.join('；')) }
|
||
else console.log(' ✓ ' + f + (title ? '（title=' + title[1] + '）' : ''))
|
||
}
|
||
|
||
// 内联 <script> 必须能被 JS 解析（2026-09-13 事故：脚本语法错误 = 静默失效）
|
||
import { writeFileSync, mkdtempSync } from 'node:fs'
|
||
import { tmpdir } from 'node:os'
|
||
import { execFileSync } from 'node:child_process'
|
||
const tmp = mkdtempSync(join(tmpdir(), 'vstatic-'))
|
||
for (const f of pages) {
|
||
const s = readFileSync(join(WEB, f), 'utf8')
|
||
const blocks = [...s.matchAll(/<script(?![^>]*\bsrc=)[^>]*>([\s\S]*?)<\/script>/g)].map((m) => m[1])
|
||
blocks.forEach((code, i) => {
|
||
const file = join(tmp, f.replace(/\W/g, '_') + '.' + i + '.js')
|
||
writeFileSync(file, code)
|
||
try { execFileSync(process.execPath, ['--check', file], { stdio: 'pipe' }); console.log(' ✓ ' + f + ' 内联脚本#' + i + ' 语法通过') }
|
||
catch (e) { bad++; console.log(' ✗ ' + f + ' 内联脚本#' + i + ' **语法失败**：' + String(e.stderr || e).split('\n').slice(0, 2).join(' ')) }
|
||
})
|
||
}
|
||
|
||
// CSS/JS 资源也要过一遍去痕迹约束
|
||
for (const f of readdirSync(WEB).filter((f) => /\.(css|js)$/.test(f))) {
|
||
const s = readFileSync(join(WEB, f), 'utf8')
|
||
if (s.includes(BANNED)) { bad++; console.log(' ✗ ' + f + '：含内部平台名') }
|
||
else console.log(' ✓ ' + f)
|
||
}
|
||
|
||
// SVG 资产单独过一遍（2026-09-19 档案 137 新增）。
|
||
// 为什么必须查：**XML 注释里不允许出现两个连续 ASCII 连字符**，而 SVG 文件里写 CSS 变量名
|
||
// （双连字符加名字）是最自然的写法 ⇒ 一旦踩中，**整份 SVG 解析失败、图标静默不显示**，
|
||
// 页面与接口都不报任何错。第一版 favicon 就栽在这里（注释里写了 `--ink`），
|
||
// 是靠"用真解析器验一遍"才抓到的 ⇒ 把它做成可重跑的判据，而不是靠人记得。
|
||
for (const f of readdirSync(WEB).filter((f) => f.endsWith('.svg'))) {
|
||
const s = readFileSync(join(WEB, f), 'utf8')
|
||
const problems = []
|
||
if (s.includes(BANNED)) problems.push('含内部平台名')
|
||
if (!/^\s*<svg[\s>]/.test(s)) problems.push('未以 <svg 开头')
|
||
if (!s.trimEnd().endsWith('</svg>')) problems.push('未以 </svg> 结尾')
|
||
if (!/viewBox="0 0 \d+ \d+"/.test(s)) problems.push('缺 viewBox（缩放不可控）')
|
||
for (const m of s.matchAll(/<!--([\s\S]*?)-->/g)) {
|
||
if (m[1].includes('--')) {
|
||
problems.push('XML 注释含双连字符（XML 语法不允许 ⇒ 整份 SVG 会解析失败、图标静默不显示）')
|
||
}
|
||
}
|
||
if (problems.length) { bad++; console.log(' ✗ ' + f + '：' + problems.join('；')) }
|
||
else console.log(' ✓ ' + f)
|
||
}
|
||
|
||
console.log(bad ? '结论：' + bad + ' 项不合格 ❌' : '结论：全部合格 ✅')
|
||
process.exit(bad ? 1 : 0)
|