From d313e9bddd23baaefbdbdf86f6300786d14eddc3 Mon Sep 17 00:00:00 2001 From: QQ Date: Wed, 11 Nov 2026 22:39:30 +0800 Subject: [PATCH] Import vendor/dsh-remote-ssh/tests/session-path.test.mjs --- .../tests/session-path.test.mjs | 407 ++++++++++++++++++ 1 file changed, 407 insertions(+) create mode 100644 vendor/dsh-remote-ssh/tests/session-path.test.mjs diff --git a/vendor/dsh-remote-ssh/tests/session-path.test.mjs b/vendor/dsh-remote-ssh/tests/session-path.test.mjs new file mode 100644 index 0000000..d4b33b0 --- /dev/null +++ b/vendor/dsh-remote-ssh/tests/session-path.test.mjs @@ -0,0 +1,407 @@ +// 本地会话相对路径归一 —— issue #25(guolei1993,2026-10-13) +// +// 背景:本插件以 kind:"exact" 接管了 `dsh-better-sidebar` 的 `/sidebar/file` 与 `/sidebar/api/fs.*` +// 路由(为了远程工作区),**本地会话也走这里**。被接管的原实现按会话 cwd / worktree 根解析相对路径 +// (`ensureWorkspacePath(sessionCwd, raw)`),而本插件的本地分支把路径原样交给 fs —— Node 于是按 +// **插件宿主进程的 process.cwd()**(pnpm profile 目录)解析: +// cannot read: ENOENT: no such file or directory, stat '/tools/check_file_size.py' +// 绝对路径不受影响,所以用户侧只是「部分文件打不开」。`handleSidebarFile` 里更明显: +// cwd 已经算出来了,却没被使用。写操作(fs.write / fs.remove)同理会打到插件宿主目录。 +// +// 三层: +// A. 纯函数 resolveSessionPath / unresolvedPathMessage 的真值表(绝对 / 相对 / 无基准 / ~ / 空) +// B. **真实处理器的行为**(源码切片 + 假 ctx/req/res,并把 process.cwd() 搬到一个"宿主目录"上): +// fs.read / fs.tree / fs.trees / fs.write / fs.rename / fs.remove / fs.mkdir / fs.search、 +// `/sidebar/file`、`git.*`、`open.external` —— 相对路径必须落在会话 cwd 下; +// 取不到会话 cwd 时必须**报错**,绝不能读到宿主目录里的同名文件(宿主目录里放了 canary 文件)。 +// C. 接线与文档:所有落点都归一;这些处理器里不再出现 process.cwd() 兜底;版本/CHANGELOG/README。 +import { readFileSync, existsSync, mkdtempSync, rmSync, writeFileSync, mkdirSync } from 'node:fs' +import { + stat, open, readFile, writeFile, rename, rm, mkdir, opendir, lstat +} from 'node:fs/promises' +import { tmpdir, homedir } from 'node:os' +import { join, dirname, basename } from 'node:path' +import { fileURLToPath } from 'node:url' + +// 用 fileURLToPath 而不是 URL.pathname:后者会把 8.3 短路径里的 `~` 百分号编码成 %7E(Windows 上很常见)。 +const root = fileURLToPath(new URL('..', import.meta.url)) +const src = readFileSync(root + '/lib/index.js', 'utf8') +const changelog = readFileSync(root + '/CHANGELOG.md', 'utf8') +const readme = readFileSync(root + '/README.md', 'utf8') +const pkg = JSON.parse(readFileSync(root + '/package.json', 'utf8')) + +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) +} + +let pass = 0, fail = 0 +const check = (cond, label) => { if (cond) { pass++; console.log(' ✓ ' + label) } else { fail++; console.log(' ✗ FAIL: ' + label) } } + +// --------------------------------------------------------------------------- +// 沙箱:真实代码片段 + 假宿主 +// --------------------------------------------------------------------------- +const MODULE_HELPERS = [ + grab(src, 'function isAbsoluteLocalPath'), + // 2.4.30(issue #26):fs 处理器改为按请求路径**语法 + 归属**分派,沙箱必须带上这两个纯函数, + // 否则沙箱里跑真实处理器会 "classifyRequestPathSyntax is not defined"(那是沙箱缺件,不是被测行为)。 + grab(src, 'function classifyRequestPathSyntax'), + grab(src, 'function looksLikeRemoteAbsolutePath'), + grab(src, 'function resolveSessionPath'), + grab(src, 'function unresolvedPathMessage') +].join('\n') + +/** 造一个"会话注册表":只有 sess-1 存在,cwd 指向 sessionDir。 */ +function makeCtx(sessionDir) { + const session = { header: { cwd: sessionDir } } + const sessions = { get: (id) => (id === 'sess-1' ? session : null) } + return { get: (name) => (name === 'sessions' ? sessions : null), logger: { debug() {}, warn() {}, error() {} } } +} + +/** 假 req / res:res 记录 status 与 body(writeOk 的包装与真实实现一致)。 */ +function makeRes() { + const res = { + status: 0, body: undefined, headers: undefined, raw: undefined, + writeHead(status, headers) { res.status = status; res.headers = headers; return res }, + end(body) { if (body !== undefined && res.body === undefined) { res.raw = body } ; return res }, + setHeader() { return res } + } + return res +} +const writeJson = (res, status, obj) => { res.status = status; res.body = obj } +const writeOk = (res, value) => { res.status = 200; res.body = { ok: true, value: value } } +const readJsonBody = async (req) => req.__body +const requestTrust = () => 'ok' +const denyRequest = (res, why) => { res.status = 403; res.body = { ok: false, error: { code: 'denied', message: why } } } + +/** 构造 interceptFsHandler 沙箱(本地分支所需依赖一应俱全;远程分支不会被调用)。 */ +function fsSandbox(sessionDir) { + const rec = { runPooledCalls: 0 } + const fn = new Function( + 'join', 'dirname', 'basename', 'stat', 'open', 'readFile', 'writeFile', 'rename', 'rm', 'mkdir', + 'opendir', 'lstat', 'existsSync', 'homedir', 'READ_LIMIT', 'LIST_LIMIT', + 'ctx', 'requestTrust', 'denyRequest', 'writeJson', 'writeOk', 'readJsonBody', + 'readRemoteInfoSync', 'localSearchFiles', 'settingsFace', + MODULE_HELPERS + '\n' + + grab(src, 'function readPathsField') + '\n' + + grab(src, 'function sidebarEntriesFrom') + '\n' + + grab(src, 'function toPosixRelative') + '\n' + + grab(src, 'function fsSearchResult') + '\n' + + grab(src, 'function sessionCwdFrom') + '\n' + + // 2.4.29 起 fs 判定改走"按工作区根前缀匹配",这几个真源码必须一起进沙箱。 + // settingsFace 的工作区列表为空 → 匹配不到任何工作区 → 行为与之前一致(一律本地分支)。 + grab(src, 'function mirrorBaseDir') + '\n' + + grab(src, 'function isUnderMirrorBase') + '\n' + + grab(src, 'function matchRemoteWorkspace') + '\n' + + grab(src, 'function remoteWorkspaceForPath') + '\n' + + grab(src, 'async function localReadText') + '\n' + + grab(src, 'async function localWriteFile') + '\n' + + grab(src, 'async function localListDir') + '\n' + + grab(src, 'async function localRenameEntry') + '\n' + + grab(src, 'async function localRemoveEntry') + '\n' + + grab(src, 'async function localMakeDir') + '\n' + + grab(src, 'async function interceptFsHandler') + '\n' + + 'return { interceptFsHandler, localReadText };' + )( + join, dirname, basename, stat, open, readFile, writeFile, rename, rm, mkdir, + opendir, lstat, existsSync, homedir, 524288, 1000, + makeCtx(sessionDir), requestTrust, denyRequest, writeJson, writeOk, readJsonBody, + () => null, // readRemoteInfoSync → 一律本地分支 + async () => ({ entries: [], truncated: false }), // localSearchFiles → 本测试不查内容 + { read: () => ({ workspaces: [] }) } // settingsFace → 没有已注册的远程工作区 + ) + return { api: fn, rec } +} + +async function fsCall(api, sessionDir, method, payload) { + const res = makeRes() + await api.interceptFsHandler({ method: 'POST', headers: {}, __body: payload }, res, method) + return res +} + +// --------------------------------------------------------------------------- +// A. 纯函数 +// --------------------------------------------------------------------------- +console.log('\nA. resolveSessionPath 真值表') +{ + const { resolveSessionPath, unresolvedPathMessage, isAbsoluteLocalPath } = new Function('join', MODULE_HELPERS + + '\nreturn { resolveSessionPath, unresolvedPathMessage, isAbsoluteLocalPath };')(join) + const win = 'C:\\work\\proj' + const posix = '/work/proj' + check(resolveSessionPath('/etc/hosts', win).path === '/etc/hosts', 'A1 POSIX 绝对路径原样返回') + check(resolveSessionPath('C:\\work\\proj\\a.py', posix).path === 'C:\\work\\proj\\a.py', 'A2 Windows 绝对路径原样返回(基准是 POSIX 也不动它)') + check(resolveSessionPath('D:/x/y', win).path === 'D:/x/y', 'A3 正斜杠盘符路径也认作绝对') + check(resolveSessionPath('\\\\srv\\share\\x', win).path === '\\\\srv\\share\\x', 'A4 UNC 路径认作绝对') + check(resolveSessionPath('tools/x.py', win).path === join(win, 'tools/x.py'), 'A5 相对路径按基准拼接') + check(resolveSessionPath('tools/x.py', win).resolved === true, 'A6 拼接成功的 resolved 为 true') + check(resolveSessionPath('./tools/../tools/x.py', win).path === join(win, 'tools/x.py'), 'A7 相对路径里的 . / .. 归一') + check(resolveSessionPath('tools/x.py', '').resolved === false, 'A8 没有基准 → 不解析(不猜)') + check(resolveSessionPath('tools/x.py', '').reason === 'no-base', 'A9 原因是 no-base') + check(resolveSessionPath('tools/x.py', null).resolved === false, 'A10 基准为 null 同样不解析') + check(resolveSessionPath('', win).resolved === false, 'A11 空路径不解析') + check(resolveSessionPath(undefined, win).reason === 'empty', 'A12 undefined 归为 empty') + check(resolveSessionPath('~/a.py', win).path === '~/a.py', 'A13 ~ 开头原样返回(不拼出 base/~/x)') + check(resolveSessionPath('~/a.py', win).resolved === false, 'A14 ~ 视为未解析,交给调用方报错') + check(resolveSessionPath('tools/x.py', 'relative/dir').resolved === false, 'A14b 相对 base → 不解析(否则 join 出来仍是相对路径,等于把 bug 放回来)') + check(resolveSessionPath('tools/x.py', 'relative/dir').reason === 'relative-base', 'A14c 原因是 relative-base') + check(resolveSessionPath('tools/x.py', 'C:foo').resolved === false, 'A14d 盘符相对形式(C:foo)也拒(对齐上游 requireAbsolute)') + check(unresolvedPathMessage('tools/x.py', 'relative/dir', 'relative-base').includes('不是绝对路径'), 'A14e 相对 base 的文案说清是基准的问题') + check(isAbsoluteLocalPath('C:/x') && isAbsoluteLocalPath('/x') && isAbsoluteLocalPath('\\\\s\\x') && !isAbsoluteLocalPath('x/y'), 'A15 isAbsoluteLocalPath 覆盖盘符/斜杠/UNC') + check(unresolvedPathMessage('tools/x.py', '', 'no-base').includes('tools/x.py'), 'A16 报错文案里带上用户给的相对路径') + check(unresolvedPathMessage('tools/x.py', '', 'no-base').includes('cwd'), 'A17 报错文案告诉用户补 cwd / sessionId') + check(unresolvedPathMessage('', '', 'empty') === 'path 为必填项', 'A18 空路径的文案') + check(unresolvedPathMessage('~/a', '', 'unexpanded-tilde').includes('不支持'), 'A19 ~ 的文案说明不支持展开') +} + +// --------------------------------------------------------------------------- +// B. 真实处理器行为(把 process.cwd() 搬到一个"插件宿主目录"上) +// --------------------------------------------------------------------------- +console.log('\nB. 真实处理器行为(宿主目录里放 canary,验证不会被读到/写到)') +const hostDir = mkdtempSync(join(tmpdir(), 'rssh-host-')) +const sessionDir = mkdtempSync(join(tmpdir(), 'rssh-sess-')) +const otherDir = mkdtempSync(join(tmpdir(), 'rssh-other-')) +const originalCwd = process.cwd() +try { + mkdirSync(join(hostDir, 'tools'), { recursive: true }) + writeFileSync(join(hostDir, 'tools', 'x.py'), 'HOST-CANARY') + writeFileSync(join(hostDir, 'tools', 'canary.txt'), 'HOST-CANARY') + mkdirSync(join(sessionDir, 'tools'), { recursive: true }) + mkdirSync(join(sessionDir, 'sub'), { recursive: true }) + writeFileSync(join(sessionDir, 'tools', 'x.py'), 'SESSION-CONTENT') + writeFileSync(join(sessionDir, 'sub', 'y.txt'), 'SUB-CONTENT') + mkdirSync(join(otherDir, 'otherSub'), { recursive: true }) + writeFileSync(join(otherDir, 'otherSub', 'z.txt'), 'OTHER-CONTENT') + process.chdir(hostDir) // ← 插件宿主进程的 cwd(issue #25 里相对路径落到的那个目录) + + const { api } = fsSandbox(sessionDir) + + // ---- fs.read ---- + let r = await fsCall(api, sessionDir, 'fs.read', { sessionId: 'sess-1', path: 'tools/x.py' }) + check(r.status === 200 && r.body.value.content === 'SESSION-CONTENT', + 'B1 fs.read 相对路径 → 读的是**会话 cwd** 下的文件(旧代码会读到宿主目录或 ENOENT)') + check(r.body.value.content !== 'HOST-CANARY', 'B2 不会读到宿主目录里的同名文件') + r = await fsCall(api, sessionDir, 'fs.read', { sessionId: 'sess-1', path: join(sessionDir, 'tools', 'x.py') }) + check(r.status === 200 && r.body.value.content === 'SESSION-CONTENT', 'B3 绝对路径照旧可用(无回归)') + r = await fsCall(api, sessionDir, 'fs.read', { cwd: sessionDir, path: 'tools/x.py' }) + check(r.status === 200 && r.body.value.content === 'SESSION-CONTENT', 'B4 只给 cwd(没有 sessionId)同样能解析') + // 客户端传相对 cwd 时不能拿它当基准(否则 join 出来仍是相对路径 → 又按 process.cwd() 解析) + r = await fsCall(api, sessionDir, 'fs.read', { cwd: 'relative/dir', path: 'tools/canary.txt' }) + check(r.status === 400 && r.body.value === undefined, 'B4b 相对 cwd 不被采信 + 有会话时回退到会话 cwd 之外一律报错(读不到宿主 canary)') + r = await fsCall(api, sessionDir, 'fs.read', { sessionId: 'sess-1', cwd: 'relative/dir', path: 'tools/x.py' }) + check(r.status === 200 && r.body.value.content === 'SESSION-CONTENT', 'B4c 相对 cwd 被忽略后回退到会话注册表(仍读到正确文件)') + r = await fsCall(api, sessionDir, 'fs.tree', { sessionId: 'sess-1', cwd: 'relative/dir', path: '.' }) + check(r.status === 200 && r.body.value.entries.some((e) => e.name === 'sub'), 'B4d 相对 cwd 被忽略后 tree 仍按会话 cwd 列目录') + r = await fsCall(api, sessionDir, 'fs.read', { sessionId: 'sess-UNKNOWN', path: 'tools/canary.txt' }) + check(r.status === 400, 'B5 会话取不到 + 相对路径 → 明确报错(400)') + check(r.body && r.body.error && r.body.error.code === 'bad-request', 'B6 报错码是 bad-request') + check(String((r.body && r.body.error && r.body.error.message) || '').includes('tools/canary.txt'), 'B7 报错文案带上原始相对路径,便于自查') + check(r.body.value === undefined, 'B8 绝不回退到宿主目录(旧代码会在这里返回宿主 canary 的内容)') + + // ---- fs.tree ---- + r = await fsCall(api, sessionDir, 'fs.tree', { sessionId: 'sess-1', path: 'sub' }) + check(r.status === 200 && r.body.value.entries.some((e) => e.name === 'y.txt'), 'B9 fs.tree 相对路径 → 列的是会话 cwd 下的目录') + r = await fsCall(api, sessionDir, 'fs.tree', { sessionId: 'sess-1', path: '.' }) + check(r.status === 200 && r.body.value.entries.some((e) => e.name === 'sub'), 'B10 fs.tree path="." → 会话 cwd 本身') + + // ---- fs.tree 的空路径(issue #27:「添加工作区 → 本地目录」弹窗首次打开)---- + // 客户端发 {sessionId:"", path:""},语义是"打开主目录"(lib/client.js 注释 + localListDir 的 + // homedir 兜底)。2.4.27 为修 #25 加的 localPathOf() 对空路径一律 400,把这条只读初始列举拦了。 + r = await fsCall(api, sessionDir, 'fs.tree', { path: '' }) + check(r.status === 200 && !!r.body.value && r.body.value.path === homedir(), + 'B10b 无会话 + 空路径的 fs.tree → 200 且列出**主目录**(issue #27 回归点:2.4.27–2.4.30 此处 400「path 为必填项」)') + check(!!r.body.value && Array.isArray(r.body.value.entries), 'B10c 返回目录条目数组(只读初始列举不再被必填校验拦下)') + r = await fsCall(api, sessionDir, 'fs.tree', { sessionId: 'sess-1', path: '' }) + check(r.status === 200 && !!r.body.value && r.body.value.path === sessionDir, + 'B10d 有会话 cwd 时仍按**会话 cwd** 列举(放行空路径不会改去列主目录)') + r = await fsCall(api, sessionDir, 'fs.read', { path: '' }) + check(r.status === 400 && String(r.body.error.message).includes('path 为必填项'), + 'B10e 同一个空路径给 fs.read 仍然 400(issue #25 的必填校验不被放宽)') + r = await fsCall(api, sessionDir, 'fs.write', { path: '', content: 'X' }) + check(r.status === 400, 'B10f 写操作的空路径仍然 400(放行范围只限只读列举)') + r = await fsCall(api, sessionDir, 'fs.tree', { path: 'tools' }) + check(r.status === 400, 'B10g 无会话 + **相对路径**的 fs.tree 仍然 400(相对路径不放宽)') + + // ---- fs.trees ---- + r = await fsCall(api, sessionDir, 'fs.trees', { sessionId: 'sess-1', paths: ['tools', 'sub'] }) + check(r.status === 200 && r.body.value.levels.length === 2, 'B11 fs.trees 两条相对路径都处理') + check(r.body.value.levels[0].path === join(sessionDir, 'tools'), 'B12 fs.trees 回显的 level.path 是**解析后的绝对路径**(客户端据此落缓存)') + check(r.body.value.levels[0].entries.some((e) => e.name === 'x.py'), 'B13 fs.trees 真的列出了会话 cwd 下的内容') + r = await fsCall(api, sessionDir, 'fs.trees', { sessionId: 'sess-UNKNOWN', paths: ['tools', join(sessionDir, 'sub')] }) + check(r.status === 200 && !!r.body.value.levels[0].error && r.body.value.levels[0].path === 'tools', + 'B14 fs.trees 解析不了的那条**只让自己**报错(回显原始路径;不静默落到宿主目录)') + check(r.body.value.levels[0].entries.length === 0, 'B15 坏条目不返回任何条目(不可能来自宿主目录)') + check(r.body.value.levels[1].entries.some((e) => e.name === 'y.txt'), 'B15b 同一批里能解析的那条照常返回(一条坏路径不拖垮整棵树)') + r = await fsCall(api, sessionDir, 'fs.trees', { paths: ['tools'] }) + check(r.status === 200 && !!r.body.value.levels[0].error, 'B15c 完全没有会话信息 + 相对路径 → 该条带 error') + r = await fsCall(api, sessionDir, 'fs.trees', { sessionId: 'sess-1', paths: [join(sessionDir, 'sub')] }) + check(r.status === 200 && r.body.value.levels[0].entries.some((e) => e.name === 'y.txt'), 'B16 fs.trees 绝对路径照旧可用') + + // ---- fs.write(写操作最危险:旧代码会写进插件宿主目录)---- + r = await fsCall(api, sessionDir, 'fs.write', { sessionId: 'sess-1', path: 'tools/new.txt', content: 'W1' }) + check(r.status === 200, 'B17 fs.write 相对路径 → 成功') + check(existsSync(join(sessionDir, 'tools', 'new.txt')), 'B18 文件落在**会话 cwd** 下') + check(!existsSync(join(hostDir, 'tools', 'new.txt')), 'B19 没有出现在插件宿主目录里(旧代码会写在那里)') + r = await fsCall(api, sessionDir, 'fs.write', { sessionId: 'sess-UNKNOWN', path: 'tools/evil.txt', content: 'X' }) + check(r.status === 400 && !existsSync(join(hostDir, 'tools', 'evil.txt')), 'B20 解析不了时既不写、也不报成功') + + // ---- fs.rename ---- + r = await fsCall(api, sessionDir, 'fs.rename', { sessionId: 'sess-1', path: 'tools/new.txt', name: 'renamed.txt' }) + check(r.status === 200 && existsSync(join(sessionDir, 'tools', 'renamed.txt')), 'B21 fs.rename 相对路径 → 改的是会话 cwd 下的文件') + check(!existsSync(join(hostDir, 'tools', 'renamed.txt')), 'B22 宿主目录里没有被动过') + + // ---- fs.remove(最危险的破坏性操作)---- + r = await fsCall(api, sessionDir, 'fs.remove', { sessionId: 'sess-1', path: 'tools/renamed.txt' }) + check(r.status === 200 && !existsSync(join(sessionDir, 'tools', 'renamed.txt')), 'B23 fs.remove 相对路径 → 删的是会话 cwd 下的文件') + check(existsSync(join(hostDir, 'tools', 'canary.txt')), 'B24 宿主目录里的 canary 毫发无损(旧代码会删到它)') + r = await fsCall(api, sessionDir, 'fs.remove', { sessionId: 'sess-UNKNOWN', path: 'tools/canary.txt' }) + check(r.status === 400 && existsSync(join(hostDir, 'tools', 'canary.txt')), 'B25 解析不了时拒绝执行(canary 仍在)') + + // ---- fs.mkdir ---- + r = await fsCall(api, sessionDir, 'fs.mkdir', { sessionId: 'sess-1', path: 'tools', name: 'made' }) + check(r.status === 200 && existsSync(join(sessionDir, 'tools', 'made')), 'B26 fs.mkdir 相对路径 → 建在会话 cwd 下') + check(!existsSync(join(hostDir, 'tools', 'made')), 'B27 宿主目录里没有多出目录') + + // ---- fs.search ---- + r = await fsCall(api, sessionDir, 'fs.search', { sessionId: 'sess-UNKNOWN', query: 'x' }) + check(r.status === 400, 'B28 fs.search 没有会话 cwd → 400(不在宿主目录里乱搜)') + r = await fsCall(api, sessionDir, 'fs.search', { sessionId: 'sess-1', query: 'x' }) + check(r.status === 200, 'B29 fs.search 有会话 cwd → 正常(无回归)') + + // ---- /sidebar/file ---- + { + const md = new Function('join', 'stat', 'readFile', 'ctx', 'requestTrust', 'trustErrorMessage', + 'writeJson', 'matchRemoteWorkspace', 'mediaTypeForPath', 'readRemoteInfoSync', 'getProfile', + MODULE_HELPERS + '\n' + grab(src, 'function sessionCwdFrom') + '\n' + grab(src, 'async function handleSidebarFile') + + '\nreturn handleSidebarFile;')( + join, stat, readFile, makeCtx(sessionDir), requestTrust, (w) => 'blocked: ' + w, + writeJson, () => null, () => 'text/plain', () => null, () => null + ) + const fileReq = (qs) => ({ method: 'GET', url: '/sidebar/file?' + qs, headers: {} }) + let res = makeRes() + await md(fileReq('sessionId=sess-1&path=' + encodeURIComponent('tools/x.py')), res) + check(res.status === 200 && String(res.raw) === 'SESSION-CONTENT', + 'B30 /sidebar/file 相对路径 → 读会话 cwd 下的文件(旧代码 ENOENT 到宿主目录)') + res = makeRes() + await md(fileReq('sessionId=sess-1&cwd=' + encodeURIComponent(otherDir) + '&path=' + encodeURIComponent('otherSub/z.txt')), res) + check(res.status === 200 && String(res.raw) === 'OTHER-CONTENT', 'B31 /sidebar/file 里显式 cwd 参数优先于会话 cwd') + res = makeRes() + await md(fileReq('sessionId=sess-UNKNOWN&path=' + encodeURIComponent('tools/canary.txt')), res) + check(res.status === 400 && String(res.raw) !== 'HOST-CANARY', 'B32 /sidebar/file 解析不了 → 400,不读宿主 canary') + res = makeRes() + await md(fileReq('sessionId=sess-1&path=' + encodeURIComponent(join(sessionDir, 'tools', 'x.py'))), res) + check(res.status === 200 && String(res.raw) === 'SESSION-CONTENT', 'B33 /sidebar/file 绝对路径照旧可用') + } + + // ---- git.* ---- + { + const rec = { cwd: null } + const git = new Function('join', 'existsSync', 'readFileSync', 'ctx', 'requestTrust', 'denyRequest', + 'writeJson', 'writeOk', 'readJsonBody', 'matchRemoteWorkspace', 'readRemoteInfoSync', 'getProfile', 'localToRemote', + 'runGitLocal', 'runGitRemote', 'gitStatusImpl', 'parseLogLines', 'posixDirname', + MODULE_HELPERS + '\n' + grab(src, 'function sessionCwdFrom') + '\n' + grab(src, 'function gitContextOf') + '\n' + + grab(src, 'async function interceptGitHandler') + '\nreturn interceptGitHandler;')( + join, existsSync, readFileSync, makeCtx(sessionDir), requestTrust, denyRequest, + writeJson, writeOk, readJsonBody, () => null, () => null, () => null, (a) => a, + async (cwd) => { rec.cwd = cwd; return '' }, async () => '', async () => '', () => [], (p) => p + ) + let res = makeRes() + await git({ method: 'POST', headers: {}, __body: { sessionId: 'sess-1' } }, res, 'diff') + check(res.status === 200 && rec.cwd === sessionDir, 'B34 git.diff 用**会话 cwd** 跑 git(旧代码退到 process.cwd() = 插件宿主目录)') + rec.cwd = null + res = makeRes() + await git({ method: 'POST', headers: {}, __body: { cwd: otherDir } }, res, 'diff') + check(res.status === 200 && rec.cwd === otherDir, 'B35 git 面板显式给的 cwd 优先') + rec.cwd = null + res = makeRes() + await git({ method: 'POST', headers: {}, __body: { sessionId: 'sess-UNKNOWN' } }, res, 'diff') + check(res.status === 400 && rec.cwd === null, 'B36 取不到会话 cwd → 400,**不跑** git(不给一个错的仓库)') + } + + // ---- open.external ---- + { + const rec = { kind: null, value: null } + const open2 = new Function('join', 'ctx', 'requestTrust', 'denyRequest', 'writeJson', 'writeOk', 'readJsonBody', + 'launchRemoteEditor', 'launchExternal', 'parseExternalUrl', 'localPathFromExternalUrl', + MODULE_HELPERS + '\n' + grab(src, 'function sessionCwdFrom') + '\n' + grab(src, 'async function interceptOpenExternalHandler') + + '\nreturn interceptOpenExternalHandler;')( + join, makeCtx(sessionDir), requestTrust, denyRequest, writeJson, writeOk, readJsonBody, + async () => false, (kind, value) => { rec.kind = kind; rec.value = value; return true }, + () => null, () => null + ) + let res = makeRes() + await open2({ method: 'POST', headers: {}, __body: { action: 'reveal', sessionId: 'sess-1', path: 'tools/x.py' } }, res) + check(res.status === 200 && rec.value === join(sessionDir, 'tools', 'x.py'), + 'B37 open.external reveal 相对路径 → 先归一(旧代码直接 400 “path must be an absolute path”)') + rec.value = null + res = makeRes() + await open2({ method: 'POST', headers: {}, __body: { action: 'reveal', path: 'tools/x.py' } }, res) + check(res.status === 400 && rec.value === null, 'B38 reveal 解析不了 → 400,不带着相对路径去调本机打开器') + rec.value = null + res = makeRes() + await open2({ method: 'POST', headers: {}, __body: { action: 'reveal', path: join(sessionDir, 'sub', 'y.txt') } }, res) + check(res.status === 200 && rec.value === join(sessionDir, 'sub', 'y.txt'), 'B39 reveal 绝对路径照旧可用') + } +} finally { + process.chdir(originalCwd) + for (const d of [hostDir, sessionDir, otherDir]) { try { rmSync(d, { recursive: true, force: true }) } catch (e) {} } +} + +// --------------------------------------------------------------------------- +// C. 接线与文档 +// --------------------------------------------------------------------------- +console.log('\nC. 接线与文档') +{ + // 注释里会出现 process.cwd() 这个字样(说明为什么不能回退到它),所以断言前先把注释剥掉。 + const strip = (code) => code.replace(/\/\*[\s\S]*?\*\//g, '').split('\n').map((l) => l.replace(/\/\/.*$/, '')).join('\n') + const fsHandler = strip(grab(src, 'async function interceptFsHandler')) + const fileHandler = strip(grab(src, 'async function handleSidebarFile')) + const gitHandler = strip(grab(src, 'async function interceptGitHandler')) + const openHandler = strip(grab(src, 'async function interceptOpenExternalHandler')) + + check((fsHandler.match(/localPathOf\(/g) || []).length >= 12, 'C1 fs 处理器里 12 个落点都过 localPathOf(远程 7 + 本地 7,含 fs.trees/fs.mkdir)') + check(!/localReadText\(payload|localWriteFile\(payload|localRenameEntry\(payload|localRemoveEntry\(payload|localMakeDir\(payload|localListDir\(payload/.test(fsHandler), + 'C2 本地分支不再把 payload.path 直接交给 fs 函数') + // C3(issue #27 重指):本地分支里 `payload.path || sessionCwd` 必须经 localPathOf 才能交给 fs 函数。 + // 唯一例外是 fs.tree 的空路径哨兵 rawTreePath —— 它只承载"空"这一种取值(非空分支仍走 localPathOf), + // 空值最终交给 localListDir(""),由 localListDir 自己的 homedir 兜底处理。 + const badAssign = [] + for (const m of fsHandler.matchAll(/(?:const|let|var)\s+(\w+)\s*=\s*payload\.path \|\| sessionCwd;/g)) { + const name = m[1] + const tail = fsHandler.slice(m.index) + const usedByLocalPathOf = new RegExp('localPathOf\\(\\s*' + name).test(tail) + const isTreeSentinel = name === 'rawTreePath' && /if \(!rawTreePath\)/.test(tail) + if (!usedByLocalPathOf && !isTreeSentinel) badAssign.push(name) + } + check(badAssign.length === 0, 'C3 本地分支的 `payload.path || sessionCwd` 一律经 localPathOf(fs.tree 的空路径哨兵除外)') + check(!fsHandler.includes('process.cwd()'), 'C4 fs 处理器里没有 process.cwd() 兜底') + check(!fileHandler.includes('process.cwd()'), 'C5 /sidebar/file 里没有 process.cwd() 兜底') + check(!gitHandler.includes('process.cwd()'), 'C6 git 处理器里没有 process.cwd() 兜底') + check(fileHandler.includes('resolveSessionPath(rawPath, cwd)'), + 'C7 /sidebar/file 真的用了那个算出来的 cwd(此前 cwd 算完未被使用)') + check(fileHandler.includes('unresolvedPathMessage(rawPath, cwd, localPath.reason)'), 'C8 /sidebar/file 解析失败时报可读错误') + check(gitHandler.includes('无法确定会话工作目录'), 'C9 git 处理器在拿不到会话 cwd 时给出明确错误') + check(openHandler.includes('resolveSessionPath(rawRevealPath, revealBase)'), 'C10 open.external reveal 先归一再打开') + check(fsHandler.includes('if (syn === "relative") return "relative";'), + 'C11 相对路径在探测工作区**之前**就被分类掉,不参与"这是不是一个远程工作区"的判定') + check((src.match(/function isAbsoluteLocalPath\(/g) || []).length === 1, 'C12 绝对路径判断只有一份实现(原来 apply 内那份已收敛)') + check((src.match(/function sessionCwdFrom\(/g) || []).length === 1, 'C13 会话 cwd 的取法只有一份实现') + check(fsHandler.includes('resolveSessionPath(raw, pathBase)'), 'C14 fs.trees 逐条归一') + check(fsHandler.includes('unresolvedPathMessage(raw, pathBase, r.reason)'), 'C15 fs.trees 的失败条目带可读原因(回显原始路径)') + + check(/^2\.4\.(2[7-9]|[3-9]\d)$/.test(pkg.version), 'C16 版本号已升到 2.4.27 或更高(' + pkg.version + ')') + check(/## \[2\.4\.27\]/.test(changelog), 'C17 CHANGELOG 有 2.4.27 段落') + check(changelog.includes('issue [#25]'), 'C18 CHANGELOG 引用了 issue #25') + check(changelog.includes('process.cwd()'), 'C19 CHANGELOG 说明了根因(process.cwd())') + check(readme.includes('dsh-remote-ssh@' + pkg.version), 'C20 README 的安装命令指向当前版本(' + pkg.version + ')') +} + +console.log(`\n结果: ${pass} 通过, ${fail} 失败`) +process.exit(fail ? 1 : 0)