@mzzsfy/dsh-tunnel 0.1.0

package/test/ai-switch.test.mjs

@@ -0,0 +1,272 @@
+// 「允许 ai 使用」开关注册面 BDD: 开关决定 tunnel_open/list/close 是否向 ai 注册,
+// 关闭即注销(干净禁用), GUI/REST 同表不受影响。覆盖双形态读写:
+// legacy 设置节(watch 回写)与 0.1.7+ volatile ref(loader 原地热更 + loader/volatile-update)。
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { EventEmitter } from 'node:events'
+import { mkdtempSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+const TOOL_NAMES = ['tunnel_open', 'tunnel_list', 'tunnel_close']
+
+class MockWebServer {
+  exact = new Map()
+  prefixes = new Map()
+  upgrades = new Map()
+  fallback = undefined
+  host = '127.0.0.1'
+  port = 3080
+
+  register(route) {
+    const table = route.kind === 'exact' ? this.exact : this.prefixes
+    if (table.has(route.path)) throw new Error(`webserver: duplicate ${route.kind} route "${route.path}"`)
+    table.set(route.path, route)
+    return () => table.delete(route.path)
+  }
+
+  registerUpgrade(route) {
+    this.upgrades.set(route.path, route)
+    return () => this.upgrades.delete(route.path)
+  }
+
+  registerFallback(handler) {
+    this.fallback = handler
+    return () => { this.fallback = undefined }
+  }
+}
+
+function createToolsService() {
+  const registered = new Map()
+  return {
+    registered,
+    names: () => [...registered.keys()],
+    register(tool) {
+      registered.set(tool.name, tool)
+      return () => registered.delete(tool.name)
+    },
+  }
+}
+
+function createCtx({ tools, settings, configEditor, fiber } = {}) {
+  const events = new Map()
+  const effectDisposers = []
+  const runEffect = (fn) => {
+    const disposer = fn()
+    if (typeof disposer === 'function') effectDisposers.push(disposer)
+    return disposer
+  }
+  const ctx = {
+    webServer: undefined,
+    fiber,
+    get: (name) => (name === 'configEditor' ? configEditor : undefined),
+    on: (event, handler) => {
+      if (!events.has(event)) events.set(event, [])
+      events.get(event).push(handler)
+      return () => { events.set(event, events.get(event).filter((cb) => cb !== handler)) }
+    },
+    effect: runEffect,
+    inject(names, cb) { cb({ tools, settings, effect: runEffect }) },
+  }
+  return { ctx, events, effectDisposers }
+}
+
+// legacy mock settings: 与 tunnel.test.mjs 同款语义(内存存储 + watch 登记 + 手动触发)
+function createSettingsService(initial = {}) {
+  const store = { tunnel: { ...initial } }
+  const watchers = []
+  return {
+    store,
+    service: {
+      get: (ns) => store[ns],
+      update: (ns, patch) => { store[ns] = { ...(store[ns] ?? {}), ...patch } },
+      register: (ns) => ({ watch: (cb) => watchers.push(cb) }),
+    },
+    setTunnel(patch) { store.tunnel = { ...store.tunnel, ...patch }; for (const cb of watchers) cb() },
+  }
+}
+
+function volatileRef(value) {
+  return { get: () => (typeof value === 'function' ? value() : value) }
+}
+
+const tempDataDirs = new Set()
+const defaultDataDir = () => {
+  const dir = mkdtempSync(join(tmpdir(), 'dsh-tunnel-ai-'))
+  tempDataDirs.add(dir)
+  return dir
+}
+process.on('exit', () => {
+  for (const dir of tempDataDirs) rmSync(dir, { recursive: true, force: true })
+})
+
+async function applyPlugin(config = {}, services = {}) {
+  const { apply } = await import('../src/index.js')
+  const tools = services.tools ?? createToolsService()
+  const webServer = new MockWebServer()
+  const { ctx, events, effectDisposers } = createCtx({ ...services, tools })
+  ctx.webServer = webServer
+  const full = { connectTimeoutMs: 10 * 1000, dataDir: defaultDataDir(), ...config }
+  const dispose = apply(ctx, full)
+  const disposeAll = () => {
+    dispose()
+    for (const disposer of effectDisposers.reverse()) disposer()
+  }
+  return { webServer, tools, events, dispose: disposeAll }
+}
+
+async function callApi(webServer, method, path, body) {
+  const route = webServer.prefixes.get('/api/tunnel')
+  assert.ok(route, 'REST 前缀路由未注册')
+  const req = new EventEmitter()
+  req.method = method
+  req.url = '/api/tunnel' + path
+  req.headers = { host: 'localhost:3080' }
+  const res = { status: null, payload: null }
+  res.writeHead = (status) => { res.status = status }
+  res.end = (text) => {
+    try { res.payload = JSON.parse(text) } catch { res.payload = null }
+  }
+  const done = route.handler(req, res)
+  process.nextTick(() => {
+    if (body !== undefined) req.emit('data', Buffer.from(JSON.stringify(body)))
+    req.emit('end')
+  })
+  await done
+  return res
+}
+
+const openTunnel = (webServer) => callApi(webServer, 'POST', '/tunnels', { name: 'app', targetPort: 80 })
+
+test('默认注册三件工具, status 暴露 aiTools 开', async () => {
+  const { webServer, tools, dispose } = await applyPlugin()
+  try {
+    assert.deepEqual(tools.names().sort(), [...TOOL_NAMES].sort())
+    const status = await callApi(webServer, 'GET', '/status')
+    assert.equal(status.payload.ui.aiTools, true)
+  } finally { dispose() }
+})
+
+test('config.aiTools=false 不注册工具, 看板 REST 增删照常', async () => {
+  const { webServer, tools, dispose } = await applyPlugin({ aiTools: false })
+  try {
+    assert.deepEqual(tools.names(), [])
+    const opened = await openTunnel(webServer)
+    assert.equal(opened.payload.ok, true)
+    const listed = await callApi(webServer, 'GET', '/tunnels')
+    assert.deepEqual(listed.payload.items.map((row) => row.name), ['app'])
+    const status = await callApi(webServer, 'GET', '/status')
+    assert.equal(status.payload.ui.aiTools, false)
+  } finally { dispose() }
+})
+
+test('legacy 设置节运行时翻转: 关闭注销, 重开恢复', async () => {
+  const settings = createSettingsService()
+  const { tools, dispose } = await applyPlugin({}, { settings: settings.service })
+  try {
+    assert.deepEqual(tools.names().sort(), [...TOOL_NAMES].sort())
+    settings.setTunnel({ aiTools: false })
+    assert.deepEqual(tools.names(), [])
+    settings.setTunnel({ aiTools: true })
+    assert.deepEqual(tools.names().sort(), [...TOOL_NAMES].sort())
+  } finally { dispose() }
+})
+
+test('legacy 设置节初值 false: 激活后保持注销', async () => {
+  const settings = createSettingsService({ aiTools: false })
+  const { tools, dispose } = await applyPlugin({}, { settings: settings.service })
+  try {
+    assert.deepEqual(tools.names(), [])
+  } finally { dispose() }
+})
+
+test('0.1.7 形态: volatile ref 初值生效, volatile-update 驱动翻转', async () => {
+  let aiValue = false
+  const { tools, events, dispose } = await applyPlugin({
+    aiTools: volatileRef(() => aiValue),
+    sidebarTab: volatileRef(false),
+    connectTimeoutMs: volatileRef(5 * 1000),
+  })
+  try {
+    assert.deepEqual(tools.names(), [])
+    aiValue = true
+    for (const handler of events.get('loader/volatile-update') ?? []) handler()
+    assert.deepEqual(tools.names().sort(), [...TOOL_NAMES].sort())
+    aiValue = false
+    for (const handler of events.get('loader/volatile-update') ?? []) handler()
+    assert.deepEqual(tools.names(), [])
+  } finally { dispose() }
+})
+
+test('REST ui-settings 翻转 aiTools: 工具注销且回写 ui(legacy 通道)', async () => {
+  const settings = createSettingsService()
+  const { webServer, tools, dispose } = await applyPlugin({}, { settings: settings.service })
+  try {
+    const flipped = await callApi(webServer, 'POST', '/ui-settings', { aiTools: false })
+    assert.equal(flipped.status, 200)
+    assert.equal(flipped.payload.ok, true)
+    assert.equal(flipped.payload.ui.aiTools, false)
+    assert.deepEqual(settings.store.tunnel.aiTools, false)
+    assert.deepEqual(tools.names(), [])
+    const restored = await callApi(webServer, 'POST', '/ui-settings', { aiTools: true })
+    assert.equal(restored.payload.ui.aiTools, true)
+    assert.deepEqual(tools.names().sort(), [...TOOL_NAMES].sort())
+  } finally { dispose() }
+})
+
+test('0.1.7 写路径: aiTools 经 configEditor 落 profile 条目, ref 写穿后注册面跟随', async () => {
+  // mock loader updateVolatile 语义: edit 落条目 → volatile ref 原地换值 → 偏好重读生效
+  const entry = { aiTools: true }
+  const configEditor = {
+    edit: async (_entry, change) => { Object.assign(entry, change({ ...entry })) },
+  }
+  const { webServer, tools, dispose } = await applyPlugin({
+    aiTools: volatileRef(() => entry.aiTools),
+  }, { configEditor, fiber: { entry: { id: 'row-1' } } })
+  try {
+    const flipped = await callApi(webServer, 'POST', '/ui-settings', { aiTools: false })
+    assert.equal(flipped.payload.ok, true)
+    assert.deepEqual(entry, { aiTools: false })
+    assert.deepEqual(tools.names(), [])
+  } finally { dispose() }
+})
+
+test('ui-settings 校验: 非布尔 400, 空补丁 400', async () => {
+  const { webServer, dispose } = await applyPlugin()
+  try {
+    const bad = await callApi(webServer, 'POST', '/ui-settings', { aiTools: 'yes' })
+    assert.equal(bad.status, 400)
+    assert.match(bad.payload.error, /aiTools 须为布尔/)
+    const empty = await callApi(webServer, 'POST', '/ui-settings', {})
+    assert.equal(empty.status, 400)
+    assert.match(empty.payload.error, /须为布尔/)
+  } finally { dispose() }
+})
+
+test('写路径服务缺失降级: updateUi 返回 ok:false', async () => {
+  const { webServer, tools, dispose } = await applyPlugin()
+  try {
+    const res = await callApi(webServer, 'POST', '/ui-settings', { aiTools: false })
+    assert.equal(res.status, 200)
+    assert.equal(res.payload.ok, false)
+    assert.match(res.payload.error, /设置服务不可用/)
+    assert.deepEqual(tools.names().sort(), [...TOOL_NAMES].sort(), '写失败不得翻转注册面')
+  } finally { dispose() }
+})
+
+test('插件停用回收工具注册', async () => {
+  const { tools, dispose } = await applyPlugin()
+  assert.deepEqual(tools.names().sort(), [...TOOL_NAMES].sort())
+  dispose()
+  assert.deepEqual(tools.names(), [])
+})
+
+test('Config volatile 标记面: 三个偏好字段 live, dataDir 不进 UI', async () => {
+  const { Config, SETTINGS_SCHEMA } = await import('../src/index.js')
+  assert.equal(Config.dict.aiTools.meta.volatile, true)
+  assert.equal(Config.dict.sidebarTab.meta.volatile, true)
+  assert.equal(Config.dict.connectTimeoutMs.meta.volatile, true)
+  assert.equal(Config.dict.dataDir.meta.volatile, undefined)
+  assert.equal(SETTINGS_SCHEMA.dict.aiTools.meta.default, true)
+  assert.equal(SETTINGS_SCHEMA.dict.dataDir, undefined, 'legacy 设置节不收环境路径')
+})

package/test/api.test.mjs

@@ -0,0 +1,145 @@
+// REST 路由测试: CRUD / status / ui-settings / 错误语义(设计 docs/设计-隧道GUI.md §3.1)。
+// 桩形态对齐 cron-board routes.test.mjs: makeReq/call 内存桩, tunnelsApi 业务桩。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { EventEmitter } from 'node:events'
+
+import { createApi } from '../src/api.mjs'
+
+function makeTunnelsApi() {
+  const rows = new Map()
+  return {
+    rows,
+    open(args) {
+      if (rows.has(args.name)) return { ok: false, error: `隧道名已占用: ${args.name}` }
+      rows.set(args.name, { createdAt: 't' })
+      return { ok: true, name: args.name }
+    },
+    list() {
+      return { ok: true, tunnels: [...rows.keys()].map((name) => ({ name })) }
+    },
+    close({ name }) {
+      const removed = rows.delete(name)
+      return { ok: true, removed }
+    },
+  }
+}
+
+function makeReq(method, pathAndQuery, body) {
+  const req = new EventEmitter()
+  req.method = method
+  req.url = pathAndQuery
+  req.headers = { host: 'localhost:3000' }
+  if (body !== undefined) {
+    const payload = typeof body === 'string' ? body : JSON.stringify(body)
+    process.nextTick(() => {
+      req.emit('data', Buffer.from(payload))
+      req.emit('end')
+    })
+  }
+  return req
+}
+
+async function call(api, method, pathAndQuery, body) {
+  const res = { status: null, payload: null }
+  res.writeHead = (status) => { res.status = status }
+  res.end = (text) => {
+    res.raw = text
+    try { res.payload = JSON.parse(text) } catch { res.payload = null }
+  }
+  await api.handle(makeReq(method, pathAndQuery, body), res)
+  return res
+}
+
+function makeApi(overrides = {}) {
+  const tunnelsApi = makeTunnelsApi()
+  const api = createApi({
+    tunnelsApi,
+    readUi: overrides.readUi ?? (() => ({ sidebarTab: false })),
+    updateUi: overrides.updateUi ?? ((body) => {
+      if (typeof body?.sidebarTab !== 'boolean') throw new Error('sidebarTab 须为布尔')
+      return { ok: true, ui: { sidebarTab: body.sidebarTab } }
+    }),
+    logSystem: overrides.logSystem ?? (() => {}),
+  })
+  return { tunnelsApi, api }
+}
+
+test('GET tunnels 返回同表列表', async () => {
+  const { tunnelsApi, api } = makeApi()
+  tunnelsApi.open({ name: 'app', targetPort: 80 })
+  const res = await call(api, 'GET', '/api/tunnel/tunnels')
+  assert.equal(res.status, 200)
+  assert.deepEqual(res.payload.items, [{ name: 'app' }])
+})
+
+test('POST tunnels 合法入表, 业务错误 400 中文透传', async () => {
+  const { api } = makeApi()
+  const ok = await call(api, 'POST', '/api/tunnel/tunnels', { name: 'app', targetPort: 80 })
+  assert.equal(ok.status, 200)
+  assert.equal(ok.payload.ok, true)
+  const clash = await call(api, 'POST', '/api/tunnel/tunnels', { name: 'app', targetPort: 81 })
+  assert.equal(clash.status, 400)
+  assert.match(clash.payload.error, /已占用/)
+})
+
+test('DELETE tunnels/:name 幂等', async () => {
+  const { api } = makeApi()
+  await call(api, 'POST', '/api/tunnel/tunnels', { name: 'app', targetPort: 80 })
+  const first = await call(api, 'DELETE', '/api/tunnel/tunnels/app')
+  assert.deepEqual(first.payload, { ok: true, removed: true })
+  const again = await call(api, 'DELETE', '/api/tunnel/tunnels/app')
+  assert.deepEqual(again.payload, { ok: true, removed: false })
+})
+
+test('GET status 携带 ui 与 total', async () => {
+  const { tunnelsApi, api } = makeApi()
+  tunnelsApi.open({ name: 'a', targetPort: 80 })
+  tunnelsApi.open({ name: 'b', targetPort: 81 })
+  const res = await call(api, 'GET', '/api/tunnel/status')
+  assert.deepEqual(res.payload, { ui: { sidebarTab: false }, total: 2 })
+})
+
+test('POST ui-settings 合法回写, 非法 400', async () => {
+  const seen = []
+  const { api } = makeApi({
+    updateUi: (body) => {
+      if (typeof body?.sidebarTab !== 'boolean') throw new Error('sidebarTab 须为布尔')
+      seen.push(body.sidebarTab)
+      return { ok: true, ui: { sidebarTab: body.sidebarTab } }
+    },
+  })
+  const ok = await call(api, 'POST', '/api/tunnel/ui-settings', { sidebarTab: true })
+  assert.deepEqual(ok.payload, { ok: true, ui: { sidebarTab: true } })
+  assert.deepEqual(seen, [true])
+  const bad = await call(api, 'POST', '/api/tunnel/ui-settings', { sidebarTab: 'yes' })
+  assert.equal(bad.status, 400)
+  assert.match(bad.payload.error, /布尔/)
+})
+
+test('POST ui-settings 服务缺失降级: updateUi 返回 ok:false 时 200 透传', async () => {
+  const { api } = makeApi({
+    updateUi: () => ({ ok: false, error: '设置服务不可用' }),
+  })
+  const res = await call(api, 'POST', '/api/tunnel/ui-settings', { sidebarTab: true })
+  assert.equal(res.status, 200)
+  assert.deepEqual(res.payload, { ok: false, error: '设置服务不可用' })
+})
+
+test('DELETE 畸形百分号编码按 404 不抛英文错误', async () => {
+  const { api } = makeApi()
+  const res = await call(api, 'DELETE', '/api/tunnel/tunnels/%E0%A4%A')
+  assert.equal(res.status, 404)
+  assert.match(res.payload.error, /接口不存在/)
+})
+
+test('未知路径与方法 404, 非法 JSON 400', async () => {
+  const { api } = makeApi()
+  assert.equal((await call(api, 'GET', '/api/tunnel/nope')).status, 404)
+  assert.equal((await call(api, 'PATCH', '/api/tunnel/tunnels')).status, 404)
+  assert.equal((await call(api, 'GET', '/other')).status, 404)
+  const bad = await call(api, 'POST', '/api/tunnel/tunnels', '{not-json')
+  assert.equal(bad.status, 400)
+  assert.match(bad.payload.error, /JSON/)
+})

package/test/client-id.test.mjs

@@ -0,0 +1,25 @@
+// client.js 注册 id 与样式标记守卫:loader 按 graph row id(完整包名)匹配注册, 短名即加载失败;
+// 样式注入缺 data-plugin 会被宿主 claimStyles 误归属给后续材质化插件, 其 HMR 重建即整批误删。
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const { name } = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf8'))
+
+test('client.js 注册 id 为完整包名', () => {
+  const source = readFileSync(join(PKG_ROOT, 'src', 'client.js'), 'utf8')
+  const match = source.match(/__ModuleLoader__\.load\(\{\s*id:\s*'([^']+)'/)
+  assert.ok(match, 'client.js 缺少 __ModuleLoader__.load 注册')
+  assert.equal(match[1], name)
+})
+
+test('client.js 样式注入自带 data-plugin', () => {
+  const source = readFileSync(join(PKG_ROOT, 'src', 'client.js'), 'utf8')
+  const injections = source.split("createElement('style')").length - 1
+  assert.ok(injections > 0, 'client.js 无样式注入点')
+  const marked = source.split(`setAttribute('data-plugin', '${name}')`).length - 1
+  assert.equal(marked, injections, '每个样式注入点都必须自带 data-plugin(值=注册包名), 防宿主 claimStyles 误归属后随他插件 HMR 整批误删')
+})

package/test/switch-guard.test.mjs

@@ -0,0 +1,81 @@
+// 开关样式守卫 BDD:裸 checkbox/裸 input 状态选择器会静默损坏 UI 或误伤同 label 的文本输入,
+// 属无报错的 UI 退化, 静态断言锁死 tu-switch 结构(参照 cb-switch/mce-switch 同款守卫)。
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const source = readFileSync(join(PKG_ROOT, 'src', 'client.js'), 'utf8')
+
+test('switch 隐藏规则以 input[type="checkbox"] 精确匹配', () => {
+  assert.match(source, /\.tu-switch input\[type="checkbox"\] \{ position:absolute/)
+})
+
+test('switch 状态选择器禁止裸 input 锚定(防误伤同 label 的文本输入)', () => {
+  const bare = source.match(/\.tu-switch input:(?!\[type)[a-z-]+/g)
+  assert.equal(bare, null, `裸 input 状态选择器: ${bare}`)
+})
+
+test('checkbox 仅允许出现在 switchToggle 工厂内, 禁止裸 checkbox 直出', () => {
+  const occurrences = [...source.matchAll(/type: 'checkbox'/g)].map((match) => match.index)
+  assert.equal(occurrences.length, 1, `checkbox 字面量出现 ${occurrences.length} 次`)
+  const factoryStart = source.indexOf('function switchToggle')
+  const factoryEnd = source.indexOf('}', source.indexOf('__thumb', factoryStart))
+  assert.ok(occurrences[0] > factoryStart && occurrences[0] < factoryEnd, 'checkbox 字面量不在 switchToggle 工厂内')
+})
+
+test('switchToggle 产出顺序为 input 在前 track 在后', () => {
+  const factory = source.slice(source.indexOf('function switchToggle'))
+  assert.ok(factory.indexOf("h('input'") < factory.indexOf('tu-switch__track'), '工厂内 input 必须先于 track')
+})
+
+test('disabled 态 hover 高亮被 :has 守卫排除', () => {
+  assert.match(source, /\.tu-switch:not\(:has\(input\[type="checkbox"\]:disabled\)\):hover/)
+})
+
+test('checked/focus-visible/disabled 三态均以 checkbox 锚定', () => {
+  assert.match(source, /\.tu-switch input\[type="checkbox"\]:checked \+/)
+  assert.match(source, /\.tu-switch input\[type="checkbox"\]:focus-visible \+/)
+  assert.match(source, /\.tu-switch input\[type="checkbox"\]:disabled \+/)
+})
+
+test('插件页卡片为官方 PluginCard 形制: li 卡壳 + 头部折叠 + 令牌同源', () => {
+  // Given 官方插件卡片 = ul.cards > li.PluginCard(边框卡壳 + 名称/描述头部 + chevron 折叠)
+  // When 本插件卡片注册进同一列表(slot 契约: 外观归插件自持, 官方壳未导出)
+  // Then 静态锁定 tu-pc 镜像形制, 防止退化回裸 div 平铺
+  assert.match(source, /h\('li', \{ className: 'tu-pc/, '卡片根元素必须是 li(官方列表 ul.cards 的合法子元素)')
+  assert.match(source, /\.tu-pc\{border:\.5px solid var\(--dsw-alias-border-l4\)/, '卡壳边框/底色令牌必须与官方 PluginCard 同源')
+  assert.match(source, /h\('button', \{ type: 'button', className: 'tu-pc__head'/, '缺少官方形制的头部按钮')
+  assert.match(source, /aria-expanded/, '头部必须可折叠并暴露 aria-expanded')
+  assert.match(source, /\.tu-pc__hint\{[^}]*var\(--dsw-alias-label-tertiary\)/, '提示文本令牌必须与官方 hint 同源')
+})
+
+test('client.js 无顶层词法声明(经典 script 书挡内安全)', () => {
+  // IIFE 书挡内允许任意声明;守卫确认整文件被书挡包裹
+  const trimmed = source.trim()
+  assert.ok(trimmed.startsWith('(() => {'), '必须以 IIFE 书挡开头')
+  assert.ok(trimmed.endsWith('})()'), '必须以 IIFE 书挡结尾')
+})
+
+test('类名前缀全量 tu-(插件样式全局注入, 跨包类名冲突即互相覆盖)', () => {
+  const classNames = [...source.matchAll(/className: '([a-z][a-z0-9_-]*)/g)].map((match) => match[1])
+  const foreign = classNames.filter((name) => !name.startsWith('tu-'))
+  assert.deepEqual(foreign, [], `存在非 tu- 前缀类名: ${[...new Set(foreign)].join(', ')}`)
+})
+
+test('插件卡双代槽位并存注册(0.1.2-0.1.5 settings.plugin.item; 0.1.7-rc.1+ plugins.bundle.config)', () => {
+  // Given settings>插件 页可配置卡在 rc.1 被宿主移除, 插件管理页包详情配置槽为 rc.1 载体
+  // Then 两代注册面同在, 新代 key = 完整包名, 错误世代宿主惰性零成本
+  assert.match(source, /ctx\.slots\.inject\('settings\.plugin\.item'/)
+  assert.match(source, /key: PANEL_ID, label: PANEL_LABEL/)
+  assert.match(source, /ctx\.slots\.inject\('plugins\.bundle\.config'/)
+  assert.match(source, /name: 'plugins\.bundle\.config', key: '@mzzsfy\/dsh-tunnel'/)
+})
+
+test('设置卡提供 ai 使用开关: aiTools 读写面在场且经 ui-settings 提交', () => {
+  assert.match(source, /允许 ai 使用隧道工具/, '缺少 ai 使用开关行标签')
+  assert.match(source, /flip\('aiTools', aiOn\)/, 'ai 开关未接 flip 写通道')
+  assert.match(source, /outcome\.data\.ui\.aiTools/, '开关态未回读 aiTools')
+})