dsh-muv-table 0.2.9 → 0.2.11

package/CHANGELOG.md

@@ -1,38 +1,44 @@
-# Changelog
-
-## v0.2.8 (2026-09-20)
-
-### 🐛 修复：Zod「变量结构」整类读不到（覆盖面最大的一个）
-
-parseMuvCard() 取 Zod schema 时用的是**精确等值** `s.name === 'zod'`，而真机上的卡
-几乎不这么命名（「变量结构」「星辉zod」…）——**一个都对不上**，zodSource 恒为空。
-Zod（`z.object({...})` / `registerMvuSchema`）是 MUV 最主流的 schema 载体，
-读不到等于整张卡的变量表建不出来，而且是静默失败。
-
-现在按两条线索找：**名字含 zod**，或**内容像 Zod schema**（`z.object(` /
-`registerMvuSchema` / `prefault(` 等）。
-实测：`_足控天堂2` 0 → **148106** 字符；`异世界农场` 0 → **953** 字符。
-
-### 🐛 修复：面板把 `@deepseek-ai/dsh-persona` 当卡名显示
-
-`extractMuvFromYml()` 的 `^\s*name:` 兜底会吃到 YAML 里的**服务声明**
-（`name: '@deepseek-ai/dsh-persona'`）。隔壁 `extractCardNameFromYml()` 有
-`@`/`/` 守卫，这里漏了。面板会把它显示成卡名并写进 localStorage 粘住。已补上同一守卫。
-
-### 🐛 修复：`<VariableInsert>` 形态的卡建不出变量表
-
-（由上一版引入的 `extractVariableInsert()` 修复，此处一并记录）
-`_足控天堂2` 的变量树在 `first_mes` 的 `<VariableInsert>{JSON}</VariableInsert>` 里，
-卡中**没有 `<initvar>`**，而 PNG 卡主路径走的 `parseMuvCard()` 只扫
-`alternate_greetings` 的 `<initvar>` → `schemas: 0`。现在 `parseMuvCard()` 在
-`initvarBlocks` 为空时回退到 `<VariableInsert>`，`<initvar>` 卡行为完全不变。
-实测 `schemas` 0 → **8**（世界信息/主角信息/公司/道具系统/剧情事件/因特网/剧情选项/主播档案）。
-
-> 回归：`node test-png-card.mjs` 12 → **28** 项；
-> 复现脚本 `repro-variableinsert.mjs` 留在仓库里可直接跑（进程内挂真实路由，不需要重启 DSH）。
-
-## Unreleased
+# Changelog
 
+## v0.2.11 (2026-09-20)
+### 🐛 修复：世界书里「没有 `<initvar>` 标签、只有 `[initvar]` 注释前缀」的裸 YAML 变量树读不到
+
+**现象**：`异世界农场` 的整棵变量树**不在卡文本里**，而在世界书条目
+`[initvar]变量初始化勿开` 的 `content` 里，是裸 YAML：
+
+```
+时间:
+  日期: '05-20'
+  星期: 周日
+种族好感度:
+  凛原族: 0
+  …
+```
+
+它**没有 `<initvar>` 标签**，所以按标签扫描的候选集
+（`first_mes` / `description` / `scenario` / `alternate_greetings` / 世界书 / helper）
+永远扫不到 → 该卡 `schemas` 恒为 `0`，面板一片空白。
+
+**修法**（`lib/muv-parser.js`）：新增 `worldbookInitvarEntries()`（找 `comment` 以
+`[initvar]` 开头的世界书条目）与 `looksLikeInitvarMapping()`（content 必须**读起来像
+变量映射**：`键:` / `键: 值` 行算键、`- item` 算列表内容、空行与 `#` 注释跳过，
+**只要有一行不属于这三类就否决**）。四道闸：① 只在上面所有来源都落空时启用；
+② content 必须过形状判定；③ 解析出的映射非空；④ 响应里标
+`schemaSource: 'worldbook-initvar'`，来源可见（面板上显示在卡名后面）。
+
+**★ 为什么它会读一条 `enabled: false` 的条目**（这条请照原样保留，否则会被当 bug 报回来）：
+要读的那条条目**本身就是被禁用的**，而且 `comment` 里就写着「变量初始化**勿开**」。
+这是卡作者的**约定**：把变量树放进一条禁用条目 → 它不会被注入上下文，但工具链仍然
+可以读到（「勿开」正是这个意思的字面声明）。所以判定只认 `[initvar]` 这个**显式标记**，
+`enabled` 不参与；没有该标记的禁用条目**永远不读**。挡住垃圾的是「标记 + 形状判定」，
+不是 `enabled`。若要求条目必须启用，这条兜底在唯一需要它的卡上就是空转。
+
+**实测**：`异世界农场` schemas **0 → 3**（时间 / 种族好感度 / 个人好感度），
+`schemaSource = worldbook-initvar`；`苍玄界`（对应条目叫 `[mvu_update]变量输出格式`，
+是**文档**不是数据）、`_足控天堂2`、`食人世界`、`涩涩提瓦特`、`default_Seraphina`
+**逐字节无回归**；`test-muv-parser.mjs` 56 → 76 项。
+
+## v0.2.10 (2026-09-20)
 ### 🐛 修复：变量面板读不到「足控天堂2」这种卡的变量表
 
 **现象**（已复现）：`GET /api/muv-table/tavern-card?presetId=…` 对这张卡返回
@@ -90,6 +96,234 @@ initvarBlocks: 0
 > 而是放在世界书条目 `[initvar]变量初始化勿开` 的 `content` 里，因此它的
 > `schemas` 依然是 0。那是另一套投递方式（世界书），不是本次的
 > `<VariableInsert>` 问题，需要单独决定是否要让面板读世界书。
+>
+> **更新（下一节「变量块来源」）**：世界书/脚本里**带 `<initvar>` / `<VariableInsert>`
+> 标签**的块现在能读了。但 `异世界农场` 那条世界书条目是**没有标签的裸 YAML**
+> （content 里只有 `时间:`、`种族好感度:` 这样的裸文本），按标签扫描依然扫不到，
+> 它的 `schemas` 仍是 0 —— 这一条需要一条**新规则**才能接住，见下一节末尾
+> 「仍未修 / 待决定」。
+
+---
+
+### 🔴 修复：initvar 列表值被吞成空对象（内容静默丢失）
+
+**现象**（`苍玄界` 实测，已复现）：卡里写的是
+
+```
+最近互动记录:
+  - 因为想吃灵鹤被{{user}}抓包，目前心虚加不知所措。
+```
+
+解析结果却是 `最近互动记录 = {}` —— **内容消失，且不进 schema**。该卡 initvar 共 65 个
+叶子行，`人际交往.结识道友录.沈慕微.最近互动记录` 与 `人际交往.结识道友录.江念.最近互动记录`
+两条路径**都不在 schema 里**（含这两条路径的叶子 = 0）。
+
+**根因**：`lib/initvar-parser.js` 两处配合出事——
+
+- 空值建空对象：`键: ` 后面为空就被当成「嵌套对象的开始」；
+- 无冒号的行直接丢弃：紧随其后的 `- item` 是列表项、没有冒号，被整行 `continue` 掉。
+
+于是「空值 + 下一行 `- `」这种写法（`苍玄界`、以及 MUV 原生卡的常规形态）必然退化成空对象。
+
+**修法**（`lib/initvar-parser.js` 为主）：
+
+- 栈帧改为记录「开启它的键 + 持有它的父对象」。`- item` 行归属**最内层待定键**：
+  该键若仍是空对象，就说明它其实是列表 → 原地替换成数组再追加。判定放在出栈**之前**
+  （列表允许与它的键同缩进）。
+- 列表项按标量解析（`- 3` → `3`）；列表下再出现的 `键: 值` 保留成条目文本，不静默丢行。
+- `serializeInitvar()` 把数组写回 `键:` + `  - item`（空数组写 `[]`），`parseValue('[]')` → `[]`，
+  列表**往返一致**。
+- `inferSchemaFromData()` / `index.js: inferSchemas()` / `client.js: renderField`：
+  列表行按换行拼接显示并带 `isList: true`；`applyEditsAndGenerate()` 把「编辑成多行文本」的列表行
+  再切回数组，生成块仍是 `- ` 列表，不会被拍平成 `a,b`。
+
+**实测数据**：
+
+- `repro-initvar-list.mjs`：改前 **7 项不通过** → 改后全通过；叶子行 **65 → 67**。
+- 真实卡往返一致性：`苍玄界`（16 个 initvar 块）+ 其 `.json` 共 **34 块**，
+  解析 → 序列化 → 解析 **逐字节一致**（改前 34 块里 32 块不一致）。
+- 引擎端到端（不改 `dsh-muv-engine`，只调用它）：`parseLatestInitvar → mergeState → generateBlock`
+  用 `苍玄界` 真实问候语跑通，合并后列表仍在，生成行是
+  `        - 因为想吃灵鹤被{{user}}抓包，目前心虚加不知所措。`，回读一致。
+
+### 🔴 附带发现：`键: ""` 往返变成 `{}`（类型静默翻转）
+
+**现象**：`苍玄界` 的 `世界系统.在场角色: ""`，生成块时被写成裸的 `在场角色: `，
+下次解析回来变成 `{}`（空对象）—— 同一个字段的形状在往返中变了。
+**根因**：`parseValue('""') → ''`，而 `formatValue('') → ''`；写出去的那一行看起来正是「空值 = 嵌套对象开始」。
+**修法**：`formatValue('')` 输出 `""`（卡片自己就是这么写的，等于沿用卡的惯例）。
+**实测**：上面那条 34 块往返一致性用例就是它的哨兵 —— 改前所有不一致都出自这一处，改后为 0。
+
+### 🔴 修复：`presetId` 不存在时静默返回另一张卡
+
+**现象**（已复现）：`GET /api/muv-table/tavern-card?presetId=does-not-exist`
+
+```
+HTTP 200 { ok:true, found:true, cardName:'川上富江', presetDir:'tavern-lite' }
+```
+
+用户以为在看自己的卡，其实拿到的是 tavern-lite 的卡。预设改名（历史上「深渊区」→「精简酒馆」）
+或重名，一样中招。
+
+**根因**：`lib/index.js` 里 `let presetDir = …; if (!fs.existsSync(presetDir)) presetDir = TAVERN_PRESET_DIR`
+—— 任何一步定位失败都**无条件**换成硬编码的 tavern-lite，而且响应里没有任何字段说明「这不是你要的那张」。
+
+**修法**：定位结果分来源，且**失败就明说**：
+
+| 请求 | 行为 |
+| --- | --- |
+| `presetId` 存在 | 用它，`presetSource: 'explicit'` |
+| `presetId` 不存在 | `found:false`，`error: preset not found: <id>`，附 `availablePresets` 清单 |
+| `sessionId` 绑定到真实预设 | 用它，`presetSource: 'session'` |
+| `sessionId` 绑定**已消失**（改名） | `found:false`，`error: preset bound to session … not found: <旧名>` |
+| `sessionId` 绑定为 `default` / 无绑定 | 用酒馆自己的默认（tavern-lite），`presetSource: 'session-default'` |
+| 两个定位参数都没给 | 按「最近写入的会话」猜，`presetSource: 'active'`；猜不到才用默认，`presetSource: 'default'` |
+
+- `default` 这条**是照抄酒馆的规则**，不是猜：`dsh-tavern` 的
+  `lib/index.js:2404` 就是 `if (currentPresetId === 'default') currentPresetId = 'tavern-lite'`，
+  `GET /api/tavern/presets` 也返回 `defaultPresetId: 'tavern-lite'`。
+  区别在于现在响应里**标明了**来源，而不是混在 `found:true` 里让人看不出来。
+- `presetId` / `sessionId` 一律当**目录名**解析，带 `\` `/` 或 `..` 的直接判不存在（顺带收紧路径穿越）。
+- 成功响应统一新增 `presetSource`；`/api/muv-table/active-preset` 不再返回
+  `fallback: 'tavern-lite'`（那个字段暗示仍会回退到固定预设，已不成立）。
+
+**实测数据**：`repro-preset-not-found.mjs` 改前 **4 项不通过**（复现「静默换卡」）→ 改后全通过；
+新增 `test-preset-resolve.mjs` 用**临时 DSH_HOME** 造 6 个假预设/假卡，**30 项全通过**
+（含 `?sessionId=` 的四种绑定形态，以及畸形卡不再 500）。
+
+### 🟠 修复：变量块的来源只扫 4 个字段，世界书 / helper 脚本读不到
+
+**现象**：`<initvar>` / `<VariableInsert>` 只可能在 `first_mes` / `description` / `scenario` /
+`alternate_greetings` 里被找到。写在 `character_book.entries[].content` 或
+`tavern_helper` 脚本里的变量块，整张卡的变量表就是空的。
+
+**修法**（`lib/muv-parser.js`）：新增 `variableTextCandidates(data)`，把四个字段、世界书条目
+（`character_book.entries[].content`，`where` 带上 `comment` 便于排查）、
+`extensions.tavern_helper.scripts[].content` 一起纳入候选集，并给每个候选打**分组**，
+让调用方能按「问候语级来源优先」取用。优先级（**先到先得**）：
+
+1. `alternate_greetings` 里的 `<initvar>`（16 个都要，行为不变）
+2. `first_mes` → `description` → `scenario` 里的 `<initvar>`（顺带把 `scenario` 补上 ——
+   `<VariableInsert>` 一直认它，`<initvar>` 不认，两条路本来就不对称）
+3. 任意来源（含世界书/脚本）里的 `<VariableInsert>`，第一个能 `JSON.parse` 成对象的块
+4. **最后**才看世界书/脚本里的 `<initvar>`
+
+第 4 步排在 `<VariableInsert>` 之后是刻意的：世界书和脚本里塞满了**引用标签的示例**
+（`苍玄界` 的 `[mvu_update]变量输出格式`、`_足控天堂2` 的 `ERA 变量操作规则/意图说明`），
+示例更可能是「能解析成垃圾、但不会抛异常」的裸 `<initvar>` 骨架，所以把它压到最后。
+**非法 JSON 继续往后找、全程不抛异常**这条行为有专门的用例守着。
+
+**实测数据**：`repro-parser-robustness.mjs` 改前 9 项不通过 → 改后全通过。
+`_足控天堂2` 的 8 组 schema、`公司.总现金 = 40000` 与 `主播档案.$template` 剔除全部不变
+（世界书里那两份文档块**没有**被误命中）。
+
+### 🟠 修复：畸形卡让端点 500
+
+**现象**：`alternate_greetings` 是**对象**（不是数组）时，`data.alternate_greetings || []`
+之后的 `for...of` 抛 `TypeError: greetings is not iterable` →
+`/api/muv-table/tavern-card` 直接 500。同理还有两处：`tavern_helper.scripts` 不是数组时
+`scripts.find is not a function`；世界书 `entries` 不是数组时同样炸。
+
+**修法**：`asArray()` 统一归一化 `alternate_greetings` / `character_book.entries` /
+`tavern_helper.scripts`；条目为 `null` 也跳过。
+
+**实测数据**：改前抛 3 个 TypeError（脚本里的 `scripts.find` 是复现时才发现的第三处），
+改后 `parseMuvCard(null)`、对象版 `alternate_greetings`、`entries: [null, 7, …]` 全部不抛异常；
+端点用例里那张畸形卡从 **500 → 200 + `schemas: []`**（同张卡别的内容照旧返回）。
+
+### 🟠 修复：扁平 V1 JSON 卡读成 0 字段
+
+**现象**：`findJsonMatch` 能按卡名找到**没有 `data` 包装**的扁平 V1 卡（`{name, description,
+first_mes, …}`），但 `parseMuvCard` 只认 `cardJson.data` → 卡名对了、变量表 0 字段。
+`regexScriptsOf()` 同样只认 `cardJson.data.extensions.regex_scripts`，扁平卡的正则脚本也一起丢。
+
+**修法**：新增 `cardData(cardJson)`：有对象型 `data` 就用它，否则**把卡本身当 data**
+（规格 v1 就是这样）。`regexScriptsOf()` 用同一套判定。
+
+**实测数据**：扁平卡的 `<initvar>` / `<VariableInsert>` 从 0 → 正常建表；
+有 `data` 包装的卡仍然以 `data` 为准（回归用例守住）。
+
+### 🧪 本轮新增的哨兵 / 回归
+
+| 文件 | 作用 |
+| --- | --- |
+| `repro-initvar-list.mjs` | ① 最小复现（`苍玄界` 真实卡）。改前 7 失败 → 改后 0 |
+| `repro-preset-not-found.mjs` | ② 最小复现。改前 4 失败 → 改后 0 |
+| `repro-parser-robustness.mjs` | ③④⑤ 最小复现。改前 9 失败 → 改后 0 |
+| `test-muv-parser.mjs` | 解析器回归 **56 项**（含真实卡往返一致性、列表 schema 形状、编辑回写、畸形卡） |
+| `test-preset-resolve.mjs` | 端点回归 **30 项**（临时 DSH_HOME，不碰真实环境） |
+| `test-cards.mjs` | 测试用的真实卡定位辅助（找不到就 SKIP，不失败） |
+
+原有基线不变：`node test-png-card.mjs` **28 通过**；
+`node C:\dsh-muv-engine\test-status-cascade.mjs` **84 通过**。
+
+### ⏭ 仍未修 / 待决定：世界书里**没有标签**的 `[initvar]` 条目
+
+`异世界农场.png` 的初始值放在世界书条目 `[initvar]变量初始化勿开` 的 content 里，
+但那份 content 是**裸 YAML、没有 `<initvar>` 标签**：
+
+```
+时间:
+  日期: '05-20'
+  …
+种族好感度: …
+个人好感度: {}
+```
+
+所以按标签扫描（本节这套）扫不到它，该卡 `schemas` 仍是 0（它的变量表实际由
+`tavern_helper` 里的 Zod 结构定义，`zodSource` 953 字符，已能读到，但面板是用
+`initvarData` 建行的）。要接住它需要一条**新**规则，例如：
+
+> 彻底找不到变量块时，再找 `comment` 以 `[initvar]` 开头的世界书条目，把 `content`
+> 当 initvar 块解析（预计 `异世界农场` 会从 0 变成 `时间` / `种族好感度` / `个人好感度` 三组）。
+
+**本轮没做**：它超出「扫这两个来源里的标签」的范围，而且会引入「注释前缀」这一层新判定
+（`苍玄界` 的对应条目叫 `[mvu_update]变量输出格式`，是文档不是数据 —— 两个前缀是有区别的，
+但 `[initvar]` 万一也是文档就会解析出垃圾表）。留待决定。现状已用
+`test-muv-parser.mjs` 的第 [10] 节**钉住**（含「没有标签」这条断言），改动必然是有意的。
+
+## v0.2.9 (2026-09-20)
+### 🐛 修复：面板「不管点哪个会话都显示同一张卡」
+
+服务端无问题（按 `presetId` 请求时每个预设都返回各自的卡）。根因在客户端：它一直发同一个
+预设——因为它依赖酒馆 DOM，而 `#tavern-session-preset-label` 的 `dataset.presetId`
+在切换会话时不一定更新（酒馆自己 `bundle.js:1655` 用 `savedPid || 旧值`，`savedPid`
+为空时**保留旧值**），`localStorage` 那份更是切换预设时才写。**切换会话根本不会更新它们。**
+
+改为**优先用当前 DSH 会话 id 请求**：服务端按 `session-bindings.json` 查出该会话绑定的预设，
+切换会话必然跟着变，不会粘。实测 4/5 会话正确解析（第 5 个 `minimal-gitbash` 本身无卡）。
+
+注意只传一个定位参数且会话 id 优先——服务端判定顺序是 `if (presetId) … else if (sessionId) …`，
+两个都传时**可能粘住的那个会盖掉可靠的**。
+## v0.2.8 (2026-09-20)
+### 🐛 修复：Zod「变量结构」整类读不到（覆盖面最大的一个）
+
+parseMuvCard() 取 Zod schema 时用的是**精确等值** `s.name === 'zod'`，而真机上的卡
+几乎不这么命名（「变量结构」「星辉zod」…）——**一个都对不上**，zodSource 恒为空。
+Zod（`z.object({...})` / `registerMvuSchema`）是 MUV 最主流的 schema 载体，
+读不到等于整张卡的变量表建不出来，而且是静默失败。
+
+现在按两条线索找：**名字含 zod**，或**内容像 Zod schema**（`z.object(` /
+`registerMvuSchema` / `prefault(` 等）。
+实测：`_足控天堂2` 0 → **148106** 字符；`异世界农场` 0 → **953** 字符。
+
+### 🐛 修复：面板把 `@deepseek-ai/dsh-persona` 当卡名显示
+
+`extractMuvFromYml()` 的 `^\s*name:` 兜底会吃到 YAML 里的**服务声明**
+（`name: '@deepseek-ai/dsh-persona'`）。隔壁 `extractCardNameFromYml()` 有
+`@`/`/` 守卫，这里漏了。面板会把它显示成卡名并写进 localStorage 粘住。已补上同一守卫。
+
+### 🐛 修复：`<VariableInsert>` 形态的卡建不出变量表
+
+（由上一版引入的 `extractVariableInsert()` 修复，此处一并记录）
+`_足控天堂2` 的变量树在 `first_mes` 的 `<VariableInsert>{JSON}</VariableInsert>` 里，
+卡中**没有 `<initvar>`**，而 PNG 卡主路径走的 `parseMuvCard()` 只扫
+`alternate_greetings` 的 `<initvar>` → `schemas: 0`。现在 `parseMuvCard()` 在
+`initvarBlocks` 为空时回退到 `<VariableInsert>`，`<initvar>` 卡行为完全不变。
+实测 `schemas` 0 → **8**（世界信息/主角信息/公司/道具系统/剧情事件/因特网/剧情选项/主播档案）。
+
+> 回归：`node test-png-card.mjs` 12 → **28** 项；
+> 复现脚本 `repro-variableinsert.mjs` 留在仓库里可直接跑（进程内挂真实路由，不需要重启 DSH）。
 
 ## v0.2.7 (2026-09-20)
 

package/lib/block-generator.js

@@ -47,6 +47,14 @@ function setNestedValue(obj, path, value) {
   }
   const lastKey = keys[keys.length - 1]
 
+  // A list row is edited as newline-joined text; splitting it back keeps the
+  // field a list so the generated block still writes `- item` lines instead of
+  // collapsing the list into one comma-joined string.
+  if (Array.isArray(current[lastKey]) && typeof value === 'string') {
+    current[lastKey] = value.split('\n').map(s => s.trim()).filter(s => s !== '')
+    return
+  }
+
   // Coerce types
   if (typeof current[lastKey] === 'number' || (!isNaN(current[lastKey]) && current[lastKey] !== '' && current[lastKey] !== null && current[lastKey] !== undefined)) {
     const num = Number(value)

package/lib/client.js

@@ -318,7 +318,10 @@ window.__ModuleLoader__.load({
       // ============ render a field node recursively ============
       const renderField = (field, data, prefix, depth) => {
         const path = prefix?prefix+'.'+field.name:field.name
-        const val = data?.[field.name]
+        const raw = data?.[field.name]
+        // A `- item` list arrives as an array; this row is one input, so join the
+        // items with newlines instead of letting React render "a,b".
+        const val = Array.isArray(raw)?raw.join('\n'):raw
         const isContainer = field.type==='object' && field.children && field.children.length>0
         const isCollapsed = collapsed.has(path)
         const changed = state.edits[path]!==undefined

package/lib/index.js

@@ -33,7 +33,6 @@ function resolveDshHome() {
 // apply() 时按 DSH 实际 home 重新绑定
 let DSH_HOME = resolveDshHome()
 let PRESETS_ROOT = path.join(DSH_HOME, '.agent-presets')
-let TAVERN_PRESET_DIR = path.join(PRESETS_ROOT, 'tavern-lite')
 let SESSION_BINDINGS_FILE = path.join(PRESETS_ROOT, 'session-bindings.json')
 
 /**
@@ -49,7 +48,6 @@ function bindDshPaths(ctx) {
   if (!home) home = resolveDshHome()
   DSH_HOME = home
   PRESETS_ROOT = path.join(home, '.agent-presets')
-  TAVERN_PRESET_DIR = path.join(PRESETS_ROOT, 'tavern-lite')
   SESSION_BINDINGS_FILE = path.join(PRESETS_ROOT, 'session-bindings.json')
 }
 
@@ -164,16 +162,68 @@ function scanAllPresetCards() {
 }
 
 /** Resolve preset dir for a session id via session-bindings.json */
-function presetDirForSession(sessionId) {
+function presetIdForSession(sessionId) {
   try {
     const bindPath = SESSION_BINDINGS_FILE
     if (sessionId && fs.existsSync(bindPath)) {
       const bind = JSON.parse(fs.readFileSync(bindPath, 'utf8'))
       const preset = bind[sessionId]
-      if (preset && preset !== 'default') return path.join(PRESETS_ROOT, preset)
+      if (preset && preset !== 'default') return String(preset)
     }
   } catch (_) {}
-  return TAVERN_PRESET_DIR
+  return ''
+}
+
+/** Names of the presets that actually exist — for diagnostics when one misses. */
+function availablePresetIds() {
+  try {
+    return fs.readdirSync(PRESETS_ROOT, { withFileTypes: true })
+      .filter(d => d.isDirectory())
+      .map(d => d.name)
+      .sort()
+  } catch (_) {
+    return []
+  }
+}
+
+/**
+ * The preset the tavern itself uses when a session has none.
+ *
+ * `GET /api/tavern/presets` answers `defaultPresetId: 'tavern-lite'`, and the
+ * tavern maps an explicit `default` binding onto it the same way
+ * (`if (currentPresetId === 'default') currentPresetId = 'tavern-lite'`). So
+ * falling back here is *not* a guess — it is the tavern's own rule, and the only
+ * reason this plugin is allowed to use it is that the response now says so via
+ * `presetSource`.
+ * @returns {string} absolute directory, or '' when it does not exist
+ */
+function defaultPresetDir() {
+  return resolvePresetDirById('tavern-lite')
+}
+
+/**
+ * Resolve one preset id to an existing directory *inside* PRESETS_ROOT.
+ *
+ * Returns '' when the preset does not exist, and the caller must report that as
+ * `found:false`. It used to fall back to `TAVERN_PRESET_DIR`, which meant a
+ * mistyped or renamed preset id silently served a *different* preset's card
+ * (`?presetId=does-not-exist` → tavern-lite's 川上富江) while the panel said
+ * nothing — the user had no way to tell they were looking at someone else's card.
+ *
+ * Ids are directory names, never paths: separators and `..` are rejected so a
+ * request cannot walk out of the preset root.
+ * @param {string} id
+ * @returns {string} absolute directory, or ''
+ */
+function resolvePresetDirById(id) {
+  const name = String(id || '').trim()
+  if (!name || name === '.' || name === '..' || /[\\/]/.test(name)) return ''
+  const dir = path.join(PRESETS_ROOT, name)
+  try {
+    return fs.statSync(dir).isDirectory() ? dir : ''
+  } catch (_) {
+    return ''
+  }
 }
 
 /**
@@ -337,7 +387,11 @@ function loadRawCardForPreset(presetDir, cardName) {
  * @returns {object[]}
  */
 function regexScriptsOf(cardJson) {
-  const scripts = cardJson?.data?.extensions?.regex_scripts
+  // Spec-v2 wraps fields in `data`, spec-v1 (flat) keeps them at the top level —
+  // reading only `data` dropped every regex script of a flat card, which is what
+  // makes the rendering engine work at all.
+  const data = (cardJson?.data && typeof cardJson.data === 'object') ? cardJson.data : cardJson
+  const scripts = data?.extensions?.regex_scripts
   return Array.isArray(scripts) ? scripts : []
 }
 
@@ -386,7 +440,8 @@ function extractMuvFromCharactersJson(presetDir) {
           schemas: inferSchemas(clean),
           initvarData: clean,
           initvarBlocks: [body],
-          zodSource: ''
+          zodSource: '',
+          schemaSource: 'variable-insert'
         }
       } catch (_) {
         // Fall through: the block may still be YAML-ish.
@@ -402,7 +457,8 @@ function extractMuvFromCharactersJson(presetDir) {
         schemas: inferSchemas(parsed),
         initvarData: parsed,
         initvarBlocks: [iv[1]],
-        zodSource: ''
+        zodSource: '',
+        schemaSource: 'initvar'
       }
     }
     return null
@@ -430,10 +486,10 @@ function extractMuvFromYml(yml) {
       const blockText = m[1]
       const parsed = parseInitvar(blockText)
       const schemas = inferSchemas(parsed)
-      return { name, schemas, initvarData: parsed, initvarBlocks: [blockText], zodSource: '' }
+      return { name, schemas, initvarData: parsed, initvarBlocks: [blockText], zodSource: '', schemaSource: 'initvar' }
     }
     // No initvar default — serve empty-but-valid so the panel opens empty
-    return { name, schemas: [], initvarData: {}, initvarBlocks: [], zodSource: '' }
+    return { name, schemas: [], initvarData: {}, initvarBlocks: [], zodSource: '', schemaSource: 'none' }
   } catch (_) {
     return null
   }
@@ -449,6 +505,16 @@ function inferSchemas(data) {
       if (children.length > 0) fields.push({ name: key, type: 'object', defaultValue: '{}', description: '', children })
     } else if (typeof value === 'number') {
       fields.push({ name: key, type: 'number', defaultValue: String(value), description: '', children: [] })
+    } else if (Array.isArray(value)) {
+      // `- item` list: shown as newline-joined text, kept as an array in the data.
+      fields.push({
+        name: key,
+        type: 'string',
+        defaultValue: value.map(v => (v === null || v === undefined) ? '' : String(v)).join('\n'),
+        description: '',
+        children: [],
+        isList: true
+      })
     } else {
       fields.push({ name: key, type: 'string', defaultValue: String(value ?? ''), description: '', children: [] })
     }
@@ -581,7 +647,10 @@ export function apply(ctx) {
       handler: (req, res) => {
         try {
           const presetId = activePresetId()
-          json(res, 200, { ok: true, presetId, fallback: presetId ? '' : path.basename(TAVERN_PRESET_DIR) })
+          // No `fallback` name any more: falling back to a fixed preset is what
+          // made the panel show an unrelated card. An empty presetId now means
+          // "cannot tell", and tavern-card says so instead of guessing.
+          json(res, 200, { ok: true, presetId, fallback: '' })
         } catch (e) {
           json(res, 500, { ok: false, error: e.message })
         }
@@ -597,21 +666,64 @@ export function apply(ctx) {
           const sessionId = url.searchParams.get('sessionId') || ''
 
           // Resolve the preset: explicit id > the session's bound preset >
-          // whichever preset the user is actually in. The last resort used to be
-          // a hardcoded `tavern-lite`, which made the panel show that preset's
-          // card (a stale 苍玄界 copy) whenever the client had no preset id yet
-          // — which is the common case, since the id only arrives via a
-          // `tavern-preset-changed` event that never fires on a fresh page.
-          let presetDir
+          // whichever preset the user is actually in > the tavern's own default.
+          //
+          // 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
+          // nothing — the user had no way to tell they were looking at someone
+          // else's card. The default is still the right answer for a session the
+          // tavern itself considers unbound (`default` ⇒ `tavern-lite`), but it is
+          // no longer the answer for an id that was asked for by name; those
+          // report `found:false` with the reason, and every hit reports how it was
+          // located in `presetSource`.
+          let presetDir = ''
+          let presetSource = ''
+          let missing = ''
+          let requested = ''
           if (presetId) {
-            presetDir = path.join(PRESETS_ROOT, presetId)
+            requested = String(presetId)
+            presetDir = resolvePresetDirById(presetId)
+            if (presetDir) presetSource = 'explicit'
+            else missing = 'preset not found: ' + requested
           } else if (sessionId) {
-            presetDir = presetDirForSession(sessionId)
-          } else {
+            const bound = presetIdForSession(sessionId)
+            requested = bound
+            if (!bound || bound === 'default') {
+              // The session has no preset of its own — the tavern uses its
+              // default for it, so that is the honest answer.
+              presetDir = defaultPresetDir()
+              if (presetDir) presetSource = 'session-default'
+            } else {
+              presetDir = resolvePresetDirById(bound)
+              if (presetDir) presetSource = 'session'
+              else missing = 'preset bound to session ' + sessionId + ' not found: ' + bound
+            }
+          }
+          if (!presetDir && !missing) {
             const active = activePresetId()
-            presetDir = active ? path.join(PRESETS_ROOT, active) : TAVERN_PRESET_DIR
+            if (active) {
+              requested = active
+              presetDir = resolvePresetDirById(active)
+              if (presetDir) presetSource = 'active'
+              else missing = 'active preset not found: ' + active
+            }
+          }
+          if (!presetDir && !missing) {
+            presetDir = defaultPresetDir()
+            if (presetDir) presetSource = 'default'
+          }
+          if (!presetDir) {
+            json(res, 200, {
+              ok: true, found: false,
+              error: missing || 'no preset could be resolved',
+              reason: missing ? 'preset-not-found' : 'no-preset-resolved',
+              requestedPresetId: requested || undefined,
+              availablePresets: availablePresetIds(),
+              regexScripts: []
+            })
+            return
           }
-          if (!fs.existsSync(presetDir)) presetDir = TAVERN_PRESET_DIR
           const ymlPath = path.join(presetDir, 'agent.cordis.yml')
 
           let yml = fs.existsSync(ymlPath) ? readYmlSafe(ymlPath) : ''
@@ -629,6 +741,7 @@ export function apply(ctx) {
               cardSource: raw.source,
               cardName,
               presetDir: path.basename(presetDir),
+              presetSource,
               ...parseMuvCard(raw.json),
               // Consumers read the scripts from either shape; keep both so an
               // existing reader keeps working while the engine migrates.
@@ -651,6 +764,7 @@ export function apply(ctx) {
                 cardSource: 'characters',
                 cardName: fromStore.cardName || cardName,
                 presetDir: path.basename(presetDir),
+                presetSource,
                 name: fromStore.name,
                 schemas: fromStore.schemas,
                 initvarData: fromStore.initvarData,
@@ -666,12 +780,16 @@ export function apply(ctx) {
               ok: true, found: true,
               fileName: path.basename(presetDir) + '/agent.cordis.yml',
               cardName, presetDir: path.basename(presetDir),
+              presetSource,
               ...parsed,
               regexScripts: [],
               data: { extensions: { regex_scripts: [] } }
             })
           } else {
-            json(res, 200, { ok: true, found: false, error: 'no card in preset', regexScripts: [] })
+            json(res, 200, {
+              ok: true, found: false, error: 'no card in preset',
+              presetDir: path.basename(presetDir), presetSource, regexScripts: []
+            })
           }
         } catch (e) {
           json(res, 500, { ok: false, error: e.message })