163 lines
9.4 KiB
JavaScript
163 lines
9.4 KiB
JavaScript
// 清单兼容性 回归测试(2026-09-28:DSH 0.2.0-rc.1 起 harness 会阻止不兼容插件)。
|
||
//
|
||
// 背景:DSH 的插件管理器用**插件自己声明的 DSH peer 版本范围**判定兼容性:
|
||
// 范围覆盖不到当前运行时版本时,安装/激活被整条拒绝("Plugin … is incompatible with dsh <v>"),
|
||
// 只能靠 `dsh plugin allow-version … --accept-risk` 逐版本豁免(官方警告:可能崩溃、丢数据)。
|
||
// 2.4.15 只声明了 `^0.1.0-rc.6`,在 0.2.0-rc.1 上被拒 —— 插件在宿主里根本不出现。
|
||
//
|
||
// ⚠ 语义要点:判定是**严格 npm semver**(预发布版本只被"元组相同且自身带预发布"的比较器接受)。
|
||
// 因此 `^0.1.0-rc.6` 覆盖不到 `0.1.5-rc.1`/`0.1.7-rc.2`/`0.2.0-rc.1` 这些**预发布**运行时 ——
|
||
// 必须像 dsh-cron 那样把每条已验证的版本线**显式列出**(`^0.1.5-rc.1 || ^0.1.7-rc.2 || …`)。
|
||
//
|
||
// 本测试用内置的严格比较器断言:每个 peer 范围覆盖**全部已验证版本线**,且不越界声明未验证的线。
|
||
import { readFileSync, existsSync } from 'node:fs'
|
||
import { join } from 'node:path'
|
||
|
||
const root = new URL('..', import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1')
|
||
const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
|
||
|
||
/** 我们已实测过的运行时版本线(新增验证后往这里加;每条都必须被每个 peer 范围覆盖)。 */
|
||
const VERIFIED_LINES = ['0.1.0-rc.6', '0.1.5-rc.1', '0.1.7-rc.2', '0.2.0-rc.1', '0.2.1-rc.1']
|
||
/**
|
||
* 当前官方最新线(harness 实际跑的目标)。
|
||
*
|
||
* 注:本文件的比较器是**严格** npm semver(预发布需"元组相同且比较器自带预发布"),等价于宿主
|
||
* `semver.satisfies(v, range)` **不带** `includePrerelease` 的判定,也正是最坏情况。0.2.1-rc.1 这条线
|
||
* 显式列进每个 peer 后,两种判定都通过;只写到 `^0.2.0-rc.1` 时,则只有宿主加 `includePrerelease: true`
|
||
* 才通过(dsh-app-boot 目前确实加了,但那是宿主实现细节,不该由它兜底)。
|
||
*/
|
||
const TARGET = process.env.DSH_RUNTIME_VERSION || '0.2.1-rc.1'
|
||
/** 运行时实际带的 cordis 版本(cordis 是普通库,版本号不属于 DSH 线)。 */
|
||
const CORDIS_VERSION = process.env.DSH_CORDIS_VERSION || '4.0.5'
|
||
|
||
// ---- 小型 semver(覆盖本项目用到的写法:^x.y.z、可带 -pre、`||` 列表),严格语义 ----
|
||
function parseVersion(text) {
|
||
const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(String(text).trim())
|
||
if (!m) return null
|
||
return { major: +m[1], minor: +m[2], patch: +m[3], pre: m[4] ? m[4].split('.') : [] }
|
||
}
|
||
function compareIdentifiers(a, b) {
|
||
const an = /^\d+$/.test(a), bn = /^\d+$/.test(b)
|
||
if (an && bn) return Number(a) - Number(b)
|
||
if (an) return -1 // 数字标识符优先级低于字母
|
||
if (bn) return 1
|
||
return a < b ? -1 : a > b ? 1 : 0
|
||
}
|
||
function compareVersions(a, b) {
|
||
const va = parseVersion(a), vb = parseVersion(b)
|
||
if (!va || !vb) throw new Error('版本号无法解析: ' + a + ' / ' + b)
|
||
for (const k of ['major', 'minor', 'patch']) if (va[k] !== vb[k]) return va[k] - vb[k]
|
||
if (va.pre.length === 0 && vb.pre.length === 0) return 0
|
||
if (va.pre.length === 0) return 1 // 正式版 > 预发布
|
||
if (vb.pre.length === 0) return -1
|
||
for (let i = 0; i < Math.max(va.pre.length, vb.pre.length); i++) {
|
||
if (va.pre[i] === undefined) return -1
|
||
if (vb.pre[i] === undefined) return 1
|
||
const d = compareIdentifiers(va.pre[i], vb.pre[i])
|
||
if (d !== 0) return d
|
||
}
|
||
return 0
|
||
}
|
||
function sameTuple(a, b) {
|
||
return a.major === b.major && a.minor === b.minor && a.patch === b.patch
|
||
}
|
||
/** caret 范围展开成一对比较器(>=floor, <ceil);0.x 线提升 minor。 */
|
||
function caretComparators(range) {
|
||
const v = parseVersion(range.slice(1))
|
||
if (!v) throw new Error('不支持的 caret 范围: ' + range)
|
||
return [
|
||
{ op: '>=', version: range.slice(1) },
|
||
{ op: '<', version: v.major === 0 ? `0.${v.minor + 1}.0` : `${v.major + 1}.0.0` },
|
||
]
|
||
}
|
||
/**
|
||
* 严格 npm semver:预发布版本 v 只有在"某个比较器的元组与 v 相同、且该比较器自身带预发布"时才可能满足。
|
||
* (这正是 `^0.1.0-rc.6` 挡不住也放不过 `0.2.0-rc.1`、而 `^0.2.0-rc.1` 才覆盖它的原因。)
|
||
*/
|
||
function satisfiesRange(version, range) {
|
||
const v = parseVersion(version)
|
||
if (!v) throw new Error('版本号无法解析: ' + version)
|
||
const sets = String(range).split('||').map((r) => r.trim()).filter(Boolean).map(caretComparators)
|
||
for (const comparators of sets) {
|
||
const ok = comparators.every((c) => {
|
||
const cmp = compareVersions(version, c.version)
|
||
return c.op === '>=' ? cmp >= 0 : cmp < 0
|
||
})
|
||
if (!ok) continue
|
||
if (v.pre.length > 0) {
|
||
const allowed = comparators.some((c) => {
|
||
const cv = parseVersion(c.version)
|
||
return cv.pre.length > 0 && sameTuple(cv, v)
|
||
})
|
||
if (!allowed) continue
|
||
}
|
||
return true
|
||
}
|
||
return false
|
||
}
|
||
|
||
let pass = 0, fail = 0
|
||
const check = (cond, label) => { if (cond) { pass++; console.log(' ✓ ' + label) } else { fail++; console.log(' ✗ FAIL: ' + label) } }
|
||
|
||
console.log('A · 比较器自检(先证明围栏本身与 harness 判定一致)')
|
||
{
|
||
check(satisfiesRange('0.1.0-rc.6', '^0.1.0-rc.6') === true, '^0.1.0-rc.6 覆盖自身')
|
||
check(satisfiesRange('0.1.7-rc.2', '^0.1.0-rc.6') === false, '⚠ 严格语义:^0.1.0-rc.6 **不**覆盖 0.1.7-rc.2(预发布需元组匹配)')
|
||
check(satisfiesRange('0.1.7-rc.2', '^0.1.7-rc.2') === true, '^0.1.7-rc.2 覆盖 0.1.7-rc.2')
|
||
check(satisfiesRange('0.2.0-rc.1', '^0.1.0-rc.6') === false, '⚠ 回归点:^0.1.0-rc.6 **不**覆盖 0.2.0-rc.1(2.4.15 被拒的原因)')
|
||
check(satisfiesRange('0.2.0-rc.1', '^0.2.0-rc.1') === true, '^0.2.0-rc.1 覆盖 0.2.0-rc.1')
|
||
// 0.2.1-rc.1(2026-10-17 实测 harness 版本):只写到 ^0.2.0-rc.1 时,本严格判定为 false ——
|
||
// 也就是说旧范围能通过完全依赖宿主传 includePrerelease: true。显式加线后两种判定都成立。
|
||
check(satisfiesRange('0.2.1-rc.1', '^0.2.0-rc.1') === false, '⚠ 脆弱点:严格判定下 ^0.2.0-rc.1 **不**覆盖 0.2.1-rc.1(需宿主加 includePrerelease)')
|
||
check(satisfiesRange('0.2.1-rc.1', '^0.2.0-rc.1 || ^0.2.1-rc.1') === true, '显式加 ^0.2.1-rc.1 后严格判定也覆盖 0.2.1-rc.1(消除对宿主选项的依赖)')
|
||
check(satisfiesRange('0.4.0', '^0.2.1-rc.1') === false, '^0.2.1-rc.1 不越界覆盖 0.4.x')
|
||
check(satisfiesRange('0.3.0-rc.1', '^0.2.0-rc.1') === false, '^0.2.0-rc.1 不越界覆盖 0.3 线')
|
||
check(satisfiesRange('0.1.0-rc.6', '^0.1.0-rc.6 || ^0.1.5-rc.1 || ^0.1.7-rc.2 || ^0.2.0-rc.1') === true, 'OR 列表覆盖首条线')
|
||
check(satisfiesRange('0.1.5-rc.3', '^0.1.0-rc.6 || ^0.1.5-rc.1 || ^0.1.7-rc.2 || ^0.2.0-rc.1') === true, 'OR 列表覆盖 0.1.5 线的补丁预发布')
|
||
check(satisfiesRange('4.0.4', '^4.0.1') === true, '^4.0.1 覆盖 4.0.4(正式版比较)')
|
||
check(satisfiesRange('5.0.0', '^4.0.1') === false, '^4.0.1 不越界覆盖 5.x')
|
||
}
|
||
|
||
console.log('B · 每个 peer 范围覆盖全部已验证版本线')
|
||
{
|
||
const peers = pkg.peerDependencies || {}
|
||
const dshPeers = Object.keys(peers).filter((n) => n !== '@deepseek-ai/cordis')
|
||
check(dshPeers.length >= 3, `声明了 ${dshPeers.length} 个 DSH peer`)
|
||
for (const name of dshPeers) {
|
||
for (const line of VERIFIED_LINES) {
|
||
check(satisfiesRange(line, peers[name]) === true, `${name} 覆盖 ${line}`)
|
||
}
|
||
check(satisfiesRange(TARGET, peers[name]) === true, `${name} 覆盖当前官方最新 ${TARGET}`)
|
||
}
|
||
for (const name of ['@deepseek-ai/dsh-tools', '@deepseek-ai/dsh-client-locale', '@deepseek-ai/dsh-client-ui-primitives']) {
|
||
check(typeof peers[name] === 'string', `声明了 ${name}`)
|
||
}
|
||
check(satisfiesRange(CORDIS_VERSION, peers['@deepseek-ai/cordis'] || '') === true, `cordis 范围覆盖运行时实际版本 ${CORDIS_VERSION}`)
|
||
}
|
||
|
||
console.log('C · 不越界(不声明未实测的版本线)')
|
||
{
|
||
const peers = pkg.peerDependencies || {}
|
||
for (const name of Object.keys(peers)) {
|
||
if (name === '@deepseek-ai/cordis') continue
|
||
check(satisfiesRange('0.3.0-rc.1', peers[name]) === false, `${name} 不声明 0.3 线(未验证)`)
|
||
check(satisfiesRange('1.0.0', peers[name]) === false, `${name} 不声明 1.x(未验证)`)
|
||
}
|
||
}
|
||
|
||
console.log('D · 客户端注入清单与 bundle 声明')
|
||
{
|
||
const inject = (pkg.dsh && pkg.dsh.client && pkg.dsh.client.inject) || []
|
||
check(pkg.dsh && pkg.dsh.bundle && pkg.dsh.bundle.patch === './cordis.patch.yml', 'dsh.bundle.patch 指向 cordis.patch.yml')
|
||
check(existsSync(join(root, 'cordis.patch.yml')), 'cordis.patch.yml 确实存在(否则 bundle 无法装载)')
|
||
check((pkg.dsh && pkg.dsh.client && pkg.dsh.client.platform) === 'web', 'client.platform = web')
|
||
check(inject.includes('@deepseek-ai/dsh-client-ui-primitives'), 'client 注入 dsh-client-ui-primitives(client.js 真的 require 它)')
|
||
check(inject.includes('@deepseek-ai/dsh-client-locale') && inject.includes('@deepseek-ai/dsh-client-ui-slots'), 'client 注入 locale 与 ui-slots')
|
||
check(inject.includes('@deepseek-ai/dsh-client-modules'), 'client 注入 dsh-client-modules(客户端插件运行时)')
|
||
// 0.2.0-rc.1 起运行时不再提供 dsh-client-runtime;注入不存在的包会让客户端半边装不上
|
||
check(!inject.includes('@deepseek-ai/dsh-client-runtime'), '不再注入 dsh-client-runtime(0.2.0-rc.1 运行时已无此包,代码也未使用)')
|
||
}
|
||
|
||
console.log(`\n结果: ${pass} 通过, ${fail} 失败`)
|
||
process.exit(fail ? 1 : 0)
|