dsh-sansheng-liubu/scripts/workbench-preflight.mjs

129 lines
5.2 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.

// 重启前自检:只读,不改任何东西。
//
// 目的:把「重启 DSH 之后才发现客户端 bundle 根本没加载」这类问题提前挡掉。
// 检查四件事——
// 1. profile 里到底有没有把本插件链进去(dependencies + dsh.profile.bundles)
// 2. 链接指向的目录里,exports 声明的那个文件在不在
// 3. 那个文件是不是一段能解析的 JS(语法坏了会让整页白屏,且报错很难看懂)
// 4. Host 侧装配能不能在内存账本上跑起来(13 条路由 + bootstrap 可用)
//
// 用法:node scripts/workbench-preflight.mjs
// 退出码:0 全通;1 有失败项(打印哪一项失败、为什么)。
import fs from 'node:fs'
import os from 'node:os'
import path from 'node:path'
import vm from 'node:vm'
import { createWorkbenchHost } from '../workbench/host/index.mjs'
import { WorkbenchStore } from '../workbench/core/store.mjs'
const PLUGIN_ID = 'dsh-sansheng-liubu-workbench'
const results = []
function check(name, run) {
try {
const detail = run()
results.push({ name, ok: true, detail })
} catch (error) {
results.push({ name, ok: false, detail: error?.message ?? String(error) })
}
}
function dshHome(env = process.env) {
const value = typeof env.DSH_HOME === 'string' && env.DSH_HOME.trim() ? env.DSH_HOME.trim() : ''
return value === '' ? path.join(os.homedir(), '.dsh') : value
}
const profileDir = path.join(dshHome(), 'profiles', 'desktop')
const profilePackage = path.join(profileDir, 'package.json')
let profile = null
check('读取 profile/package.json', () => {
profile = JSON.parse(fs.readFileSync(profilePackage, 'utf8'))
return profilePackage
})
check('profile 的 dependencies 里链了本插件', () => {
const spec = profile?.dependencies?.[PLUGIN_ID]
if (typeof spec !== 'string' || spec === '') throw new Error(`dependencies 里没有 ${PLUGIN_ID}`)
return spec
})
check('profile 的 bundles 里登记了本插件', () => {
const bundles = profile?.dsh?.profile?.bundles
if (!Array.isArray(bundles) || !bundles.includes(PLUGIN_ID)) {
throw new Error(`dsh.profile.bundles 里没有 ${PLUGIN_ID}(现有:${Array.isArray(bundles) ? bundles.join(', ') : '无'})`)
}
return `${bundles.length} 个 bundle`
})
const linkedDir = path.join(profileDir, 'node_modules', PLUGIN_ID)
let entryFile = null
check('链接目录与入口文件存在', () => {
const stat = fs.statSync(linkedDir)
if (!stat.isDirectory()) throw new Error(`${linkedDir} 不是目录`)
const pkg = JSON.parse(fs.readFileSync(path.join(linkedDir, 'package.json'), 'utf8'))
const exported = pkg?.exports?.['./client']
const rel = typeof exported === 'string' ? exported : exported?.import ?? exported?.default
if (typeof rel !== 'string') throw new Error('package.json 没有 exports["./client"]')
entryFile = path.join(linkedDir, rel)
const size = fs.statSync(entryFile).size
if (size < 1024) throw new Error(`入口文件过小(${size} 字节),可能是空壳`)
return `${path.basename(entryFile)} · ${size} 字节`
})
check('客户端 bundle 语法可解析(语法错会让整页白屏)', () => {
if (entryFile === null) throw new Error('上一个检查没通过,跳过')
const text = fs.readFileSync(entryFile, 'utf8')
if (!text.includes('__ModuleLoader__')) throw new Error('入口不像 DSH 客户端 bundle(缺少 __ModuleLoader__)')
if (!text.includes(PLUGIN_ID)) throw new Error(`入口里没有插件 id ${PLUGIN_ID}`)
// 只解析不执行:能抓住未闭合括号、非法 token 这类致命错误。
new vm.Script(text, { filename: entryFile })
return `${Math.round(text.length / 1024)} KB`
})
check('Host 侧装配:内存账本上能起 13 条路由', () => {
const routes = new Map()
const fakeCtx = {
get: () => undefined,
webServer: {
register(route) {
routes.set(route.path, route)
return () => routes.delete(route.path)
},
},
}
const store = new WorkbenchStore({ file: null })
const host = createWorkbenchHost(fakeCtx, { store, startReconciler: false, load: false })
try {
if (routes.size !== 13) throw new Error(`注册了 ${routes.size} 条路由,预期 13 条`)
// bootstrap 要落在具体项目上才有席位;这里现建一个临时项目,不写磁盘。
const project = host.service.registerProject({ hostWorkspaceId: 'preflight' }).project
const boot = host.service.bootstrap(project.id)
if (!Array.isArray(boot.seats) || boot.seats.length !== 10) throw new Error('bootstrap 没有给出十席')
return `${routes.size} 条路由 · 十席就位`
} finally {
host.dispose()
}
})
check('账本落点可写(重启后第一次写账不会失败)', () => {
const dir = path.join(dshHome(), 'sansheng-liubu')
fs.mkdirSync(dir, { recursive: true })
const probe = path.join(dir, '.preflight')
fs.writeFileSync(probe, String(Date.now()))
fs.rmSync(probe, { force: true })
return dir
})
let failed = 0
for (const row of results) {
const mark = row.ok ? 'PASS' : 'FAIL'
if (!row.ok) failed += 1
process.stdout.write(`[${mark}] ${row.name}${row.detail ? ` — ${row.detail}` : ''}\n`)
}
process.stdout.write(`\n${results.length - failed}/${results.length} 通过\n`)
if (failed > 0) process.exitCode = 1