Files
dsh_shenxian/scripts/verify-models-render.cjs
T
admin 5ec99ce227
build / build-and-scan (push) Waiting to run
chore: 文档库全量重新入库(2026-10-20)
2026-10-20 15:05:55 +08:00

189 lines
8.6 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.
#!/usr/bin/env node
/**
* verify-models-render.cjs —— 「模型设置」分区(`poc/business-plugins/lib/client.js`)
* 的**真渲染冒烟**:把 `ModelSettingsSection` 抠出来,用桩 React / jsxRuntime 跑一遍,
* 覆盖「卡片行 / 添加提供方卡片 / 自定义提供方卡片 / 默认双按钮 / 删除确认弹窗」五个分支。
*
* 为什么需要(语法检查抓不到的东西):
* `node --check` 只保证能解析;`verify-models-dict.mjs` 只保证词典齐全与版式锚点。
* 但组件里还有一类**只在渲染时才炸**的错:未定义变量、jsxRuntime 用法错、
* 访问了 `undefined.trim()` 之类。这类错在浏览器里表现为「整个设置页白屏」,
* 而本仓库没有前端测试运行器。本脚本用最小桩把渲染跑通,把这类错拦在构建期。
*
* ⚠️ **维护约束**:桩 `useState` 按**调用序号**喂值(见 `STATE_MAP`)。若给组件新增/调换
* `useState`,请同步 `STATE_MAP`;脚本会先断言调用数量,数量不符时**明确报错**而不是静默测错。
*
* 用法:node scripts/verify-models-render.cjs 退出码 0=全绿 / 1=有失败
*/
const { readFileSync } = require('node:fs')
const { join, dirname } = require('node:path')
const ROOT = join(__dirname, '..')
const FILE = join(ROOT, 'poc', 'business-plugins', 'lib', 'client.js')
const src = readFileSync(FILE, 'utf8')
let failed = 0
const ok = (name, cond, extra = '') => {
console.log((cond ? ' ✓ ' : ' ✗ ') + name + (extra ? ' ' + extra : ''))
if (!cond) failed++
}
/** 从 `function <name>() {` 起按大括号配平截取函数源码(跳过字符串与注释)。 */
function extractFn(text, name) {
const at = text.indexOf('function ' + name + '()')
if (at < 0) return null
const start = text.indexOf('{', at)
let depth = 0
let i = start
while (i < text.length) {
const c = text[i]
if (c === '/' && text[i + 1] === '/') { while (i < text.length && text[i] !== '\n') i++; continue }
if (c === '/' && text[i + 1] === '*') { i = text.indexOf('*/', i) + 2; continue }
if (c === '"' || c === "'" || c === '`') {
const q = c
i++
while (i < text.length && text[i] !== q) { if (text[i] === '\\') i++; i++ }
i++
continue
}
if (c === '{') depth++
else if (c === '}') { depth--; if (depth === 0) return text.slice(at, i + 1) }
i++
}
return null
}
const fnSrc = extractFn(src, 'ModelSettingsSection')
ok('取到 ModelSettingsSection 源码', fnSrc !== null)
if (fnSrc === null) process.exit(1)
/** 真词典(顺便验证键真的存在)。 */
function grabObj(text, name) {
const at = text.indexOf('var ' + name + ' = {')
const start = text.indexOf('{', at)
let depth = 0
for (let i = start; i < text.length; i++) {
if (text[i] === '{') depth++
else if (text[i] === '}') { depth--; if (depth === 0) return text.slice(start, i + 1) }
}
return null
}
const zh = eval('(' + grabObj(src, 'zh') + ')')
/**
* 桩 `useState` 的**位置→语义**映射。顺序 = 组件里 `var x = useState(...)` 的先后。
* 键是调用序号,值是「该序号在真实组件里是什么」——仅用于可读性,实际取值看 `over`。
*/
const STATE_MAP = [
'data', 'providers', 'loading', 'busy', 'msg', 'mode',
'fPick', 'fKey', 'fName', 'fRoute', 'fUrl', 'fApi', 'fModels', 'fShow', 'delTarget', 'catalog',
]
const mockedKeys = []
const FAKE_DATA = {
keys: [
{ id: 1, name: '内置 DeepSeek', route: null, enabled: true, baseUrl: null, api: null },
{ id: 2, name: 'Moonshot', route: 'moonshot', enabled: false, baseUrl: null, api: null },
{ id: 3, name: '我的中转', route: 'my-gw', enabled: true, baseUrl: 'https://gw.example/v1', api: 'openai-completions' },
],
// 档案 138:`granted` = 管理员授权(前端据它决定是否渲染「平台共享模型」区块)
shared: { available: true, name: '内置 DeepSeek', owner: 'admin', ownerIsMe: true, granted: true, count: 1 },
sharedModelEnabled: true,
sharedModelGranted: true,
protocols: ['openai-completions', 'anthropic-messages'],
}
const FAKE_PROVIDERS = [
{ id: 'moonshot', label: '月之暗面', cn: true, modelCount: 3, models: ['kimi-k2', 'kimi-lite', 'kimi-pro'] },
{ id: 'openai', label: 'OpenAI', cn: false, modelCount: 2, models: ['gpt-5', 'gpt-5-mini'] },
]
function makeUseState(pass, counter) {
return function useState(init) {
const k = counter.i++
const over = pass.over || {}
// 未提供的字段回落到 init(而不是 undefined)—— 免得桩的疏漏被当成组件缺陷
const v = Object.prototype.hasOwnProperty.call(over, k) && over[k] !== undefined ? over[k] : init
return [v, function () {}]
}
}
const React = { useState: null, useEffect: function () {} }
const jsxRuntime = {
jsx: (type, props) => ({ type, props: props || {} }),
jsxs: (type, props) => ({ type, props: props || {} }),
Fragment: 'Fragment',
}
const t = (k) => {
if (!(k in zh)) { mockedKeys.push(k); return '<' + k + '>' }
return zh[k]
}
const noopReq = () => Promise.resolve({ ok: true, json: () => Promise.resolve({}) })
const MS_ERR = {}
const portalHost = () => ''
function render(pass) {
const counter = { i: 0 }
React.useState = makeUseState(pass, counter)
const factory = new Function(
'React', 'jsxRuntime', 't', 'paReq', 'papostJson', 'portalHost', 'MS_ERR',
fnSrc + '\nreturn ModelSettingsSection;',
)
const tree = factory(React, jsxRuntime, t, noopReq, noopReq, portalHost, MS_ERR)()
return { tree, calls: counter.i }
}
function walk(node, out) {
if (node == null || typeof node !== 'object') return
if (Array.isArray(node)) { for (const n of node) walk(n, out); return }
const p = node.props || {}
if (p.className) out.classes.push(String(p.className))
if (typeof p.children === 'string') out.text.push(p.children)
if (Array.isArray(p.children)) {
for (const c of p.children) { if (typeof c === 'string') out.text.push(c); else walk(c, out) }
} else if (p.children && typeof p.children === 'object') walk(p.children, out)
}
const BASE = { key: 'sk-abc', msg: '', over: {} }
const CASES = [
['默认态(两个虚线按钮)', { over: { 0: FAKE_DATA, 1: FAKE_PROVIDERS, 2: false, 3: false, 4: '', 5: '', 6: '', 7: BASE.key, 12: [''], 13: false, 14: null, 15: null } },
['ms-rows', 'ms-rowCard', 'ms-rowHead', 'ms-rowIdentity', 'ms-rowActions', 'ms-addActions', 'ms-addBtn']],
['添加提供方卡片', { over: { 0: FAKE_DATA, 1: FAKE_PROVIDERS, 2: false, 3: false, 4: '', 5: 'add', 6: 'moonshot', 7: BASE.key, 12: [''], 13: false, 14: null, 15: null } },
['ms-card', 'ms-field', 'ms-fieldLabel', 'ms-details', 'ms-summary', 'ms-editorActions']],
['自定义提供方卡片', { over: { 0: FAKE_DATA, 1: FAKE_PROVIDERS, 2: false, 3: false, 4: '', 5: 'custom', 6: '', 7: BASE.key, 8: '我的网关', 9: 'my-gw', 10: 'https://gw.example/v1', 11: 'openai-completions', 12: ['m1', ''], 13: false, 14: null, 15: null } },
['ms-modelList', 'ms-modelEntry', 'ms-modelRow', 'ms-iconBtn']],
['删除确认弹窗', { over: { 0: FAKE_DATA, 1: FAKE_PROVIDERS, 2: false, 3: false, 4: '', 5: '', 6: '', 7: BASE.key, 12: [''], 13: false, 14: FAKE_DATA.keys[1], 15: null } },
['pa-overlay', 'pa-modal', 'ms-editorActions']],
]
let sawCalls = 0
for (const [title, pass, expect] of CASES) {
let tree, calls
try {
const r = render(pass)
tree = r.tree
calls = r.calls
} catch (e) {
console.log(' ✗ ' + title + ' → 抛异常: ' + e.message)
failed++
continue
}
sawCalls = calls
const out = { classes: [], text: [] }
walk(tree, out)
const joined = out.classes.join(' | ')
const miss = expect.filter((c) => joined.indexOf(c) < 0)
const problems = []
if (miss.length) problems.push('缺 class: ' + miss.join(', '))
const unrendered = out.text.filter((s) => /^<ms\./.test(s))
if (unrendered.length) problems.push('未渲染词典键: ' + unrendered.join(', '))
if (problems.length) { console.log(' ✗ ' + title + ' → ' + problems.join(' ; ')); failed++ }
else console.log(' ✓ ' + title + ' (class ' + out.classes.length + ' 个, 文本 ' + out.text.length + ' 段)')
}
ok('useState 调用数量与 STATE_MAP 对齐', sawCalls === STATE_MAP.length,
sawCalls === STATE_MAP.length ? '-> ' + sawCalls : '-> 实测 ' + sawCalls + ' / 映射 ' + STATE_MAP.length + '(组件加了 state?请同步本脚本 STATE_MAP)')
ok('渲染期未出现缺词典键', mockedKeys.length === 0, mockedKeys.length ? '-> ' + [...new Set(mockedKeys)].join(', ') : '')
console.log(failed === 0 ? '\n渲染冒烟全部通过' : '\n' + failed + ' 项失败')
process.exit(failed === 0 ? 0 : 1)