// better-sidebar 0.25.0 新端点的接管 —— fs.createFile + git.blame / diff-head / worktrees / pull / push // // 背景:0.25.0 新增了 9 个端点,其中 6 个与「仓库 / 路径」相关。本插件用 kind:"exact" 接管 // `/sidebar/api/fs.*` 与 `/sidebar/api/git.*`,所以**没被注册的端点会回落到上游实现**, // 而远程工作区里上游的 cwd 是本地镜像目录(镜像没有 .git、也不是文件系统的事实来源): // · fs.createFile → 空文件只建在本地镜像里,远端永远没有(与 0.24 的 fs.trees 同一类) // · git.blame / diff-head / worktrees → 按镜像里的 git 状态返回(通常是空/报错) // · git.pull / push → 在镜像上跑 git,动的是一个与远端无关的仓库 // 维护笔记里的硬规则(MAINTENANCE「升级 better-sidebar 后必做对拍」)就是这条:升级后必须 // 把上游宿主 handler 键集合与本插件注册集合逐项比对。本文件的 C 段把这条规则**自动化**。 // // 三层: // A. 纯函数真值表:creatableFileNameProblem / isoWithOffset / parseBlamePorcelain / // parseWorktreeList / countStatusEntries / 路径同一性 —— 规则逐条对齐上游。 // B. **真实处理器的行为**(源码切片 + 假 ctx/req/res + 假远端): // 本地 fs.createFile 落盘与 409、远程 fs.createFile 走 SSH(命令形状)、 // git.blame / diff-head / worktrees / pull / push 的实参与返回形状(pull 还要失效缓存)。 // C. 接线与上游覆盖率:注册数组包含 6 个端点;若本机装了 better-sidebar, // 直接与它的宿主 handler 键集合对拍(没装则 SKIP,不算失败)。 import { readFileSync, existsSync, mkdtempSync, rmSync, mkdirSync, writeFileSync, readdirSync } 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' const root = fileURLToPath(new URL('..', import.meta.url)) const src = readFileSync(root + '/lib/index.js', 'utf8') const changelog = readFileSync(root + '/CHANGELOG.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) } } // 0.25.0 新端点的纯函数是**连续一段**,整段切出来即可(它是模块作用域、无外部依赖)。 const HELPER_BLOCK_START = '// ---- better-sidebar 0.25.0 新端点的纯函数' const HELPER_BLOCK_END = '/**\n * 解析 better-sidebar 0.24 的 `open.external` URL' const NEW_HELPERS = (() => { const a = src.indexOf(HELPER_BLOCK_START) const b = src.indexOf(HELPER_BLOCK_END) if (a < 0 || b < 0 || b <= a) throw new Error('0.25.0 helper block not found') return src.slice(a, b) })() // issue #25 (2.4.27) 引入的路径归一helper,处理器沙箱还要用 const PATH_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') const helpersModule = new Function(NEW_HELPERS + '\nreturn { creatableFileNameProblem, isoWithOffset, parseBlamePorcelain, parseWorktreeList, countStatusEntries, posixPathIdentity, localPathIdentity, firstIllegalNameChar, RESERVED_FILE_NAMES };')() const { creatableFileNameProblem, isoWithOffset, parseBlamePorcelain, parseWorktreeList, countStatusEntries, posixPathIdentity, localPathIdentity, firstIllegalNameChar, RESERVED_FILE_NAMES } = helpersModule // --------------------------------------------------------------------------- // A. 纯函数 // --------------------------------------------------------------------------- console.log('\nA. 纯函数(规则对齐上游)') check(creatableFileNameProblem('readme.md') === '', 'A1 普通文件名可用') check(creatableFileNameProblem('📁数据.txt') === '', 'A2 emoji/中文名可用(按码点迭代,不误判成非法半字符)') check(creatableFileNameProblem('') === 'name must be a single path segment', 'A3 空名 → 单段名错误') check(creatableFileNameProblem('.') === 'name must be a single path segment', 'A4 "." 拒绝') check(creatableFileNameProblem('..') === 'name must be a single path segment', 'A5 ".." 拒绝') check(creatableFileNameProblem('a/b') === 'name must be a single path segment', 'A6 含 "/" 拒绝') check(String.raw`a\b`.length === 3 && creatableFileNameProblem(String.raw`a\b`) === 'name must be a single path segment', 'A7 含 "\\" 拒绝') for (const bad of ['ab', 'a:b', 'a"b', 'a|b', 'a?b', 'a*b']) { check(creatableFileNameProblem(bad).indexOf('not allowed in a file name') > 0, 'A8 非法字符拒绝: ' + bad) } check(creatableFileNameProblem('a\u0001b').indexOf('not allowed in a file name') > 0, 'A9 控制字符拒绝(码点 < 32)') for (const res of ['NUL', 'nul.txt', 'COM1', 'lpt9.tar.gz', 'con']) { check(creatableFileNameProblem(res).indexOf('reserved device name') > 0, 'A10 Windows 保留名拒绝: ' + res) } check(creatableFileNameProblem('nulx').indexOf('reserved device name') < 0, 'A11 前缀相同的普通名(nulx)不被误拒') check(firstIllegalNameChar('ok') === undefined && firstIllegalNameChar('a WT.split('/remote/root').join(String(rootPath)) const wtRows = parseWorktreeList(wtFixture('/remote/root')) check(wtRows.length === 3, 'A22 worktree 解析出 3 条') check(wtRows[0].path === '/remote/root' && wtRows[0].branch === 'main' && wtRows[0].locked === false && wtRows[0].prunable === false, 'A23 第一条 path/branch 正确') check(wtRows[1].branch === 'feature' && wtRows[1].locked === true, 'A24 locked 被识别') check(wtRows[2].prunable === true, 'A25 prunable 被识别') check(parseWorktreeList('worktree /a\nHEAD x\nbranch refs/heads/b').length === 1, 'A26 末尾没有空行也能收尾(上游 framed 语义)') check(parseWorktreeList('worktree /a\0HEAD x\0branch refs/heads/b\0\0').length === 1, 'A27 NUL 分隔(-z)同样能解析') check(parseWorktreeList('').length === 0, 'A28 空输出 → []') check(countStatusEntries('') === 0, 'A29 空 status → 0 条') check(countStatusEntries(' M a.txt\0?? b.txt\0') === 2, 'A30 普通修改 + 未跟踪 → 2 条') check(countStatusEntries('R new.txt\0old.txt\0') === 1, 'A31 改名占两条 NUL 记录,只算 1 条(口径同上游 entries.length)') check(countStatusEntries('R n1\0o1\0R n2\0o2\0') === 2, 'A32 连续两个改名 → 2 条') check(countStatusEntries('?? sub/\0 M x\0A y\0') === 3, 'A33 混合状态 → 3 条') check(posixPathIdentity('/a/b/') === '/a/b' && posixPathIdentity('/A/B') === '/A/B', 'A34 远端同一性:去尾斜杠、区分大小写') const lp = localPathIdentity('C:\\Dir\\Sub\\') check(lp === (process.platform === 'win32' ? 'c:\\dir\\sub' : 'C:\\Dir\\Sub'), 'A35 本机同一性:Windows 下大小写无关') // --------------------------------------------------------------------------- // B. 真实处理器行为 // --------------------------------------------------------------------------- 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 } } } function makeRes() { const res = { status: 0, body: undefined, raw: undefined, writeHead(s) { res.status = s; return res }, end(b) { if (b !== undefined && res.raw === undefined) res.raw = b; return res }, setHeader() { return res } } return res } function makeCtx(sessionDir) { const sessions = { get: (id) => (id === 'sess-1' ? { header: { cwd: sessionDir } } : null) } return { get: (n) => (n === 'sessions' ? sessions : null), logger: { debug() {}, warn() {}, error() {} } } } const originalCwd = process.cwd() const hostDir = mkdtempSync(join(tmpdir(), 'dsh-0250-host-')) const sessionDir = mkdtempSync(join(tmpdir(), 'dsh-0250-sess-')) mkdirSync(join(sessionDir, 'tools'), { recursive: true }) writeFileSync(join(sessionDir, 'tools', 'x.py'), 'SESSION-CONTENT') writeFileSync(join(hostDir, 'tools-canary.txt'), 'HOST-CANARY') const REMOTE_ROOT = '/remote/root' const HOST = '' const USER = '' const KEY = '' /** 远程工作区沙箱:readRemoteInfoSync 认得 sessionDir,runPooled 记录远端命令。 */ function fsSandbox(opts) { const rec = { cmds: [], invalidations: [] } const remote = !!opts.remote 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', 'getProfile', 'localToRemote', 'shellQuotePath', 'runPooled', 'invalidateRemoteCaches', 'settingsFace', PATH_HELPERS + '\n' + NEW_HELPERS + '\n' + // 2.4.29 起 fs 判定按"工作区根前缀"匹配:这几个真源码必须一起进沙箱(不 stub 判定逻辑)。 grab(src, 'function mirrorBaseDir') + '\n' + grab(src, 'function isUnderMirrorBase') + '\n' + grab(src, 'function matchRemoteWorkspace') + '\n' + grab(src, 'function remoteWorkspaceForPath') + '\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' + 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 localCreateFile') + '\n' + grab(src, 'async function interceptFsHandler') + '\n' + 'return interceptFsHandler;' )( join, dirname, basename, stat, open, readFile, writeFile, rename, rm, mkdir, opendir, lstat, existsSync, homedir, 524288, 1000, makeCtx(sessionDir), requestTrust, denyRequest, writeJson, writeOk, readJsonBody, remote ? (p) => (typeof p === 'string' && p.indexOf(sessionDir) === 0 ? { profileId: 'p1', host: HOST, user: USER, keyPath: KEY, remotePath: REMOTE_ROOT, mirrorPath: sessionDir } : null) : () => null, async () => ({ entries: [], truncated: false }), () => ({ id: 'p1', host: HOST, user: USER, keyPath: KEY }), (local, mirror, remoteRoot) => String(remoteRoot) + String(local).replace(/\\/g, '/').slice(String(mirror).replace(/\\/g, '/').length), (p) => "'" + String(p).replace(/'/g, "'\\''") + "'", async (profile, cmd) => { rec.cmds.push(cmd) // 只把 taken.txt 当作"远端已存在",其余不存在 —— 用于验证 409 分支。 if (/^test -e /.test(cmd)) return { ok: /taken\.txt/.test(cmd), stdout: '', stderr: '' } if (/set -C/.test(cmd)) return { ok: true, stdout: '', stderr: '' } return { ok: true, stdout: '', stderr: '' } }, (p, path, o) => { rec.invalidations.push([path, o]) }, // 已注册工作区:remote 模式下把会话镜像根注册进去(真实客户端里 sessionId → 会话 cwd = 镜像根) { read: () => ({ workspaces: remote ? [{ mirrorPath: sessionDir }] : [] }) } ) return { handler: fn, rec } } const fsCall = async (api, payload, method) => { const res = makeRes() await api({ method: 'POST', headers: {}, __body: payload }, res, method) return res } console.log('\nB1. fs.createFile(本地分支:真落盘、真 409)') try { process.chdir(hostDir) const { handler } = fsSandbox({ remote: false }) let r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'new.txt' }, 'fs.createFile') check(r.status === 200 && r.body.ok === true && r.body.value.path === join(sessionDir, 'tools', 'new.txt'), 'B1 createFile 相对 path → 建在**会话 cwd** 下并返回绝对路径(旧代码会建到插件宿主目录)') check(existsSync(join(sessionDir, 'tools', 'new.txt')) && readFileSync(join(sessionDir, 'tools', 'new.txt'), 'utf8') === '', 'B2 文件真的存在于会话目录,且是空文件') check(!existsSync(join(hostDir, 'tools', 'new.txt')), 'B3 宿主目录里没有多出这个文件') r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'new.txt' }, 'fs.createFile') check(r.status === 409 && /"new.txt" already exists/.test(r.body.error.message), 'B4 同名已存在 → 409(上游契约,不是 400)') r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'a/b' }, 'fs.createFile') check(r.status === 400 && r.body.error.code === 'bad-request' && /single path segment/.test(r.body.error.message), 'B5 非法名 → 400 bad-request(带上游文案,客户端能直接显示)') r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'nul' }, 'fs.createFile') check(r.status === 400 && /reserved device name/.test(r.body.error.message), 'B6 Windows 保留名 → 400') r = await fsCall(handler, { sessionId: 'sess-UNKNOWN', path: 'tools', name: 'host-side.txt' }, 'fs.createFile') check(r.status === 400 && !existsSync(join(hostDir, 'tools', 'host-side.txt')), 'B7 取不到会话 cwd → 400,绝不在宿主目录里建文件') // fs.mkdir 的"已存在"对齐成 409(此前本地分支误给 400) r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'new.txt' }, 'fs.mkdir') check(r.status === 409, 'B8 本地 fs.mkdir 同名已存在 → 409(与上游/本插件远程分支一致)') } finally { process.chdir(originalCwd) } console.log('\nB2. fs.createFile(远程分支:必须落到远端)') try { process.chdir(hostDir) const { handler, rec } = fsSandbox({ remote: true }) const r = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'far.txt' }, 'fs.createFile') check(r.status === 200 && r.body.value.path === join(sessionDir, 'tools', 'far.txt'), 'B9 远程 createFile → 200 且返回镜像路径(客户端认镜像路径)') const create = rec.cmds.filter((c) => /set -C/.test(c)) check(create.length === 1 && create[0].indexOf(REMOTE_ROOT + '/tools/far.txt') > 0, 'B10 空文件是在**远端**创建的(命令含远端绝对路径):' + (create[0] || '(无命令)')) check(rec.cmds.some((c) => /^test -e /.test(c) && c.indexOf(REMOTE_ROOT + '/tools/far.txt') > 0), 'B11 创建前先探测远端是否已存在') check(rec.invalidations.length === 1 && rec.invalidations[0][0] === REMOTE_ROOT + '/tools', 'B12 父目录列举缓存被失效(面板能立刻看到新文件)') const r2 = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'taken.txt' }, 'fs.createFile') check(r2.status === 409, 'B13 远端已存在(探测命中)→ 409 且不执行创建') const r3 = await fsCall(handler, { sessionId: 'sess-1', path: 'tools', name: 'bad/name' }, 'fs.createFile') check(r3.status === 400 && !rec.cmds.some((c) => c.indexOf('bad/name') > 0), 'B14 非法名在本地就被挡下(不产生任何 SSH 命令)') check(rec.cmds.every((c) => typeof c === 'string' && c.length > 0), 'B15 所有远端命令都是字符串(无 undefined 拼接)') } finally { process.chdir(originalCwd) } console.log('\nB3. git.* 新端点(真实处理器 + 假 git)') function gitSandbox(opts) { const rec = { calls: [], invalidations: [], freshness: [] } const remote = !!opts.remote const responses = opts.responses || {} const key = (dir, args) => dir + ' :: ' + args.join(' ') const handler = new Function( 'join', 'existsSync', 'readFileSync', 'ctx', 'requestTrust', 'denyRequest', 'writeJson', 'writeOk', 'readJsonBody', 'matchRemoteWorkspace', 'readRemoteInfoSync', 'getProfile', 'localToRemote', 'runGitLocal', 'runGitRemote', 'invalidateRemoteCaches', 'freshnessForgetProfile', 'wrapperDir', PATH_HELPERS + '\n' + NEW_HELPERS + '\n' + grab(src, 'function sessionCwdFrom') + '\n' + grab(src, 'function parsePorcelainZ') + '\n' + grab(src, 'function parseLogLines') + '\n' + grab(src, 'async function gitStatusImpl') + '\n' + grab(src, 'async function gitWorktreesImpl') + '\n' + grab(src, 'function gitContextOf') + '\n' + grab(src, 'async function interceptGitHandler') + '\n' + 'return interceptGitHandler;' )( join, existsSync, readFileSync, makeCtx(sessionDir), requestTrust, denyRequest, writeJson, writeOk, readJsonBody, remote ? (a, b) => ({ mirrorPath: sessionDir }) : () => null, remote ? (p) => (typeof p === 'string' && p.indexOf(sessionDir) === 0 ? { profileId: 'p1', host: HOST, user: USER, keyPath: KEY, remotePath: REMOTE_ROOT, mirrorPath: sessionDir } : null) : () => null, () => ({ id: 'p1' }), (local, mirror, remoteRoot) => String(remoteRoot) + String(local).replace(/\\/g, '/').slice(String(mirror).replace(/\\/g, '/').length), async (dir, args) => { rec.calls.push(['local', dir, args.join(' ')]) if (responses[key(dir, args)] !== undefined) { const v = responses[key(dir, args)] if (v instanceof Error) throw v return v } if (args[0] === 'status') return '' if (args[0] === 'worktree') return '' return '' }, async (profile, dir, args) => { rec.calls.push(['remote', dir, args.join(' ')]) if (responses[key(dir, args)] !== undefined) { const v = responses[key(dir, args)] if (v instanceof Error) throw v return v } if (args[0] === 'status') return '' return '' }, (p, path, o) => { rec.invalidations.push([path, o]) }, (stateDir, profileId) => { rec.freshness.push([stateDir, profileId]) }, '' ) return { handler, rec } } const gitCall = async (api, method, payload) => { const res = makeRes() await api({ method: 'POST', headers: {}, __body: payload }, res, method) return res } try { process.chdir(hostDir) // ---- blame ---- { const { handler, rec } = gitSandbox({ remote: false, responses: { [sessionDir + ' :: blame --porcelain -L 3,7 -- src/a.ts']: BLAME } }) const r = await gitCall(handler, 'blame', { sessionId: 'sess-1', path: 'src/a.ts', startLine: 3, endLine: 7 }) check(r.status === 200 && r.body.value.lines.length === 3 && r.body.value.lines[0].author === 'Alice', 'B16 git.blame → {lines:[…]}(真实处理器解析 porcelain)') check(rec.calls.length === 1 && rec.calls[0][1] === sessionDir && rec.calls[0][2] === 'blame --porcelain -L 3,7 -- src/a.ts', 'B17 blame 用会话 cwd 跑,实参与上游一致(-L start,end -- path)') const bad1 = await gitCall(handler, 'blame', { sessionId: 'sess-1', path: 'src/a.ts', startLine: 0, endLine: 7 }) check(bad1.status === 400 && rec.calls.length === 1, 'B18 startLine 非正整数 → 400,且**不跑** git') const bad2 = await gitCall(handler, 'blame', { sessionId: 'sess-1', path: 'src/a.ts', startLine: 7, endLine: 3 }) check(bad2.status === 400 && /must not precede/.test(bad2.body.error.message), 'B19 endLine < startLine → 400(上游文案)') const bad3 = await gitCall(handler, 'blame', { sessionId: 'sess-1', startLine: 1, endLine: 2 }) check(bad3.status === 400 && /path is required/.test(bad3.body.error.message), 'B20 缺 path → 400') const failing = gitSandbox({ remote: false, responses: { [sessionDir + ' :: blame --porcelain -L 1,1 -- untracked.txt']: new Error('fatal: no such path') } }) const r2 = await gitCall(failing.handler, 'blame', { sessionId: 'sess-1', path: 'untracked.txt', startLine: 1, endLine: 1 }) check(r2.status === 200 && r2.body.value.lines.length === 0, 'B21 blame 失败 → 静默降级成空数组(上游同)') } // ---- diff-head ---- { const { handler, rec } = gitSandbox({ remote: false, responses: { [sessionDir + ' :: diff --no-ext-diff --no-color -U3 HEAD -- src/a.ts']: 'DIFF-HEAD-TEXT' } }) const r = await gitCall(handler, 'diff-head', { sessionId: 'sess-1', path: 'src/a.ts' }) check(r.status === 200 && r.body.value.diff === 'DIFF-HEAD-TEXT', 'B22 git.diff-head → {diff}') check(rec.calls[0][2] === 'diff --no-ext-diff --no-color -U3 HEAD -- src/a.ts', 'B23 diff-head 实参与上游一致(--no-ext-diff --no-color -U3 HEAD)') const noHead = gitSandbox({ remote: false, responses: { [sessionDir + ' :: diff --no-ext-diff --no-color -U3 HEAD -- src/a.ts']: new Error('fatal: ambiguous argument HEAD') } }) const r2 = await gitCall(noHead.handler, 'diff-head', { sessionId: 'sess-1', path: 'src/a.ts' }) check(r2.status === 200 && noHead.rec.calls.some((c) => c[2] === 'diff --no-ext-diff --no-color -U3 --cached -- src/a.ts'), 'B24 没有 HEAD 时回退 --cached(上游的回退分支)') const r3 = await gitCall(handler, 'diff-head', { sessionId: 'sess-1' }) check(r3.status === 400, 'B25 diff-head 缺 path → 400') } // ---- worktrees(本地)---- { const { handler, rec } = gitSandbox({ remote: false, responses: { [sessionDir + ' :: rev-parse --is-inside-work-tree']: 'true\n', [sessionDir + ' :: rev-parse --show-toplevel']: sessionDir + '\n', [sessionDir + ' :: worktree list --porcelain']: wtFixture(sessionDir), [sessionDir + ' :: status --porcelain=v1 -z --untracked-files=all']: ' M a.txt\0?? b.txt\0' } }) const r = await gitCall(handler, 'worktrees', { sessionId: 'sess-1' }) const rows = r.body.value check(r.status === 200 && Array.isArray(rows) && rows.length === 2, 'B26 git.worktrees → 数组(prunable 被过滤)') check(rows[0].path === sessionDir && rows[0].current === true && rows[0].branch === 'main' && rows[0].changes === 2, 'B27 current 条目排最前,changes 为 status 条目数') check(rows[1].path === '/remote/wt2' && rows[1].current === false && rows[1].branch === 'feature' && rows[1].changes === 0, 'B28 其他 worktree 保留远端路径形状,changes 缺省 0') check(rec.calls.some((c) => c[1] === '/remote/wt2' && c[2].indexOf('status --porcelain=v1 -z --untracked-files=all') === 0), 'B29 每个 worktree 的 status 用**它自己的目录**跑(不是会话 cwd)') const notRepo = gitSandbox({ remote: false, responses: { [sessionDir + ' :: rev-parse --is-inside-work-tree']: 'false\n' } }) const r2 = await gitCall(notRepo.handler, 'worktrees', { sessionId: 'sess-1' }) check(r2.status === 200 && r2.body.value.length === 0, 'B30 不是仓库 → [](上游同)') } // ---- worktrees(远程:runIn 必须走 SSH + 用远端路径)---- { const { handler, rec } = gitSandbox({ remote: true, responses: { [REMOTE_ROOT + ' :: rev-parse --is-inside-work-tree']: 'true\n', [REMOTE_ROOT + ' :: rev-parse --show-toplevel']: REMOTE_ROOT + '\n', [REMOTE_ROOT + ' :: worktree list --porcelain']: wtFixture(REMOTE_ROOT), [REMOTE_ROOT + ' :: status --porcelain=v1 -z --untracked-files=all']: ' M a.txt\0' } }) const r = await gitCall(handler, 'worktrees', { sessionId: 'sess-1' }) check(r.status === 200 && r.body.value[0].current === true, 'B31 远程 worktrees:current 用远端路径判定') check(rec.calls.every((c) => c[0] === 'remote'), 'B32 远程分支只走 runGitRemote(不在本机跑 git)') check(rec.calls.some((c) => c[1] === '/remote/wt2'), 'B33 每个 worktree 用**远端**路径跑(/remote/wt2)') check(rec.calls.every((c) => !String(c[1]).startsWith(sessionDir)), 'B34 没有任何调用落到本地镜像目录') } // ---- pull / push ---- { const { handler, rec } = gitSandbox({ remote: true, responses: { [REMOTE_ROOT + ' :: pull --ff-only']: 'Already up to date.\n' } }) const r = await gitCall(handler, 'pull', { sessionId: 'sess-1' }) check(r.status === 200 && r.body.value.ok === true, 'B35 git.pull → {ok:true}') check(rec.calls.length === 1 && rec.calls[0][1] === REMOTE_ROOT && rec.calls[0][2] === 'pull --ff-only', 'B36 pull 在**远端仓库**上跑(--ff-only,与上游一致)') check(rec.invalidations.length === 1 && rec.invalidations[0][0] === REMOTE_ROOT && rec.invalidations[0][1].subtree === true, 'B37 pull 之后整棵远端列举缓存失效(工作树可能变了)') check(rec.freshness.length === 1 && rec.freshness[0][1] === 'p1', 'B38 pull 之后清掉写回桥的远端指纹(否则下次写回被误判"远端已改动")') const pushed = gitSandbox({ remote: true, responses: { [REMOTE_ROOT + ' :: push']: 'ok\n' } }) const r2 = await gitCall(pushed.handler, 'push', { sessionId: 'sess-1' }) check(r2.status === 200 && r2.body.value.ok === true && pushed.rec.calls[0][2] === 'push', 'B39 git.push → {ok:true} 且实参为 push') check(pushed.rec.invalidations.length === 0 && pushed.rec.freshness.length === 0, 'B40 push 不改工作树 → 不做缓存失效(避免无谓刷新)') const local = gitSandbox({ remote: false, responses: { [sessionDir + ' :: pull --ff-only']: '' } }) const r3 = await gitCall(local.handler, 'pull', { sessionId: 'sess-1' }) check(r3.status === 200 && local.rec.calls[0][1] === sessionDir, 'B41 本地 pull 用会话 cwd,且不触碰远端缓存/指纹') check(local.rec.invalidations.length === 0 && local.rec.freshness.length === 0, 'B42 本地 pull 不做远端失效') } // ---- 未注册的模型类端点不应被本插件接管(回归:别把它们塞进 GIT_METHODS)---- { const { handler } = gitSandbox({ remote: false }) const r = await gitCall(handler, 'models', { sessionId: 'sess-1' }) check(r.status === 404, 'B43 git.models 不由本插件处理(纯模型端点,交给上游)') } } finally { process.chdir(originalCwd) } // --------------------------------------------------------------------------- // C. 接线与上游对拍 // --------------------------------------------------------------------------- console.log('\nC. 接线、文档与上游覆盖率') const fsRouteArray = (() => { const m = src.match(/\["fs\.tree",[^\]]*\]\.forEach/) if (!m) throw new Error('fs route array not found') return [...m[0].matchAll(/"(fs\.[a-zA-Z]+)"/g)].map((x) => x[1]) })() const gitMethods = (() => { const m = src.match(/const GIT_METHODS = \[([^\]]+)\]/) if (!m) throw new Error('GIT_METHODS not found') return [...m[1].matchAll(/"([^"]+)"/g)].map((x) => x[1]) })() const NEED_FS = ['fs.createFile'] const NEED_GIT = ['blame', 'diff-head', 'worktrees', 'pull', 'push'] // 0.28.2 新增的 git.history(提交图超分支上限时的分页历史兜底)—— upstream-drift 2026-11-02 报红的那一项。 // 远程工作区不接管它,客户端翻页时会拿本地镜像里的仓库列历史(与本文件 C 段防的是同一类静默失效)。 const NEED_GIT_0282 = ['history'] for (const m of NEED_FS) check(fsRouteArray.includes(m), 'C1 fs 路由注册了 0.25.0 新端点 ' + m) for (const m of NEED_GIT) check(gitMethods.includes(m), 'C2 GIT_METHODS 注册了 0.25.0 新端点 git.' + m) for (const m of NEED_GIT_0282) check(gitMethods.includes(m), 'C2b GIT_METHODS 注册了 0.28.2 新端点 git.' + m) check(!gitMethods.includes('models') && !gitMethods.includes('suggest-message') && !gitMethods.includes('commit-model'), 'C3 模型类端点(models / suggest-message / commit-model)**不**注册(它们不碰仓库路径,交给上游才对)') check(!/function createWorkspaceFile\(/.test(src) && !/function assertCreatableFileName\(/.test(src) && !/function parseBlamePorcelain\(output\) \{\s*const rows = \[\];\s*const seen = \/\* @__PURE__ \*\//.test(src), 'C4 没有把上游实现整段抄进来(只按契约重写;上游函数名最多出现在注释里)') check(/set -C; : > /.test(src), 'C5 远端建空文件用 noclobber 重定向(探测与创建之间的竞态不会清空别人的文件)') check(src.indexOf('creatableFileNameProblem(fileName)') > 0, 'C6 远程分支同样做文件名校验(不把非法名发到远端)') check(/result\.exists === true \? 409 : 400/.test(src), 'C7 "已存在"统一映射成 409(本地/远端、mkdir/createFile 一致)') // 与**实际安装的** better-sidebar 对拍(MAINTENANCE 硬规则的自动化) const installed = (() => { const base = join(homedir(), '.dsh', 'profiles') if (!existsSync(base)) return null for (const dir of readdirSync(base)) { const p = join(base, dir, 'node_modules', 'dsh-better-sidebar') if (existsSync(join(p, 'lib', 'index.js'))) { return { version: JSON.parse(readFileSync(join(p, 'package.json'), 'utf8')).version, src: readFileSync(join(p, 'lib', 'index.js'), 'utf8') } } } return null })() if (!installed) { console.log(' · SKIP C8:本机没有安装 dsh-better-sidebar,跳过上游对拍(不算失败)') } else { const keys = [...new Set([...installed.src.matchAll(/"(fs|git)\.[a-zA-Z-]+"/g)].map((m) => m[0].slice(1, -1)))] const fsKeys = keys.filter((k) => k.startsWith('fs.')) const gitKeys = keys.filter((k) => k.startsWith('git.')) const MODEL_ONLY = ['git.models', 'git.commit-model', 'git.suggest-message'] const missingFs = fsKeys.filter((k) => !fsRouteArray.includes(k)) const missingGit = gitKeys.filter((k) => !gitMethods.includes(k.slice(4)) && !MODEL_ONLY.includes(k)) check(missingFs.length === 0, 'C8 对拍 better-sidebar@' + installed.version + ':所有 fs.* 端点都已接管(缺: ' + (missingFs.join(', ') || '无') + ')') check(missingGit.length === 0, 'C9 对拍 better-sidebar@' + installed.version + ':所有与仓库相关的 git.* 端点都已接管(缺: ' + (missingGit.join(', ') || '无') + ')') console.log(' · 对拍快照:fs ' + fsKeys.length + ' 个 / git ' + gitKeys.length + ' 个,其中模型类 3 个不接管') } check(new RegExp('## \\[' + pkg.version.replace(/\./g, '\\.') + '\\]').test(changelog), 'C10 CHANGELOG 有当前版本的条目(' + pkg.version + ')') check(/0\.25\.0/.test(changelog), 'C11 CHANGELOG 记了这次升级到 0.25.0 的端点变化') // --------------------------------------------------------------------------- // D. 语义差分对拍(把上游真实纯函数抽出来,同一批输入逐条比较) // --------------------------------------------------------------------------- // C8/C9 只保证「端点都注册了」,D 段保证「语义没走样」:文件名校验的接受/拒绝与拒绝文案、 // isoWithOffset 的格式、blame porcelain 与 worktree 列表的解析、status 条目计数(对齐上游 // parsePorcelainZ().length)。上游内部实现随版本变化,抽不到就 SKIP、不算失败。 console.log('\nD. 语义差分对拍(vs 实际安装的 better-sidebar)') function grabConst(text, marker, endMarker) { const i = text.indexOf(marker) if (i < 0) throw new Error('missing ' + marker) const start = text.lastIndexOf('\n', i) + 1 const j = text.indexOf(endMarker, i) if (j < 0) throw new Error('missing end ' + endMarker) return text.slice(start, j + endMarker.length) } function grabFnText(text, marker) { const i = text.indexOf(marker) if (i < 0) throw new Error('missing ' + marker) const start = text.lastIndexOf('\n', i) + 1 let depth = 0, k = text.indexOf('{', i) for (; k < text.length; k++) { if (text[k] === '{') depth++; else if (text[k] === '}') { depth--; if (!depth) break } } return text.slice(start, text.indexOf('\n', k)) } if (!installed) { console.log(' · SKIP:本机没有安装 dsh-better-sidebar,跳过语义对拍(不算失败)') } else { let up = null try { up = new Function([ 'class SidebarError extends Error { constructor(code, message, status = 400) { super(message); this.code = code; this.status = status } }', grabConst(installed.src, 'const ILLEGAL_FILE_NAME_CHARS =', ';'), grabFnText(installed.src, 'function firstIllegalNameChar('), grabConst(installed.src, 'const RESERVED_FILE_NAMES =', ']);'), // 0.26.1 起 assertCreatableFileName 把"单段名"检查拆给了 assertSingleSegmentName, // 不一起抽进沙箱的话它对**每个**输入都抛 ReferenceError(看起来像"上游全部拒绝")。 grabFnText(installed.src, 'function assertSingleSegmentName('), grabFnText(installed.src, 'function assertCreatableFileName('), grabFnText(installed.src, 'function isoWithOffset('), grabFnText(installed.src, 'function parseBlamePorcelain('), grabFnText(installed.src, 'function parseWorktreeList('), 'return { assertCreatableFileName, isoWithOffset, parseBlamePorcelain, parseWorktreeList };' ].join('\n'))() } catch (e) { console.log(' · SKIP:上游纯函数抽取失败(' + e.message + ')——升级后实现变了,人工看一眼') } if (up) { let same = 0, diff = 0 const cmp = (label, u, m) => { if (JSON.stringify(u) === JSON.stringify(m)) { same++; return } diff++ console.log(' ✗ 与上游不一致 [' + label + '] 上游=' + JSON.stringify(u).slice(0, 90) + ' 本插件=' + JSON.stringify(m).slice(0, 90)) } const NAMES = ['readme.md', 'a', 'A.TXT', '.gitignore', '..hidden', '📁数据.txt', '中文 名.csv', '', '.', '..', 'a/b', String.raw`a\b`, 'a= 60, 'D2 对拍覆盖足够多的输入(' + same + ' 项 ≥ 60)') } } try { rmSync(hostDir, { recursive: true, force: true }) } catch (e) {} try { rmSync(sessionDir, { recursive: true, force: true }) } catch (e) {} console.log('\n结果: ' + pass + ' 通过, ' + fail + ' 失败') process.exit(fail ? 1 : 0)