/** * 呈现对拍(P11)· 多页签版:把**重构前的页面**与**Vue 迁移后的组件**放在同一份数据上比一遍。 * * 口径(实逮决定): * · `/detail/v2` 是浏览器里现渲的单页(HTML 只有壳 + 内联 app.js/charts.js + 语言包,无 window.__DATA__) * ⇒ 基线必须**让旧代码真跑一遍**:jsdom 加载现网页面,并在 **beforeParse** 装 fetch 桩转发到真实网关 * (桩晚装一句,旧页面就 `fetch is not defined`,基线全空)。 * · 页签由 hash 决定(`#tab=energy`)⇒ 基线按同一 hash 加载,两边渲染同页签。 * · Vue 侧用**同一份数据**(fetch 桩记录下的 /api/fleet 响应)经 SSR 渲成 HTML。 * · 比对: * ① 文本序列(`#root` 下所有文本节点,按 DOM 顺序、空白归一)—— 结构 + 文案一致; * ② 表格单元格文本(逐表、逐行); * ③ **图表数据**:旧页面内联 SVG 里的数字 vs Vue 侧 ECharts option 里 `__data__` 的数字 * (视觉实现不同是用户令「引入 ECharts」的结果,**数据必须同源**)。 * * 用法:node tools/render_parity.mjs [gateway] [tab1] [tab2] ... * 退出码:0 全一致 · 9 有不一致 · 2 基准页取不到。 */ import { fileURLToPath, pathToFileURL } from 'node:url' import { dirname, resolve } from 'node:path' import { JSDOM, VirtualConsole } from 'jsdom' const HERE = dirname(fileURLToPath(import.meta.url)) const GATEWAY = process.argv[2] || 'http://127.0.0.1:28084' const TABS = process.argv.slice(3).length ? process.argv.slice(3) : ['overview', 'energy', 'component', 'fault'] /** * 显式前置条件:把 `/api/curves` 追到**出图**那一份为止(首次常是 building)。 * 追不到就抛错 —— 宁可报错,也不要让"骨架屏 vs 出图"把对拍结果搞成不可复现。 */ async function awaitCurves(tries = 20, gapMs = 3000) { for (let k = 0; k < tries; k++) { const r = await fetch(GATEWAY + '/detail/api/curves') if (!r.ok) throw new Error(`/api/curves ${r.status}`) const j = await r.json() if (!j.building && (j.figs || []).length) return j await new Promise((r2) => setTimeout(r2, gapMs)) } throw new Error('等 /api/curves 出图超时(仍是 building/无 figs)—— 先让服务端把曲线算完再对拍') } /** 取一份 /api/fleet —— 对拍两侧**共用这一份**(先取后喂,避免"页面缓存数据 vs 新取数据"的版本错位)。 */ async function fleetData(win = '') { const url = GATEWAY + '/detail/api/fleet' + (win ? `?win=${encodeURIComponent(win)}` : '') const r = await fetch(url) if (!r.ok) throw new Error(`取数失败 ${r.status} ${url}`) return await r.json() } /** * 给 jsdom 装 fetch 桩: * · `/api/fleet` **一律返回 state.fleet**(加载页面前我们自己取好的那一份)—— 保证"旧页面"与"Vue" * 渲染的是同一份数据(实逮:页面有 pending 轮询,桩若记录"最后一次"响应,两边数据版本会不同, * 于是把"数据错位"误判成"文案不一致"); * · 其余请求照常转发到真实网关。 */ function installFetch(window, state) { window.fetch = async (input, init) => { const raw = typeof input === 'string' ? input : (input && input.url) || String(input) const url = raw.startsWith('http') ? raw : GATEWAY + (raw.startsWith('/') ? raw : '/' + raw) if (url.includes('/api/curves')) { // 数据源已在 baseline() 里前置取好(awaitCurves);这里只负责回放,保证两侧同源 if (!state.curves) { const r2 = await fetch(url, init) state.curves = JSON.parse(await r2.text()) state.curvesRaw = JSON.stringify(state.curves) } const body = state.curvesRaw return { ok: true, status: 200, headers: { get: () => 'application/json' }, json: async () => JSON.parse(body), text: async () => body } } if (url.includes('/api/vibcms')) { if (!state.cms) { // ★ 与 fleet 同理:只认第一次拿到的 const r1 = await fetch(url, init) state.cms = JSON.parse(await r1.text()) state.cmsRaw = JSON.stringify(state.cms) } const body = state.cmsRaw return { ok: true, status: 200, headers: { get: () => 'application/json' }, json: async () => JSON.parse(body), text: async () => body } } if (url.includes('/api/fleet')) { if (!state.fleet) { // ★ 只认**第一次**(页面 pending 轮询会再取,那是另一份) const r0 = await fetch(url, init) state.fleet = JSON.parse(await r0.text()) state.fleetRaw = JSON.stringify(state.fleet) } const body = state.fleetRaw return { ok: true, status: 200, headers: { get: () => 'application/json' }, json: async () => JSON.parse(body), text: async () => body } } const resp = await fetch(url, init) const body = await resp.text() // 通用接口快照:把页面请求过的 /api/* 首次响应按**路径**记下来(供 decision/assistant/report/system 复用) try { const u = new URL(url) if (u.pathname.includes('/api/')) { if (!state.apis) state.apis = {} if (!(u.pathname in state.apis)) state.apis[u.pathname] = JSON.parse(body) } } catch { /* 非 JSON 或非 URL:忽略 */ } return { ok: resp.ok, status: resp.status, headers: { get: (k) => resp.headers.get(k) }, json: async () => JSON.parse(body), text: async () => body, } } } const norm = (s) => String(s).replace(/\s+/g, ' ').trim() /** 文本节点序列(跳过画布/SVG —— 图形由"图表数据"那一项比)。 */ function textsIn(root) { const out = [] const walk = (n) => { for (const c of n.childNodes) { if (c.nodeType === 3) { const s = norm(c.textContent) if (s) out.push(s) } else if (c.nodeType === 1) { const tag = c.tagName.toLowerCase() if (tag === 'canvas' || tag === 'svg' || tag === 'script' || tag === 'style') continue walk(c) } } } walk(root) return out } /** 表格:每张表的行×单元格文本。 */ function tablesIn(root) { return Array.from(root.querySelectorAll('table')).map((tb) => Array.from(tb.querySelectorAll('tr')).map((tr) => Array.from(tr.querySelectorAll('th,td')).map((c) => norm(c.textContent)))) } /** 旧页面图表里的数字(内联 SVG 文本里的数值)。 */ function svgNumbers(root) { const out = [] for (const t of Array.from(root.querySelectorAll('svg text'))) { for (const m of norm(t.textContent).matchAll(/-?\d[\d,]*(?:\.\d+)?/g)) out.push(m[0].replace(/,/g, '')) } return out } /** Vue 侧:ECharts option 的 `__data__` 里的数字(数据级对拍)。 */ function chartNumbers(root) { const out = [] for (const el of Array.from(root.querySelectorAll('[data-chart]'))) { let opt = null try { opt = JSON.parse(el.getAttribute('data-chart') || 'null') } catch { /* ignore */ } const d = opt && opt.__data__ if (!d) continue const walk = (x) => { // 旧图把值直接写进 SVG 文本(txt(..., v))⇒ 这里也按**原值**取字符串,不取整 if (typeof x === 'number') { if (Number.isFinite(x)) out.push(String(x)); return } if (Array.isArray(x)) { x.forEach(walk); return } if (x && typeof x === 'object') { Object.values(x).forEach(walk) } } walk(d) } return out } async function baseline(tab, sub) { // ★ 不预先自取 fleet:记录**页面自己第一次**拿到的 /api/fleet,再用同一份喂 Vue(见 installFetch 注释) const state = {} // ★ generation:页面前置条件 —— 先把 /api/curves 追到出图,作为唯一数据源(见 awaitCurves) if (tab === 'generation') { state.curves = await awaitCurves() state.curvesRaw = JSON.stringify(state.curves) console.log(` [i] /api/curves 已出图:figs ${(state.curves.figs || []).length} 张`) } const html = await (await fetch(GATEWAY + '/detail/v2')).text() const dom = new JSDOM(html, { url: GATEWAY + `/detail/v2#tab=${tab}`, runScripts: 'dangerously', pretendToBeVisual: true, virtualConsole: new VirtualConsole(), beforeParse: (window) => installFetch(window, state), }) const doc = dom.window.document // ★实逮:`#root` 初始就带一个 `.panel`(出错提示占位)——若拿 `.panel` 当"渲染好了"的判据, // 会在 app.js 取数之前就跳出循环,基线全空。判据改用 render() 一定产出的 `.page-head`, // 并且要求 fetch 桩已经记下 `/api/fleet` 的响应。 for (let i = 0; i < 120; i++) { const root = doc.getElementById('root') if (root && root.querySelector('.page-head')) break await new Promise((r) => setTimeout(r, 500)) } // 子视图:页签内部还有一层 pill(旧页面是 `data-fsub`);点一下再抽锚点 if (sub) { const pill = doc.querySelector(`#root [data-fsub="${sub}"]`) if (pill) { pill.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true })) // cms 子视图要等它异步取 /api/vibcms 再渲染 ⇒ 多等几轮 const waitMs = sub === 'cms' ? 4000 : 1200 await new Promise((r) => setTimeout(r, waitMs)) } else { console.log(` [i] 基准页没有子视图 pill data-fsub="${sub}"(按默认子视图比)`) } } return { doc, data: state.fleet, cms: state.cms ?? null, curves: state.curves ?? null, apis: state.apis ?? {}, root: doc.getElementById('root') } } async function vueAnchors(data, tab, sub, cms, curves, apis) { const entry = pathToFileURL(resolve(HERE, '../target/ssr/entry-server.js')).href const html = await (await import(entry)).renderTab(data, tab, sub, cms, curves, apis) const dom = new JSDOM(`
${html}
`) const wrap = dom.window.document.getElementById('wrap') // ★对齐口径:基线取的是 `#root`(页签内容本身,页签导航在 #root 之外的 #tabs,子视图 pill 在 #root 内)。 // Vue 的 Workbench 把页签导航也渲进来了 ⇒ 摘掉 `nav.wb-tabs` 再比;导航/子视图文案单独比(见 tabsLabel)。 const tabsLabel = Array.from(wrap.querySelectorAll('.wb-tabs button, #tabs button, [data-fsub]')) .map((b) => norm(b.textContent.replace(/迁移中/, ''))) const nav = wrap.querySelector('.wb-tabs') if (nav) nav.remove() return { wrap, tabsLabel } } /** 深比较(表格用):返回第一个差异的说明。 */ function cmpDeep(a, b, label) { const A = JSON.stringify(a), B = JSON.stringify(b) if (A === B) return '' if (a.length !== b.length) return `${label}: 张数/行数不同 ${a.length} ≠ ${b.length}` for (let i = 0; i < a.length; i++) { if (JSON.stringify(a[i]) !== JSON.stringify(b[i])) { const ra = a[i] || [], rb = b[i] || [] if (ra.length !== rb.length) return `${label}: 第 ${i + 1} 张表行数 ${ra.length} ≠ ${rb.length}` for (let r = 0; r < ra.length; r++) { if (JSON.stringify(ra[r]) !== JSON.stringify(rb[r])) { return `${label}: 第 ${i + 1} 张表第 ${r + 1} 行不同 —— "${String(ra[r]).slice(0, 60)}" ≠ "${String(rb[r]).slice(0, 60)}"` } } } } return label + ': 有差异' } function cmpList(a, b, label) { if (a.length !== b.length) { const [short, long, side] = a.length < b.length ? [a, b, 'Vue 多'] : [b, a, '基准多'] const extra = long.slice(short.length, short.length + 6).map((s) => `"${String(s).slice(0, 60)}"`) return `${label}: 条数 ${a.length} ≠ ${b.length};${side} ${long.length - short.length} 项,例如 ${extra.join(' / ')}` } for (let i = 0; i < a.length; i++) { if (a[i] !== b[i]) return `${label}[${i}]: "${String(a[i]).slice(0, 70)}" ≠ "${String(b[i]).slice(0, 70)}"` } return '' } /** 图数据:**子集**规则 —— 旧图把数据与坐标刻度都写成 SVG 文本,ECharts 的刻度在画布上拿不到, * 所以只要求"Vue 画的每个数都在旧图数字里出现"(抓数据画错/画多;刻度差异不算)。 */ function cmpSubset(vueNums, baseNums, label) { const pool = new Set(baseNums) const missing = vueNums.filter((v) => !pool.has(v)) if (missing.length) return `${label}: Vue 有 ${missing.length} 个数字不在旧图里,例如 ${missing.slice(0, 6).join(',')}` return '' } /** * 显式例外(每条例外都要写清"为什么不是前端偏差"): * tab : 页签 · prefix : 两侧文本都以此开头时视为同一条 · why : 理由 */ const ALLOW = [ { tab: 'vibration', prefix: '窗末月? (', why: '与 fault 同类:列窗文案在"页面按窗缓存"与"实时 /api/fleet"两条路径上不同("(变化统计方法=同型机)" vs ' + '"(变化口径=同型机)")⇒ 非前端偏差;待后端统一口径后删除本例外。', }, { tab: 'fault', prefix: '平均停机间隔(MTBO', why: '后端两条路径文案不一致(页面的按窗缓存 vs 实时 /api/fleet):"(MTBO统计方法)/(纯故障统计方法)" vs ' + '"(MTBO口径)/(纯故障口径)"。两侧同一字段、同一模板 ⇒ 非前端偏差;待后端统一口径后删除本例外。', }, ] /** 把基准文本按例外归一到 Vue 侧(并返回用到的例外数)。 */ function applyAllow(tab, baseTexts, vueTexts) { let used = 0 const out = baseTexts.map((s, i) => { const rule = ALLOW.find((r) => r.tab === tab && s.includes(r.prefix) && (vueTexts[i] || '').includes(r.prefix)) if (rule) { used += 1; return vueTexts[i] } return s }) return { texts: out, used } } let bad = 0 let allowed = 0 const DUMP = process.env.PARITY_DUMP === '1' for (const spec of TABS) { const [tab, sub] = String(spec).split(':') const base = await baseline(tab, sub) if (!base.data) { console.log(`[X] ${tab}: 取不到 /api/fleet 数据(服务没起?)`) bad++ continue } const vroot = await vueAnchors(base.data, tab, sub, base.cms, base.curves, base.apis) const allowRes = applyAllow(tab, textsIn(base.root), textsIn(vroot.wrap)) allowed += allowRes.used if (DUMP) { const bt = textsIn(base.root), vt = textsIn(vroot.wrap) console.log(`\n== ${tab} 文本对照(基准 ${bt.length} / Vue ${vt.length})==`) for (let i = 0; i < Math.max(bt.length, vt.length); i++) { const same = bt[i] === vt[i] console.log(` ${String(i).padStart(3)} ${same ? ' ' : '≠ '}基:${String(bt[i] ?? '—').slice(0, 60).padEnd(62)} Vue:${String(vt[i] ?? '—').slice(0, 60)}`) } console.log(` 图数字 基: ${svgNumbers(base.root).join(',')}`) console.log(` 图数字 Vue: ${chartNumbers(vroot.wrap).join(',')}`) console.log(` 末尾 基: ${bt.slice(-5).map((s) => `"${s.slice(0, 40)}"`).join(' | ')}`) console.log(` 末尾 Vue: ${vt.slice(-5).map((s) => `"${s.slice(0, 40)}"`).join(' | ')}`) console.log(` 表 基: ${JSON.stringify(tablesIn(base.root)).slice(0, 400)}`) console.log(` 表 Vue: ${JSON.stringify(tablesIn(vroot.wrap)).slice(0, 400)}`) const bt1 = tablesIn(base.root)[1], vt1 = tablesIn(vroot.wrap)[1] if (bt1 || vt1) { console.log(` 第2张表 基 ${(bt1 || []).length} 行 / Vue ${(vt1 || []).length} 行`) for (let i = 0; i < Math.max((bt1 || []).length, (vt1 || []).length); i++) { const A = JSON.stringify(bt1?.[i] ?? null), B = JSON.stringify(vt1?.[i] ?? null) if (A !== B) console.log(` 行${i} 基:${String(A).slice(0, 130)}\n Vue:${String(B).slice(0, 130)}`) } } } const baseTabs = Array.from(base.doc.querySelectorAll('#tabs button, #root [data-fsub]')).map((b) => norm(b.textContent)) // 例外同样作用于表格:单元格若命中登记例外(两侧都以同一前缀开头),取 Vue 侧文本再比 const allowTables = (bt, vt) => bt.map((rows, i) => rows.map((cells, r) => cells.map((c, k) => { const rule = ALLOW.find((x) => x.tab === tab && c.includes(x.prefix) && String((vt[i] || [])[r]?.[k] ?? '').includes(x.prefix)) return rule ? String((vt[i] || [])[r][k]) : c }))) const checks = [ cmpList(allowRes.texts, textsIn(vroot.wrap), '文本序列'), cmpDeep(allowTables(tablesIn(base.root), tablesIn(vroot.wrap)), tablesIn(vroot.wrap), '表格'), cmpList(baseTabs, vroot.tabsLabel, '页签'), ] const svgN = svgNumbers(base.root) const echN = chartNumbers(vroot.wrap) // 图表:老页面没有 SVG(或该页签本就无图)时不比;两边都有才比数据集合 if (svgN.length && echN.length) checks.push(cmpSubset(echN, svgN, '图表数据(Vue ⊆ 旧图)')) const fails = checks.filter(Boolean) const extra = `文本 ${textsIn(base.root).length} 项(例外 ${allowRes.used} 条) · 表 ${tablesIn(base.root).length} 张 · 图数字 ${svgN.length}/${echN.length}` if (fails.length) { bad++ console.log(`[X] ${spec} —— ${extra}`) for (const f of fails) console.log(' ' + f) } else { console.log(`[OK] ${spec} —— ${extra}(呈现一致)`) } } if (allowed) { for (const r of ALLOW) console.log(`[i] 已登记例外(${r.tab} · ${r.prefix}…):${r.why.slice(0, 90)}…`) } console.log(`\n结论: ${bad === 0 ? `页签 ${TABS.join('/')} 与重构前呈现一致(含登记例外 ${allowed} 条)` : `${bad} 个页签不一致(见上)`}`) process.exit(bad === 0 ? 0 : 9)