// 同步范围的可达性(issue #28)。 // // 举报人核对过:`syncPaths` / `syncExclude` / `syncMaxBytes`(#20 引入)后端早就齐了 // —— schema 有字段、`updateWorkspace` 能写、`syncOptsFrom` 有三级回退 —— 但 GUI 里 // 一个入口都没有,「添加工作区」也只会建出 `syncPaths: []` 的工作区。对 remotePath 是 // `~` 的工作区,空范围意味着 sync 退化成整树、先被 2 GiB 体积哨兵拒绝,每次都得手改配置 // 或直调 HTTP。 // // 这个文件钉住四件事: // ① 三个归一化/解析函数的行为(抽真实实现跑,不是看代码里有没有写); // ② 宿主三个入口(updateWorkspaceGuards / createRemoteWorkspace / savePrefs+getPrefs) // 都真的接住了这三个字段,且 createRemoteWorkspace 会回落到全局默认; // ③ 三个 settings face 的 read() 都回 defaultSync*(少一处,设置面板在旧版 DSH 上就显示空); // ④ 客户端真有控件(含「添加工作区」弹窗与手动同步按钮),且新文案中英各一份。 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) } } /** 从源码里按大括号配对抽出一个函数声明(含注释头)。 */ function grab(text, name) { const start = text.indexOf(name) if (start < 0) throw new Error(name + ' not found') const declStart = text.lastIndexOf('\n', start) let i = text.indexOf('{', start) let depth = 0 for (; i < text.length; i++) { if (text[i] === '{') depth++ else if (text[i] === '}') { depth--; if (depth === 0) break } } return text.slice(declStart + 1, i + 1) } console.log('A · 归一化函数的行为(抽真实实现跑)') { const block = [ grab(src, 'function normalizeSyncList('), grab(src, 'function parseSyncMaxBytes(') ].join('\n') const fns = new Function(block + '\nreturn { normalizeSyncList, parseSyncMaxBytes }')() const { normalizeSyncList, parseSyncMaxBytes } = fns check(Array.isArray(normalizeSyncList(['a', ' b ', '', ' '])), 'normalizeSyncList 回数组') check(JSON.stringify(normalizeSyncList(['a', ' b ', '', ' '])) === '["a","b"]', '数组输入:trim + 丢空串') check(JSON.stringify(normalizeSyncList('.dsh, src\n docs;config')) === '[".dsh","src","docs","config"]', '整串输入:逗号/换行/分号都认(与客户端输入框同语义)') check(JSON.stringify(normalizeSyncList(['a', 'a', ' a '])) === '["a"]', '重复项去重(否则 tar 命令行无谓变长)') check(JSON.stringify(normalizeSyncList(null)) === '[]' && JSON.stringify(normalizeSyncList(undefined)) === '[]', 'null / undefined → 空数组(清空范围时不会塞进奇怪值)') check(JSON.stringify(normalizeSyncList('')) === '[]', '空串 → 空数组(空 exclude 会命中一切,必须丢掉)') check(parseSyncMaxBytes(0) === 0, '数字 0 是合法值(= 用内置默认上限)') check(parseSyncMaxBytes(1048576) === 1048576, '数字按字节原样接受') check(parseSyncMaxBytes('2 GiB') === 2 * 1024 * 1024 * 1024, '"2 GiB" 按 1024 进制解析') check(parseSyncMaxBytes('512MB') === 512 * 1000 * 1000, '"512MB" 按 1000 进制解析') check(parseSyncMaxBytes('1.5GiB') === Math.round(1.5 * 1024 * 1024 * 1024), '接受小数') check(parseSyncMaxBytes(-1) === null, '负数非法 → null') check(parseSyncMaxBytes('abc') === null, '乱填非法 → null') check(parseSyncMaxBytes('') === null && parseSyncMaxBytes(null) === null, '空值 → null(调用方据此回落到默认)') } console.log('B · 宿主:schema 与三个入口都接住新字段') { check(/defaultSyncPaths: z\.array\(z\.string\(\)\)\.default\(\[\]\)/.test(src), 'PrefsSchema 有 defaultSyncPaths') check(/defaultSyncExclude: z\.array\(z\.string\(\)\)\.default\(\[\]\)/.test(src), 'PrefsSchema 有 defaultSyncExclude') check(/defaultSyncMaxBytes: z\.number\(\)\.default\(0\)/.test(src), 'PrefsSchema 有 defaultSyncMaxBytes') const guardBody = src.slice( src.indexOf('updateWorkspaceGuards: async (args) => {'), src.indexOf('createRemoteWorkspace: async (args) => {') ) check(/next\.syncPaths = normalizeSyncList\(a\.syncPaths\)/.test(guardBody), 'updateWorkspaceGuards 写 syncPaths') check(/next\.syncExclude = normalizeSyncList\(a\.syncExclude\)/.test(guardBody), 'updateWorkspaceGuards 写 syncExclude') check(/next\.syncMaxBytes = n === null \? 0 : n/.test(guardBody), 'updateWorkspaceGuards 写 syncMaxBytes(非法值归 0)') check(/if \(a\.syncPaths !== undefined\)/.test(guardBody), '只有传了才写(undefined = 不动,避免误清空)') const createBody = src.slice( src.indexOf('createRemoteWorkspace: async (args) => {'), src.indexOf('deleteWorkspace: async (args) => {') ) // issue #32 起建区还会「接管」同连接同路径的旧条目:取值优先级是 // 显式参数 > 旧记录(复用时不把用户设好的范围重置回默认) > 全局默认。 check(/a\.syncPaths !== undefined/.test(createBody) && /prefsNow\.defaultSyncPaths/.test(createBody), '建区时显式 syncPaths 优先,否则回落全局默认') check(/existing \? existing\.syncPaths : prefsNow\.defaultSyncPaths/.test(createBody), '复用旧条目时沿用该条目自己的 syncPaths(不被默认值覆盖)') check(/a\.syncExclude !== undefined/.test(createBody) && /prefsNow\.defaultSyncExclude/.test(createBody), '建区时 syncExclude 同样回落全局默认') check(/existing \? existing\.syncExclude : prefsNow\.defaultSyncExclude/.test(createBody), '复用旧条目时沿用该条目自己的 syncExclude') check(/prefsNow\.defaultSyncMaxBytes/.test(createBody), '建区时体积上限回落全局默认') check(/syncPaths: normalizeSyncList\(/.test(createBody) && /syncExclude: normalizeSyncList\(/.test(createBody), '落库前先归一化(手调 HTTP 传整串也不会写进脏数据)') const saveBody = src.slice( src.indexOf('savePrefs: async (args) => {'), src.indexOf('updateWorkspaceGuards: async (args) => {') ) check(/patch\.defaultSyncPaths = normalizeSyncList\(a\.defaultSyncPaths\)/.test(saveBody), 'savePrefs 接受 defaultSyncPaths') check(/patch\.defaultSyncExclude = normalizeSyncList\(a\.defaultSyncExclude\)/.test(saveBody), 'savePrefs 接受 defaultSyncExclude') check(/patch\.defaultSyncMaxBytes = n === null \? 0 : n/.test(saveBody), 'savePrefs 接受 defaultSyncMaxBytes(非法归 0)') check(!/patch\.profiles/.test(saveBody) && !/patch\.workspaces/.test(saveBody), 'savePrefs 仍不碰 profiles / workspaces(负向控制)') const getBody = src.slice(src.indexOf('getPrefs: async () => {'), src.indexOf('savePrefs: async (args) => {')) check(/defaultSyncPaths: normalizeSyncList\(v\.defaultSyncPaths\)/.test(getBody), 'getPrefs 回 defaultSyncPaths(设置面板要能显示)') check(/defaultSyncMaxBytes: Number\.isFinite\(v\.defaultSyncMaxBytes\)/.test(getBody), 'getPrefs 回 defaultSyncMaxBytes') } console.log('C · 三个 settings face 的 read() 都回 defaultSync*(旧版 DSH 上也不能显示成空)') { const n = (src.match(/defaultSyncPaths: normalizeSyncList\(prefsArray\(/g) || []).length check(n === 3, 'defaultSyncPaths 在三处 read() 都回(实际 ' + n + ')') const m = (src.match(/defaultSyncMaxBytes: prefsNumber\(0,/g) || []).length check(m === 3, 'defaultSyncMaxBytes 在三处 read() 都回(实际 ' + m + ')') check(/function prefsNumber\(fallback, \.\.\.candidates\)/.test(src), '有 prefsNumber(0 是合法值,不能被当成"没设")') } console.log('D · 客户端:控件、弹窗、手动同步按钮') { check(/api\("updateWorkspaceGuards"/.test(client), '工作区保存仍走 updateWorkspaceGuards') const saveCall = client.slice( client.indexOf('function saveGuard(ws) {'), client.indexOf('function runSync(ws, action) {') ) check(/syncPaths: splitList\(g\.syncPaths\)/.test(saveCall), 'saveGuard 提交 syncPaths') check(/syncExclude: splitList\(g\.syncExclude\)/.test(saveCall), 'saveGuard 提交 syncExclude') check(/syncMaxBytes: gibTextToBytes\(g\.syncMaxBytes\)/.test(saveCall), 'saveGuard 提交 syncMaxBytes(GiB 文本 → 字节)') check(/setGuard\(ws\.id, "syncPaths"/.test(client), '每个工作区有"同步范围"输入框') check(/setGuard\(ws\.id, "syncExclude"/.test(client), '每个工作区有"同步排除"输入框') check(/setGuard\(ws\.id, "syncMaxBytes"/.test(client), '每个工作区有"体积上限"输入框') check(/setPref\("defaultSyncPaths"/.test(client), '偏好设置里有"默认同步范围"输入框') check(/setPref\("defaultSyncMaxBytes"/.test(client), '偏好设置里有"默认体积上限"输入框') check(/defaultSyncPaths: splitList\(prefs\.defaultSyncPaths\)/.test(client), 'savePrefs 提交默认同步范围') const flow = client.slice(client.indexOf('function RemoteWorkspaceFlow(props) {'), client.indexOf('// 设置页小节')) check(/payload\.syncPaths = scope/.test(flow), '「添加工作区」弹窗把同步范围传给 createRemoteWorkspace') check(/scope\.length/.test(flow), '留空不传(交给宿主用全局默认兜底)') check(/api\(action, \{ id: ws\.id \}\)/.test(client), '手动同步按钮复用已有 syncDown / syncUp 端点') check(/runSync\(ws, "syncDown"\)/.test(client) && /runSync\(ws, "syncUp"\)/.test(client), '工作区卡片有"同步/推送"两个按钮') check(/if \(syncId\) return;/.test(client) && /disabled: !!syncId/.test(client), '同步进行中再次点击被挡住(两次同步会在同一镜像目录里抢)') } console.log('E · 客户端辅助函数的行为(抽真实实现跑)') { const start = client.indexOf('// ---- 同步范围输入框') const end = client.indexOf('// 远程操作弹窗') check(start > 0 && end > start, '能定位客户端辅助函数区块') const block = client.slice(start, end) const fns = new Function(block + '\nreturn { splitList, bytesToGibText, gibTextToBytes, prefsForUi }')() const { splitList, bytesToGibText, gibTextToBytes, prefsForUi } = fns check(JSON.stringify(splitList('.dsh, src\ndocs')) === '[".dsh","src","docs"]', 'splitList 与宿主同样拆分') check(JSON.stringify(splitList('')) === '[]', 'splitList 空串 → 空数组') check(bytesToGibText(2 * 1024 * 1024 * 1024) === '2', 'bytesToGibText(2 GiB) = "2"') check(bytesToGibText(0) === '' && bytesToGibText(undefined) === '', '0 / 未设 → 空(占位符提示用默认)') check(gibTextToBytes('2') === 2 * 1024 * 1024 * 1024, 'gibTextToBytes("2") = 2 GiB') check(gibTextToBytes('') === 0 && gibTextToBytes('abc') === 0, '空/乱填 → 0(回到内置默认上限)') const ui = prefsForUi({ nodePath: 'n', writeBackFailure: 'log', writeBackFreshness: false, defaultSyncPaths: ['.dsh', 'src'], defaultSyncExclude: [], defaultSyncMaxBytes: 1073741824 }) check(ui.defaultSyncPaths === '.dsh, src' && ui.defaultSyncExclude === '' && ui.defaultSyncMaxBytes === '1', 'prefsForUi 数组转文本、字节转 GiB') check(ui.writeBackFreshness === false, 'prefsForUi 保留复选框的 false(负向控制)') } console.log('F · 文案:新键在 zh / en 各定义一次') { const keys = [ 'settings.wsSyncPaths', 'settings.wsSyncExclude', 'settings.wsSyncMaxBytes', 'settings.syncScope', 'settings.syncScopeHint', 'settings.defaultSyncPaths', 'settings.defaultSyncExclude', 'settings.defaultSyncMaxBytes', 'flow.syncPaths', 'sync.upDone', 'sync.upFail' ] for (const k of keys) { const n = (client.match(new RegExp('"' + k.replace(/\./g, '\\.') + '":', 'g')) || []).length check(n === 2, k + ' 在 zh/en 各定义一次(实际 ' + n + ')') } } /** 从源码里抽出一个对象方法(`name: async (args) => { ... }`),按大括号配对,保留箭头头。 */ function grabMethod(text, label) { const start = text.indexOf(label) if (start < 0) throw new Error(label + ' not found') let i = text.indexOf('{', start) let depth = 0 for (; i < text.length; i++) { if (text[i] === '{') depth++ else if (text[i] === '}') { depth--; if (depth === 0) break } } const arrowStart = text.indexOf('async', start) return text.slice(arrowStart, i + 1) } console.log('G · 真跑宿主写路径(抽真实 handler,注入假 settingsFace)') { const block = grab(src, 'function normalizeSyncList(') + '\n' + grab(src, 'function parseSyncMaxBytes(') const helpers = new Function(block + '\nreturn { normalizeSyncList, parseSyncMaxBytes }')() // ---- updateWorkspaceGuards:同步范围真的落库,undefined 不动,空值清空 ---- const store = { workspaces: [{ id: 'w1', profileId: 'p1', title: 't', remotePath: '~', mirrorPath: 'm', syncPaths: [], syncExclude: [], syncMaxBytes: 0 }] } const face = { read: () => JSON.parse(JSON.stringify(store)), updateWorkspaces: async (list) => { store.workspaces = JSON.parse(JSON.stringify(list)) }, updatePrefs: async () => {} } const guard = new Function( 'settingsFace', 'normalizeSyncList', 'parseSyncMaxBytes', 'return ' + grabMethod(src, 'updateWorkspaceGuards: async (args) => {') )(face, helpers.normalizeSyncList, helpers.parseSyncMaxBytes) const r1 = await guard({ id: 'w1', syncPaths: ' .dsh , src\n.dsh ', syncExclude: ['data/', ' '], syncMaxBytes: '2 GiB' }) check(r1.ok === true, 'updateWorkspaceGuards 返回 ok') check(JSON.stringify(store.workspaces[0].syncPaths) === '[".dsh","src"]', 'syncPaths 真落库(trim + 去重 + 拆整串)') check(JSON.stringify(store.workspaces[0].syncExclude) === '["data/"]', 'syncExclude 真落库(空项被丢掉)') check(store.workspaces[0].syncMaxBytes === 2 * 1024 * 1024 * 1024, 'syncMaxBytes 按 "2 GiB" 落成字节数') const before = JSON.stringify(store.workspaces[0].syncPaths) await guard({ id: 'w1', writeBack: false }) check(store.workspaces[0].writeBack === false, 'writeBack 照旧可写') check(JSON.stringify(store.workspaces[0].syncPaths) === before, '没传同步范围 → 原值不动(undefined = 不改,负向控制)') await guard({ id: 'w1', syncPaths: [], syncExclude: '', syncMaxBytes: 'garbage' }) check(JSON.stringify(store.workspaces[0].syncPaths) === '[]', '传空数组 = 显式清空(回到整树)') check(JSON.stringify(store.workspaces[0].syncExclude) === '[]', '传空串 = 显式清空') check(store.workspaces[0].syncMaxBytes === 0, '乱填体积上限 → 归 0(回到内置默认),不会写进 NaN') const missing = await guard({ id: 'nope', syncPaths: ['.dsh'] }) check(missing.ok === false && /未找到远程工作区/.test(missing.error), '工作区不存在时报错而不是静默成功') // ---- savePrefs:新键进白名单、非法体积归一化、无关键不写 ---- const prefsStore = { nodePath: '', writeBackFailure: 'error', writeBackFreshness: true, defaultSyncPaths: [], defaultSyncExclude: [], defaultSyncMaxBytes: 0 } const patches = [] const prefsFace = { read: () => Object.assign({}, prefsStore), updatePrefs: async (patch) => { patches.push(patch); Object.assign(prefsStore, patch) } } const savePrefs = new Function( 'settingsFace', 'normalizeSyncList', 'parseSyncMaxBytes', 'return ' + grabMethod(src, 'savePrefs: async (args) => {') )(prefsFace, helpers.normalizeSyncList, helpers.parseSyncMaxBytes) const saved = await savePrefs({ defaultSyncPaths: '.dsh, src', defaultSyncExclude: 'data/', defaultSyncMaxBytes: '512MB', evil: 'x' }) check(saved.ok === true, 'savePrefs 返回 ok') check(JSON.stringify(patches[0].defaultSyncPaths) === '[".dsh","src"]', 'defaultSyncPaths 归一化后写入') check(patches[0].defaultSyncMaxBytes === 512 * 1000 * 1000, 'defaultSyncMaxBytes 按 "512MB" 写入') check(!('evil' in patches[0]) && !('profiles' in patches[0]) && !('workspaces' in patches[0]), '白名单外的键不写(负向控制)') check(JSON.stringify(saved.prefs.defaultSyncPaths) === '[".dsh","src"]', '返回值回读最新值(面板据此刷新)') const none = await savePrefs({ unrelated: 1 }) check(none.ok === false && /没有可保存的字段/.test(none.error), '没有任何白名单键时报错') } console.log(`\n结果: ${pass} 通过, ${fail} 失败`) process.exit(fail ? 1 : 0)