cardbuddy 0.16.0 → 0.18.0

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

@@ -1164,6 +1164,140 @@ export function persistReport(result, { sp, dp, irPath, reset = false, design =
   }
 }
 
+/**
+ * 报告摘要：给 stdout（= 模型上下文）用，全文已在 persistReport 里落盘。
+ *
+ * 为什么必须摘要（2026-10-09 实测）：原版 `JSON.stringify(result, null, 2)` 把整份报告灌进上下文，
+ * 单轮 6~15KB，而模型每轮的决策依据只有「gate 过了没有 / match 多少 / 差在哪个节点」。
+ * 体积大头全在它不需要的东西上：
+ *   - `contributors.elements[]`：每个热区逐节点度量（rect/h/hSibling/designH/flags），
+ *     而提示词自己写着「一轮只改 contributors[0].elements[0]」—— 后面的热区本轮根本不看；
+ *   - `elements[]`（--elements 的逐元素实测）、`fidelity.missing[]`/`invented[]` 的全文清单：
+ *     门禁只判 `.length === 0`，逐条文案对「该不该改样式」没有增量信息；
+ *   - `geometry.collapsed[]`/`overWrapped[]` 全文、`lint.warningDetails`、`preflight.details`。
+ * 15 轮迭代 = 9~22 万字符常驻，且每轮都重发（宿主把历史工具结果原样带回）⇒ 上下文斜率被它单独拉高。
+ *
+ * 摘要必须保留的字段（S5 全部决策都基于这些，删一条就会「照着不存在的结论调像素」）：
+ *   ok / gate（含 checks.failed.verdict.stage）/ pixelDiff.match / pixelDiff.size.heightDelta
+ *   / best / stalled / rounds / conclusion / contributors[0] / structuralGaps
+ *   / contentOffset1x+hint / widthMismatch / geometry.counts / 各 errors 计数
+ *   / readiness / diffImage / renderImage / report（全文路径，供 --detail 或 fs_read 取全文）
+ *
+ * 削峰的边界（刻意保留的「第一条 + 计数」）：
+ *   - contributors 只留 [0]，其余热区只报个数；
+ *   - missing / invented / collapsed 等清单只留**前 3 条文本 + 总数**——
+ *     前几条往往就是漏得最刺眼的（最长文案 / 最显眼的标题），模型据此能定位；要看全量有 report 路径。
+ */
+export function summarizeReport(result) {
+  if (!result || typeof result !== 'object') return result
+  // 幂等：已封装的摘要原样放过。宿主侧会对旧版未封装的全量报告做兜底裁剪，
+  // 二次裁剪会把 {total,sample} 当数组处理、把内容清空 —— 这是「封装过就别再动」的硬约束。
+  if (result.summary === true) return result
+  const r = result
+  const pd = r.pixelDiff
+  /**
+   * 清单类字段：留前 3 条 + 总数（不是只留计数 —— 模型要靠具体文案判断漏了什么）。
+   * 容忍两种输入：数组（全量）与 {total,sample}（已封装）—— 后者原样返回。
+   */
+  const list = (arr, map = (x) => x) => {
+    if (arr && !Array.isArray(arr) && typeof arr === 'object') return arr.total != null || arr.sample ? arr : undefined
+    const a = Array.isArray(arr) ? arr : []
+    if (!a.length) return undefined
+    return { total: a.length, sample: a.slice(0, 3).map(map), more: a.length > 3 ? `…另 ${a.length - 3} 条（见 report 全文）` : undefined }
+  }
+
+  const out = {
+    ok: r.ok,
+    cardId: r.cardId,
+    // 全文落盘路径放第一行：模型要看被削掉的内容时有确定入口，不必重跑 --detail
+    report: r.report,
+    conclusion: r.conclusion,
+    rounds: r.rounds,
+    best: r.best,
+    stalled: r.stalled,
+    gate: r.gate,
+    iterationReset: r.iterationReset,
+    appliedSets: r.appliedSets,
+    validate: r.validate
+      ? { errors: r.validate.errors, warnings: r.validate.warnings, envError: r.validate.envError, details: r.validate.details }
+      : undefined,
+    lint: r.lint
+      ? {
+          errors: r.lint.errors,
+          warnings: r.lint.warnings,
+          infos: r.lint.infos,
+          details: r.lint.details,
+          warningDetails: r.lint.warningDetails,
+        }
+      : undefined,
+    preflight: r.preflight
+      ? { errors: r.preflight.errors, details: list(r.preflight.details, (d) => (typeof d === 'string' ? d : d?.message || JSON.stringify(d))) }
+      : undefined,
+    readiness: r.readiness,
+    widthMismatch: r.widthMismatch,
+    contentOffset1x: r.contentOffset1x,
+    contentOffsetHint: r.contentOffsetHint,
+    // 像素主体：只留决策要用的三件（match / 尺寸差 / 热区），inkBox / diffPixels / totalPixels 是中间量
+    pixelDiff: pd
+      ? {
+          match: pd.match,
+          diffRatio: pd.diffRatio,
+          size: pd.size,
+          contentOffset: pd.contentOffset,
+          structuralGaps: pd.structuralGaps,
+          // 热区本身已在 contributors 里归因过，这里只留坐标供「还有哪些区没归因」的自查
+          hotspots: Array.isArray(pd.hotspots) ? pd.hotspots.slice(0, 3) : pd.hotspots,
+          hotspotsTotal: Array.isArray(pd.hotspots) ? pd.hotspots.length : pd.hotspotsTotal,
+        }
+      : undefined,
+    structuralGaps: r.structuralGaps,
+    // 分项归因：只留首条热区（提示词钦定「一轮只改 contributors[0].elements[0]」），其余只报个数
+    contributors: Array.isArray(r.contributors) ? r.contributors.slice(0, 1) : r.contributors,
+    contributorsTotal: Array.isArray(r.contributors) ? r.contributors.length : r.contributorsTotal,
+    contributorsNote: r.contributorsNote,
+    geometry: r.geometry
+      ? {
+          counts: r.geometry.counts,
+          collapsed: list(r.geometry.collapsed),
+          outOfCard: list(r.geometry.outOfCard),
+          overWrapped: r.geometry.counts?.overWrapped != null ? undefined : list(r.geometry.overWrapped),
+        }
+      : undefined,
+    geometryNote: r.geometryNote,
+    fidelity: r.fidelity
+      ? {
+          total: r.fidelity.total,
+          matched: r.fidelity.matched,
+          missing: list(r.fidelity.missing),
+          invented: list(r.fidelity.invented),
+          slices: r.fidelity.slices,
+          symbols: r.fidelity.symbols,
+          shapes: r.fidelity.shapes,
+        }
+      : undefined,
+    render: r.render,
+    designImage: r.designImage,
+    diffImage: r.diffImage,
+    renderImage: r.renderImage,
+    diffImageNote: r.diffImageNote,
+    elapsedMs: r.elapsedMs,
+  }
+  if (r.error || r.message) {
+    out.error = r.error
+    out.message = r.message
+  }
+  // 被削掉的字段名写清楚：模型必须知道「摘要 ≠ 全量」，否则会把「没提到」误读成「不存在」
+  // fs_read 现在支持 offset 续读（尾巴会给下一段起点），所以「读全文」的正解是照着 offset 读到底，
+  // 而不是一遍 fs_read —— 一遍只拿得到一屏。
+  out.summaryNote =
+    '本报告为摘要（contributors 只留首条热区、要素/几何清单只留前 3 条 + 总数、逐元素度量已省略）；' +
+    '需要全量明细用 fs_read 读 report 路径（长报告会带下一段 offset，照抄续读），或重跑加 --detail。'
+  // 幂等标记：宿主侧（ai-chat.js）会对未封装的旧版全量报告做一次兜底裁剪，
+  // 见标记后它会原样放过 —— 否则二次裁剪会把已封装的 {total,sample} 当数组处理、把内容清空。
+  out.summary = true
+  return out
+}
+
 /* ── 核心管线 ──────────────────────────────────────────────── */
 async function runPipeline({ ir: irPath, out: outDir, design: designPath, width, session, alwaysDiffImage, withElements, sets, specPath, skipPreflight, slicesDir: slicesDirArg, reset: resetFlag, noReadiness: noReadinessArg }) {
   const t0 = performance.now()
@@ -1476,7 +1610,7 @@ async function runPipeline({ ir: irPath, out: outDir, design: designPath, width,
 
 /* ── CLI ───────────────────────────────────────────────────── */
 function parseArgs(argv) {
-  const out = { ir: '', out: '', design: '', width: 0, keepAlive: false, diffImage: false, elements: false, sets: [], spec: '', gate: false, id: '', skipPreflight: false, slicesDir: '', reset: false, noReadiness: false }
+  const out = { ir: '', out: '', design: '', width: 0, keepAlive: false, diffImage: false, elements: false, sets: [], spec: '', gate: false, id: '', skipPreflight: false, slicesDir: '', reset: false, noReadiness: false, detail: false }
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i]
     if (a === '--ir') out.ir = argv[++i] || ''
@@ -1488,6 +1622,8 @@ function parseArgs(argv) {
     else if (a === '--slices-dir') out.slicesDir = argv[++i] || ''
     else if (a === '--id') out.id = argv[++i] || ''
     else if (a === '--gate') out.gate = true
+    // stdout 默认只回摘要（省上下文）；--detail 才回全量报告（模型真要看逐元素度量时才加）
+    else if (a === '--detail') out.detail = true
     else if (a === '--no-preflight') out.skipPreflight = true
     // 逃生门：跳过 S4.9 内容就绪门禁（debug 用；正常流程**不该**用它）
     else if (a === '--no-readiness') out.noReadiness = true
@@ -1625,7 +1761,7 @@ async function main() {
   }
 
   if (!args.ir || !args.out) {
-    console.error('用法: node iterate.mjs --ir <IR.json> --out <cardDir> [--design <design.png>] [--width 343]')
+    console.error('用法: node iterate.mjs --ir <IR.json> --out <cardDir> [--design <design.png>] [--width 343] [--detail]')
     process.exit(1)
   }
 
@@ -1644,7 +1780,8 @@ async function main() {
     noReadiness: args.noReadiness,
   })
 
-  console.log(JSON.stringify(result, null, 2))
+  // 默认摘要：stdout = 模型上下文，全量报告已落盘在 report 字段指向的文件（见 summarizeReport 头注）
+  console.log(JSON.stringify(args.detail ? result : summarizeReport(result)))
   if (!result.ok) process.exit(1)
   // 门禁未达标不算脚本失败（报告照常回喂），但退出码要让调用方一眼看出没收敛
   if (result.gate && result.gate.passed === false) process.exitCode = 2

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

@@ -388,6 +388,53 @@ function inferInputParams(bindings) {
 
 const INTENTS = ['blank', 'list', 'detail', 'form', 'dialog', 'tab', 'canvas-head']
 
+/**
+ * 空白根样式：margin / padding / gap 显式归零，压掉渲染器对无样式容器的默认注入
+ * （padding:2px / gap:4px / justify-content:center）。形状与存量卡根节点一致
+ * （style-meta.json：marginType / paddingType，'0' = 全边统一值）。
+ * 同一形状还有两份内联副本（禁跨包 import）：server/core/cardFiles.js 的 blankResetStyle、
+ * skills/finmall-card-sync api_batch_sync.mjs 的 buildBlankSchema —— 改这里必须同步改那两处。
+ */
+function blankResetStyle() {
+  return {
+    properties: [
+      {
+        itemId: '100',
+        itemKey: 'flex',
+        itemValueFrom: '0',
+        itemValue: {},
+        itemChildren: {
+          properties: [{ itemId: '003', itemKey: 'gap', itemValueFrom: '0', itemValue: '0' }],
+        },
+      },
+      {
+        itemId: '400',
+        itemKey: 'padding',
+        itemValueFrom: '0',
+        itemValue: {},
+        itemChildren: {
+          properties: [
+            { itemId: '001', itemKey: 'paddingType', itemValueFrom: '0', itemValue: '0' },
+            { itemId: '002', itemKey: 'padding', itemValueFrom: '0', itemValue: '0' },
+          ],
+        },
+      },
+      {
+        itemId: '500',
+        itemKey: 'margin',
+        itemValueFrom: '0',
+        itemValue: {},
+        itemChildren: {
+          properties: [
+            { itemId: '001', itemKey: 'marginType', itemValueFrom: '0', itemValue: '0' },
+            { itemId: '002', itemKey: 'margin', itemValueFrom: '0', itemValue: '0' },
+          ],
+        },
+      },
+    ],
+  }
+}
+
 /**
  * 装配一张合法的最小卡片骨架。
  * @returns {{schema:object, data:object}}
@@ -402,7 +449,7 @@ export function buildCardSkeleton(intent, opts = {}) {
   const view = {
     width: '375',
     className: 'Root',
-    style: { properties: [] },
+    style: blankResetStyle(),
     properties: [],
     eventactions: [],
     components: rootChildren,

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

@@ -544,6 +544,18 @@ function buildSchemaFromSemantics(sem, id, name, opts = {}) {
   for (const cluster of sem.chartClusters || []) {
     addSemanticBound(cluster.y, cluster.y + cluster.height, true)
   }
+  // 富文本段落块（多行段落按视觉行重组、逐片保留字重）：占据真实纵向空间，必须登记边界——
+  // 否则下游行（辅助文案/徽章行/按钮）的顶距只能从更早的语义底沿起算，逐段累积下漂
+  // （r265 实测：首段之后所有内容整体 +88px，全卡溢出 ~400px）。
+  for (const rb of sem.richBlocks || []) {
+    const box = rect(rb.container)
+    const lineBottomOf = (rb.lines || []).reduce((maxBottom, line) => Math.max(
+      maxBottom,
+      (rect(line[0]).y || 0) + Math.max(...line.map((f) => rect(f).height || 0)),
+    ), 0)
+    const bottom = Math.max((rb.y || 0) + (box.height || 0), lineBottomOf)
+    addSemanticBound(rb.y, bottom, true)
+  }
   for (const aux of sem.auxTexts || []) {
     addSemanticBound(aux.y, textBoundBottom(aux.y, aux.height, aux.fontSize))
     // 主视觉领行（文本左侧大切片）：流式行高取主视觉高度；主视觉溢出卡顶时流式
@@ -2819,7 +2831,10 @@ function buildSchemaFromSemantics(sem, id, name, opts = {}) {
   // 拓扑驱动：先渲染「实时到账」类 mid 文本，表单行随后，footer 文本（温馨提示/最大金额）留到按钮之后。
   const formTopY = sem.formRows && sem.formRows.length
     ? Math.min(...sem.formRows.map((f) => f.label.y))
-    : (sem.buttons.length ? (rect(sem.buttons[0]).y || 0)
+    // buttons[] 是归一化对象（几何挂在 x/y/width/height，没有 .rect），rect() 读不到会恒取 0 →
+    // formTopY 塌成 0 时 midAux 全空、全部辅助文案并进 footAux（顶距退化成「同子列上一行估算底沿」）。
+    // 归一化字段优先、spec 元素 rect 兜底。
+    : (sem.buttons.length ? (Number.isFinite(sem.buttons[0].y) ? sem.buttons[0].y : (rect(sem.buttons[0]).y || 0))
       : (scatterBand ? scatterBand.pillTop : 9999))
   const midAux = (sem.postAmountTexts || []).filter((t) => (t.y || 0) < formTopY)
   const footAux = (sem.postAmountTexts || []).filter((t) => (t.y || 0) >= formTopY)
@@ -2837,7 +2852,7 @@ function buildSchemaFromSemantics(sem, id, name, opts = {}) {
     }
     return bottom
   }
-  const lineBottom = (pat) => (pat.y || 0) + ((pat.fontSize || 14) * 1.4)
+  const lineBottom = (pat) => (pat.y || 0) + estimatedTextBoxHeight(pat.height, pat.fontSize || 14)
   // 上方元素底沿：前一项行底；第一项用显式传入的 beforeBottom（主金额底/按钮底/表单底），否则 null（回退固定值）
   function auxRowPadding(pat, prevPat, isLast, beforeBottom) {
     const gaps = {}
@@ -3447,6 +3462,17 @@ function buildSchemaFromSemantics(sem, id, name, opts = {}) {
       })
       previousFormBottom = rowVisualBottom
     }
+    // 表单行认领的图标（左侧 icon / 值前导媒体 / 行尾媒体 / 右侧 affordance）已在本行渲染，
+    // 必须从孤立媒体兜底池回收——否则同一个切片渲染两遍（重影 + duplication 掉分），
+    // 且兜底行会另起一段流式内容把按钮整体下推（r282 实测：卡图标在账户行与按钮行各出现一次，
+    // 按钮行被顶出卡片底、y≈716 单带像素差异 88%）。
+    if (Array.isArray(sem.isolatedBlocks)) {
+      const _rowClaimed = new Set(sorted.flatMap((p2) => [p2.leftIconSlice, p2.valueLeadSlice,
+        p2.trailingIconSlice, p2.rightAffordanceSlice]).filter(Boolean))
+      if (_rowClaimed.size) {
+        sem.isolatedBlocks = sem.isolatedBlocks.filter((bl) => !_rowClaimed.has(bl.element))
+      }
+    }
     // Interleave dividers that fall between form rows into formHost
     const formTopY = sorted[0].label.y
     const formBottomY = Math.max(...sorted.map((fr) => Math.max(...[fr.value, ...(fr.subValues || []), fr.label]
@@ -3708,6 +3734,9 @@ if (subsActive.length && !sem._subAmountsConsumed) {
     })()
     // 单按钮行的水平内边距按 spec 按钮边缘推导（flex-end→右缘、flex-start→左缘），
     // 通用卡 padding 会把按钮钉在错误内缩上（如壳内右锚按钮偏出 16px）。
+    // 注意：只按断言侧给单边内缩。两侧同时写几何内缩会把 width:100% 的按钮挤窄
+    // （右锚 195+16 内缩 → 内容盒只剩 132px → 文案换行溢出 textOverflow 门，
+    // r276 于 33 例上实测回归）。按钮宽度由下面的「设计宽 vs 撑满行」分支决定。
     const btnLeftPad = singleBtn && singleJustify === 'flex-start'
       ? Math.max(0, Math.round((singleBtn.x || buildCardLeft) - buildCardLeft))
       : T.pad('card')
@@ -3733,7 +3762,12 @@ if (subsActive.length && !sem._subAmountsConsumed) {
       if (sem.buttons.length > 1) {
         setStyleChild(b, 'flex', 'flexShrink', '1')
         setStyleChild(b, 'rect', 'width', '100%')
-      } else if (btn.width && btn.width < (sem.cardRect?.width || 375) * 0.8) {
+      // 单按钮宽度：设计宽 < 卡宽 ⇒ 标注带显式设计宽（含「壳内按钮的内缩宽」），用设计宽 +
+      // flexShrink:0；水平位置交给行内边距与 justify（见上，只给断言侧单边内缩）。
+      // 旧判据用「卡宽 ×0.8」这条魔数比例，落在 80%~100% 区间的设计宽会被并进「撑满行」分支、
+      // 宽度被抹成行内容盒宽（r273 实测 279/343 的按钮渲染成 311 满宽）；
+      // 而右锚按钮（flex-end）本就该用设计宽——撑满行会把按钮左缘推到卡片左缘。
+      } else if (btn.width && btn.width < (sem.cardRect?.width || 375) - 2) {
         setStyleChild(b, 'flex', 'flexShrink', '0')
         setStyleChild(b, 'rect', 'width', String(Math.round(btn.width)))
       } else {
@@ -3786,7 +3820,10 @@ if (subsActive.length && !sem._subAmountsConsumed) {
   for (let i = 0; i < footAux.length; i++) {
     const pat = footAux[i]
     const isLast = i === footAux.length - 1
-    const beforeBottom = i > 0 ? lineBottom(footAux[i - 1]) : (previousSemanticBottom(pat.y) ?? btnBottom)
+    // 顶距锚点优先取「真实语义底沿」而非同子列上一行的估算底沿：两者之间可能夹着
+    // 其它通道渲染的块（序号徽章行 / 富文本段落 / 分割线），用上一行估算底沿会把夹层
+    // 高度重复计入顶距、逐段累积下漂（r265 实测每段 +34px）。取不到语义底沿才回退。
+    const beforeBottom = previousSemanticBottom(pat.y) ?? (i > 0 ? lineBottom(footAux[i - 1]) : btnBottom)
     const geom = auxRowPadding(pat, i > 0 ? footAux[i - 1] : null, isLast, beforeBottom)
     // 水平位置同 midAux 纪律：左 padding 由 spec x 坐标驱动（几何锚定与对齐意图无关），
     // 缺了会把左对齐页脚（金额说明/提示语）甩到卡片默认内缩处。

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

@@ -2511,6 +2511,10 @@ const floatDecos = []
     if (formConsumed.has(t) || panelTextConsumed.has(t)) return false
     if (subAmountEls.has(t)) return false
     if (_panelGroupMemberEls.has(t)) return false
+    // 序号徽章行成员（数字壳 + 右侧内容）已被 badgeRows 通道整体渲染：同一文本元素不得
+    // 再被 listTitle 认领。否则徽章行内容二次渲染（重影），且 postAmountTexts 的 y 上界被
+    // 这个假标题截断——假标题下方的段落/页脚文案整批静默丢失（r265 实测 5 段文案蒸发）。
+    if (_badgeRowTextEls.has(t)) return false
     // 复合行模式：行标题判定 = 候选下方 18-110px 有波段，且【另一文本】在相同相对距离(±4px)也有波段
     // （行结构周期性重复）。卡标题（如「我的账户」距首波段 88px，无周期同伴）不受影响。
     if (repeatRowMode) {
@@ -2918,6 +2922,9 @@ const floatDecos = []
       }))
       // 面板组成员：由面板列表模板整体接管
       && !_panelGroupMemberEls.has(t)
+      // 序号徽章行成员（数字 + 右侧内容）：行结构已由 badgeRows 通道还原，
+      // 再当列表项标题会把同一行渲染两次（徽章行 + ListLayout 项重影）。
+      && !_badgeRowTextEls.has(t)
   })
   // 同 y（±10）的 first-col 文本聚合为一项；按 y 排序
   // P0/P1 升级：列表项必须存在「标题下方 18-36px 的描述文本」（desc）——否则摘要区
@@ -3590,20 +3597,46 @@ const floatDecos = []
   } : null
 
   // —— 底部控制件：只用“按钮区下方 + 居中 + 小尺寸近似方形媒体”判定；低置信度的纯文本不建模。
+  // 「折叠/展开控件」是**卡底**控件，判据必须锚在卡底区域，不能只锚「按钮区之下」：
+  // 无按钮卡里 buttonShapes 为空会让 btnRegionBottom 塌成 0，于是卡中任何
+  // 「小尺寸近方形 + 横向居中」的切片都被误认（如账户行左侧的圆形卡标，
+  // r282 实测：同一图标在账户行与卡底各渲染一次，且卡底多出的那一行把
+  // 底部按钮整体顶出内容区，单带像素差异 88%）。
+  // 补一道真值门：切片必须落在卡内下缘带内（底沿不低于卡底 − 带高），
+  // 且不得高于卡片内容区（文本/媒体）底沿——控件在内容之下，不在内容之中。
   const collapseBtn = (() => {
+    const cardRectR = rect(card)
+    const cardBottom = (cardRectR.y || 0) + (cardRectR.height || 0)
     const btnRegionBottom = buttonShapes.length
       ? Math.max(...buttonShapes.map((s) => (rect(s).y || 0) + (rect(s).height || 0)))
       : 0
+    // 卡内下缘带高：不超过卡高 22%，至少容得下控件自身高度
+    const bottomBandHeight = Math.max(24, Math.round((cardRectR.height || 0) * 0.22))
+    // 内容底沿：所有文本/媒体元素的最低底沿（归一化对象用 rect() 读不到时按 0 略过）
+    let contentBottom = 0
+    for (const t of texts) {
+      const tr = rect(t)
+      contentBottom = Math.max(contentBottom, (tr.y || 0) + (tr.height || 0))
+    }
+    for (const s of slices) {
+      const sr = rect(s)
+      contentBottom = Math.max(contentBottom, (sr.y || 0) + (sr.height || 0))
+    }
     const mediaSlice = slices.find((s) => {
       const sr = rect(s)
       const width = sr.width || 0
       const height = sr.height || 0
       const center = (sr.x || 0) + width / 2
-      const cardCenter = (rect(card).x || 0) + ((rect(card).width || 0) / 2)
+      const cardCenter = (cardRectR.x || 0) + ((cardRectR.width || 0) / 2)
+      const bottom = (sr.y || 0) + height
       return width >= 12 && width <= 36 && height >= 12 && height <= 36
         && Math.abs(width - height) <= Math.max(10, width * 0.5)
         && (sr.y || 0) > btnRegionBottom
-        && Math.abs(center - cardCenter) <= Math.max(24, (rect(card).width || 0) * 0.12)
+        // 落在卡内下缘带内（真值门）
+        && bottom >= cardBottom - bottomBandHeight
+        // 在内容之下而非内容之中：控件顶沿不得低于内容底沿减去自身高度容差
+        && (sr.y || 0) >= contentBottom - height - 4
+        && Math.abs(center - cardCenter) <= Math.max(24, (cardRectR.width || 0) * 0.12)
     })
     const textEl = null
     if (!mediaSlice) return null
@@ -4018,8 +4051,9 @@ const orphanSlices = slices.filter((s) => {
   }
 
   // —— 壳内右列文本（两列拓扑）——
-  // 内容壳（面板壳/渐变壳）右半区独立成列的文本：>=2 个文本左边界落在壳宽 45% 之后且互相成列
-  // （x 差 <=8、分属不同行），壳内左侧另有 >=2 个文本 → 该壳是「左列 + 右列」拓扑而非竖排单列。
+  // 内容壳（面板壳/渐变壳）右半区独立成列的文本：>=2 个文本左边界落在列界之后且互相成列
+  // （x 差 <=8、分属不同行），壳内左侧另有 >=2 个文本、或存在前导媒体（整块图/大切片）→
+  // 该壳是「左列 + 右列」拓扑而非竖排单列。列界取前导媒体右缘，无媒体才回退「壳宽 45%」。
   // 此前右列文本或被压成竖排堆叠（panelRows 路径），或整段落进主视觉死区不渲染（渐变壳路径）。
   const shellButtonTextEls = new Set(buttons.map((button) => button.sourceEl).filter(Boolean))
   const shellRightColumns = []
@@ -4031,7 +4065,22 @@ const orphanSlices = slices.filter((s) => {
     // 标题行（与壳内首个文本同 band）整体保留为整行：名称 + 紧邻短标签不是右列成员
     const headerEls = inner.filter((t) => Math.abs((rect(t).y || 0) - topY) <= 8)
     const headerSet = new Set(headerEls)
-    const splitX = (sr.x || 0) + (sr.width || 0) * 0.45
+    // 前导媒体（壳内左侧的整块图 / 大切片）：高显著大于壳内行高、右缘落在壳左半区。
+    // 右列左界此前固定取「壳宽 45%」——该比例隐含「前导媒体宽 ≈ 壳宽一半」的假设；
+    // 媒体较窄时（80px 图 / 311px 壳）右列起点落在比例线左侧，右列文本整体被划到左列一侧
+    // → left.length 恒 < 2 → 两列拓扑被整条判死，右列文本退化成全宽竖排行。
+    // 有前导媒体时改用其右缘为列界（几何真值），无媒体才回退比例线。
+    const innerHeights = inner.map((t) => rect(t).height || 0).sort((a, b) => a - b)
+    const innerLineH = innerHeights[Math.floor(innerHeights.length / 2)] || 14
+    const leadMedia = [...isolatedBlocks, ...slices]
+      .filter((el) => thinInside(el, shape))
+      .map((el) => rect(el))
+      .filter((r) => (r.height || 0) >= Math.max(24, innerLineH * 1.8)
+        && (r.x || 0) + (r.width || 0) <= (sr.x || 0) + (sr.width || 0) * 0.5)
+      .sort((a, b) => ((a.x || 0) + (a.width || 0)) - ((b.x || 0) + (b.width || 0)))[0] || null
+    const splitX = leadMedia
+      ? Math.max((sr.x || 0) + 2, (leadMedia.x || 0) + (leadMedia.width || 0) + 2)
+      : (sr.x || 0) + (sr.width || 0) * 0.45
     const columns = []
     for (const t of inner.filter((item) => !headerSet.has(item) && (rect(item).x || 0) >= splitX)
       .slice().sort((a, b) => (rect(a).x || 0) - (rect(b).x || 0))) {
@@ -4047,7 +4096,9 @@ const orphanSlices = slices.filter((s) => {
     if (!best) continue
     const bestSet = new Set(best.items)
     const left = inner.filter((t) => !headerSet.has(t) && !bestSet.has(t) && (rect(t).x || 0) < splitX)
-    if (left.length < 2) continue
+    // 左列成员可以是一张整块图而非文本（「产品图 + 右列信息」是常见形态）：
+    // 有前导媒体时左列无文本也成立，否则该形态永远进不了两列通道。
+    if (left.length < 2 && !leadMedia) continue
     shellRightColumns.push({
       shapeEl: shape,
       x: sr.x || 0, y: sr.y || 0, width: sr.width || 0, height: sr.height || 0,

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

@@ -179,8 +179,17 @@ export function fixFlexShrinkOverflow(root) {
       const children = getChildren(node)
       if (!isAutoSize && children.length >= 2) {
         const allShrinkZero = children.every((child) => getStyleVal(child, 'flex', 'flexShrink') === '0')
-        if (allShrinkZero) {
-          // Set the last child to flexShrink:1 (typically the most flexible content area)
+        // 「子节点全为固定 px 宽」= 这些宽度是设计稿逐个标注出来的（并排药丸/标签/统计块），
+        // 它们的和就是设计真值。此时**不得**为末位放开可缩点：药丸被压窄后内部文案换行、
+        // 行高撑高，连带 textOverflow 与 structure 一起掉（r284 实测：149+12+150 恰等于
+        // 组宽 311，却被压成两行，textOverflow 0.889 < 门 0.90）。
+        // 真正的「溢出兜底」场景是子节点里混有 auto/百分比宽（内容长度不可知），
+        // 那种才需要放开一个可缩点让内容有地方收缩。
+        const allFixedPx = children.every((child) => {
+          const cw = getStyleVal(child, 'rect', 'width')
+          return cw != null && /^\d+(\.\d+)?$/.test(String(cw))
+        })
+        if (allShrinkZero && !allFixedPx) {
           setStyleVal(children[children.length - 1], 'flex', 'flexShrink', '1')
         }
       }
@@ -474,9 +483,14 @@ export function amountExpr(varName, srcText, opts = {}) {
     const unit = JSON.stringify(unitMatch[2])
     return `${sign} + ${abs} + ${unit}`
   }
+  // 货币符号必须进表达式：spec 把「¥」与「5,638.00」拆成两层时，裸符号层会被合并段
+  // （mergeCurrencyLayer）吞掉，表达式是符号唯一的载体——不输出前缀 ⇒ 渲染只剩数字
+  // （"¥5,638.00" → "5,638.00"）。前缀取自原文、运行时与负号拼接顺序固定（负号在前）。
+  // 纯数字原文（"2000" 配相邻"万元"）不写前缀，避免凭空加符号。
+  const cur = hasCurrency ? JSON.stringify(curPrefix) + ' + ' : ''
   // 列表行模板共用一套表达式：货币前缀必须逐行数据驱动（$amtCurN），否则首行符号套到全行
   if (opts.prefixVar) return `${sign} + $${opts.prefixVar} + ${abs}`
-  return `${sign} + ${abs}`
+  return `${sign} + ${cur}${abs}`
 }
 
 export function amountValueExpr(varName, srcText, { currencyPrefix = true } = {}) {

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

@@ -63,6 +63,7 @@ if (argv.includes('--help') || argv.includes('-h')) {
 
 const workRoot = path.join(REPO, '.cache', 'v3-regression')
 const workCards = path.join(workRoot, 'src', 'cards')
+const workSlices = path.join(workRoot, '__slices')
 const baselineDir = path.join(REPO, 'training', 'pass1', 'baseline')
 const node = process.execPath
 // 同 gate.mjs：改为统一解析（此前 `process.env.PYTHON || 'python3'` 不认 DSL_CARD_PYTHON、不探测）
@@ -103,6 +104,10 @@ for (const c of cases) {
     continue
   }
   // 1) 首轮生成（无 decisions）
+  // 切图落点必须一并密闭化：卡片产物已隔离到 .cache/v3-regression，但切图默认仍写 src/slices
+  // —— 金标 spec 来自 training/fixtures（含仓库未跟踪的切图名），跑一次回归就把它们混进
+  // 受跟踪资产目录（实测污染 src/slices 2 个未跟踪文件），并让 ci-gate 的源码污染守卫报错。
+  // 口径与 tools/regress-fidelity.mjs 一致。
   const gen = run(node, [
     path.join(SCRIPTS, 'spec_to_schema_v3.mjs'),
     '--spec', specPath,
@@ -110,7 +115,9 @@ for (const c of cases) {
     '--cardIndex', String(c.card),
     '--out', workCards,
     '--force',
-  ])
+  ], {
+    DSL_CARD_SLICES_DIR: workSlices,
+  })
   if (!gen.ok) {
     results.push({ regId: c.regId, pass: false, reason: 'generate 失败', detail: gen.output.slice(-600) })
     continue

package/dist/vendored/skills/finmall-card-sync/scripts/api_batch_sync.mjs

@@ -740,8 +740,52 @@ async function syncBlankCard(page, card, { cardDir, appId, workspaceId }) {
   };
 }
 
-/** 最小合法空白 schema：满足 validate_schema.py 的顶层必填（version/pageId/name/dictionary/view）。 */
+/**
+ * 最小合法空白 schema：满足 validate_schema.py 的顶层必填（version/pageId/name/dictionary/view）。
+ * 根样式 margin / padding / gap 显式归零，压掉渲染器对无样式容器的默认注入
+ * （padding:2px / gap:4px / justify-content:center）——形状与存量卡根节点一致
+ * （style-meta.json：marginType / paddingType，'0' = 全边统一值）。
+ * 同一形状还有两份内联副本（禁跨包 import）：server/core/cardFiles.js 的 blankResetStyle、
+ * skills/dsl-card-generator lib/scaffold.mjs —— 改这里必须同步改那两处。
+ */
 function buildBlankSchema(card) {
+  const blankResetStyle = () => ({
+    properties: [
+      {
+        itemId: '100',
+        itemKey: 'flex',
+        itemValueFrom: '0',
+        itemValue: {},
+        itemChildren: {
+          properties: [{ itemId: '003', itemKey: 'gap', itemValueFrom: '0', itemValue: '0' }],
+        },
+      },
+      {
+        itemId: '400',
+        itemKey: 'padding',
+        itemValueFrom: '0',
+        itemValue: {},
+        itemChildren: {
+          properties: [
+            { itemId: '001', itemKey: 'paddingType', itemValueFrom: '0', itemValue: '0' },
+            { itemId: '002', itemKey: 'padding', itemValueFrom: '0', itemValue: '0' },
+          ],
+        },
+      },
+      {
+        itemId: '500',
+        itemKey: 'margin',
+        itemValueFrom: '0',
+        itemValue: {},
+        itemChildren: {
+          properties: [
+            { itemId: '001', itemKey: 'marginType', itemValueFrom: '0', itemValue: '0' },
+            { itemId: '002', itemKey: 'margin', itemValueFrom: '0', itemValue: '0' },
+          ],
+        },
+      },
+    ],
+  });
   return {
     version: '1.0.0',
     pageId: String(card.cardId),
@@ -752,7 +796,7 @@ function buildBlankSchema(card) {
     view: {
       width: '375',
       className: 'Root',
-      style: { properties: [] },
+      style: blankResetStyle(),
       properties: [],
       eventactions: [],
       components: [],