diff --git a/vendor/dsh-remote-ssh/tests/settings-ui-reachability.test.mjs b/vendor/dsh-remote-ssh/tests/settings-ui-reachability.test.mjs new file mode 100644 index 0000000..1db64a4 --- /dev/null +++ b/vendor/dsh-remote-ssh/tests/settings-ui-reachability.test.mjs @@ -0,0 +1,88 @@ +// 设置项的可达性(issue #24 第二轮验收里举报人指出的问题): +// 2.4.24 修好了"写回失败对模型不可见",但 `nodePath`(#23 的逃生舱)、`writeBack*`、 +// `writeBackFreshness` 这几个字段**没有进客户端设置界面** —— 而 #23 的场景恰恰是"终端完全 +// 打不开、最需要一条自救路径"的那批用户;他们够不着设置,等于逃生舱不存在。 +// +// 这个文件同时钉住三件事: +// ① 客户端设置面板真的有这几个控件(而不是只存在于 README 里); +// ② 宿主侧真的有对应端点,且三个 settings face(新版 / 旧版 / 只读兜底)都实现了 updatePrefs; +// ③ `settingsFace.read()` 真的回这几个标量 —— 否则 writeBackFailure / writeBackFreshness +// 的运行时判断永远读不到用户设的值(这是 2.4.24 里一个没被发现的 bug)。 +import { readFileSync } from 'node:fs' + +const root = new URL('..', import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1') +const src = readFileSync(root + '/lib/index.js', 'utf8') +const client = readFileSync(root + '/lib/client.js', 'utf8') + +let pass = 0 +let fail = 0 +const check = (cond, label) => { + if (cond) { pass++; console.log(' ✓ ' + label) } + else { fail++; console.log(' ✗ FAIL: ' + label) } +} + +console.log('A · 客户端设置面板:四个字段都有控件(issue #23 的 nodePath + issue #24 的三项)') +{ + check(/api\("getPrefs"\)/.test(client), '面板加载时读全局偏好(getPrefs)') + check(/api\("savePrefs"/.test(client), '面板能保存全局偏好(savePrefs)') + check(/api\("updateWorkspaceGuards"/.test(client), '每个工作区能保存写回护栏(updateWorkspaceGuards)') + check(/setPref\("nodePath"/.test(client), 'nodePath 有输入框(终端起不来时用户能自救)') + check(/setPref\("writeBackFailure"/.test(client), 'writeBackFailure 有下拉(error / log)') + check(/setPref\("writeBackFreshness"/.test(client), 'writeBackFreshness 有勾选(护栏 B 开关)') + check(/setGuard\(ws\.id, "writeBack"/.test(client), '每个工作区有"启用写回"勾选(护栏 A)') + check(/setGuard\(ws\.id, "exclude"/.test(client), '每个工作区有写回排除输入框(护栏 A)') + check(/placeholder: "_patch\/, \*\.log, wbdeep\/\*\*"/.test(client), '排除项的占位示例就是验收里用过的三条(可照抄)') +} + +console.log('B · 双语键齐备:每个新键在 zh 与 en 各出现一次(只加一种语言是常见疏漏)') +{ + const keys = [ + 'settings.guards', 'settings.guardsHint', 'settings.nodePath', 'settings.writeBackFailure', + 'settings.wbError', 'settings.wbLog', 'settings.writeBackFreshness', + 'settings.wsWriteBack', 'settings.wsWriteBackExclude', 'settings.saveGuards' + ] + for (const k of keys) { + const n = (client.match(new RegExp('"' + k.replace(/\./g, '\\.') + '":', 'g')) || []).length + check(n === 2, k + ' 在 zh/en 各定义一次(实际 ' + n + ')') + } +} + +console.log('C · 宿主端点:白名单、只写这三个字段,且写回的是最新值') +{ + check(/getPrefs: async \(\) => \{/.test(src), '有 getPrefs 端点') + check(/savePrefs: async \(args\) => \{/.test(src), '有 savePrefs 端点') + check(/updateWorkspaceGuards: async \(args\) => \{/.test(src), '有 updateWorkspaceGuards 端点') + const saveBody = src.slice(src.indexOf('savePrefs: async (args) => {'), src.indexOf('updateWorkspaceGuards: async (args) => {')) + check(/typeof a\.nodePath === "string"/.test(saveBody), '只接受字符串 nodePath(白名单,不让客户端乱写)') + check(/patch\.writeBackFailure = \(m === "log" \|\| m === "silent"\) \? "log" : "error"/.test(saveBody), + 'writeBackFailure 只归一化成 error / log 两态(避免写入拼错的字符串)') + check(/typeof a\.writeBackFreshness === "boolean"/.test(saveBody), 'writeBackFreshness 只接受布尔') + check(!/patch\.profiles/.test(saveBody) && !/patch\.workspaces/.test(saveBody), '不会顺手改 profiles / workspaces(负向控制)') + const guardBody = src.slice(src.indexOf('updateWorkspaceGuards: async (args) => {'), src.indexOf('createRemoteWorkspace: async (args) => {')) + check(/settingsFace\.updateWorkspaces\(list\)/.test(guardBody), '工作区护栏走整表替换(schema 是数组字段)') + check(/\.map\(\(s\) => String\(s \|\| ""\)\.trim\(\)\)\.filter\(Boolean\)/.test(guardBody), '排除项去空白、丢空串(否则空规则会命中一切)') +} + +console.log('D · 三个 settings face 都要有 updatePrefs,否则旧版 DSH 上保存会静默无效') +{ + const n = (src.match(/updatePrefs:/g) || []).length + check(n === 3, 'updatePrefs 在三处都实现(新版 describe/update、旧版 register、只读兜底;实际 ' + n + ')') + check(/updatePrefs: \(patch\) => write\(patch\)/.test(src), '新版 face:写进 loader 行的 Config') + check(/updatePrefs: async \(patch\) => \{ await scope\.update\(patch\); \}/.test(src), '旧版 face:走 scope.update') +} + +console.log('E · read() 必须回标量(2.4.24 的隐性 bug:writeBackFailure 读了 undefined)') +{ + check(/nodePath: String\(prefsScalar\("", v && v\.nodePath/.test(src), '新版 read() 回 nodePath') + check(/writeBackFailure: String\(prefsScalar\("error", v && v\.writeBackFailure/.test(src), '新版 read() 回 writeBackFailure') + check(/writeBackFreshness: prefsScalar\(true, v && v\.writeBackFreshness/.test(src), '新版 read() 回 writeBackFreshness') + const reads = (src.match(/nodePath: String\(prefsScalar/g) || []).length + check(reads === 3, '三个 face 的 read() 都回这些标量(实际 ' + reads + ')') + // 运行时的两个判断读的就是 read() 的字段 —— 把这条关系钉住,避免以后又把字段挪走 + const failureMode = src.slice(src.indexOf('function writeBackFailureMode() {'), src.indexOf('function writeBackFreshnessEnabled() {')) + check(/settingsFace\.read\(\)\.writeBackFailure/.test(failureMode), 'writeBackFailureMode 读的是 read().writeBackFailure') + check(/settingsFace\.read\(\)\.writeBackFreshness/.test(src), 'writeBackFreshnessEnabled 读的是 read().writeBackFreshness') +} + +console.log(`\n结果: ${pass} 通过, ${fail} 失败`) +process.exit(fail ? 1 : 0)