@mzzsfy/dsh-shell-select 0.4.1 → 0.4.3

package/test/deny-output-schema.test.mjs

@@ -0,0 +1,53 @@
+// FIND-020-3 回归:deny 命中返回对象必须通过工具输出 foreground oneOf 分支校验
+// (additionalProperties:false)——历史缺陷:blocked/blockedBy 声明外字段致宿主判
+// INVALID_TOOL_OUTPUT,拒绝文案在真机不可达。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { DenyError } from '../src/denylist.mjs'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const source = readFileSync(join(here, '..', 'src', 'tool.mjs'), 'utf8')
+
+// 前台输出分支属性表与 additionalProperties 与 src/tool.mjs 同源抽取
+function extractForegroundProperties(src) {
+  const start = src.indexOf('function foregroundOutputProperties()')
+  const body = src.slice(start, src.indexOf('\n}\n', start))
+  return body
+}
+
+function pickStringProps(propsSource) {
+  const names = [...propsSource.matchAll(/^\s{4}(\w+):/gm)].map((m) => m[1])
+  return names
+}
+
+test('deniedForeground 返回对象逐字段落 foreground 分支声明内', () => {
+  const propsSource = extractForegroundProperties(source)
+  const declared = pickStringProps(propsSource)
+  assert.ok(declared.includes('kind') && declared.includes('stderr'), '属性表抽取自净(schema 自身声明)')
+  // deniedForeground 构造器字段全部在声明表内(拒绝实现不再携带声明外字段)
+  const fnStart = source.indexOf('function deniedForeground(')
+  const fnBody = source.slice(fnStart, source.indexOf('\n}\n', fnStart))
+  const used = [...fnBody.matchAll(/^\s{4}(\w+):/gm)].map((m) => m[1])
+  const extra = used.filter((k) => !declared.includes(k))
+  assert.deepEqual(extra, [], `deniedForeground 不得携带声明外字段: ${extra.join(',')}`)
+  assert.doesNotMatch(fnBody, /blocked:/)
+  assert.doesNotMatch(fnBody, /blockedBy:/)
+})
+
+test('两执行分支 catch 均走 deniedForeground(不再内联声明外字段对象)', () => {
+  assert.equal((source.match(/deniedForeground\(error, entry\.id\)/g) ?? []).length, 2)
+  assert.doesNotMatch(source, /kind: 'foreground', shell: entry\.id, blocked: true/)
+})
+
+test('拒绝文案仍含契约锚(模型可见 [blocked by shell-select: matches deny pattern …])', () => {
+  const error = new DenyError('echo\\\\s', 'echo x')
+  const fnStart = source.indexOf('function deniedForeground(')
+  const fnBody = source.slice(fnStart, source.indexOf('\n}\n', fnStart))
+  assert.match(fnBody, /blockedMarker\(error\)/)
+  assert.match(source, /function blockedMarker\(error\)/)
+  assert.ok(error.pattern.length > 0)
+})

package/test/executor-seam.test.mjs

@@ -1,4 +1,4 @@
-// executor 官方 seam 集成(桩 ctx):BDD 场景见本文件与 README「官方工具兼容」。
+// executor 官方 seam 集成(桩 ctx):BDD 场景见本文件与 README「官方工具兼容」。
 // 背景:preset 注入的官方 tool-pwsh 经 cordis 服务代理(ctx.shell)调用执行器,
 // 代理把方法 this 重定向到阴影对象;执行器公开面必须与官方 PwshLocalExecutor
 // 同构地使用公有字段/方法(#私有在阴影 receiver 下触发品牌检查错误)。
@@ -38,6 +38,7 @@ function stubCtx({ sandboxMode = 'danger-full-access', spawn = stubSpawn() } = {
   }
   const ctx = {
     reflect: { provide: () => {} },
+    on: () => () => {},
     logger: { warn: () => {} },
     get(service) {
       if (service === 'webServer') return { register: (item) => registered.routes.push(item.path) }

package/test/executor.test.mjs

@@ -6,6 +6,13 @@ import assert from 'node:assert/strict'
 import ShellSelectExecutor from '../src/executor.mjs'
 import { resolveConfig, assertServiceableConfig, defaultConfig } from '../src/config.mjs'
 
+test('执行器激活后挂模型工具投影', () => {
+  // Given 有模型服务；When构造执行器；Then组装事件由执行器生命周期持有。
+  const { ctx, registered } = stubCtx()
+  new ShellSelectExecutor(ctx, baseConfig())
+  assert.equal(registered.listeners?.filter((row) => row.name === 'system-prompt/assemble').length, 1)
+})
+
 // --- 桩具 ---
 
 function stubReader(text) {
@@ -59,6 +66,11 @@ function stubCtx({ withSettings = true, sandboxMode = 'danger-full-access', spaw
       }
       fn(child)
     },
+    on(name, handler) {
+      registered.listeners ??= []
+      registered.listeners.push({ name, handler })
+      return () => {}
+    },
     subprocess: spawn,
     sandbox: {
       confine: (argv, policy) => ({

package/test/official-contract.test.mjs

@@ -0,0 +1,208 @@
+// 官方 ctx.shell 契约钉死 pwsh + 工具层六场景矩阵(前台/后台 × pwsh/git-bash):
+// BDD:官方 dsh-pwsh-local 契约即 PowerShell 专用,execute/run/start 落默认
+// 客户端会随配置漂移炸方言(官方 pwsh 工具调用在 git-bash 里执行 PowerShell)。
+// 后台分支 owner 必须是 agent id(resolveOwner 以 id 查 registry,传对象报
+// "[object Object] has no live agent");deny 探测不得真实 spawn(命令双跑)。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import ShellSelectExecutor from '../src/executor.mjs'
+import { registerShellTool } from '../src/tool.mjs'
+
+function stubReader(text) {
+  return { readFrom: () => ({ text, lossy: false, nextOffset: text.length }) }
+}
+
+function stubSpawn(stdoutText = '', stderrText = '', exitCode = 0) {
+  const calls = []
+  const spawn = (spec) => {
+    calls.push(spec)
+    return {
+      collected: { stdout: stubReader(stdoutText), stderr: stubReader(stderrText) },
+      done: Promise.resolve({ exitCode, signal: null }),
+      terminate: () => true,
+    }
+  }
+  return { spawn, calls }
+}
+
+const SHELLS = [
+  { id: 'pwsh', name: 'PowerShell', kind: 'pwsh', path: process.execPath },
+  { id: 'git-bash', name: 'Git Bash', kind: 'bash', path: process.execPath },
+]
+
+function buildExecutor({ defaultId = 'git-bash', deny = [] } = {}) {
+  const stub = stubSpawn('out', '', 0)
+  const registered = { tools: [] }
+  const jobs = { starts: [] }
+  const ctx = {
+    reflect: { provide: () => {} },
+    on: () => () => {},
+    logger: { warn: () => {} },
+    get(service) {
+      if (service === 'webServer') return { register: () => {} }
+      if (service === 'jobs') return jobsApi()
+      return undefined
+    },
+    inject(services, fn) {
+      fn({ settings: undefined, effect: (effectFn) => effectFn() })
+    },
+    subprocess: stub,
+    sandbox: { confine: (argv) => ({ argv: ['WRAPPED', ...argv], enforcement: 'full', denialSignatures: [], runnerFailureRules: [] }) },
+    sandboxPolicy: { defaultMode: 'danger-full-access', resolve: () => ({ mode: 'danger-full-access', roots: [] }) },
+    tools: { register: (definition) => { registered.tools.push(definition); return () => registered.tools.pop() } },
+    systemPrompt: { section: () => {}, getSectionOrder: (key) => key },
+    shellEnv: { collect: () => ({}) },
+    effect: (fn) => fn(),
+  }
+  function jobsApi() {
+    return {
+      start(spec) {
+        jobs.starts.push(spec)
+        const outcome = spec.run()
+        return { id: `job-${jobs.starts.length}`, done: outcome.done, read: () => outcome.readOutput() }
+      },
+    }
+  }
+  const executor = new ShellSelectExecutor(ctx, { shells: SHELLS, default: defaultId, deny })
+  return { executor, ctx, stub, registered, jobs }
+}
+
+const execFor = (id) => ({ signal: new AbortController().signal, agent: { id, session: { header: { cwd: process.cwd() } } } })
+const EXEC = execFor('agent-0')
+
+test('execute 契约钉死 pwsh:default=git-bash 时仍走 pwsh argv', async () => {
+  const { executor, stub } = buildExecutor({ defaultId: 'git-bash' })
+  const handle = await executor.execute(executor.resolve({ command: 'Get-Date', workdir: process.cwd() }))
+  await handle.result()
+  assert.match(stub.calls[0].argv.at(-1), /Get-Date$/)
+  assert.deepEqual(stub.calls[0].argv.slice(1, 5), ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command'])
+})
+
+test('start 契约钉死 pwsh:default=git-bash 时仍走 pwsh argv', () => {
+  const { executor, stub } = buildExecutor({ defaultId: 'git-bash' })
+  const proc = executor.start(executor.resolve({ command: 'Get-Date', workdir: process.cwd(), onExpiry: 'none' }))
+  return proc.done.then(() => {
+    assert.deepEqual(stub.calls[0].argv.slice(1, 5), ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command'])
+  })
+})
+
+test('配置删除 pwsh 条目:契约现场探测仍走 pwsh,不落默认客户端', async () => {
+  const { executor, stub } = buildExecutor({ defaultId: 'git-bash' })
+  executor.refresh({ shells: SHELLS.filter((entry) => entry.id !== 'pwsh'), default: 'git-bash' })
+  assert.throws(() => executor.entryFor('pwsh'), /pwsh/)
+  const entry = executor.contractEntry()
+  assert.equal(entry.kind, 'pwsh')
+  const handle = await executor.execute(executor.resolve({ command: 'Get-Date', workdir: process.cwd() }))
+  await handle.result()
+  assert.deepEqual(stub.calls[0].argv.slice(1, 5), ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command'])
+})
+
+// --- 工具层六场景矩阵 ---
+
+test('矩阵:shell 前台 pwsh(git-bash 默认)', async () => {
+  const { executor, ctx, stub, registered } = buildExecutor({ defaultId: 'git-bash' })
+  registerShellTool(ctx, { executor })
+  const shellTool = registered.tools.find((tool) => tool.name === 'shell')
+  const value = await shellTool.execute({ command: 'Write-Output hi', description: 'probe', shell: 'pwsh', workdir: process.cwd() }, EXEC)
+  assert.equal(value.kind, 'foreground')
+  assert.equal(value.shell, 'pwsh')
+  assert.deepEqual(stub.calls[0].argv.slice(1, 5), ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command'])
+})
+
+test('矩阵:shell 前台 git-bash(默认)', async () => {
+  const { executor, ctx, stub, registered } = buildExecutor({ defaultId: 'git-bash' })
+  registerShellTool(ctx, { executor })
+  const shellTool = registered.tools.find((tool) => tool.name === 'shell')
+  const value = await shellTool.execute({ command: 'echo hi', description: 'probe', workdir: process.cwd() }, EXEC)
+  assert.equal(value.kind, 'foreground')
+  assert.equal(value.shell, 'git-bash')
+  assert.deepEqual(stub.calls[0].argv.slice(1, 3), ['-c', 'echo hi'])
+})
+
+test('矩阵:pwsh 工具前台(钉死 pwsh)', async () => {
+  const { executor, ctx, stub, registered } = buildExecutor({ defaultId: 'git-bash' })
+  registerShellTool(ctx, { executor })
+  const pwshTool = registered.tools.find((tool) => tool.name === 'pwsh')
+  const value = await pwshTool.execute({ command: 'Get-Date', description: 'probe', workdir: process.cwd() }, EXEC)
+  assert.equal(value.shell, 'pwsh')
+  assert.deepEqual(stub.calls[0].argv.slice(1, 5), ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command'])
+})
+
+async function backgroundCase({ shellArg, defaultId }) {
+  const { executor, ctx, stub, registered, jobs } = buildExecutor({ defaultId })
+  registerShellTool(ctx, { executor })
+  const shellTool = registered.tools.find((tool) => tool.name === 'shell')
+  const args = { command: 'echo hi', description: 'probe', run_in_background: true, workdir: process.cwd() }
+  if (shellArg !== undefined) args.shell = shellArg
+  const value = await shellTool.execute(args, { signal: new AbortController().signal, agent: execFor('agent-1').agent })
+  assert.equal(value.kind, 'background')
+  assert.equal(jobs.starts.length, 1)
+  assert.equal(jobs.starts[0].owner, 'agent-1', 'owner 必须是 agent id 而非对象')
+  const expectedKind = shellArg === 'pwsh' || (shellArg === undefined && defaultId === 'pwsh') ? 'pwsh' : 'bash'
+  assert.equal(executor.entryFor(shellArg).kind, expectedKind)
+  return { stub, jobs }
+}
+
+test('矩阵:后台 default(git-bash)', async () => {
+  const { stub, jobs } = await backgroundCase({ defaultId: 'git-bash' })
+  await jobs.starts[0].run // run() 已在 start 内同步执行
+  await Promise.resolve()
+  assert.equal(stub.calls.length, 1, 'deny 探测不得真实 spawn,整个后台任务只 spawn 一次')
+  assert.deepEqual(stub.calls[0].argv.slice(1, 3), ['-c', 'echo hi'])
+})
+
+test('矩阵:后台 shell=pwsh', async () => {
+  const { stub } = await backgroundCase({ shellArg: 'pwsh', defaultId: 'git-bash' })
+  await Promise.resolve()
+  assert.equal(stub.calls.length, 1)
+  assert.deepEqual(stub.calls[0].argv.slice(1, 5), ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command'])
+})
+
+test('矩阵:后台 default=pwsh(默认即 pwsh)', async () => {
+  const { stub } = await backgroundCase({ defaultId: 'pwsh' })
+  await Promise.resolve()
+  assert.equal(stub.calls.length, 1)
+  assert.deepEqual(stub.calls[0].argv.slice(1, 5), ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command'])
+})
+
+test('矩阵:后台 pwsh 工具(钉死 pwsh)', async () => {
+  const { executor, ctx, stub, registered, jobs } = buildExecutor({ defaultId: 'git-bash' })
+  registerShellTool(ctx, { executor })
+  const pwshTool = registered.tools.find((tool) => tool.name === 'pwsh')
+  const value = await pwshTool.execute(
+    { command: 'Get-Date', description: 'probe', run_in_background: true, workdir: process.cwd() },
+    { signal: new AbortController().signal, agent: execFor('agent-2').agent },
+  )
+  assert.equal(value.kind, 'background')
+  assert.equal(jobs.starts[0].owner, 'agent-2')
+  await Promise.resolve()
+  assert.equal(stub.calls.length, 1)
+  assert.deepEqual(stub.calls[0].argv.slice(1, 5), ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command'])
+})
+
+test('本包同名 pwsh 工具结果携带接管事实，而 shell=pwsh 只携带客户端事实', async () => {
+  // Given本包两种PowerShell入口；When执行并渲染；Then仅直接pwsh产生独立接管事实。
+  const { ctx, registered } = buildExecutor()
+  for (const name of ['pwsh', 'shell']) {
+    const tool = registered.tools.find(tool => tool.name === name)
+    const args = { command: 'Get-Date', description: 'probe', ...(name === 'shell' ? { shell: 'pwsh' } : {}) }
+    const value = await tool.execute(args, EXEC)
+    const content = tool.output.render(args, value)
+    if (name === 'pwsh') assert.deepEqual(content.at(-1), { type: 'shell-select-takeover', tool: 'pwsh' })
+    else assert.equal(content.some(part => part.type === 'shell-select-takeover'), false)
+  }
+})
+
+test('矩阵:后台 deny 命中,启动前拒绝且零 spawn', async () => {
+  const { executor, ctx, stub, registered, jobs } = buildExecutor({ defaultId: 'git-bash', deny: ['forbidden'] })
+  registerShellTool(ctx, { executor })
+  const shellTool = registered.tools.find((tool) => tool.name === 'shell')
+  const value = await shellTool.execute(
+    { command: 'echo forbidden thing', description: 'probe', run_in_background: true, workdir: process.cwd() },
+    { signal: new AbortController().signal, agent: execFor('agent-3').agent },
+  )
+  assert.equal(value.kind, 'foreground', 'deny 命中回退前台拒绝形态')
+  assert.equal(jobs.starts.length, 0)
+  assert.equal(stub.calls.length, 0)
+})

package/test/path-guidance.test.mjs

@@ -0,0 +1,28 @@
+// bash 路径措辞测试:shellDescription 在 bash 形可用客户端在场时追加路径引导。
+// BDD 场景见 docs/feat-shell-select-pathrescue/plan.md A 节。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { shellDescription } from '../src/tool.mjs'
+
+const FACES = { backgroundEnabled: true, escalationModes: [] }
+const entry = (id, kind, available) => ({ id, kind, available })
+
+test('A1 含可用 bash 条目:描述含 Windows-style 路径措辞', () => {
+  const executor = { listShells: () => ({ default: 'pwsh', shells: [entry('pwsh', 'pwsh', true), entry('git-bash', 'bash', true)] }) }
+  const text = shellDescription({ executor, ...FACES })
+  assert.match(text, /Windows-style paths/)
+  assert.match(text, /`workdir`/)
+})
+
+test('A2 仅 pwsh/cmd:不含措辞', () => {
+  const executor = { listShells: () => ({ default: 'pwsh', shells: [entry('pwsh', 'pwsh', true), entry('cmd', 'cmd', true)] }) }
+  const text = shellDescription({ executor, ...FACES })
+  assert.doesNotMatch(text, /Windows-style paths/)
+})
+
+test('A3 bash 条目不可执行:不含措辞(可执行性事实优先)', () => {
+  const executor = { listShells: () => ({ default: 'pwsh', shells: [entry('pwsh', 'pwsh', true), entry('git-bash', 'bash', false)] }) }
+  const text = shellDescription({ executor, ...FACES })
+  assert.doesNotMatch(text, /Windows-style paths/)
+})

package/test/path-rescue.test.mjs

@@ -0,0 +1,173 @@
+// 侧栏路径救援测试:函数映射、地址语法与实际注入生命周期。
+// BDD 场景见 docs/feat-shell-select-pathrescue/plan.md B 节。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const source = readFileSync(join(here, '..', 'src', 'client.js'), 'utf8')
+
+function extractLogic(name, deps = {}) {
+  const pattern = new RegExp('// LOGIC-BEGIN ' + name + '\\n([\\s\\S]*?)\\n\\s*// LOGIC-END ' + name)
+  const match = source.match(pattern)
+  if (!match) throw new Error('client.js 缺少 LOGIC 段: ' + name)
+  const keys = Object.keys(deps)
+  return new Function(...keys, 'return (' + match[1].trim() + ')')(...keys.map((key) => deps[key]))
+}
+
+const FACTS = { platform: 'win32', home: 'C:/Users/me', tmpDir: 'C:/Users/me/AppData/Local/Temp' }
+
+function mountClient({ facts, hasEffect = true, laterWrapper = false }) {
+  let definition
+  let activeFacts = facts
+  const registrations = []
+  const disposers = []
+  const controller = {
+    calls: [],
+    openResource(address, options) { this.calls.push({ method: 'openResource', address, options }); return 'opened' },
+    openResourceIn(sessionId, address, options) { this.calls.push({ method: 'openResourceIn', sessionId, address, options }); return 'opened' },
+  }
+  const original = { openResource: controller.openResource, openResourceIn: controller.openResourceIn }
+  const fetcher = () => activeFacts === null
+    ? Promise.reject(new Error('route not ready'))
+    : Promise.resolve({ ok: true, json: () => Promise.resolve(activeFacts) })
+  new Function('window', 'document', 'navigator', 'fetch', source)(
+    { __ModuleLoader__: { load: (value) => { definition = value } } },
+    { createElement: () => ({ setAttribute() {}, remove() {} }), head: { appendChild() {} } },
+    {}, fetcher,
+  )
+  const client = definition.factory((name) => name === 'react'
+    ? { createElement: () => null, useState: () => [false, () => {}], useEffect() {} }
+    : {})
+  const ctx = {
+    effect: (body) => body(),
+    slots: { inject: (_hole, callback) => callback(), register: (meta) => registrations.push(meta) },
+    inject: (names, callback) => {
+      if (!names.includes('sidebarRight')) return
+      callback({
+        sidebarRight: controller,
+        ...(hasEffect ? { effect: (body) => disposers.push(body()) } : {}),
+      })
+    },
+  }
+  client.apply(ctx)
+  if (laterWrapper) {
+    const wrapped = controller.openResource
+    controller.openResource = function later(address, options) { return wrapped.call(this, address, options) }
+  }
+  return { controller, original, disposers, setFacts: (value) => { activeFacts = value } }
+}
+
+test('B5 盘根翻译:/c/x → C:/x,/c → C:/', () => {
+  const translate = extractLogic('msysToHostPath')
+  assert.equal(translate('/c/Users/x', FACTS), 'C:/Users/x')
+  assert.equal(translate('/c', FACTS), 'C:/')
+  assert.equal(translate('/C/Users/x', FACTS), 'C:/Users/x')
+})
+
+test('B5 home 翻译:~ 与 ~/x', () => {
+  const translate = extractLogic('msysToHostPath')
+  assert.equal(translate('~', FACTS), 'C:/Users/me')
+  assert.equal(translate('~/a/b.txt', FACTS), 'C:/Users/me/a/b.txt')
+})
+
+test('B5 tmp 翻译:/tmp 与 /tmp/x', () => {
+  const translate = extractLogic('msysToHostPath')
+  assert.equal(translate('/tmp', FACTS), 'C:/Users/me/AppData/Local/Temp')
+  assert.equal(translate('/tmp/x.log', FACTS), 'C:/Users/me/AppData/Local/Temp/x.log')
+})
+
+test('B5 非翻译形态原样:Windows 路径/相对路径/未知 POSIX 段', () => {
+  const translate = extractLogic('msysToHostPath')
+  assert.equal(translate('C:/repo/a.txt', FACTS), 'C:/repo/a.txt')
+  assert.equal(translate('src/index.js', FACTS), 'src/index.js')
+  assert.equal(translate('/usr/bin/bash', FACTS), '/usr/bin/bash')
+  assert.equal(translate(42, FACTS), 42)
+})
+
+test('B6 file 地址翻译:session/absolute、空格与后缀', () => {
+  const translate = extractLogic('msysToHostPath')
+  const rescue = extractLogic('rescueFileAddress')
+  assert.equal(rescue('dsh-resource://file/session/s1//c/Users/x.txt', translate, FACTS), 'dsh-resource://file/session/s1/C:/Users/x.txt')
+  assert.equal(rescue('dsh-resource://file/absolute/c/Users/y%20x.md', translate, FACTS), 'dsh-resource://file/absolute/C:/Users/y%20x.md')
+  assert.ok(rescue('dsh-resource://file/absolute/c/Users/y.md?line=3', translate, FACTS).endsWith('?line=3'))
+  const unchanged = 'dsh-resource://file/absolute/C%3A/Users/z.txt'
+  assert.equal(rescue(unchanged, translate, FACTS), unchanged)
+})
+
+test('B6 非 file、UNC、坏转义地址原样', () => {
+  const translate = extractLogic('msysToHostPath')
+  const rescue = extractLogic('rescueFileAddress')
+  for (const address of [
+    'dsh-resource://other/abc', 'not an address',
+    'dsh-resource://file/absolute//server/share/x',
+    'dsh-resource://file/absolute/%zz/x',
+  ]) assert.equal(rescue(address, translate, FACTS), address)
+})
+
+test('B6 编码 sessionId 翻译后只编码一次', () => {
+  const translate = extractLogic('msysToHostPath')
+  const rescue = extractLogic('rescueFileAddress')
+  const address = 'dsh-resource://file/session/s%201//c/Users/x.txt'
+  assert.equal(rescue(address, translate, FACTS), 'dsh-resource://file/session/s%201/C:/Users/x.txt')
+})
+
+test('B6 地址翻译函数是纯函数,平台门由运行时安装包装负责', () => {
+  const translate = extractLogic('msysToHostPath')
+  assert.equal(translate('/c/x', null), 'C:/x')
+  const rescue = extractLogic('rescueFileAddress')
+  assert.equal(rescue('dsh-resource://file/absolute/c/x', translate, FACTS), 'dsh-resource://file/absolute/C:/x')
+})
+
+test('B7 可观察的 sidebar 包装透传两个入口并在 fiber dispose 后恢复', async () => {
+  const mounted = mountClient({ facts: FACTS })
+  await new Promise((resolve) => setImmediate(resolve))
+  const { controller, original, disposers } = mounted
+  assert.equal(controller.openResource('dsh-resource://file/absolute/c/x', { tab: true }), 'opened')
+  assert.deepEqual(controller.calls.at(-1), { method: 'openResource', address: 'dsh-resource://file/absolute/C:/x', options: { tab: true } })
+  assert.equal(controller.openResourceIn('s2', 'dsh-resource://file/session/s1//c/x', { line: 2 }), 'opened')
+  assert.equal(controller.calls.at(-1).address, 'dsh-resource://file/session/s1/C:/x')
+  assert.equal(controller.calls.at(-1).sessionId, 's2')
+  disposers[0]()
+  assert.equal(controller.openResource, original.openResource)
+  assert.equal(controller.openResourceIn, original.openResourceIn)
+  controller.openResource('dsh-resource://file/absolute/c/x')
+  assert.equal(controller.calls.at(-1).address, 'dsh-resource://file/absolute/c/x')
+})
+
+test('B7 缺少 effect 清理能力时不改写侧栏方法', () => {
+  const mounted = mountClient({ facts: FACTS, hasEffect: false })
+  assert.equal(mounted.controller.openResource, mounted.original.openResource)
+  assert.equal(mounted.controller.openResourceIn, mounted.original.openResourceIn)
+})
+
+test('B7 后续插件包装仍保留,卸载只移除本插件包装', async () => {
+  const mounted = mountClient({ facts: FACTS, laterWrapper: true })
+  await new Promise((resolve) => setImmediate(resolve))
+  const laterWrapper = mounted.controller.openResource
+  mounted.disposers[0]()
+  assert.equal(mounted.controller.openResource, laterWrapper)
+  mounted.controller.openResource('dsh-resource://file/absolute/c/x')
+  assert.equal(mounted.controller.calls.at(-1).address, 'dsh-resource://file/absolute/c/x')
+})
+
+test('B7 pathmap 请求失败可在后续调用重试', async () => {
+  const mounted = mountClient({ facts: null })
+  await new Promise((resolve) => setImmediate(resolve))
+  mounted.setFacts(FACTS)
+  mounted.controller.openResource('dsh-resource://file/absolute/c/x')
+  await new Promise((resolve) => setImmediate(resolve))
+  mounted.controller.calls.length = 0
+  mounted.controller.openResource('dsh-resource://file/absolute/c/x')
+  assert.equal(mounted.controller.calls[0].address, 'dsh-resource://file/absolute/C:/x')
+})
+
+test('B7 非 Windows pathmap 不改写原地址', async () => {
+  const mounted = mountClient({ facts: { ...FACTS, platform: 'linux' } })
+  await new Promise((resolve) => setImmediate(resolve))
+  mounted.controller.openResource('/c/x')
+  assert.equal(mounted.controller.calls[0].address, '/c/x')
+})