dsh-muv-table 0.2.11 → 0.3.0

package/lib/index.js

@@ -664,10 +664,22 @@ export function apply(ctx) {
           const url = new URL(req.url, 'http://localhost')
           const presetId = url.searchParams.get('presetId') || ''
           const sessionId = url.searchParams.get('sessionId') || ''
+          // 需要「我就是要这个 preset，别管会话」的调用方显式声明。
+          const preferPreset = url.searchParams.get('preferPreset') === '1'
 
-          // Resolve the preset: explicit id > the session's bound preset >
+          // Resolve the preset: **the session's bound preset > explicit id >**
           // whichever preset the user is actually in > the tavern's own default.
           //
+          // ★ 顺序为什么会话在前（实测的事故）：客户端曾经两个 id 都送、且 presetId 排在前面，
+          //   于是"带 presetId 就按 presetId 走"让 sessionId 形同虚设。而 presetId 恰恰是
+          //   **会粘住**的那个 —— 它来自酒馆面板的 `dataset.presetId` / localStorage，切换会话时
+          //   那个值可能仍是上一个会话的预设。用户实测：在「瑟瑟提瓦特」的会话里看到了
+          //   「足控天堂」的状态栏界面（串台）。
+          //
+          //   会话 id 是唯一随会话切换必然变化的依据（服务端按 session-bindings.json 查），
+          //   所以它必须优先。确实需要"按 id 强制取某个预设"的调用方（诊断脚本、卡库检查）
+          //   显式加 `preferPreset=1` —— 不把它们的语义悄悄改掉。
+          //
           // Every step that missed used to end in `presetDir = TAVERN_PRESET_DIR`
           // *silently*, so an unknown id (a renamed preset, a stale id cached in
           // the client, a typo) served that preset's card while the panel said
@@ -681,12 +693,7 @@ export function apply(ctx) {
           let presetSource = ''
           let missing = ''
           let requested = ''
-          if (presetId) {
-            requested = String(presetId)
-            presetDir = resolvePresetDirById(presetId)
-            if (presetDir) presetSource = 'explicit'
-            else missing = 'preset not found: ' + requested
-          } else if (sessionId) {
+          const fromSession = () => {
             const bound = presetIdForSession(sessionId)
             requested = bound
             if (!bound || bound === 'default') {
@@ -700,7 +707,32 @@ export function apply(ctx) {
               else missing = 'preset bound to session ' + sessionId + ' not found: ' + bound
             }
           }
-          if (!presetDir && !missing) {
+          const fromExplicit = () => {
+            requested = String(presetId)
+            presetDir = resolvePresetDirById(presetId)
+            if (presetDir) presetSource = 'explicit'
+            else missing = 'preset not found: ' + requested
+          }
+          if (preferPreset && presetId) {
+            fromExplicit()
+          } else {
+            if (sessionId) fromSession()
+            if (!presetDir && !missing && presetId) fromExplicit()
+          }
+          // ★ 这里原来会无条件回落到 `activePresetId()`（"最近写入的会话"的绑定）。已收窄。
+          //
+          //   为什么不能当默认兜底（实测）：它的实现是按**会话文件的 mtime** 倒序，取第一个
+          //   有绑定的预设。而"最近写入"根本不是"用户正在看的会话" —— 实测当时它返回的是
+          //   标题为「安装 dsh-tavern-v2 及其附属插件」的**开发会话**的绑定，因为那类会话在
+          //   持续写文件（跑 agent、被试跑的门禁）。于是**每个没带 sessionId 的请求都拿到
+          //   同一张卡**，用户看到的就是"基本上每个会话都变成看 X 的界面"（串台）。
+          //   它还**不稳定**：同一请求在不同时刻会解析到不同预设。
+          //
+          //   现在没有会话依据就落到**稳定默认**（tavern-lite），`presetSource` 记 `default`。
+          //   面板据此能如实提示"这个会话还没绑卡"，而不是悄悄给用户看别人的卡。
+          //   确实需要"最近活跃预设"的调用方（诊断脚本）显式加 `preferActive=1` ——
+          //   不把"猜"当成静默兜底。
+          if (!presetDir && !missing && url.searchParams.get('preferActive') === '1') {
             const active = activePresetId()
             if (active) {
               requested = active
@@ -742,6 +774,16 @@ export function apply(ctx) {
               cardName,
               presetDir: path.basename(presetDir),
               presetSource,
+              // ★ 诚实上报（交叉复核发现）：调用方**显式**给了 presetId，但被"会话优先"规则
+              //   忽略了 —— 会话存在但未绑定 ⇒ `fromSession()` 把 `defaultPresetDir()` 写进了
+              //   `presetDir`，于是上面那句 `if (!presetDir && !missing && presetId) fromExplicit()`
+              //   永远进不去。实测 `?sessionId=<已存在但未绑定>&presetId=A-preset` 会返回
+              //   tavern-lite，显式 presetId 被**静默吞掉** —— 与被修掉的串台是同一症状类
+              //   （拿到不是你要的卡，而且不告诉你）。行为保持不变（要强制用它请带
+              //   `preferPreset=1`），但至少不再沉默。
+              ...(presetId && !preferPreset && presetSource === 'session-default'
+                ? { note: 'presetId 被忽略：该会话未绑定预设（会话优先）。要强制用它请带 preferPreset=1', ignoredPresetId: presetId }
+                : {}),
               ...parseMuvCard(raw.json),
               // Consumers read the scripts from either shape; keep both so an
               // existing reader keeps working while the engine migrates.
@@ -765,6 +807,10 @@ export function apply(ctx) {
                 cardName: fromStore.cardName || cardName,
                 presetDir: path.basename(presetDir),
                 presetSource,
+                // 同上：显式 presetId 被会话优先规则忽略时如实说明
+                ...(presetId && !preferPreset && presetSource === 'session-default'
+                  ? { note: 'presetId 被忽略：该会话未绑定预设（会话优先）。要强制用它请带 preferPreset=1', ignoredPresetId: presetId }
+                  : {}),
                 name: fromStore.name,
                 schemas: fromStore.schemas,
                 initvarData: fromStore.initvarData,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-muv-table",
-  "version": "0.2.11",
+  "version": "0.3.0",
   "description": "MUV 变量表格编辑器 —— 树形变量面板、宏测试浮窗（random/pick/roll）、骰子快捷栏、pick 缓存管理；支持直接读取 SillyTavern PNG 角色卡（含正则脚本、世界书、变量表）。dsh-muv-engine 的伴生插件",
   "type": "module",
   "main": "lib/index.js",
@@ -10,7 +10,7 @@
     "./lib/*": "./lib/*",
     "./package.json": "./package.json"
   },
-  "files": ["lib", "cordis.patch.yml", "CHANGELOG.md", "README.md", "test-png-card.mjs", "test-muv-parser.mjs", "test-preset-resolve.mjs"],
+  "files": ["lib", "cordis.patch.yml", "CHANGELOG.md", "README.md", "test-cards.mjs", "test-png-card.mjs", "test-muv-parser.mjs", "test-preset-resolve.mjs", "test-card-ops.mjs", "test-var-section.mjs"],
   "keywords": ["dsh", "dsh-plugin", "deepseek-harness", "muv", "magvarupdate", "tavern", "variable-table"],
   "license": "PolyForm-Noncommercial-Copyleft-1.0.0",
   "dsh": {
@@ -18,5 +18,8 @@
     "client": { "platform": "web" }
   },
   "repository": {"type": "git", "url": "git+https://github.com/chen731215-dev/dsh-muv-table.git"},
-  "engines": { "node": ">=20" }
+  "engines": { "node": ">=20" },
+  "scripts": {
+    "test": "node test-var-section.mjs"
+  }
 }

package/test-card-ops.mjs

@@ -0,0 +1,152 @@
+// 卡运维回归：「点『➕ 把当前卡的开场白注入会话末尾』→ 发出去的请求体是什么」。
+//
+// Run: node test-card-ops.mjs
+//
+// 为什么测这个：这条链路唯一的"协议"就是那个 HTTP 请求。面板上一切（成功/已存在/降级）
+// 都是从响应里读出来的，所以**请求体形状**错了，用户看到的现象会非常难查（服务端按
+// sessionId 权威解析预设；带错 presetId 会静默串台到别的卡，见 docs/04 排错手册）。
+//
+// 本用例**逐字提取** lib/client.js 里两端标记之间的那段函数执行 —— 不是复制一份到测试里，
+// 所以被测代码改了它就会跟着变（对照组会因此变红，见 §D）。
+// 因此那段代码有硬约束：不许引用 React / DOM / 外层闭包变量，只用入参 + 全局 fetch。
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+let pass = 0, fail = 0
+function check(name, cond, detail) {
+  if (cond) { pass++; console.log('  OK   ' + name) }
+  else { fail++; console.log('  FAIL ' + name + (detail ? '  -> ' + detail : '')) }
+}
+
+const here = path.dirname(fileURLToPath(import.meta.url))
+const CLIENT = path.join(here, 'lib', 'client.js')
+const src = fs.readFileSync(CLIENT, 'utf8')
+
+// ── 逐字提取被标记的那段 ─────────────────────────────────────────────
+const BEGIN = '// [[card-ops-greeting-start]]'
+const END = '// [[card-ops-greeting-end]]'
+const i0 = src.indexOf(BEGIN)
+const i1 = src.indexOf(END)
+if (i0 < 0 || i1 < 0 || i1 < i0) {
+  console.log('FAIL 在 lib/client.js 里找不到 [[card-ops-greeting-start/end]] 标记')
+  process.exit(1)
+}
+const extracted = src.slice(i0 + BEGIN.length, i1).trim()
+
+console.log('=== 卡运维 · 开场白注入（逐字提取执行）===\n')
+
+// 把提取到的函数体编译出来（声明语句 → 取出函数引用）
+function buildFn(body) {
+  // eslint-disable-next-line no-new-func
+  return new Function(body + '\nreturn cardOpsInsertGreeting')()
+}
+
+// 假的 fetch：记录请求，按脚本回响应
+function mockFetch(responder) {
+  const calls = []
+  const f = async (url, init) => {
+    calls.push({ url, init })
+    return responder(url, init)
+  }
+  f.calls = calls
+  return f
+}
+function jsonRes(status, obj) {
+  return { status, ok: status >= 200 && status < 300, json: async () => obj }
+}
+// 路由不存在时的真实形态：非 JSON 响应 ⇒ json() 抛错
+function htmlRes(status) {
+  return { status, ok: false, json: async () => { throw new SyntaxError('Unexpected token <') } }
+}
+
+console.log('[A] 结构不变量（提取段必须自洽，否则"逐字提取"就成了假的）')
+check('提取段含 cardOpsInsertGreeting 声明', /async function cardOpsInsertGreeting\s*\(/.test(extracted))
+check('提取段不引用 React / document / window（否则无法独立执行）',
+  !/\bReact\b|\bdocument\b|\bwindow\.__/.test(extracted),
+  (extracted.match(/\bReact\b|\bdocument\b|\bwindow\.__/g) || []).join(','))
+
+const insetGreeting = buildFn(extracted)
+
+console.log('\n[B] 手势 → 请求：有会话 id 时')
+{
+  const f = mockFetch(() => jsonRes(200, { ok: true, inserted: true, cardName: '足控天堂', greetingLen: 321, turn: 1 }))
+  const r = await insetGreeting({ sessionId: 'session-0123456789abcdef0123456789abcdef', fetch: f })
+  check('只发一次请求', f.calls.length === 1, 'calls=' + f.calls.length)
+  const c = f.calls[0] || {}
+  check('打的是 /api/tavern/greeting/insert', c.url === '/api/tavern/greeting/insert', String(c.url))
+  check('方法 POST', c.init && c.init.method === 'POST', String(c.init && c.init.method))
+  check('content-type: application/json',
+    c.init && c.init.headers && c.init.headers['content-type'] === 'application/json',
+    JSON.stringify(c.init && c.init.headers))
+  check('请求体**只**含 sessionId（presetId 由服务端按会话权威解析，不许发猜的）',
+    c.init && c.init.body === '{"sessionId":"session-0123456789abcdef0123456789abcdef"}',
+    String(c.init && c.init.body))
+  check('成功 ⇒ kind=ok 且带回卡名与字数',
+    r.kind === 'ok' && r.message.includes('足控天堂') && r.message.includes('321'),
+    JSON.stringify(r))
+}
+
+console.log('\n[C] 手势 → 请求：认不出会话（不带 sessionId）')
+{
+  const f = mockFetch(() => jsonRes(200, { ok: true, cardName: 'X', greetingLen: 1, turn: 1 }))
+  const r = await insetGreeting({ sessionId: '', fetch: f })
+  const c = f.calls[0] || {}
+  check('请求体为空对象 {}（undefined 键被 JSON.stringify 丢掉，交给服务端兜底 lastSessionId）',
+    c.init && c.init.body === '{}', String(c.init && c.init.body))
+  check('仍然 kind=ok（不是本地拦下）', r.kind === 'ok', JSON.stringify(r))
+}
+
+console.log('\n[D] 对照臂（必须真变红）：把请求体改回"带上猜出来的 presetId"')
+{
+  // 函数式 replace（铁律）：大段文本替换一律用函数式替换串
+  const mutated = extracted.replace(
+    'body: JSON.stringify({ sessionId: sessionId || undefined })',
+    () => "body: JSON.stringify({ sessionId: sessionId || undefined, presetId: 'stuck-preset-from-dom' })"
+  )
+  check('对照臂的替换确实生效（没生效的话下面的断言就是空跑）', mutated !== extracted)
+  const bad = buildFn(mutated)
+  const f = mockFetch(() => jsonRes(200, { ok: true, cardName: 'X', greetingLen: 1, turn: 1 }))
+  await bad({ sessionId: 'session-0123456789abcdef0123456789abcdef', fetch: f })
+  const c = f.calls[0] || {}
+  const wouldPass = c.init && c.init.body === '{"sessionId":"session-0123456789abcdef0123456789abcdef"}'
+  check('带 presetId 的请求体**过不了** [B] 的断言（断言不是永真）',
+    !wouldPass, 'body=' + String(c.init && c.init.body))
+}
+
+console.log('\n[E] 响应分支：已存在 / 服务端明确原因 / 接口不存在 / 网络不可达')
+{
+  const okSpy = mockFetch(() => jsonRes(200, { ok: false, error: 'greeting-already-present' }))
+  const r1 = await insetGreeting({ sessionId: 'session-0123456789abcdef0123456789abcdef', fetch: okSpy })
+  check('greeting-already-present ⇒ kind=present（蓝色提示，不是报错）',
+    r1.kind === 'present' && r1.message.includes('已有开场白'), JSON.stringify(r1))
+
+  const liveSpy = mockFetch(() => jsonRes(404, { ok: false, error: 'session-not-live：会话 x 当前没有活跃的 Session 对象' }))
+  const r2 = await insetGreeting({ sessionId: 'session-0123456789abcdef0123456789abcdef', fetch: liveSpy })
+  check('404 + JSON（会话不活跃）⇒ kind=error 且照原样显示服务端原因（不当成"接口不存在"）',
+    r2.kind === 'error' && r2.message.includes('session-not-live'), JSON.stringify(r2))
+
+  const missSpy = mockFetch(() => htmlRes(404))
+  const r3 = await insetGreeting({ sessionId: 'session-0123456789abcdef0123456789abcdef', fetch: missSpy })
+  check('404 + 非 JSON（路由没实现）⇒ kind=degrade，提示更新/重启酒馆插件',
+    r3.kind === 'degrade' && r3.message.includes('dsh-tavern-v2'), JSON.stringify(r3))
+
+  const badSpy = mockFetch(() => { throw new TypeError('Failed to fetch') })
+  const r4 = await insetGreeting({ sessionId: 'session-0123456789abcdef0123456789abcdef', fetch: badSpy })
+  check('fetch 直接抛（酒馆插件没起）⇒ kind=degrade，不向上抛异常',
+    r4.kind === 'degrade' && r4.message.includes('Failed to fetch'), JSON.stringify(r4))
+}
+
+console.log('\n[F] 提取段确实来自 lib/client.js 的交付版本（不是测试自带副本）')
+check('标记在文件里各出现一次',
+  src.split(BEGIN).length - 1 === 1 && src.split(END).length - 1 === 1)
+check('client.js 里 UI 侧确实调用它（按钮 → 纯函数）',
+  src.includes('setGreet(await cardOpsInsertGreeting('), '缺少调用点')
+check('client.js 里有卡运维区块的挂载点与元素标记',
+  src.includes("'data-dsh-muv-card-ops'") &&
+  src.includes("'data-dsh-card-ops-greeting-insert'") &&
+  src.includes("'data-dsh-card-ops-refresh'"))
+
+console.log(`\n=== 结果: ${pass} 通过, ${fail} 失败 ===`)
+process.exit(fail ? 1 : 0)

package/test-cards.mjs

@@ -0,0 +1,58 @@
+// Locate real character cards on this machine for the tests.
+//
+// The search roots mirror `MUV_CARD_DIRS` in lib/index.js so a test finds the
+// same files the plugin would. Nothing here writes to disk; a missing card is a
+// normal outcome (`null`) and callers turn that into a SKIP, never a failure —
+// the tests must stay runnable on a machine without the sample library.
+
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+
+/** Directories worth searching for a sample card. */
+export function cardDirs() {
+  const roots = [
+    'C:/MySpecialFolder/SillyTavern',
+    path.join(os.homedir(), 'SillyTavern'),
+    path.join(os.homedir(), 'Documents', 'SillyTavern'),
+  ]
+  // Same order index.js uses: explicit download dir, env override, ST, then the
+  // usual download/desktop drop zones.
+  const out = ['E:/BaiduNetdiskDownload/EdgeDownload']
+  for (const d of String(process.env.DSH_MUV_CARD_DIRS || '').split(path.delimiter)) {
+    if (d.trim()) out.push(d.trim())
+  }
+
+  // SillyTavern keeps cards under data/<user>/characters.
+  for (const root of roots) {
+    const dataDir = path.join(root, 'data')
+    if (!fs.existsSync(dataDir)) continue
+    try {
+      for (const user of fs.readdirSync(dataDir)) {
+        const chars = path.join(dataDir, user, 'characters')
+        if (fs.existsSync(chars)) out.push(chars)
+      }
+    } catch (_) {}
+  }
+
+  out.push(path.join(os.homedir(), 'Downloads'), path.join(os.homedir(), 'Desktop'))
+
+  return out.filter((d, i, all) => all.indexOf(d) === i)
+}
+
+/**
+ * Find a card file by base name (without extension).
+ * @param {string} name - e.g. '苍玄界', '_足控天堂2'
+ * @returns {string} absolute path, or '' when not on this machine
+ */
+export function findCard(name) {
+  const explicit = process.env.MUV_TEST_CARD_DIR
+  const dirs = explicit ? [explicit, ...cardDirs()] : cardDirs()
+  for (const dir of dirs) {
+    for (const ext of ['.png', '.json']) {
+      const p = path.join(dir, name + ext)
+      if (fs.existsSync(p)) return p
+    }
+  }
+  return ''
+}

package/test-preset-resolve.mjs

@@ -181,11 +181,96 @@ check('结果可解释：要么 found:false，要么标成 session-default',
   'found=' + r7.body?.found + ' source=' + r7.body?.presetSource)
 check('绝不谎称 explicit', r7.body?.presetSource !== 'explicit', r7.body?.presetSource)
 
-console.log('\n[8] 两个定位参数同时给：presetId 优先（客户端只该给一个）')
-const r8 = await call('?presetId=real-preset&sessionId=session-bound-default')
+// ── 8) ★ 串台钉子：会话绑定优先于显式 presetId ───────────────
+//
+// 实测事故：客户端两个 id 都送、且 presetId 排在前面，而 presetId 来自酒馆面板的
+// `dataset.presetId` / localStorage —— **切换会话后它可能仍是上一个会话的预设**。
+// 于是用户切到「瑟瑟提瓦特」后，服务端还按「足控天堂」的 presetId 出卡，**串台**。
+//
+// 会话 id 是唯一随会话切换必然变化的依据（服务端按 session-bindings.json 查），必须优先。
+console.log('\n[8] ?sessionId=session-bound-real&presetId=tavern-lite（会话绑定 A + 过期的 presetId B）')
+const r8 = await call('?sessionId=session-bound-real&presetId=tavern-lite')
 show('返回', r8)
-check('用 presetId 那个', r8.body?.presetDir === 'real-preset' && r8.body?.presetSource === 'explicit',
-  r8.body?.presetDir + '/' + r8.body?.presetSource)
+check('★ 解析出会话绑定的那个（real-preset），不是过期的 presetId',
+  r8.body?.presetDir === 'real-preset', r8.body?.presetDir)
+check('★ presetSource=session（一眼能看出这个结果是按会话来的）',
+  r8.body?.presetSource === 'session', r8.body?.presetSource)
+check('★ 绝不能是 explicit（那就说明 presetId 又盖掉了会话）',
+  r8.body?.presetSource !== 'explicit', r8.body?.presetSource)
+
+console.log('\n[8b] ?presetId=tavern-lite（没有 sessionId：原语义必须保持）')
+const r8b = await call('?presetId=tavern-lite')
+show('返回', r8b)
+check('found:true', r8b.body?.found === true, 'found=' + r8b.body?.found)
+check('按 presetId 取到 tavern-lite', r8b.body?.presetDir === 'tavern-lite', r8b.body?.presetDir)
+check('presetSource=explicit（没有会话时它就是显式指定）',
+  r8b.body?.presetSource === 'explicit', r8b.body?.presetSource)
+
+console.log('\n[8c] ?sessionId=session-bound-real&presetId=tavern-lite&preferPreset=1（显式开关）')
+const r8c = await call('?sessionId=session-bound-real&presetId=tavern-lite&preferPreset=1')
+show('返回', r8c)
+check('★ preferPreset=1 时按 presetId 走（不把需要它的调用方语义悄悄改掉）',
+  r8c.body?.presetDir === 'tavern-lite' && r8c.body?.presetSource === 'explicit',
+  r8c.body?.presetDir + '/' + r8c.body?.presetSource)
+
+console.log('\n[8d] ?sessionId=session-bound-gone&presetId=tavern-lite（会话绑定悬空 + 有 presetId）')
+const r8d = await call('?sessionId=session-bound-gone&presetId=tavern-lite')
+show('返回', r8d)
+check('★ 仍报 found:false：会话绑定的预设不存在时，不许退回用 presetId 静默换一张卡',
+  r8d.body?.found === false, 'found=' + r8d.body?.found + ' dir=' + r8d.body?.presetDir)
+check('错误里点名的是会话绑定的那个已消失预设',
+  typeof r8d.body?.error === 'string' && r8d.body.error.includes('renamed-away'),
+  JSON.stringify(r8d.body?.error))
+
+// ── 8e) 串台回归：没有会话依据时**不许**回落到"最近写入的会话"的预设 ──────────
+// 只断言"结果是 default"是**证明不了东西**的：若夹具里不存在"最近写入且有绑定的会话"，
+// 旧代码同样会给 default，这条用例就静默失效。所以先**造出**该条件，再**断言条件成立**。
+const sessDir = path.join(tmp, 'storages', 'session_projcache', 'sessions')
+fs.mkdirSync(sessDir, { recursive: true })
+const recentSess = path.join(sessDir, 'session-bound-real.json')
+fs.writeFileSync(recentSess, '{}', 'utf8')
+const _t = Date.now() / 1000
+fs.utimesSync(recentSess, _t, _t + 30)   // 把它变成"最近写入"的那个会话文件
+const _bindNow = JSON.parse(fs.readFileSync(path.join(presets, 'session-bindings.json'), 'utf8'))
+check('前置条件：夹具里确实有「最近写入 + 绑定可解析」的会话（否则本用例没有鉴别力）',
+  _bindNow['session-bound-real'] === 'real-preset' &&
+  fs.existsSync(path.join(presets, 'real-preset')),
+  'bind=' + _bindNow['session-bound-real'])
+
+console.log('\n[8e] 无参数（没有会话依据，但存在"最近写入的会话"的绑定）')
+const r8e = await call('')
+show('返回', r8e)
+check('★ 绝不许回落到 active —— 那正是"基本上每个会话都变成看同一张卡"的串台向量',
+  r8e.body?.presetSource !== 'active', 'presetSource=' + r8e.body?.presetSource)
+check('落到稳定默认（presetSource=default，而不是别人会话的卡）',
+  r8e.body?.presetSource === 'default', r8e.body?.presetSource + ' / ' + r8e.body?.presetDir)
+
+// ── 8f) ★ 交叉复核发现：显式 presetId 被"会话优先"规则忽略时**不许静默吞掉** ────────
+//
+// 机制：会话存在但未绑定 ⇒ `fromSession()` 把 `defaultPresetDir()` 写进了 `presetDir`，
+// 于是后面那句 `if (!presetDir && !missing && presetId) fromExplicit()` **永远进不去**。
+// 于是 `?sessionId=<未绑定>&presetId=A` 会返回 tavern-lite，**显式给的 A 被静默丢弃** ——
+// 与被修掉的串台是同一症状类：拿到不是你要的卡，而且不告诉你。
+//
+// 行为保持不变（要强制用 A 请带 `preferPreset=1`，见 [8c]），但必须在响应里说明。
+// 这里故意让 presetId 指向一个**真实存在且与结果不同**的预设（real-preset vs tavern-lite），
+// 这样"它确实没生效"和"我们如实说了"两件事能同时被钉住。
+console.log('\n[8f] ?sessionId=session-unbound&presetId=real-preset（会话未绑定 + 显式 presetId）')
+const r8f = await call('?sessionId=session-unbound&presetId=real-preset')
+show('返回', r8f)
+check('会话优先：落在 tavern-lite，显式 presetId 未生效',
+  r8f.body?.presetDir === 'tavern-lite', 'presetDir=' + r8f.body?.presetDir)
+check('来源如实标 session-default（不是谎称 explicit）',
+  r8f.body?.presetSource === 'session-default', r8f.body?.presetSource)
+check('★ 不许静默吞掉：note 里说明 presetId 被忽略、并指出逃生门 preferPreset=1',
+  typeof r8f.body?.note === 'string' && r8f.body.note.includes('preferPreset'),
+  JSON.stringify(r8f.body?.note))
+check('★ 并点名被忽略的是哪个 presetId（调用方能自查）',
+  r8f.body?.ignoredPresetId === 'real-preset', 'ignoredPresetId=' + r8f.body?.ignoredPresetId)
+check('反向：带 preferPreset=1 时它**必须**生效（逃生门真的可用，不是空话）',
+  (await call('?sessionId=session-unbound&presetId=real-preset&preferPreset=1')).body?.presetDir === 'real-preset')
+check('反向：没有显式 presetId 时不该出现 note（避免噪音字段）',
+  (await call('?sessionId=session-unbound')).body?.note === undefined)
 
 // ── 9) 畸形卡不再 500（④ 的端点面） ────────────────────────
 console.log('\n[9] 畸形卡（alternate_greetings 是对象）走端点')