From 4c52fc035c007c3bce910d0553def7f87ae0f126 Mon Sep 17 00:00:00 2001 From: QQ Date: Wed, 11 Nov 2026 22:39:41 +0800 Subject: [PATCH] Import vendor/dsh-remote-ssh/tests/settings-compat.test.mjs --- .../tests/settings-compat.test.mjs | 256 ++++++++++++++++++ 1 file changed, 256 insertions(+) create mode 100644 vendor/dsh-remote-ssh/tests/settings-compat.test.mjs diff --git a/vendor/dsh-remote-ssh/tests/settings-compat.test.mjs b/vendor/dsh-remote-ssh/tests/settings-compat.test.mjs new file mode 100644 index 0000000..fcbc8cd --- /dev/null +++ b/vendor/dsh-remote-ssh/tests/settings-compat.test.mjs @@ -0,0 +1,256 @@ +// DSH 0.1.7-rc.2 settings 兼容层 回归测试(issue #16)。 +// +// 背景:0.1.7-rc.2 的 `settings` 服务移除了 `register(ns, schema)`,改为 +// 读 `describe()`(按 **profile entry id** 取,ns 不再是包名) +// 写 `update(entryId, patch, revision)` +// 用户偏好存放于**本插件 loader 行的 Config**,且字段必须标 `.volatile()` +// (否则 Loader 的 volatile-commit 路径不提交,写入"报成功但值不变")。 +// 旧版的 section 键是包名(dsh-remote-ssh),新版按 entry id(remote-ssh)导入 → +// 旧数据会被留在 `settings.yaml.imported`,必须自己迁移,否则升级后连接/工作区全为空。 +// +// 三层:A. 纯函数(ownEntryId / 旧 section 解析 / 读取 / 数组提取) +// B. 外观与迁移行为(假 settings 服务) +// C. 接线与 schema(Config 用 volatile、双版本分支、解析器依赖) +import { readFileSync, mkdtempSync, writeFileSync, mkdirSync, rmSync } from 'node:fs' +import { tmpdir } from 'node:os' +import { join, dirname } from 'node:path' +import { pathToFileURL } from 'node:url' + +const root = new URL('..', import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1') +const src = readFileSync(root + '/lib/index.js', 'utf8') + +/** + * 仓库本身不装 node_modules(依赖由 profile 提供),所以按目录查找真实包再按绝对路径导入。 + * CJS/ESM 双形态都兼容:优先取命名导出,取不到再退回 default。 + */ +async function loadDep(name, member) { + const candidates = [ + process.env.DSH_PROFILE_DIR ? join(process.env.DSH_PROFILE_DIR, 'node_modules', name) : undefined, + join(process.env.USERPROFILE || '', '.dsh', 'profiles', 'desktop', 'node_modules', name), + 'E:\\Program Files\\DSH Desktop\\resources\\app\\node_modules\\' + name, + join(root, 'node_modules', name), + ].filter(Boolean) + const dir = candidates.find((p) => { + try { return readFileSync(join(p, 'package.json'), 'utf8').length > 0 } catch (e) { return false } + }) + if (!dir) throw new Error('找不到依赖: ' + name) + const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8')) + const entry = pkg.main || (pkg.exports && typeof pkg.exports === 'string' ? pkg.exports : 'index.js') + const mod = await import(pathToFileURL(join(dir, entry)).href) + if (member && mod[member] !== undefined) return mod[member] + const def = mod.default && mod.default[member] !== undefined ? mod.default[member] : mod.default + return def !== undefined ? def : mod +} + +const parseYaml = await loadDep('yaml', 'parse') +const z = await loadDep('@deepseek-ai/schemastery') + +function grab(name) { + const start = src.indexOf(name) + if (start < 0) throw new Error(name + ' not found') + const declStart = src.lastIndexOf('\n', start) + let i = src.indexOf('{', start) + let depth = 0 + for (; i < src.length; i++) { + if (src[i] === '{') depth++ + else if (src[i] === '}') { depth--; if (depth === 0) break } + } + return src.slice(declStart + 1, i + 1) +} + +const api = new Function( + 'parseYaml', 'join', 'readFile', 'z', + grab('function ownEntryId') + '\n' + grab('function parseLegacyPrefsSection') + '\n' + + grab('async function readLegacyPrefs') + '\n' + grab('function resolvePrefValue') + '\n' + grab('function prefsArray') + '\n' + + grab('function prefsScalar') + '\n' + + // issue #28:read() 里还要归一化全局默认同步范围,这两个 helper 必须一起进沙箱 + grab('function prefsNumber') + '\n' + grab('function normalizeSyncList') + '\n' + grab('function parseSyncMaxBytes') + '\n' + + grab('function describePrefsShape') + '\n' + + grab('function createNewSettingsFace') + '\n' + grab('async function migrateLegacyPrefs') + + '\nreturn { ownEntryId, parseLegacyPrefsSection, readLegacyPrefs, resolvePrefValue, prefsArray, prefsScalar, prefsNumber, normalizeSyncList, parseSyncMaxBytes, createNewSettingsFace, migrateLegacyPrefs };' +)( + parseYaml, + (await import('node:path')).join, + (await import('node:fs/promises')).readFile, + z, +) + +let pass = 0, fail = 0 +const check = (cond, label) => { if (cond) { pass++; console.log(' ✓ ' + label) } else { fail++; console.log(' ✗ FAIL: ' + label) } } + +const PKG = '@zhangfengshun/dsh-remote-ssh' + +console.log('A1 · ownEntryId(新版命名空间 = loader entry id)') +{ + const mkCtx = (entries, fiber) => ({ fiber, loader: { entries: () => entries } }) + const fiber = {} + check(api.ownEntryId(mkCtx([{ options: { id: 'remote-ssh', name: PKG }, fiber }], fiber), PKG) === 'remote-ssh', + '按 fiber 命中本插件行 → 返回其 id') + check(api.ownEntryId(mkCtx([{ options: { id: 'other', name: 'x' }, fiber }, { options: { id: 'remote-ssh', name: PKG }, fiber: {} }], fiber), PKG) === 'remote-ssh', + 'fiber 不匹配时退回「同包名且未禁用」的行') + check(api.ownEntryId(mkCtx([{ options: { id: 'remote-ssh', name: PKG }, fiber: {}, disabled: true }], fiber), PKG) === undefined, + '只有被禁用的行 → undefined(调用方回退 NS)') + check(api.ownEntryId(mkCtx([{ options: { name: PKG }, fiber }], fiber), PKG) === undefined, 'id 非字符串 → 跳过') + check(api.ownEntryId({ loader: { entries: () => { throw new Error('boom') } } }, PKG) === undefined, 'loader 抛错 → 安全返回 undefined') +} + +console.log('A2 · parseLegacyPrefsSection(旧 section 键是包名)') +{ + const yamlText = [ + 'llm-deepseek:', + ' baseURL: https://example.invalid', + 'dsh-remote-ssh:', + ' profiles:', + ' - id: p1', + ' host: hpc-a.example.com', + ' workspaces:', + ' - id: w1', + ' mirrorPath: ~/.dsh/remote-workspaces/wmirror1', + ' unrelatedLegacyField: dropped', + ].join('\n') + const section = api.parseLegacyPrefsSection(yamlText, 'dsh-remote-ssh', ['profiles', 'workspaces']) + check(!!section && Array.isArray(section.profiles) && section.profiles.length === 1, '取到 profiles(1 条)') + check(section.profiles[0].host === 'hpc-a.example.com', '条目字段保留') + check(section.unrelatedLegacyField === undefined, 'section 内未声明的**顶层**键被过滤(不写与 Config 无关的字段)') + check(Array.isArray(section.workspaces) && section.workspaces.length === 1, '取到 workspaces') + check(api.parseLegacyPrefsSection(yamlText, 'nope', ['profiles']) === undefined, 'section 不存在 → undefined') + check(api.parseLegacyPrefsSection('{{ not yaml', 'dsh-remote-ssh', ['profiles']) === undefined, 'YAML 损坏 → undefined(不抛)') + check(api.parseLegacyPrefsSection('dsh-remote-ssh: [1,2]', 'dsh-remote-ssh', ['profiles']) === undefined, 'section 是数组 → undefined') + check(api.parseLegacyPrefsSection('dsh-remote-ssh:\n other: 1', 'dsh-remote-ssh', ['profiles', 'workspaces']) === undefined, + '过滤后为空 → undefined(不写空配置)') +} + +console.log('A3 · readLegacyPrefs(.imported 优先,退回 settings.yaml)') +{ + const dir = mkdtempSync(join(tmpdir(), 'rssh-legacy-')) + try { + const ns = 'dsh-remote-ssh' + const declared = ['profiles', 'workspaces'] + // 只有 settings.yaml 时 + writeFileSync(join(dir, 'settings.yaml'), 'dsh-remote-ssh:\n profiles:\n - id: old\n') + let got = await api.readLegacyPrefs(dir, ns, declared) + check(!!got && got.profiles[0].id === 'old', '只有 settings.yaml → 能读到(迁移进行中的主机)') + // 两个都在时,.imported 优先 + writeFileSync(join(dir, 'settings.yaml.imported'), 'dsh-remote-ssh:\n profiles:\n - id: imported\n') + got = await api.readLegacyPrefs(dir, ns, declared) + check(!!got && got.profiles[0].id === 'imported', '两个都在 → .imported 优先(已启动过一次的主机)') + // 都没有 + const empty = mkdtempSync(join(tmpdir(), 'rssh-legacy-empty-')) + try { + check((await api.readLegacyPrefs(empty, ns, declared)) === undefined, '两个文件都没有 → undefined') + check((await api.readLegacyPrefs('', ns, declared)) === undefined, '空 home → undefined') + } finally { rmSync(empty, { recursive: true, force: true }) } + } finally { + rmSync(dir, { recursive: true, force: true }) + } +} + +console.log('A4 · prefsArray / resolvePrefValue(volatile 字段是**引用对象**,要 .get())') +{ + check(api.prefsArray([1, 2]).length === 2, '普通数组直接返回') + // issue #16 报告者明确提示的形状:schema 验证后字段是引用对象而非数组 + const ref = { get: () => [{ id: 'fromRef' }], meta: { volatile: true } } + check(api.prefsArray(ref).length === 1 && api.prefsArray(ref)[0].id === 'fromRef', 'volatile 引用对象 → 调 .get() 取实时值') + check(api.prefsArray({ meta: { volatile: true }, value: [9] })[0] === 9, '带 meta.volatile 的普通包装 → 取 .value') + // get() 抛错时安全跳过,继续试下一个候选 + const bad = { get: () => { throw new Error('gone') } } + check(api.prefsArray(bad, [7])[0] === 7, '.get() 抛错 → 跳过该候选,退回下一个') + check(api.prefsArray(undefined, null, 'x').length === 0, '都不是数组 → 空数组') + check(api.resolvePrefValue('plain') === 'plain' && api.resolvePrefValue(null) === null, 'resolvePrefValue 对普通值原样返回') +} + +console.log('A5 · prefsScalar(标量偏好:nodePath / writeBackFailure / writeBackFreshness)') +{ + check(api.prefsScalar('', 'x') === 'x', '取到第一个非空候选') + check(api.prefsScalar('err', undefined, null, '') === 'err', '全部为空 → 回退默认值(空串也算"没设")') + // false 是合法取值,必须原样返回 —— 护栏 B 的开关就靠这一条 + check(api.prefsScalar(true, false) === false, '**false 是合法值**,不能被当成"没设"而回退默认(护栏 B 开关)') + check(api.prefsScalar('error', { get: () => 'log', meta: { volatile: true } }) === 'log', 'volatile 引用对象 → 调 .get()(与数组同源问题)') + check(api.prefsScalar(true, { get: () => { throw new Error('gone') } }, false) === false, '.get() 抛错 → 跳过该候选,继续试下一个') + check(api.prefsScalar(0, 0) === 0, '0 也不算空(数值偏好可用)') +} + +console.log('B1 · createNewSettingsFace(新版读写)') +{ + const calls = [] + const value = { profiles: [{ id: 'p1' }, { id: 'p2' }], workspaces: [{ id: 'w1' }] } + const svc = { + describe: (opts) => { calls.push(['describe', opts]); return [{ ns: 'other', value: {} }, { ns: 'remote-ssh', value, revision: 7, user: {} }] }, + update: async (ns, patch, rev) => { calls.push(['update', ns, patch, rev]) }, + } + const built = api.createNewSettingsFace(svc, 'remote-ssh', { profiles: [], workspaces: [] }, { warn: () => {} }) + const read = built.face.read() + check(read.profiles.length === 2 && read.workspaces.length === 1, '按 entry id 从 describe().value 读取') + check(calls[0][0] === 'describe' && calls[0][1].redactSecrets === false, 'describe 以 redactSecrets:false 读(运行时需要明文口令拼 ssh;对外出口由 publicProfiles 脱敏)') + await built.face.updateProfiles([{ id: 'p9' }]) + const upd = calls.find((c) => c[0] === 'update') + check(!!upd && upd[1] === 'remote-ssh' && upd[3] === 7, '写走 update(entryId, patch, revision)(带 revision 防并发覆盖)') + check(!!upd && Array.isArray(upd[2].profiles) && upd[2].profiles[0].id === 'p9', 'patch 只带被改的字段') + + // 表单缺失 → 退回 fallback(apply 的 config;volatile 引用要 .get()) + const svc2 = { describe: () => [], update: async () => {} } + const built2 = api.createNewSettingsFace(svc2, 'remote-ssh', { profiles: [{ id: 'fromConfig' }], workspaces: [] }, { warn: () => {} }) + check(built2.face.read().profiles[0].id === 'fromConfig', '表单缺失 → 退回 apply(config) 的值') + const built2b = api.createNewSettingsFace(svc2, 'remote-ssh', { profiles: { get: () => [{ id: 'fromRef' }], meta: { volatile: true } } }, { warn: () => {} }) + check(built2b.face.read().profiles[0].id === 'fromRef', 'apply(config) 的字段是引用对象时也能读到(.get())') + + // 刚迁移进来的数据:让升级后第一次启动即可见(describe 与 config 都还是空) + const migrated = { profiles: [{ id: 'justImported' }], workspaces: [{ id: 'w-imported' }] } + const built2c = api.createNewSettingsFace(svc2, 'remote-ssh', {}, { warn: () => {} }, migrated) + const readC = built2c.face.read() + check(readC.profiles[0].id === 'justImported' && readC.workspaces[0].id === 'w-imported', '迁移后的内存兜底:第一次启动就能看到连接与工作区') + // describe 抛错 → 不炸 + const svc3 = { describe: () => { throw new Error('svc down') }, update: async () => {} } + const warnings = [] + const built3 = api.createNewSettingsFace(svc3, 'remote-ssh', { profiles: [], workspaces: [] }, { warn: (m) => warnings.push(m) }) + check(built3.face.read().profiles.length === 0 && warnings.length === 1, 'describe 抛错 → 空配置 + 一条 warn(不抛)') +} + +console.log('B2 · migrateLegacyPrefs(仅在用户层为空时导入)') +{ + const dir = mkdtempSync(join(tmpdir(), 'rssh-migrate-')) + try { + writeFileSync(join(dir, 'settings.yaml.imported'), 'dsh-remote-ssh:\n profiles:\n - id: legacy\n workspaces:\n - id: w9\n') + const updates = [] + const svc = { describe: () => [], update: async (ns, patch) => { updates.push([ns, patch]) } } + const formOfEmpty = () => ({ ns: 'remote-ssh', value: { profiles: [], workspaces: [] }, revision: 1, user: {} }) + const out1 = await api.migrateLegacyPrefs({ svc, entryId: 'remote-ssh', formOf: formOfEmpty, homeDir: dir, ns: 'dsh-remote-ssh', declaredKeys: ['profiles', 'workspaces'], log: {} }) + check(out1 === 'imported', '用户层为空 → 导入旧 section') + check(updates.length === 1 && updates[0][0] === 'remote-ssh' && updates[0][1].profiles[0].id === 'legacy' && updates[0][1].workspaces[0].id === 'w9', + '写到 entry id,且 profiles/workspaces 都带上') + + updates.length = 0 + const formOfUser = () => ({ ns: 'remote-ssh', value: {}, revision: 2, user: { profiles: [{ id: 'newer' }] } }) + const out2 = await api.migrateLegacyPrefs({ svc, entryId: 'remote-ssh', formOf: formOfUser, homeDir: dir, ns: 'dsh-remote-ssh', declaredKeys: ['profiles', 'workspaces'], log: {} }) + check(out2 === 'already-configured' && updates.length === 0, '用户层已有值 → 不导入(绝不覆盖升级后的设置)') + + const out3 = await api.migrateLegacyPrefs({ svc, entryId: 'remote-ssh', formOf: formOfEmpty, homeDir: '', ns: 'dsh-remote-ssh', declaredKeys: ['profiles'], log: {} }) + check(out3 === 'no-profile-home', '没有 profile home → no-profile-home') + const out4 = await api.migrateLegacyPrefs({ svc, entryId: 'remote-ssh', formOf: formOfEmpty, homeDir: join(dir, 'nope'), ns: 'dsh-remote-ssh', declaredKeys: ['profiles'], log: {} }) + check(out4 === 'no-legacy-section', '没有旧文件 → no-legacy-section(不写空配置)') + } finally { + rmSync(dir, { recursive: true, force: true }) + } +} + +console.log('C · 接线与 schema') +{ + check(/import z from "@deepseek-ai\/schemastery";/.test(src), '用 DSH 分支的 schemastery(只有它实现 .volatile())') + check(/import \{ parse as parseYaml \} from "yaml";/.test(src), '引入 yaml 解析器(旧 settings.yaml 迁移用)') + check(/PrefsSchema\.dict\[key\]\.volatile\(\)/.test(src), 'Config 字段逐个标 .volatile()(否则新版 Loader 不提交写入)') + check(/const Config = z\.object\(Object\.fromEntries/.test(src), 'Config 由 PrefsSchema 派生(单一事实来源)') + const cfgIdx = src.indexOf('const Config = z.object(Object.fromEntries') + const prefsIdx = src.indexOf('const PrefsSchema = z.object') + check(prefsIdx > 0 && cfgIdx > prefsIdx, 'Config 定义在 PrefsSchema 之后(模块级求值顺序)') + check(/typeof svc\.describe === "function" && typeof svc\.update === "function"/.test(src), '新版分支按能力探测(describe + update)') + check(/typeof svc\.register === "function"/.test(src), '旧版分支保留 register(≤0.1.6 兼容)') + check(/svc\.configure\(\{ auto: false \}, ctx\.fiber\)/.test(src), '新版用 configure 注册页面策略(替代 register)') + check(/ctx\.loader\.await/.test(src), '迁移等 loader 落定后再写(与 better-sidebar 一致)') + check(/ctx\.profileContext && ctx\.profileContext\.home/.test(src), '迁移从 profileContext.home 找旧 settings.yaml') + const pkg = JSON.parse(readFileSync(root + '/package.json', 'utf8')) + check(pkg.dependencies['@deepseek-ai/schemastery'] !== undefined, 'package.json 声明 @deepseek-ai/schemastery 依赖') + check(pkg.dependencies.yaml !== undefined, 'package.json 声明 yaml 依赖') +} + +console.log(`\n结果: ${pass} 通过, ${fail} 失败`) +process.exit(fail ? 1 : 0)