cardbuddy 0.14.2 → 0.15.0

package/dist/vendored/skills/dsl-card-generator/scripts/lint_card.mjs

@@ -22,6 +22,9 @@
  *   12. 切图命名语义化（r59）：引用名沿用设计稿图层名/导出目录前缀/中文名 → 看不出用途，必须按功能重命名。
  *   13. 切图同内容重复（r60）：src/slices 里存在 sha256 完全相同的副本 → 应复用同一份，不重复导入/上传。
  *   14. 静态文案 / 字典默认值含疑似运行期数字（r61，提醒级）：千分号数字 / ¥+数字 / 数字+单位词写死在静态 Text 或 defaultValue 里 → 提示按 rules.md §十四 做 AI 语义复核（运行期数字应抽变量 + 表达式拼接）；固定话术误报可忽略。
+ *   15. 切图引用含 URL 保留字符（r31b）：`# ? % & +` 会被浏览器当 fragment/query 截掉 → 图片静默不显示（R31 的补充，R31 只拦空格）。
+ *   16. 横向流父容器里的容器子节点未写 rect.width + flexShrink:0（r22b）：渲染器按 component-meta 默认「100%」出 → 吃掉整行，同排兄弟被压成 0 宽或被顶出卡外。
+ *   17. 切图引用在 src/slices 里没有对应文件（r31c）：渲染时 404，图片位置空白且控制台零报错 —— R31（空格）/R31b（保留字符）之外的第三种「引用与磁盘名不同源」。
  *
  * 用法：
  *   node lint_card.mjs --id <cardId>              # 体检单张卡
@@ -39,7 +42,8 @@ import path from 'node:path'
 
 import { fileURLToPath } from 'node:url'
 import { cardsDir, cardSchemaPath, cardDataPath, readJson, metaDir, slicesDir } from './lib/paths.mjs'
-import { buildContentIndex, checkSliceName, collectSliceRefStrings, duplicatePeers, sliceNameFromRef } from './lib/slice_dedupe.mjs'
+import { buildContentIndex, buildSliceFileIndex, checkSliceName, collectSliceRefStrings, duplicatePeers, findUrlReservedChars, isRemoteSliceRef, resolveSliceRefOnDisk, sliceNameFromRef } from './lib/slice_dedupe.mjs'
+import { collectRowChildNoWidth } from './lib/layout_rules.mjs'
 
 // src/slices 内容索引（sha256 → 文件名）进程内只建一次，--all 体检全量卡时复用
 let SLICE_CONTENT_INDEX = null
@@ -308,7 +312,7 @@ export function lint(schema, data) {
     out.push({
       severity: 'error',
       code: 'r43-card-transparent-background',
-      message: `卡片背景透明 —— 卡片背景不允许透明（R43）。须从设计稿标注 cardFill 取背景色写入 Root/首层容器的 background.backgroundColor + backgroundType:"01"；标注缺失时从聚焦截图取色兜底。`,
+      message: `卡片背景完全透明 —— 卡片背景不允许无背景/全透明（R43；半透明底色合法）。须从设计稿标注 cardFill 取背景色（可含 alpha）写入 Root/首层容器的 background.backgroundColor + backgroundType:"01"；标注缺失时从聚焦截图取色兜底。`,
     })
   }
 
@@ -450,6 +454,12 @@ export function lint(schema, data) {
     return sc ? String(sc.itemValue) : null
   }
 
+  /** '311' / '311px' → 311；'100%' / 'auto' / 空 → null（比例宽无法静态判定溢出） */
+  function toPx(v) {
+    const m = /^(-?\d+(?:\.\d+)?)(?:px)?$/.exec(String(v ?? '').trim())
+    return m ? Number(m[1]) : null
+  }
+
   function getWidthVal(n) {
     const sp = (n.style && n.style.properties) || []
     const rg = sp.find(p => p.itemKey === 'rect')
@@ -472,11 +482,21 @@ export function lint(schema, data) {
       const hasVShow = (child) => ((child.directives) || []).some((d) => d && d.itemKey === 'v-show')
       const isExclusiveVariantGroup = children.length >= 2 && children.every(hasVShow)
       if (!isContentSize && allShrinkZero && !isExclusiveVariantGroup) {
+        // 真实溢出 vs 稳健性提示：只有「子节点显式定宽之和 > 父容器定宽」才真的会溢出。
+        // 其余情形（父容器按比例定宽 + 子节点内容自适应 / 百分比配比）当前渲染不会溢出，
+        // 报 error 会把模型逼去改结构换宽度 —— 实测（2026-09-21 demo 建卡回合）模型为消除这条
+        // error 把 Row 改成 width:auto，match 从 87.5% 掉到 62%，再改回来，来回震荡 40+ 步。
+        // 规则的本意是「防溢出」，不是「禁止定宽子节点」：降为 warning，信号不丢、门禁不再被它卡死。
+        const parentPx = toPx(parentWidth)
+        const fixedSum = children.reduce((a, c) => a + (toPx(getWidthVal(c)) || 0), 0)
+        const realOverflow = parentPx != null && fixedSum > parentPx
         out.push({
-          severity: 'error',
+          severity: realOverflow ? 'error' : 'warn',
           code: 'r35-multi-child-all-shrink0',
           componentId: pid,
-          message: `${pcls} "${pid}" 宽度非 auto 且 ${children.length} 个并列子节点全部 flexShrink:0 → 外容器宽度变化时定宽累加溢出（R35）。至少一个子节点应保持 flexShrink:1 可压缩；内容自适应容器（width:auto）可保留固定子元素`,
+          message: realOverflow
+            ? `${pcls} "${pid}" 定宽 ${parentPx}px 装不下 ${children.length} 个子节点的定宽之和 ${fixedSum}px（全部 flexShrink:0，压不动）→ 真溢出（R35）。把最宽的那个子节点改成 flexShrink:1，或按设计稿把父容器改宽/改 auto`
+            : `${pcls} "${pid}" 宽度非 auto 且 ${children.length} 个并列子节点全部 flexShrink:0 —— 当前宽度下不会溢出（子节点定宽之和 ${fixedSum}px${parentPx != null ? ` ≤ 父 ${parentPx}px` : '，父容器按比例定宽'}），仅稳健性提示：想消除就给最宽的子节点 flexShrink:1（不溢出时视觉零影响），**不要为此改 width:auto 或删节点**`,
         })
       }
     }
@@ -500,6 +520,76 @@ export function lint(schema, data) {
     }
   })
 
+  // ── R31b: 切图引用含 URL 保留字符（# ? % & +）→ 浏览器截断请求 → 图片静默不显示 ──
+  //  事故（2026-09-21 demo/helloCard）：引用 `/slices/警示-#999.png`，`#` 之后被当 fragment，
+  //  实际只请求到 `/slices/警示-`；又因切图未命中落到 SPA 兜底返回 200+HTML ⇒ 图空白、网络面板 200、
+  //  零报错、门禁全绿。R31 只拦空格，这里补上真正的元凶（保留字符）。
+  walk(view, (n) => {
+    if (n.className !== 'Image') return
+    for (const p of n.properties || []) {
+      if (p.itemKey !== 'value' || typeof p.itemValue !== 'string') continue
+      if (!p.itemValue.includes('/slices/')) continue
+      const hit = findUrlReservedChars(sliceNameFromRef(p.itemValue))
+      if (hit) {
+        out.push({
+          severity: 'error',
+          code: 'r31b-slice-url-reserved-char',
+          componentId: n.componentId || '',
+          message: `Image "${n.componentId}" 引用路径含 URL 保留字符 ${hit.map((c) => `"${c}"`).join(' ')}: "${p.itemValue}" → 浏览器会把保留字符之后当 fragment/query 截掉，请求的不是这个文件 → background-image 加载失败，且**不报错**（R31b）。把切图重命名为纯 ASCII 无语义字符名（如 iconWarning@2x.png）并同步改写引用`,
+        })
+      }
+    }
+  })
+
+  // ── R31b（兜底）：style 背景图 / 表达式里内嵌的 /slices/ 引用同样要查（R31 只扫 Image.value）──
+  for (const ref of collectSliceRefStrings(schema)) {
+    const name = sliceNameFromRef(ref)
+    const hit = findUrlReservedChars(name)
+    if (!hit) continue
+    // Image.value 已被上面那条覆盖，避免同一处报两条
+    const already = out.some((f) => f.code === 'r31b-slice-url-reserved-char' && f.message.includes(`"${ref}"`))
+    if (already) continue
+    out.push({
+      severity: 'error',
+      code: 'r31b-slice-url-reserved-char',
+      componentId: '',
+      message: `切图引用含 URL 保留字符 ${hit.map((c) => `"${c}"`).join(' ')}: "${ref}" → 浏览器截断请求，图片会静默不显示（R31b）。重命名切图为纯 ASCII 名并同步改写引用`,
+    })
+  }
+
+  // ── R31c: 引用的切图在工程 src/slices 里根本不存在 → 渲染 404 → 图片空白（R31 家族的第三种）──
+  //  R31 拦「名字带空格」、R31b 拦「名字带 URL 保留字符」，都是「名字写了但用不了」；
+  //  R31c 补「这个名字在磁盘上就没有」。2026-09-21 helloCard 同源事故：
+  //  审计报 `警示-#999.png`、落盘被消毒成 `警示-999.png`，引用与磁盘名不同源 ⇒ 请求 404，
+  //  而切片服务先前会落 SPA 兜底返回 200+HTML ⇒ 图空白、网络面板 200、零报错、门禁全绿。
+  //  远端引用（@filestore / http / data:）天然无本地文件，不参与判定。
+  if (fs.existsSync(slicesDir)) {
+    const sliceIndex = buildSliceFileIndex(slicesDir)
+    for (const ref of collectSliceRefStrings(schema)) {
+      if (isRemoteSliceRef(ref)) continue
+      const { resolved, name } = resolveSliceRefOnDisk(sliceIndex, ref)
+      if (resolved) continue
+      out.push({
+        severity: 'error',
+        code: 'r31c-slice-ref-missing-file',
+        componentId: '',
+        message: `切图引用 "${ref}" 在 src/slices 里不存在（期望文件名 ${name}）→ 渲染时 404，图片位置一片空白且控制台不报错（R31c）。两条修法：① 把切图按引用名落盘（\`crop_slices.mjs --from-audit\` 会自动收养审计判定存在的资产并按消毒名落盘）；② 把引用改成磁盘上真实存在的文件名 —— 两者必须同源，别只改一边`,
+      })
+    }
+  }
+
+  // ── R22b: 横向流父容器里的容器子节点「未写 rect.width + flexShrink:0」→ 吃掉整行 ──
+  //  渲染契约：容器不写 rect.width ⇒ 落到 component-meta 默认 "100%" ⇒ 独占整行；再叠 flexShrink:0
+  //  就是锁死不让位。R22 只拦「显式写 width:"100%"」那一半，**不写 width**（渲染等价）完全没人管。
+  for (const hit of collectRowChildNoWidth(view)) {
+    out.push({
+      severity: 'error',
+      code: 'r22b-row-child-container-no-width',
+      componentId: hit.componentId,
+      message: hit.message,
+    })
+  }
+
   // ── R59/R60: 切图语义化命名 + 同内容去重（slices_convention.md §1.1 / §3.1）──
   for (const ref of collectSliceRefStrings(schema)) {
     const name = sliceNameFromRef(ref)
@@ -604,6 +694,17 @@ export function lint(schema, data) {
           message: `Image "${n.componentId}" itemValueFrom="1"(变量) 但值不以 $ 开头 → 表达式求值失败，空白（R25）`,
         })
       }
+      if (from === '2' && val.startsWith('$')) {
+        out.push({
+          severity: 'error',
+          code: 'r25-image-from-2',
+          componentId: n.componentId || '',
+          message:
+            `Image "${n.componentId}" itemValueFrom="2"(图片/文件值) 但值是表达式 "${val}" → ` +
+            `运行时对 "2" 是原样透传（property.js onPreview），该字符串直接进 background-image:url(${val})，` +
+            `画布必然空白（R25）。变量绑定必须改 "1"`,
+        })
+      }
     }
   })
 
@@ -762,6 +863,66 @@ export function lint(schema, data) {
   })
 
 
+  /* ── R63: width:100% 撞水平 margin —— 交叉轴定宽不可缩，节点被推出父容器右缘 ────────
+   * 渲染器语义（vendor/preview 的 StyleParser + adapter.doSize）："100%" 原样透传成 width:100%，
+   * 而 width:100% 已经等于**父容器内容盒**宽度；水平 margin 再叠加 = 元素外框超出父容器 → 向右溢出、
+   * 被 overflow:hidden 裁掉（Root / 组件默认 hidden）。实测事故：模型把「父容器水平内缩」写成
+   * 「子节点 width:100% + marginLeft/Right」，节点右侧一整块内容消失。
+   *
+   * 为什么只报交叉轴（父容器按列排布）：
+   *   主轴（父容器 flex-direction:row）里 flexShrink 默认 1，会把这个节点缩回可用宽 —— margin 被吸收，
+   *   不溢出；只有交叉轴（column：Root / Column / SingleColumn / flexDirection:"column" /
+   *   AbsoluteLayout 的 abspos 子节点——定宽对定位包含块解析、无 shrink 参与）才是**必溢出**。
+   *   实测：全仓 205 份 schema 里 4 处「width:100% + marginLeft」全在 Row 父容器（accountCreditedlist /
+   *   memberLevelNone / pointsDetail / assetOverview），全靠 shrink 吃掉间距——故本规则不报主轴，零误报。
+   */
+  const laysOutVertically = (parent) => {
+    if (!parent) return false
+    // AbsoluteLayout 子节点是 position:absolute 脱标：100% 对定位包含块（容器 padding box）取宽，
+    // margin 不参与任何收缩 → 与 column 同款必溢出。
+    if (parent.className === 'AbsoluteLayout') return true
+    const explicit = flexSub(parent, 'flexDirection')
+    if (explicit) return explicit === 'column' // 显式 flexDirection（内联样式）覆盖 CSS 类的默认方向
+    return COLUMN_FLOW.has(parent.className)
+  }
+  walk(view, (n, parent) => {
+    if (!parent) return
+    const cid = n.componentId || ''
+    const styleProps = (n.style && n.style.properties) || []
+    const rectGroup = styleProps.find((p) => p.itemKey === 'rect')
+    const widthChild = ((rectGroup && rectGroup.itemChildren && rectGroup.itemChildren.properties) || [])
+      .find((c) => c.itemKey === 'width')
+    if (!widthChild || String(widthChild.itemValue ?? '').trim() !== '100%') return
+    if (String(widthChild.itemValueFrom ?? '0') === '1') return // 表达式绑定（值不是字面 100%）
+    const marginGroup = styleProps.find((p) => p.itemKey === 'margin')
+    const marginChildren = (marginGroup && marginGroup.itemChildren && marginGroup.itemChildren.properties) || []
+    const constNum = (key) => {
+      const c = marginChildren.find((x) => x.itemKey === key)
+      if (!c || String(c.itemValueFrom ?? '0') === '1') return null // 表达式绑定：值不定，不判
+      const v = parseFloat(String(c.itemValue).replace(/[^0-9.\-]/g, ''))
+      return Number.isFinite(v) ? v : null
+    }
+    const mtype = String((marginChildren.find((c) => c.itemKey === 'marginType') || {}).itemValue ?? '')
+    const hmargin = []
+    if (mtype === '1') { // 逐边模式：只看左右
+      const ml = constNum('marginLeft')
+      const mr = constNum('marginRight')
+      if (ml !== null && ml > 0) hmargin.push(`marginLeft:${ml}`)
+      if (mr !== null && mr > 0) hmargin.push(`marginRight:${mr}`)
+    } else if (mtype === '0') { // 全边模式：margin 四边同值，左右也吃
+      const m = constNum('margin')
+      if (m !== null && m > 0) hmargin.push(`margin(全边):${m}`)
+    }
+    if (!hmargin.length || !laysOutVertically(parent)) return
+    out.push({
+      severity: 'error',
+      code: 'r63-width100-with-hmargin',
+      componentId: cid,
+      message: `${n.className} "${cid}" 同时写了 rect.width:"100%" 与水平 margin（${hmargin.join(' / ')}）—— width:100% 已经等于父容器内容宽，水平 margin 只会把节点推出父容器右缘（父容器 ${parent.className} 按列排布，水平方向是交叉轴，flexShrink 救不回来）→ 右侧内容被 overflow:hidden 裁掉（R63）。正路：① 水平间距挪到父容器 paddingLeft/Right（或由父容器 gap 承担）；② 流式父容器（Column/Root，alignItems 为空或 stretch）把 rect.width 由 "100%" 改 "auto"（显式写 auto；Text/MultiText 有组件样式 width:fit-content，只删 width 不会撑满，实测 86.67px vs 369px），靠 stretch 补宽、保留 margin（AbsoluteLayout 的 abspos 子节点 width:auto 是 fit-content、无 stretch —— 走 ① 或改显式像素宽）；③ 并排分栏用「左 width:100%+flexShrink:1，右 auto+flexShrink:0」`,
+    })
+  })
+
+
   // ── 格式铁律：值格式校验（生成器最常犯的格式错误） ──
 
   // R-FMT1: borderRadius 值不得用元组格式 {a,b,c,d}（应为标量 "12" 或单独角 borderTopLeftRadius 等）
@@ -833,6 +994,55 @@ export function lint(schema, data) {
     }
   })
 
+  // R64: 装饰条不得靠流式布局定位 —— 「标题+下划线」没按范式做的形态。
+  // 为什么单开一条：R42 只在「已经是 AbsoluteLayout」的节点上校验，用流式堆叠的写法可以整条绕过它；
+  // R38 又只禁**负** margin，模型改用**正** marginTop 造间隙，形式上完全合规。实测（2026-09-21
+  // transferRecord）Column > [Text, Row 42x5 marginTop:3] 的卡 lint 报 0 error / 0 warning，
+  // 而设计稿是 68x8 的条子压在标题底部（band 底对齐）——结构、尺寸、重叠关系、位置四处都不对，
+  // 装饰条还占掉 8px 流式高度把兄弟节点整体下推。
+  // 判定：流式容器里紧跟 Text 之后、有实色背景、高 ≤10、宽为像素或 `$变量.length * 字号` 的 Row
+  // （即「本应绝对定位的装饰条」）。已带 position 的（复用了范式）与 Divider 一律放过。
+  walk(view, (n) => {
+    if (n.className === 'AbsoluteLayout') return
+    const kids = directChildren(n)
+    if (kids.length < 2) return
+    for (let i = 1; i < kids.length; i += 1) {
+      const bar = kids[i]
+      const prev = kids[i - 1]
+      if (!bar || !prev || bar.className !== 'Row' || prev.className !== 'Text') continue
+      const child = (node, groupKey, childKey) => {
+        const g = (node.style?.properties || []).find((x) => x.itemKey === groupKey)
+        const c = (g?.itemChildren?.properties || []).find((x) => x.itemKey === childKey)
+        return c ? c.itemValue : ''
+      }
+      const bgType = child(bar, 'background', 'backgroundType')
+      const bgColor = child(bar, 'background', 'backgroundColor')
+      if (String(bgType) !== '01' || !bgColor) continue
+      const barHeight = Number(child(bar, 'rect', 'height'))
+      if (!(barHeight > 0 && barHeight <= 10)) continue
+      const barWidth = String(child(bar, 'rect', 'width') || '')
+      const pixelOrExpr = /^\d+(\.\d+)?$/.test(barWidth.trim()) || /\.length \*/.test(barWidth)
+      if (!pixelOrExpr) continue
+      const posTop = child(bar, 'position', 'top')
+      const posLeft = child(bar, 'position', 'left')
+      if (String(posTop).trim() || String(posLeft).trim()) continue
+      const cid = bar.componentId || '(no id)'
+      // 标题文案：常量在 text.text，变量绑定在 properties[].value（如 $title）——拿不到就退回节点 id
+      const boundValue = (prev.properties || []).find((x) => x.itemKey === 'value')?.itemValue
+      const title = String(child(prev, 'text', 'text') || boundValue || prev.componentId || '标题')
+      out.push({
+        severity: 'error',
+        code: 'r64-title-underline-flow',
+        componentId: cid,
+        message: `Row "${cid}"（高 ${barHeight} / 宽 ${barWidth}）是标题「${title}」的装饰条，却排在流式布局里 —— `
+          + `它会占掉流式高度把后续兄弟整体下推，且拿不到设计稿的「条子压在标题底部」的重叠关系。`
+          + `必须复用 title-underline-overlay 范式：父容器改 AbsoluteLayout(align:"BottomLeft", rect.height=标题行高)，`
+          + `装饰条与标题各自设 style.position.left/top（条 top = 标注条.y − 标注标题.y，不是公式推算），`
+          + `子节点顺序 [装饰条, 标题]。IR 可照抄 references/ir-format.md §2d（脚本 expand_ir.mjs --ir 展开，禁正/负 margin 顶位）。`,
+      })
+    }
+  })
+
   // R44: 类型+值成对检查 —— 有值但缺类型开关的样式组（borderRadius/border/shadow）→ ERROR
   walk(view, (n) => {
     const cid = n.componentId || '(root)'

package/dist/vendored/skills/dsl-card-generator/scripts/preflight.mjs

@@ -2,10 +2,11 @@
 /**
  * preflight.mjs — 生成前/后一键机械检查（替代 AI 手动过 Pre-flight Checklist）。
  *
- * 检查项（对应 quickref.md Pre-flight Checklist 12 条中可机械化的 10 条）：
+ * 检查项（对应 quickref.md Pre-flight Checklist 12 条中可机械化的 13 条）：
  *   1. 元素清单：spec text/slice/shape 数 vs schema 节点数（R29）
  *   2. 组件白名单：className ∈ component-meta.json（R28）
- *   3. Image itemValueFrom：静态路径必须 "2"，变量 "1"（R25）
+ *   3. Image itemValueFrom：静态路径必须 "2"，变量 "1"（双向都拦：`"0"` 常量放路径、
+ *      `"1"` 变量放非 `$` 值、`"2"` 图片槽放 `$` 表达式——末者会被原样透传成 url($icon)）（R25）
  *   4. Image rect.height：必须有显式高度（R32，否则被 aspect-ratio:16/9 压缩）
  *   5. 切图文件名：含空格/特殊字符必须重命名（R31）
  *   6. Icon eventaction：嵌套格式 event.eventKey（R30）
@@ -13,6 +14,10 @@
  *   8. 分割线用 Divider：禁止 Row 模拟分割线（R28）
  *   9. 卡片根样式全量提取：bg shape 有 border 但 schema 根容器未设（R33）
  *  10. 空样式 itemId：style 子项 itemId 为空串 → 运行时静默丢弃
+ *  11. 切图引用含 URL 保留字符（`# ? % & +`）→ 浏览器截断请求、图片静默不显示（R31b）
+ *  12. 横向流父容器里的容器子节点未写 rect.width + flexShrink:0 → 默认 100% 吃掉整行（R22b）
+ *  13. 切图引用在 src/slices 里没有对应文件 → 渲染 404、图空白零报错（R31c）
+ *      —— 11/12/13 与 lint_card.mjs 共用 lib/layout_rules.mjs 与 lib/slice_dedupe.mjs，避免双写漂移。
  *
  * 用法：
  *   node preflight.mjs --spec UI/<画板>/spec.json --id <卡id>
@@ -24,6 +29,8 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import { metaDir, cardsDir, slicesDir } from './lib/paths.mjs'
+import { buildSliceFileIndex, collectSliceRefStrings, findUrlReservedChars, isRemoteSliceRef, resolveSliceRefOnDisk, sliceNameFromRef } from './lib/slice_dedupe.mjs'
+import { collectRowChildNoWidth } from './lib/layout_rules.mjs'
 
 /* ── args ── */
 const args = {}
@@ -125,6 +132,13 @@ for (const n of allNodes.filter(n => n.className === 'Image')) {
   if (from === '1' && !val.startsWith('$')) {
     check('r25-image-from-1', 'error', `Image "${n.componentId}" itemValueFrom="1"(变量) 但值不以 $ 开头 → 表达式求值失败，空白（R25）`)
   }
+  if (from === '2' && val.startsWith('$')) {
+    check(
+      'r25-image-from-2',
+      'error',
+      `Image "${n.componentId}" itemValueFrom="2"(图片/文件值) 但值是表达式 "${val}" → 运行时对 "2" 是**原样透传**（property.js onPreview），该字符串会直接进 background-image:url(${val})，画布必然空白（R25）。变量绑定必须改 "1"`,
+    )
+  }
 }
 
 /* ══ Check 4: Image rect.height (R32) ══ */
@@ -227,6 +241,38 @@ for (const n of allNodes) {
   }
 }
 
+/* ══ Check 11: Slice refs with URL reserved chars (R31b) ══
+ * `#` 之后被当 fragment，浏览器根本不发这部分（实测 /slices/警示-#999.png → 请求 /slices/警示-）。
+ * 未命中时静态中间件返回 HTML 兜底（旧行为 200）⇒ 图空白、网络面板 200、零报错。 */
+for (const ref of collectSliceRefStrings(schema)) {
+  const hit = findUrlReservedChars(sliceNameFromRef(ref))
+  if (hit) {
+    check('r31b-slice-url-reserved-char', 'error', `切图引用含 URL 保留字符 ${hit.map((c) => `"${c}"`).join(' ')}: "${ref}" → 浏览器会截断请求，图片静默不显示（R31b）。重命名切图为纯 ASCII 名并同步改写引用`)
+  }
+}
+
+/* ══ Check 12: Row-child container without rect.width + flexShrink:0 (R22b) ══ */
+for (const hit of collectRowChildNoWidth(schema.view)) {
+  check('r22b-row-child-container-no-width', 'error', hit.message, `${hit.className} ${hit.componentId} ← ${hit.parentClass} ${hit.parentId}（${hit.siblingCount} 个并列子节点）`)
+}
+
+/* ══ Check 13: Slice ref target missing on disk (R31c) ══
+ * 审计给了正确的名字、但文件还在 bundle 里没落进 src/slices ⇒ 引用 404、图空白、零报错。
+ * 这一条把「引用名 ↔ 磁盘名同源」变成每轮迭代都能看到的硬约束。 */
+{
+  const sliceIndex = buildSliceFileIndex(slicesDir)
+  for (const ref of collectSliceRefStrings(schema)) {
+    if (isRemoteSliceRef(ref)) continue
+    const { resolved, name } = resolveSliceRefOnDisk(sliceIndex, ref)
+    if (resolved) continue
+    check(
+      'r31c-slice-ref-missing-file',
+      'error',
+      `切图引用 "${ref}" 在 src/slices 里不存在（期望文件名 ${name}）→ 渲染时 404，图片位置一片空白且控制台不报错（R31c）。把切图按引用名落盘（crop_slices.mjs --from-audit 会收养审计判定存在的资产），或把引用改成磁盘上真实存在的文件名 —— 两者必须同源`,
+    )
+  }
+}
+
 /* ── Output ── */
 const errors = results.filter(r => r.severity === 'error')
 const warns = results.filter(r => r.severity === 'warn')

package/dist/vendored/skills/dsl-card-generator/scripts/render_card.mjs

@@ -463,6 +463,75 @@ function describeRuntimeEvents(events) {
   }).filter(Boolean).slice(-20).join(' | ')
 }
 
+/**
+ * 抓取 `.phone__screen` 内全部 `[data-cid]` 元素的几何与文本度量。
+ *
+ * 返回 `{ elements, degenerate }`：
+ *  - `elements`：正常尺寸节点（≥1px），供评分 / 归因 / 设计稿配对使用；
+ *  - `degenerate`：**被压成零尺寸但仍参与布局**的节点（display:none / visibility:hidden 的
+ *    v-show 变体已剔除）。旧实现把它们直接丢掉，于是「被兄弟挤成 0 宽 → 文本每字一行 →
+ *    高度爆炸」这类最致命的缺陷在度量里根本不存在，模型只能靠猜。
+ *
+ * 冷路径与热路径（keep-alive 复用页面）都必须调用，否则 keep-alive 模式下 elementBoxes 恒为空。
+ */
+async function extractElementBoxes(cdp) {
+  const elRes = await cdp.send('Runtime.evaluate', {
+    expression: `(function(){
+      var scr = document.querySelector('.phone__screen');
+      if (!scr) return JSON.stringify({ elements: [], degenerate: [] });
+      var sr = scr.getBoundingClientRect();
+      var els = scr.querySelectorAll('[data-cid]');
+      var out = [];
+      var degenerate = [];
+      els.forEach(function(el) {
+        var r = el.getBoundingClientRect();
+        var cs = window.getComputedStyle(el);
+        var fs = parseFloat(cs.fontSize) || 0;
+        var lhRaw = cs.lineHeight;
+        // lineHeight 供几何审计判「文本被折了几行」（h / lh > 2 即 3 行以上）；
+        // 'normal' 时拿不到像素值，取 0 表示未知（调用方据此跳过该判定，不猜）。
+        var lh = (lhRaw && lhRaw !== 'normal') ? (parseFloat(lhRaw) || 0) : 0;
+        var text = (el.textContent || '').trim();
+        // Input 类组件的占位文本在内部 <input placeholder> 属性上，textContent 为空；
+        // 评分/位置配对需要把它当作可见文本捕获（否则占位行被误判为文本缺失）。
+        if (!text) {
+          var innerInput = (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') ? el : el.querySelector('input,textarea');
+          if (innerInput) text = (innerInput.getAttribute('placeholder') || innerInput.value || '').trim();
+        }
+        var rec = {
+          cid: el.getAttribute('data-cid') || '',
+          cls: el.getAttribute('data-class') || '',
+          text: text.slice(0, 60),
+          x: Math.round((r.left - sr.left) * 100) / 100,
+          y: Math.round((r.top - sr.top) * 100) / 100,
+          w: Math.round(r.width * 100) / 100,
+          h: Math.round(r.height * 100) / 100,
+          fs: Math.round(fs * 100) / 100,
+          lh: Math.round(lh * 100) / 100,
+          color: cs.color || '',
+          scrollH: el.scrollHeight || 0,
+          clientH: el.clientHeight || 0,
+        };
+        if (r.width < 1 || r.height < 1) {
+          // display:none / visibility:hidden 是**有意隐藏**（v-show 变体），不算缺陷
+          if (cs.display === 'none' || cs.visibility === 'hidden') return;
+          degenerate.push(rec);
+          return;
+        }
+        out.push(rec);
+      });
+      return JSON.stringify({ elements: out, degenerate: degenerate });
+    })()`,
+    returnByValue: true,
+  })
+  const raw = elRes?.result?.value
+  if (!raw) return null
+  const parsed = JSON.parse(raw)
+  // 兼容旧形态（纯数组，无 degenerate）
+  if (Array.isArray(parsed)) return { elements: parsed, degenerate: [] }
+  return { elements: Array.isArray(parsed.elements) ? parsed.elements : [], degenerate: Array.isArray(parsed.degenerate) ? parsed.degenerate : [] }
+}
+
 /* ------------------------------------------------------------------ */
 /* 可复用渲染会话                                                       */
 /* ------------------------------------------------------------------ */
@@ -507,6 +576,11 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
   } catch {}
   let closed = false
   let pageReady = false
+  // 热路径只允许「同一张卡」复用：热更新靠 history.replaceState 改 URL 再调 window.__bootCard()，
+  // 而 __bootCard 取卡片 id 的时机/来源不由本脚本控制。实测（2026-09-21）：一个会话里连续
+  // 渲染 8 张不同的卡，全部返回**第一张**的度量（8 张高度全 = 341px）——静默错卡。
+  // 一旦接上几何门禁，错卡等于给出错误结论，故用 id 白名单把热路径钉死在同卡重渲染上。
+  let lastRenderedId = null
 
   async function render({
     id,
@@ -537,8 +611,8 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
         deviceScaleFactor: 1,
         mobile: false,
       })
-      // 热更新路径：同会话内已渲染过该页时，通过 fetch 刷新卡片数据 + 重新触发 boot，跳过整页导航
-      if (hotReload && pageReady) {
+      // 热更新路径：同会话内**同一张卡**已渲染过时，通过 history.replaceState + 重新 boot 跳过整页导航
+      if (hotReload && pageReady && id === lastRenderedId) {
         await cdp.send('Emulation.setDeviceMetricsOverride', {
           width: Math.ceil(Number(width)) + 40,
           height: Math.max(2000, Math.ceil(Number(captureHeight || 2000)) + 40),
@@ -571,10 +645,19 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
               captureBeyondViewport: true,
             })
             const buffer2 = Buffer.from(shot2.data, 'base64')
+            // 热路径同样要抓元素度量：keep-alive 模式下每轮 iterate 都走这里，
+            // 漏掉就等于「除了第一轮，模型永远拿不到几何归因」。
+            let hotBoxes = null
+            if (captureElements) {
+              try { hotBoxes = await extractElementBoxes(cdp) } catch { /* best-effort */ }
+            }
+            lastRenderedId = id
             return {
               ok: true, source: 'standalone-hot', id,
               width: Math.round(box2.width), height: Math.round(box2.height),
               base64: buffer2.toString('base64'),
+              elementBoxes: hotBoxes?.elements || undefined,
+              elementBoxesDegenerate: hotBoxes?.degenerate || undefined,
               outFile: outFile ? path.resolve(outFile) : null,
               ms: Math.round(performance.now() - startedAt),
             }
@@ -594,6 +677,7 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
       }).catch(() => {})
       await renderDone
       pageReady = true
+      lastRenderedId = id
       // 截图前等网络静默：冷帧根因（背景图/字体在途时截图）在此闭环
       await waitNetworkIdle(inflight)
       const boxRes = await cdp.send('Runtime.evaluate', {
@@ -618,49 +702,12 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
       })
       const buffer = Buffer.from(shot.data, 'base64')
       let elementBoxes = null
+      let elementBoxesDegenerate = null
       if (captureElements) {
         try {
-          const elRes = await cdp.send('Runtime.evaluate', {
-            expression: `(function(){
-              var scr = document.querySelector('.phone__screen');
-              if (!scr) return JSON.stringify([]);
-              var sr = scr.getBoundingClientRect();
-              var els = scr.querySelectorAll('[data-cid]');
-              var out = [];
-              els.forEach(function(el) {
-                var r = el.getBoundingClientRect();
-                if (r.width < 1 || r.height < 1) return;
-                var cls = el.getAttribute('data-class') || '';
-                var text = (el.textContent || '').trim();
-                // Input 类组件的占位文本在内部 <input placeholder> 属性上，textContent 为空；
-                // 评分/位置配对需要把它当作可见文本捕获（否则占位行被误判为文本缺失）。
-                if (!text) {
-                  // Input.vue 根元素即 <input>：自身优先，其次向后兼容包裹式实现
-                  var innerInput = (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') ? el : el.querySelector('input,textarea');
-                  if (innerInput) text = (innerInput.getAttribute('placeholder') || innerInput.value || '').trim();
-                }
-                var cs = window.getComputedStyle(el);
-                var fs = parseFloat(cs.fontSize) || 0;
-                var color = cs.color || '';
-                out.push({
-                  cid: el.getAttribute('data-cid') || '',
-                  cls: cls,
-                  text: text.slice(0, 60),
-                  x: Math.round((r.left - sr.left) * 100) / 100,
-                  y: Math.round((r.top - sr.top) * 100) / 100,
-                  w: Math.round(r.width * 100) / 100,
-                  h: Math.round(r.height * 100) / 100,
-                  fs: Math.round(fs * 100) / 100,
-                  color: color,
-                  scrollH: el.scrollHeight || 0,
-                  clientH: el.clientHeight || 0,
-                });
-              });
-              return JSON.stringify(out);
-            })()`,
-            returnByValue: true,
-          })
-          if (elRes?.result?.value) elementBoxes = JSON.parse(elRes.result.value)
+          const boxes = await extractElementBoxes(cdp)
+          elementBoxes = boxes?.elements || null
+          elementBoxesDegenerate = boxes?.degenerate || null
         } catch (e) { /* element extraction is best-effort */ }
       }
       const json = {
@@ -670,6 +717,7 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
         height: Math.round(captureHeight ? Math.min(box.height, Number(captureHeight)) : box.height),
         base64: buffer.toString('base64'),
         elementBoxes: elementBoxes,
+        elementBoxesDegenerate: elementBoxesDegenerate,
       }
 
       if (format === 'json') return { ok: true, source: 'standalone', ...json }

package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs

@@ -34,7 +34,7 @@ const SKETCH_SKILL = path.join(hostSkillsDir, 'sketch-spec-to-card')
  * 作为提示文本随 next/note 下发，让判定器输出即带门禁，不依赖模型记住文档。
  */
 const SELECTION_GATE =
-  '# 多画板门禁（rules.md §十三 + §13.4）：用 spec_tree.mjs --list-cards 把全量画板按「画板序号.卡片序号」列出（一个画板含 N 张卡则展开为 K.1 ~ K.N）+ 末尾加「全部」；让用户选的方式 = 正文逐条写清单 + 一句提问后停止输出、等用户回序号再继续（**没有** request_user_input 这个工具，不要去找弹窗，也不要替用户挑）；序号格式「画板序号.卡片序号」（如 1.2），单独回画板序号默认取该画板第 1 张卡；UI 产物可回「全部」全量生成，产卡默认单卡片（回「全部」才算显式批量授权）；禁止自行挑画板或挑卡、禁止擅自批量产卡；清单逐行配图：每个卡片行下紧跟它自己的 card-N.png 绝对路径，同一画板的卡共享画板预览图（artboard.png）但各有聚焦图；与序号一一对应，缺图显式标缺失，禁止把图堆在清单末尾。'
+  '# 多画板门禁（rules.md §十三 + §13.4）：用 spec_tree.mjs --list-cards 把全量画板按「画板序号.卡片序号」列出（一个画板含 N 张卡则展开为 K.1 ~ K.N）+ 末尾加「全部」；让用户选的方式 = 正文逐条写清单 + 一句提问后停止输出、等用户回序号再继续（**没有** request_user_input 这个工具，不要去找弹窗，也不要替用户挑）；序号格式「画板序号.卡片序号」（如 1.2），单独回画板序号默认取该画板第 1 张卡；UI 产物可回「全部」全量生成，产卡默认单卡片（回「全部」才算显式批量授权）；禁止自行挑画板或挑卡、禁止擅自批量产卡；清单逐行配图：每个卡片行下紧跟它自己的 card-N.png 绝对路径，同一画板的卡共享画板预览图（artboard.png）但各有聚焦图；与序号一一对应，缺图显式标缺失，禁止把图堆在清单末尾；路径照抄完整绝对路径——禁止用 … / ... 省略前缀、禁止包进反引号或代码块（缩写的路径渲染端取不到图，用户那几行只剩一串文字）。'
 /**
  * 要素包根目录 UI/ —— **锚在宿主工程根，不锚在脚本自身位置**。
  *
@@ -88,7 +88,7 @@ function readTextCapped(file, cap = 64 * 1024 * 1024) {
   return head.toString('utf8') + tail.toString('utf8')
 }
 
-/** 命令里输出相对 cwd 的短路径，跨盘/越界时退回绝对路径。 */
+/** 命令里输出相对 cwd 的短路径，跨盘/越界时退回绝对路径（分隔符按平台原生形态）。 */
 function shortPath(abs) {
   const rel = path.relative(process.cwd(), abs)
   return rel && !rel.startsWith('..') && !path.isAbsolute(rel) ? rel : abs
@@ -96,7 +96,8 @@ function shortPath(abs) {
 
 function pythonBin() {
   if (process.env.DSL_CARD_PYTHON) return process.env.DSL_CARD_PYTHON
-  for (const bin of ['python3', 'python']) {
+  // py 是 Windows 官方启动器（python3 在 Windows 常是 Store 假别名：能启动、立刻 9009 退出）
+  for (const bin of ['python3', 'python', 'py']) {
     const probe = spawnSync(bin, ['--version'], { stdio: 'ignore' })
     if (probe.status === 0) return bin
   }