dsh-muv-table 0.2.7 → 0.2.8

package/CHANGELOG.md

@@ -1,4 +1,95 @@
-# Changelog
+# 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
+
+### 🐛 修复：变量面板读不到「足控天堂2」这种卡的变量表
+
+**现象**（已复现）：`GET /api/muv-table/tavern-card?presetId=…` 对这张卡返回
+
+```
+cardName    : _足控天堂2
+cardSource  : library
+fileName    : _足控天堂2.png
+schemas     : 0        ← 面板靠 schemas 建表，为 0 就什么都显示不出来
+initvarData : {}
+initvarBlocks: 0
+```
+
+`lib/client.js` 里 `schemas.length === 0` 直接渲染空态，所以整张变量表是空的。
+
+**根因**：这张卡把变量定义写在一句话的
+`<VariableInsert>{ …JSON… }</VariableInsert>` 里（在 `first_mes` = 【主页】），
+**卡里根本没有 `<initvar>`**。而 PNG 卡主路径调用的 `parseMuvCard()`
+只扫 `alternate_greetings` 里的 `<initvar>`，扫不到就返回 0 个 schema。
+
+仓库里本来就有能处理 `<VariableInsert>` 的 `extractMuvFromCharactersJson()`，
+但它只在退路分支（`loadRawCardForPreset` 返回 null、退回 `characters.json`）里被调用。
+主路径从卡库匹配到 PNG 后直接 `return`，把它整个跳过了 —— 数据就在卡里，没人读。
+
+**修法**：把 `<VariableInsert>` 支持下沉到 `lib/muv-parser.js` 的 `parseMuvCard()`，
+让主路径和退路共用同一份解析（`dsh-muv-engine` 也从这里 import `parseMuvCard`，一并受益）：
+
+- 新增导出 `extractVariableInsert(data)`：按 `first_mes` → `description` →
+  `scenario` → `alternate_greetings` 顺序找 `<VariableInsert>`，取第一个能
+  `JSON.parse` 成对象的块；这一块不是 JSON 就继续往后找，全程不抛异常。
+- **只有一个 `<initvar>` 都没找到时才走这条兜底**，所以原先正常的 `<initvar>` 卡
+  行为完全不变（回归用例 [6] 守住这一点）。
+- 顺带补上：`<initvar>` 也可能写在 `first_mes` / `description` 里，原先只看
+  `alternate_greetings` 同样会漏。该分支也只在 `alternate_greetings` 没找到时才生效。
+- 新增导出 `stripPlaceholderEntries(data)`：去掉 `主播档案.$template`。它是卡自己
+  留下的「一个主播长什么样」的占位模板，不是真实主播，当角色渲染会在表里多出一行
+  假主播。（这条规则原先只写在 `extractMuvFromCharactersJson()` 里，现在两处共用。）
+
+**测试**：`test-png-card.mjs` 12 项 → **28 项**，新增 [5][6][7] 三节：
+
+- **[5]** 合成一张 `<VariableInsert>` PNG 卡（不依赖本机卡库）验证：能建表、顶层键
+  齐全、`$template` 不成行、数值仍是 `number` 不是 `string`。
+- **[6]** 反向保护：`<initvar>` 卡不会被 `<VariableInsert>` 抢走、`first_mes` 里的
+  `<initvar>` 也认、坏 JSON 不抛异常、没有变量块的卡照样返回有效结构。
+- **[7]** 真实卡 `_足控天堂2.png`：`schemas` 非空、顶层键含
+  `世界信息/主角信息/公司/道具系统/剧情事件/因特网/剧情选项/主播档案`、
+  `主播档案` 下是 `超天酱`（不是 `$template`）、`数值.压力值` 可编辑。
+
+新增 `repro-variableinsert.mjs`：用 `apply()` 挂载真实路由、在进程内请求
+`/api/muv-table/tavern-card`（等价于浏览器那条路，但不需要重启 DSH）。
+改前 5 项不通过（复现 `schemas: 0`），改后全通过。这个脚本留在仓库里，
+以后再有人动 `parseMuvCard` 可以拿它当哨兵。
+
+> 已知相邻问题（本次**未**修）：`异世界农场.png` 的初始变量不是放在卡文本里，
+> 而是放在世界书条目 `[initvar]变量初始化勿开` 的 `content` 里，因此它的
+> `schemas` 依然是 0。那是另一套投递方式（世界书），不是本次的
+> `<VariableInsert>` 问题，需要单独决定是否要让面板读世界书。
 
 ## v0.2.7 (2026-09-20)
 

package/README.md

@@ -42,7 +42,7 @@ MUV 变量表格编辑器 —— 酒馆伴生插件。
 **这是变量数据唯一还存在的地方**。现在会从这里提取，支持
 `<VariableInsert>{…JSON…}` 与 MUV 原生的 `<UpdateVariable><initvar>…</initvar>` 两种编码。
 
-> 回归测试：`node test-png-card.mjs`（12 项，含真实卡库验证）
+> 回归测试：`node test-png-card.mjs`（28 项，含真实卡库验证）
 
 
 ## 是什么
@@ -94,7 +94,8 @@ dsh plugin --profile web add dsh-muv-table
 | 类型 | 说明 |
 |------|------|
 | 有 `<initvar>` 默认数据 | 直接显示完整变量表 |
-| 无 `<initvar>`（如瑟瑟提瓦特） | 显示空表，LLM 输出 UpdateVariable 后自动填充 |
+| 有 `<VariableInsert>{…JSON…}`（如足控天堂2） | 直接显示完整变量表（`主播档案.$template` 不算条目） |
+| 两者都没有（如瑟瑟提瓦特） | 显示空表，LLM 输出 UpdateVariable 后自动填充 |
 
 ## 协议
 

package/lib/index.js

@@ -419,7 +419,11 @@ function extractMuvFromYml(yml) {
   if (!yml) return null
   try {
     const nameMatch = yml.match(/角色名[：:]\s*([^\s#\n]+)/) || yml.match(/^\s*name:\s*(.+)$/m)
-    const name = nameMatch ? nameMatch[1].trim().replace(/^['"]|['"]$/g, '') : 'MUV Card'
+    let name = nameMatch ? nameMatch[1].trim().replace(/^['"]|['"]$/g, '') : 'MUV Card'
+    // `^\s*name:` 兜底会吃到 YAML 里的**服务声明**（`name: '@deepseek-ai/dsh-persona'`），
+    // 于是面板把插件包名当卡名显示出来。隔壁 extractCardNameFromYml() 有同样的守卫，
+    // 这里补上——否则面板会显示 `@deepseek-ai/dsh-persona` 并把它写进 localStorage 粘住。
+    if (/^@/.test(name) || name.includes('/')) name = 'MUV Card'
     // Try to find an <initvar> block in the persona
     const m = yml.match(/<initvar>([\s\S]*?)<\/initvar>/i)
     if (m) {

package/lib/muv-parser.js

@@ -3,22 +3,97 @@
 
 import { parseInitvar } from './initvar-parser.js'
 
+// Where a card keeps its variable block.
+//
+// Two shapes are in the wild:
+//
+//   1) `<initvar>…</initvar>` — MUV-native, YAML-ish, handled by initvar-parser.
+//   2) `<VariableInsert>{ …plain JSON… }</VariableInsert>` — the community
+//      form. These cards carry *no* `<initvar>` anywhere, so a parser that only
+//      looked for shape 1 returned `schemas: 0` and the variable panel came up
+//      empty even though the whole tree was sitting in the opening greeting.
+//
+// Shape 2 is normally in the greeting that opens the chat, but a card may just
+// as well park it in description/scenario, so all three are scanned.
+const VARIABLE_TEXT_FIELDS = ['first_mes', 'description', 'scenario']
+
+/**
+ * Drop a collection's `$template` placeholder.
+ *
+ * `主播档案.$template` is the card's own sketch of "what an主播 looks like" —
+ * not an actual character. Rendering it put a bogus 主播 row in the panel.
+ * @param {object} data
+ * @returns {object} a shallow copy with `$template` removed from 主播档案
+ */
+export function stripPlaceholderEntries(data) {
+  if (!data || typeof data !== 'object') return data
+  const clean = { ...data }
+  const anchors = clean['主播档案']
+  if (anchors && typeof anchors === 'object' && !Array.isArray(anchors) && '$template' in anchors) {
+    const inner = { ...anchors }
+    delete inner.$template
+    clean['主播档案'] = inner
+  }
+  return clean
+}
+
+/**
+ * Find a `<VariableInsert>{…JSON…}</VariableInsert>` block in a card and return
+ * it as usable variable data.
+ * @param {object} data - the card's `data` object
+ * @returns {{ data: object, raw: string }|null}
+ */
+export function extractVariableInsert(data) {
+  if (!data || typeof data !== 'object') return null
+
+  const candidates = []
+  for (const field of VARIABLE_TEXT_FIELDS) {
+    if (typeof data[field] === 'string') candidates.push(data[field])
+  }
+  for (const greeting of data.alternate_greetings || []) {
+    if (typeof greeting === 'string') candidates.push(greeting)
+  }
+
+  for (const text of candidates) {
+    const match = text.match(/<VariableInsert>([\s\S]*?)<\/VariableInsert>/i)
+    if (!match) continue
+    const raw = match[1].trim()
+    try {
+      const parsed = JSON.parse(raw)
+      if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+        return { data: stripPlaceholderEntries(parsed), raw }
+      }
+    } catch (_) {
+      // Not JSON — keep looking; another block might be the real one.
+    }
+  }
+  return null
+}
+
 /**
  * Parse a MUV character card JSON and extract schema + variable data.
  * @param {object} cardJson - The full character card JSON
  * @returns {{ name: string, schemas: object[], initvarData: object, zodSource: string }}
  */
 export function parseMuvCard(cardJson) {
-  const name = cardJson?.data?.name || cardJson?.name || 'Unnamed'
-  const extensions = cardJson?.data?.extensions
-  const tavernHelper = extensions?.tavern_helper
+  const data = cardJson?.data || {}
+  const name = data.name || cardJson?.name || 'Unnamed'
+  const tavernHelper = data.extensions?.tavern_helper
 
   // Extract Zod schema source (for reference)
-  const zodScript = tavernHelper?.scripts?.find(s => s.name === 'zod')
+  //
+  // 原先这里是 `s.name === 'zod'` 的精确等值匹配，而真机上的卡几乎不这么命名：
+  // 「变量结构」「星辉zod」…… 一个都对不上，于是 zodSource 恒为空。而 Zod
+  // （`z.object({...})` / `registerMvuSchema`）其实是 MUV 最主流的 schema 载体，
+  // 读不到就等于整张卡的变量表建不出来。
+  // 现在按「名字含 zod」或「内容像 Zod schema」两条线索找，兼容各种命名。
+  const scripts = tavernHelper?.scripts || []
+  const zodScript = scripts.find(s => /zod/i.test(String(s?.name || '')))
+    || scripts.find(s => /z\.object\s*\(|registerMvuSchema|Mvu\.|z\.string\s*\(|prefault\s*\(/.test(String(s?.content || '')))
   const zodSource = zodScript?.content || ''
 
   // Extract initvar blocks from alternate_greetings
-  const greetings = cardJson?.data?.alternate_greetings || []
+  const greetings = data.alternate_greetings || []
   const initvarBlocks = []
 
   for (const greeting of greetings) {
@@ -32,8 +107,35 @@ export function parseMuvCard(cardJson) {
     }
   }
 
+  // An <initvar> may live in the opening greeting instead. Only consulted when
+  // alternate_greetings had none, so a card that already worked keeps reading
+  // from exactly the same place it used to.
+  if (initvarBlocks.length === 0) {
+    for (const text of [data.first_mes, data.description]) {
+      if (typeof text !== 'string') continue
+      const match = text.match(/<initvar>([\s\S]*?)<\/initvar>/i)
+      if (match) {
+        initvarBlocks.push({
+          raw: match[1].trim(),
+          parsed: parseInitvar(match[1])
+        })
+        break
+      }
+    }
+  }
+
   // Use the first initvar block as default data
-  const initvarData = initvarBlocks.length > 0 ? initvarBlocks[0].parsed : {}
+  let initvarData = initvarBlocks.length > 0 ? initvarBlocks[0].parsed : {}
+  let initvarRaw = initvarBlocks.map(b => b.raw)
+
+  // No <initvar> anywhere → fall back to the community <VariableInsert> shape.
+  if (initvarRaw.length === 0) {
+    const inserted = extractVariableInsert(data)
+    if (inserted) {
+      initvarData = inserted.data
+      initvarRaw = [inserted.raw]
+    }
+  }
 
   // Infer schema from initvar data
   const schemas = inferSchemaFromData(initvarData)
@@ -42,7 +144,7 @@ export function parseMuvCard(cardJson) {
     name,
     schemas,
     initvarData,
-    initvarBlocks: initvarBlocks.map(b => b.raw),
+    initvarBlocks: initvarRaw,
     zodSource
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-muv-table",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "MUV 变量表格编辑器 —— 树形变量面板、宏测试浮窗（random/pick/roll）、骰子快捷栏、pick 缓存管理；支持直接读取 SillyTavern PNG 角色卡（含正则脚本、世界书、变量表）。dsh-muv-engine 的伴生插件",
   "type": "module",
   "main": "lib/index.js",

package/test-png-card.mjs

@@ -7,7 +7,8 @@
 // keeps only {name, desc, first}, so if this breaks, a card dragged into
 // SillyTavern silently arrives with none of its rendering machinery.
 import { readPngCard, readPngChunks, extractCharaPayload, isPngCard } from './lib/png-card.js'
-import { readdirSync, existsSync } from 'node:fs'
+import { parseMuvCard } from './lib/muv-parser.js'
+import { readdirSync, existsSync, writeFileSync, rmSync } from 'node:fs'
 import path from 'node:path'
 import os from 'node:os'
 
@@ -112,5 +113,110 @@ if (realCards === 0) {
   check('其中带正则脚本的 (' + realWithRegex + ' 张)', realWithRegex > 0)
 }
 
+// 5) A PNG card may declare its variables as
+//    `<VariableInsert>{…plain JSON…}</VariableInsert>` instead of `<initvar>`.
+//    Reading the PNG correctly is not enough — if the schema comes out empty
+//    the variable panel has nothing to build a table from, which is exactly how
+//    「足控天堂2」 showed up as `schemas: 0`.
+const TOP_LEVEL_KEYS = ['世界信息', '主角信息', '公司', '道具系统', '剧情事件', '因特网', '剧情选项', '主播档案']
+
+function variableInsertCard() {
+  const tree = {
+    世界信息: { 时间: { 日期: '2026年8月26日', 时间详情: '10:00' }, 游戏模式: '香脚模式' },
+    主角信息: { 名称: '{{user}}', 年龄: '20岁' },
+    公司: { 总现金: 40000, 濒死状态: false },
+    道具系统: { $template: { 库存: 0 }, 安神片: { 库存: 2, 描述: '降低压力值10' } },
+    剧情事件: { $template: { 事件描述: '' }, 事件描述: '先撑过本周现金关' },
+    因特网: { 公司主播推特1: '超天酱：袜子穿久了有点潮……' },
+    剧情选项: { 选项1: '', 选项2: '', 选项3: '' },
+    主播档案: {
+      $template: { 直播时人格: '', 数值: { 压力值: 0 } },
+      超天酱: { 直播时人格: '超天酱', 数值: { 压力值: 45 } },
+    },
+  }
+  return {
+    name: 'vi',
+    description: 'desc',
+    first_mes: '【主页】\n\n<VariableInsert>\n' + JSON.stringify(tree, null, 2) + '\n</VariableInsert>',
+    data: { name: 'vi', description: 'desc', first_mes: '【主页】\n\n<VariableInsert>\n' + JSON.stringify(tree, null, 2) + '\n</VariableInsert>' },
+  }
+}
+
+console.log('\n[5] <VariableInsert> 卡能建出变量表')
+// readPngCard takes a *path*, so the synthetic card has to touch disk. It is
+// written to a temp dir and removed again so the test stays self-contained.
+function buildPngFile(cardObj) {
+  const file = path.join(os.tmpdir(), 'dsh-muv-table-' + process.pid + '-' + Math.random().toString(36).slice(2) + '.png')
+  writeFileSync(file, buildPng(cardObj))
+  return file
+}
+const viFile = buildPngFile(variableInsertCard())
+let viParsed = { schemas: [], initvarData: {} }
+try {
+  const viCard = readPngCard(viFile)
+  check('PNG 里的 VariableInsert 卡读得出来', !!viCard && viCard.data.name === 'vi')
+  viParsed = parseMuvCard(viCard)
+} finally {
+  rmSync(viFile, { force: true })
+}
+check('schemas 非空', viParsed.schemas.length > 0, 'schemas=' + viParsed.schemas.length)
+const viKeys = viParsed.schemas.map(s => s.name)
+check('顶层键齐全', TOP_LEVEL_KEYS.every(k => viKeys.includes(k)),
+  '缺: ' + TOP_LEVEL_KEYS.filter(k => !viKeys.includes(k)).join(','))
+check('initvarData 里有真实变量树', Object.keys(viParsed.initvarData || {}).length === TOP_LEVEL_KEYS.length)
+check('主播档案.$template 不是条目（不渲染假主播）', !viKeys.includes('$template'))
+const viAnchor = viParsed.schemas.find(s => s.name === '主播档案')
+check('主播档案 下是真实主播而不是 $template',
+  !!viAnchor && (viAnchor.children || []).some(c => c.name === '超天酱')
+    && !(viAnchor.children || []).some(c => c.name === '$template'),
+  'children=' + (viAnchor ? (viAnchor.children || []).map(c => c.name).join(',') : 'n/a'))
+check('数值是 number 不是 string',
+  JSON.stringify(viParsed.schemas.find(s => s.name === '公司')?.children?.find(c => c.name === '总现金'))
+    .includes('"type":"number"'))
+
+console.log('\n[6] <VariableInsert> 兜底不能踩到别的东西')
+const nativeCard = {
+  data: {
+    name: 'native',
+    alternate_greetings: ['<initvar>\n名字: 原生\n年龄: 3\n</initvar>'],
+    first_mes: '<VariableInsert>{"不该被用":1}</VariableInsert>',
+  },
+}
+const nativeParsed = parseMuvCard(nativeCard)
+check('有 <initvar> 时不走 VariableInsert', Object.keys(nativeParsed.initvarData).join(',') === '名字,年龄',
+  Object.keys(nativeParsed.initvarData).join(','))
+const initvarInFirstMes = parseMuvCard({
+  data: { name: 'x', first_mes: '<initvar>\n名字: 开头问候里\n</initvar>' },
+})
+check('first_mes 里的 <initvar> 也认', Object.keys(initvarInFirstMes.initvarData).join(',') === '名字',
+  Object.keys(initvarInFirstMes.initvarData).join(','))
+const badJson = parseMuvCard({
+  data: { name: 'y', first_mes: '<VariableInsert>不是 JSON {</VariableInsert>', description: '' },
+})
+check('VariableInsert 不是 JSON 时返回空表而不抛异常', badJson.schemas.length === 0 && badJson.initvarData != null)
+const noVars = parseMuvCard({ data: { name: 'z', first_mes: '普通问候' } })
+check('没有变量块的卡照样返回有效结构', noVars.schemas.length === 0 && typeof noVars.initvarData === 'object')
+
+console.log('\n[7] 真实卡：_足控天堂2（存在才测）')
+const target = dirs.map(d => path.join(d, '_足控天堂2.png')).find(p => existsSync(p))
+if (!target) {
+  console.log('  SKIP 未找到 _足控天堂2.png')
+} else {
+  const real = readPngCard(target)
+  const realParsed = parseMuvCard(real)
+  check('schemas 不为空', realParsed.schemas.length > 0, 'schemas=' + realParsed.schemas.length)
+  const keys = realParsed.schemas.map(s => s.name)
+  check('顶层键含 ' + TOP_LEVEL_KEYS.join('/'),
+    TOP_LEVEL_KEYS.every(k => keys.includes(k)),
+    '缺: ' + TOP_LEVEL_KEYS.filter(k => !keys.includes(k)).join(','))
+  check('initvarData 有真实变量树', Object.keys(realParsed.initvarData || {}).length === TOP_LEVEL_KEYS.length,
+    'keys=' + Object.keys(realParsed.initvarData || {}).join(','))
+  const star = realParsed.schemas.find(s => s.name === '主播档案')
+  check('主播档案 下是 超天酱', !!star && (star.children || []).some(c => c.name === '超天酱'),
+    'children=' + (star ? (star.children || []).map(c => c.name).join(',') : 'n/a'))
+  check('超天酱 的 数值.压力值 可编辑', !!star
+    && !!star.children.find(c => c.name === '超天酱')?.children?.find(c => c.name === '数值')?.children?.some(c => c.name === '压力值'))
+}
+
 console.log(`\n=== 结果: ${pass} 通过, ${fail} 失败 ===`)
 process.exit(fail ? 1 : 0)