cardbuddy 0.15.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/dist/init.js +0 -2
  2. package/dist/preview-editor/assets/index-CXDf5tVg.css +1 -0
  3. package/dist/preview-editor/assets/{index-CIIfMlwI.js → index-DLQkCPLT.js} +113 -86
  4. package/dist/preview-editor/index.html +2 -2
  5. package/dist/vendored/card-editor/runtime/adapter.js +2 -2
  6. package/dist/vendored/mcp/client.mjs +1 -1
  7. package/dist/vendored/server/core/ai-chat.js +251 -80
  8. package/dist/vendored/server/core/browser.js +17 -0
  9. package/dist/vendored/server/core/cardFiles.js +49 -1
  10. package/dist/vendored/server/core/cardImage.js +103 -2
  11. package/dist/vendored/server/core/cardValidate.js +16 -5
  12. package/dist/vendored/server/core/screenshot.js +94 -0
  13. package/dist/vendored/skills/card-skill-trainer/SKILL.md +68 -13
  14. package/dist/vendored/skills/card-skill-trainer/scripts/diagnose_case.mjs +14 -82
  15. package/dist/vendored/skills/card-skill-trainer/scripts/lib/diagnosis.mjs +207 -0
  16. package/dist/vendored/skills/card-skill-trainer/scripts/lib/layout-correction-sim.mjs +62 -0
  17. package/dist/vendored/skills/card-skill-trainer/scripts/lib/paradigm-router.mjs +76 -0
  18. package/dist/vendored/skills/card-skill-trainer/scripts/lib/pixel-worker-runner.mjs +31 -0
  19. package/dist/vendored/skills/card-skill-trainer/scripts/lib/pixel-worker.mjs +138 -0
  20. package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs +24 -20
  21. package/dist/vendored/skills/card-skill-trainer/scripts/lib/telemetry.mjs +46 -0
  22. package/dist/vendored/skills/card-skill-trainer/scripts/plan_next_round.mjs +5 -2
  23. package/dist/vendored/skills/card-skill-trainer/scripts/run_round.mjs +286 -92
  24. package/dist/vendored/skills/card-skill-trainer/scripts/score_round.mjs +74 -2
  25. package/dist/vendored/skills/card-skill-trainer/scripts/sink_rules.mjs +127 -0
  26. package/dist/vendored/skills/dsl-card-generator/SKILL.md +93 -27
  27. package/dist/vendored/skills/dsl-card-generator/references/component_rules.md +14 -0
  28. package/dist/vendored/skills/dsl-card-generator/references/dsl_structure.md +1 -15
  29. package/dist/vendored/skills/dsl-card-generator/references/expression_engine.md +11 -20
  30. package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md +217 -44
  31. package/dist/vendored/skills/dsl-card-generator/references/ir-format.md +87 -3
  32. package/dist/vendored/skills/dsl-card-generator/references/iteration_protocol.md +35 -6
  33. package/dist/vendored/skills/dsl-card-generator/references/previewer_contract.md +21 -0
  34. package/dist/vendored/skills/dsl-card-generator/references/quickref.md +28 -27
  35. package/dist/vendored/skills/dsl-card-generator/references/recipes.md +30 -8
  36. package/dist/vendored/skills/dsl-card-generator/references/rules.md +3 -2
  37. package/dist/vendored/skills/dsl-card-generator/references/scripts_reference.md +5 -2
  38. package/dist/vendored/skills/dsl-card-generator/references/slices_convention.md +2 -3
  39. package/dist/vendored/skills/dsl-card-generator/references/spec_to_schema_patterns.md +1 -4
  40. package/dist/vendored/skills/dsl-card-generator/scripts/add_component.mjs +5 -14
  41. package/dist/vendored/skills/dsl-card-generator/scripts/autofix_schema.py +88 -0
  42. package/dist/vendored/skills/dsl-card-generator/scripts/check_fidelity.mjs +143 -42
  43. package/dist/vendored/skills/dsl-card-generator/scripts/check_topology.py +0 -35
  44. package/dist/vendored/skills/dsl-card-generator/scripts/expand_ir.mjs +99 -53
  45. package/dist/vendored/skills/dsl-card-generator/scripts/gate.mjs +5 -2
  46. package/dist/vendored/skills/dsl-card-generator/scripts/iterate.mjs +388 -29
  47. package/dist/vendored/skills/dsl-card-generator/scripts/lib/component_contract.mjs +315 -0
  48. package/dist/vendored/skills/dsl-card-generator/scripts/lib/layout-tokens.mjs +1 -1
  49. package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.mjs +23 -0
  50. package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.py +0 -37
  51. package/dist/vendored/skills/dsl-card-generator/scripts/lib/python.mjs +99 -0
  52. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/adaptive-width.mjs +105 -0
  53. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/bindings.mjs +260 -0
  54. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/expr.mjs +52 -0
  55. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/image.mjs +96 -0
  56. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/registry.mjs +166 -0
  57. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/structure.mjs +127 -0
  58. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/walk.mjs +61 -0
  59. package/dist/vendored/skills/dsl-card-generator/scripts/lib/scaffold.mjs +48 -1
  60. package/dist/vendored/skills/dsl-card-generator/scripts/lib/scope_alias.mjs +125 -0
  61. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_assemble.mjs +366 -45
  62. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_extract.mjs +169 -12
  63. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_shared.mjs +17 -9
  64. package/dist/vendored/skills/dsl-card-generator/scripts/lint_card.mjs +119 -78
  65. package/dist/vendored/skills/dsl-card-generator/scripts/preflight.mjs +48 -50
  66. package/dist/vendored/skills/dsl-card-generator/scripts/readiness.mjs +634 -0
  67. package/dist/vendored/skills/dsl-card-generator/scripts/register_card_template.mjs +5 -8
  68. package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs +5 -10
  69. package/dist/vendored/skills/dsl-card-generator/scripts/spec_audit.mjs +122 -8
  70. package/dist/vendored/skills/dsl-card-generator/scripts/v3_regression.mjs +11 -2
  71. package/dist/vendored/skills/dsl-card-generator/scripts/validate_schema.py +23 -15
  72. package/dist/vendored/skills/finmall-card-sync/scripts/api_batch_sync.mjs +46 -2
  73. package/dist/vendored/skills/mbank-design-gen/SKILL.md +76 -0
  74. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-apps.png +0 -0
  75. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-arrow-right-blue.png +0 -0
  76. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-check.png +0 -0
  77. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-settings.png +0 -0
  78. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-sound.png +0 -0
  79. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-voice-switch.png +0 -0
  80. package/dist/vendored/skills/mbank-design-gen/assets/icons/progress-thumb.png +0 -0
  81. package/dist/vendored/skills/mbank-design-gen/assets/icons/tag-bg.png +0 -0
  82. package/dist/vendored/skills/mbank-design-gen/assets/icons/vs-badge.png +0 -0
  83. package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-chat-options.png +0 -0
  84. package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-home-scene.png +0 -0
  85. package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-product-detail.png +0 -0
  86. package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-rate-table.png +0 -0
  87. package/dist/vendored/skills/mbank-design-gen/assets/robot.png +0 -0
  88. package/dist/vendored/skills/mbank-design-gen/references/component-library.md +127 -0
  89. package/dist/vendored/skills/mbank-design-gen/references/design-spec.md +261 -0
  90. package/dist/vendored/skills/mbank-design-gen/templates/mockup-template.html +138 -0
  91. package/dist/vendored/skills/mbank-design-gen/tools/screenshot.mjs +34 -0
  92. package/dist/vendored/skills/shared/exit-codes.md +79 -0
  93. package/dist/vendored/skills/shared/spec-contract.md +127 -0
  94. package/dist/vendored/skills/sketch-spec-to-card/SKILL.md +27 -10
  95. package/dist/vendored/skills/sketch-spec-to-card/references/spec-schema.md +3 -3
  96. package/dist/vendored/skills/sketch-spec-to-card/scripts/build_prompt.py +0 -8
  97. package/dist/vendored/skills/sketch-spec-to-card/scripts/cluster_states.py +14 -25
  98. package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py +121 -47
  99. package/dist/vendored/skills/sketch-spec-to-card/scripts/png_utils.py +0 -5
  100. package/dist/vendored/skills/sketch-spec-to-card/scripts/test_text_only_artboard.py +98 -16
  101. package/dist/vendored/skills/sketch-spec-to-card/scripts/vision.py +55 -37
  102. package/dist/vendored/templates/helloCard/schema.json +62 -1
  103. package/dist/vendored/tools/finmall-env.mjs +1 -18
  104. package/package.json +1 -1
  105. package/dist/preview-editor/assets/index-DQn0zQBP.css +0 -1
  106. package/dist/vendored/skills/card-skill-trainer/scripts/test_missing_slice.py +0 -122
  107. package/dist/vendored/skills/dsl-card-generator/scripts/analyze_component_usage.mjs +0 -153
@@ -20,9 +20,9 @@
20
20
  */
21
21
  import fs from 'node:fs'
22
22
  import path from 'node:path'
23
- import { spawnSync } from 'node:child_process'
24
23
  import { fileURLToPath } from 'node:url'
25
24
  import { hostSkillsDir, projectRoot } from './lib/paths.mjs'
25
+ import { resolvePython } from './lib/python.mjs'
26
26
 
27
27
  const IMAGE_EXT = new Set(['.png', '.jpg', '.jpeg', '.webp'])
28
28
  /** 已知入口文件:判定交给它所在目录(index.html=MeaXure 导出;manifest/clusters/spec/prompt=要素包;schema=卡片目录)。 */
@@ -94,14 +94,9 @@ function shortPath(abs) {
94
94
  return rel && !rel.startsWith('..') && !path.isAbsolute(rel) ? rel : abs
95
95
  }
96
96
 
97
+ /** Python 解释器:解析集中在 lib/python.mjs(单一来源,含 Windows Store 假别名识别)。 */
97
98
  function pythonBin() {
98
- if (process.env.DSL_CARD_PYTHON) return process.env.DSL_CARD_PYTHON
99
- // py 是 Windows 官方启动器(python3 在 Windows 常是 Store 假别名:能启动、立刻 9009 退出)
100
- for (const bin of ['python3', 'python', 'py']) {
101
- const probe = spawnSync(bin, ['--version'], { stdio: 'ignore' })
102
- if (probe.status === 0) return bin
103
- }
104
- return 'python3'
99
+ return resolvePython()
105
100
  }
106
101
 
107
102
  /** Sketch MeaXure 标注导出判定:index.html 的 data 签名是硬证据,preview/ assets/ links/ 是佐证。 */
@@ -341,7 +336,7 @@ function route(inputAbs) {
341
336
  `node ${shortPath(path.join(hostSkillsDir, 'dsl-card-generator', 'scripts', 'spec_tree.mjs'))} --list-cards ${shortPath(inputAbs)}`,
342
337
  SELECTION_GATE,
343
338
  ]),
344
- `# 再按 SKILL.md §8 Workflow A 六步闭环生成 schema(scaffold_card → add_component/expand_ir → validate+lint → render_diff)`,
339
+ `# 再按 SKILL.md §8 Workflow A 生成 schema(整树 IR 一次下发 → expand_ir → readiness → gate → iterate 视觉闭环);add_component 仅改卡用`,
345
340
  ],
346
341
  note: bundle.artboardBundle
347
342
  ? '输入已是单画板要素包,无需前处理,直接走 Workflow A 生成本卡。'
@@ -378,7 +373,7 @@ function route(inputAbs) {
378
373
  evidence: [`单张图片 ${path.basename(inputAbs)}(同目录无 spec.json)`],
379
374
  skillChain: ['dsl-card-generator'],
380
375
  workflow: 'Workflow 0 入口③ → Workflow A(无标注,视觉推断)',
381
- next: [`# 直接多模态读图 → scaffold_card 出骨架 → validate+lint → render_diff 视觉闭环`],
376
+ next: [`# 直接多模态读图 → 整树 IR(AI 判定布局)→ expand_ir → readiness → gate → iterate 视觉闭环`],
382
377
  note: '无 MeaXure 标注时全靠 AI 视觉推断,间距/圆角从图上目视估算;若这张图其实来自某份标注导出,请改传导出目录以走入口①。',
383
378
  }
384
379
  }
@@ -292,6 +292,40 @@ function main() {
292
292
  }
293
293
  ;(card.elements || []).forEach(walk)
294
294
 
295
+ /**
296
+ * 聚合文本节点剔除(导出侧冗余层)。
297
+ *
298
+ * MeaXure 导出会在**同一行**同时给出「合并文案」与「拆分文案」。实测 2026-09-24 收支分析卡:
299
+ * `总收入(元)` (x32 w70) 与 `总收入` (x32 w45) + `(元)` (x77 w25) 同行并存;
300
+ * `转账-张扬 (银行号转账)` (x32 w148) 与 `转账-张扬` (x32 w75) + `(银行号转账)` (x107 w74) 同行并存。
301
+ * 对设计稿做像素采样可证可见真值是**拆分节点**(主文案 #111111 + 后缀 #999999 两色),
302
+ * 合并节点的 textStyle 只有一种颜色 ⇒ 它是导出侧的聚合层,画不出来。
303
+ *
304
+ * 不剔除的代价:① texts 真值集虚高(该卡 29 条 vs 视觉 20 条),bindHints 与 listCandidates
305
+ * 一并被污染;② 模型若挑中合并节点,会把灰色后缀渲染成主色(颜色偏差)。
306
+ *
307
+ * 判据只用几何 + 文本,不含任何业务词:同行(|Δy| ≤ 2)且 x 区间被包含的 ≥2 条文本,
308
+ * 按 x 排序拼接后与本体的非空白内容相同 ⇒ 本体是聚合层。
309
+ */
310
+ const redundantTexts = []
311
+ const normText = (s) => String(s || '').replace(/\s+/g, '')
312
+ const keptTexts = texts.filter((t, i) => {
313
+ const parts = texts.filter(
314
+ (o, j) => j !== i && Math.abs(o.y - t.y) <= 2 && o.x >= t.x - 1 && o.x + o.w <= t.x + t.w + 1,
315
+ )
316
+ if (parts.length < 2) return true
317
+ const joined = parts.slice().sort((a, b) => a.x - b.x).map((p) => p.text).join('')
318
+ if (normText(joined) !== normText(t.text)) return true
319
+ redundantTexts.push({
320
+ text: t.text,
321
+ rect: { x: t.x, y: t.y, w: t.w, h: t.h },
322
+ parts: parts.map((p) => p.text),
323
+ })
324
+ return false
325
+ })
326
+ texts.length = 0
327
+ texts.push(...keptTexts)
328
+
295
329
  // 切图清单:存在性 / 复用 / 烘焙内容 / 复用但内容不同
296
330
  // 按**完整 ref** 分组(不是 basename):分组路径是图层身份的一部分,两个不同分组的同名图层是两张图。
297
331
  const byRef = new Map()
@@ -429,11 +463,22 @@ function main() {
429
463
  } else bands.push({ y: it.y, h: it.h, items: [it] })
430
464
  }
431
465
  bands.sort((a, b) => a.y - b.y)
432
- for (const b of bands) b.items.sort((a, c) => a.x - c.x)
466
+ // 带内排序必须与下面「网格行合并」用的口径**完全一致**(y 为主、x 为辅)。
467
+ // 2026-09-24 实测事故:这里原来只按 x 排,合并那里按 (y,x) 排 ⇒ 同构的三条交易行
468
+ // (每条自身两行:主文案+金额 / 账户+日期)签名被打乱成两种(t15|t12|t13|t12|t15 与
469
+ // t15|t13|t15|t12|t12),「同构连续行」的 run 检测只认出 2 条,真列表漏掉一行。
470
+ // 单行带(y 全同)下两种口径等价,改口径不会动已有单行判定。
471
+ for (const b of bands) b.items.sort((a, c) => a.y - c.y || a.x - c.x)
433
472
  const rowGaps = bands.slice(1).map((b, i) => b.y - (bands[i].y + bands[i].h))
434
473
 
435
- const xs = items.map((i) => i.x)
436
- const xes = items.map((i) => i.x + i.w)
474
+ // 左右内缩只看**内容**的外沿:整宽装饰(行底色矩形 / 通栏分割线)的 local x 恒为 0,
475
+ // 掺进来会让 padLeft / padRight 永远是 0。实测 2026-09-24 收支分析卡:三个交易行的底色
476
+ // 矩形 343×72 从 x=0 起,padLeft 报 0,而真实内容内缩是 16(文案 x=16)——
477
+ // 模型照 0 排版就直接贴边。整宽/近整宽(≥ W−4)的装饰单独屏蔽。
478
+ const insetItems = items.filter((i) => i.w < W - 4)
479
+ const padSource = insetItems.length ? insetItems : items
480
+ const xs = padSource.map((i) => i.x)
481
+ const xes = padSource.map((i) => i.x + i.w)
437
482
  const gaps = {
438
483
  padLeft: Math.min(...xs),
439
484
  padRight: W - Math.max(...xes),
@@ -470,7 +515,23 @@ function main() {
470
515
  const i = (Math.round(y * scale) * design.width + Math.round(4 * scale)) * 4
471
516
  return { hex: hex(design.data[i], design.data[i + 1], design.data[i + 2]), a: design.data[i + 3] }
472
517
  }
473
- const fill = colors.length ? colors[3]?.hex || colors[0].hex : '#FFFFFF'
518
+ // 卡底色 = 角部 + 右缘 gutter 的众数(量化色距聚类取最大簇)。
519
+ // **绝不能用 center 采样点**:卡面正中常被图表/大图占据(实测雷达卡 center=#F8B46A 恰是
520
+ // 雷达图中心橙,被当成卡底色后 bgGradientHint 产出「白→橙 264px」毒提示,模型照涂整卡,
521
+ // 像素 match 直接掉 4pp)。center 点仍保留在 colors 里供人看,但不参与底色投票。
522
+ const fillVotes = colors.filter((c) => c.label !== 'center').map((c) => c.hex)
523
+ const fill = (() => {
524
+ if (!fillVotes.length) return '#FFFFFF'
525
+ // 贪心聚类:色距 <12 视为同簇(与渐变检测的 dist 阈值一致)
526
+ const clusters = []
527
+ for (const hexV of fillVotes) {
528
+ const hit = clusters.find((c) => dist(c.ref, hexV) < 12)
529
+ if (hit) hit.n++
530
+ else clusters.push({ ref: hexV, n: 1 })
531
+ }
532
+ clusters.sort((a, b) => b.n - a.n)
533
+ return clusters[0].ref
534
+ })()
474
535
  // 首个不透明且明显异于卡底色的采样点 = 渐变带起点
475
536
  let startY = -1
476
537
  let top = null
@@ -539,24 +600,43 @@ function main() {
539
600
  const bandSig = (items) => items.filter((i) => i.kind !== 'shape').map((i) => (i.kind === 'text' ? `t${i.fs ?? ''}` : i.kind)).join('|')
540
601
  const listCandidates = []
541
602
  const pushCandidate = (layout, rows, source) => {
542
- const values = rows.map((r) => r.map((it) => (it.kind === 'text' ? it.text : it.name || '')))
603
+ // 值矩阵只保留内容项(text / slice):shape 是行底色、分割线这类纯装饰,行与行之间数量不等
604
+ // (2026-09-24 实测:三条交易行的 items 数是 6/7/8,多出来的全是 shape)—— 掺进来会让
605
+ // 「列」与「字段」整体错位,模型照着错位的矩阵命名会得到一堆空列。
606
+ const contentRows = rows.map((r) => r.filter((it) => it.kind !== 'shape'))
607
+ if (!contentRows.length || !contentRows[0].length) return
608
+ const width = Math.max(...contentRows.map((r) => r.length))
609
+ const values = contentRows.map((r) => {
610
+ const v = r.map((it) => (it.kind === 'text' ? it.text : it.name || ''))
611
+ while (v.length < width) v.push('') // 同构行理论等长;不足者补空占位,避免列数不齐
612
+ return v
613
+ })
543
614
  // 每行值完全相同 = 装饰性重复(分割线 / 同款图标行),不是数据行,不值得绑数组
544
615
  if (values.every((v) => JSON.stringify(v) === JSON.stringify(values[0]))) return
616
+ // 以最全的一行作字段基准(同构行等长,取最长更稳)
617
+ const base = contentRows.reduce((a, b) => (b.length > a.length ? b : a), contentRows[0])
545
618
  listCandidates.push({
546
619
  layout,
547
620
  rows: source,
548
- fields: rows[0].map((it, pos) => ({ pos, kind: it.kind, first: it.kind === 'text' ? it.text : it.name || '' })),
621
+ fields: base.map((it, pos) => ({ pos, kind: it.kind, first: it.kind === 'text' ? it.text : it.name || '' })),
549
622
  values,
550
623
  })
551
624
  }
552
625
  // 网格行合并:tile 内部(图标行 → 标题行 → 副标题行)的行距远小于 tile 之间的行距,
553
626
  // 按「小于中位行距 60%」把相邻 bands 粘成一行 tile;不合并的话列表候选会被拆成碎片行
627
+ //
628
+ // ⚠ 签名相同的相邻带**不粘**(2026-09-24 实测事故):tile 的各层靠签名区分(图标行 / 标题 /
629
+ // 副标题),签名相同的两条带是**并列的兄弟行**,不是同一 tile 的上下层。收支分析卡的三个交易行
630
+ // 内容高度正好顶满 72px 行高 ⇒ 带与带的 gap 为 0 ⇒ 旧逻辑把它们粘成一条带,于是
631
+ // 「同构连续行」的 run 检测再也看不到它们,真列表漏报;同时残留的那条巨带又喂出了
632
+ // 一个假候选(space-between 两端标签被当成「同构 tile 行」)。
554
633
  const rowGapMed = rowGaps.length ? [...rowGaps].sort((a, b) => a - b)[Math.floor(rowGaps.length / 2)] : 0
555
634
  const merged = []
556
635
  for (const b of bands) {
557
636
  const last = merged[merged.length - 1]
558
637
  const gap = last ? b.y - (last.y + last.h) : Infinity
559
- if (last && rowGapMed > 0 && gap >= 0 && gap < rowGapMed * 0.8) {
638
+ const sameSig = last && bandSig(b.items) === bandSig(last.items)
639
+ if (last && !sameSig && rowGapMed > 0 && gap >= 0 && gap < rowGapMed * 0.8) {
560
640
  last.items = [...last.items, ...b.items].sort((a, c) => a.y - c.y || a.x - c.x)
561
641
  last.h = Math.max(last.y + last.h, b.y + b.h) - last.y
562
642
  } else {
@@ -590,15 +670,32 @@ function main() {
590
670
  cur.push(its[i])
591
671
  }
592
672
  groups.push(cur)
593
- if (groups.length >= 2 && groups.every((g) => g.length === groups[0].length && bandSig(g) === bandSig(groups[0]))) {
673
+ // 同构 tile 组判定 + 排除「space-between 两端标签」这个高频假阳性(2026-09-24 实测:
674
+ // 收支分析卡 band1 的「总收入(元)…」/「总支出(元)…」两端标签被当成一个 2 组同构行候选,
675
+ // 模型得先在正文里推翻它才敢按真结构写 IR,白烧一轮推理)。
676
+ // 区分点:真 tile 是**等距列**(tile 之间有间隔但不吞掉大半行);两端标签是**一整条空档**。
677
+ // 故 2 组时要求列间空档不超过本带内容跨度的 40%;≥3 组不再额外限制(3 组及以上几乎不可能是两端标签)。
678
+ const span = its.reduce((m, i) => Math.max(m, i.x + i.w), 0) - its.reduce((m, i) => Math.min(m, i.x), Infinity)
679
+ const splitThreshold = Math.max(12, med * 2)
680
+ const wideSplit = gaps.some((g) => g > splitThreshold && span > 0 && g > span * 0.4)
681
+ if (
682
+ groups.length >= 2 &&
683
+ groups.every((g) => g.length === groups[0].length && bandSig(g) === bandSig(groups[0])) &&
684
+ (groups.length >= 3 || !wideSplit)
685
+ ) {
594
686
  pushCandidate('row', groups, [bi])
595
687
  }
596
688
  }
597
689
 
598
690
  const brief = {
691
+ ...(process.env.SPEC_AUDIT_DEBUG
692
+ ? { _debug: { merged: merged.map((m, i) => ({ i, y: m.y, h: m.h, sig: bandSig(m.items), n: m.items.length })) } }
693
+ : {}),
599
694
  card: { index: args.card, name: card.name || '', rect: { w: W, h: H }, fill: card.cardFill || null },
600
695
  design: design ? { path: args.design, scale: Number(scale.toFixed(3)) } : null,
601
696
  texts,
697
+ // 被剔除的导出侧聚合层(合并文案 + 其拆分件)。本行同内容只保留拆分件,模型不必再猜该用哪个。
698
+ redundantTexts: redundantTexts.length ? redundantTexts : undefined,
602
699
  shapes,
603
700
  bgLayers,
604
701
  slices,
@@ -613,6 +710,23 @@ function main() {
613
710
  missing,
614
711
  bindHints,
615
712
  listCandidates,
713
+ // 列表绑定的作用域写法,只在真有候选时出现(避免每份审计都塞一段与当前卡无关的说明)。
714
+ // 为什么必须在这里给:模型是在读 listCandidates 的这一刻决定「这是列表、要绑数组」的,
715
+ // 此刻它手边没有作用域契约,容易照直觉写 $item.<字段>(求值恒 undefined 且全链路静默)。
716
+ // 现在它写错也不会出事 —— expand_ir 在扩展开头会归一化别名(lib/scope_alias.mjs)。
717
+ // 这里给契约是为了让它一次写对、少一轮往返,而不是「提醒它别犯错」。
718
+ // 文案只讲契约,不涉及任何具体字段名 / 卡名。
719
+ ...(listCandidates.length
720
+ ? {
721
+ listBindingRule:
722
+ 'listScope 插槽内 item 的字段已**逐个展开**到作用域,规范形三种:' +
723
+ '① `$<字段名>`(字段名由你对 fields[].first 的值语义化命名,禁 text1 / val2 这类占位名);' +
724
+ '② `$$` = 整个 item 对象;③ `$_index` = 行索引。' +
725
+ '(写成 `$item.<字段>` / `$item` / `$item._index` 也不会出错:expand_ir 会在扩展开头自动归一化到上面三种规范形。作用域里本来就没有 `item` 这个键。)' +
726
+ 'fields[] 一列一字段,values[] 的每一行与 fields[] 同序(shape 装饰项已剔除)。' +
727
+ '契约全文:skills/dsl-card-generator/references/expression_engine.md §3。',
728
+ }
729
+ : {}),
616
730
  }
617
731
  // 默认落盘:审计是「整份复用」的产物(crop_slices --from-audit 直接吃),
618
732
  // 靠模型每次记得加 --save 是不可靠的;不给路径就落到工程根 .cache/spec-audit/ 下。
@@ -25,6 +25,7 @@ import fs from 'node:fs'
25
25
  import path from 'node:path'
26
26
  import { spawnSync } from 'node:child_process'
27
27
  import { fileURLToPath } from 'node:url'
28
+ import { resolvePython } from './lib/python.mjs'
28
29
 
29
30
  const HERE = path.dirname(fileURLToPath(import.meta.url))
30
31
  const SCRIPTS = HERE
@@ -62,9 +63,11 @@ if (argv.includes('--help') || argv.includes('-h')) {
62
63
 
63
64
  const workRoot = path.join(REPO, '.cache', 'v3-regression')
64
65
  const workCards = path.join(workRoot, 'src', 'cards')
66
+ const workSlices = path.join(workRoot, '__slices')
65
67
  const baselineDir = path.join(REPO, 'training', 'pass1', 'baseline')
66
68
  const node = process.execPath
67
- const py = process.env.PYTHON || 'python3'
69
+ // 同 gate.mjs:改为统一解析(此前 `process.env.PYTHON || 'python3'` 不认 DSL_CARD_PYTHON、不探测)
70
+ const py = resolvePython()
68
71
 
69
72
  fs.rmSync(workRoot, { recursive: true, force: true })
70
73
  fs.mkdirSync(workCards, { recursive: true })
@@ -101,6 +104,10 @@ for (const c of cases) {
101
104
  continue
102
105
  }
103
106
  // 1) 首轮生成(无 decisions)
107
+ // 切图落点必须一并密闭化:卡片产物已隔离到 .cache/v3-regression,但切图默认仍写 src/slices
108
+ // —— 金标 spec 来自 training/fixtures(含仓库未跟踪的切图名),跑一次回归就把它们混进
109
+ // 受跟踪资产目录(实测污染 src/slices 2 个未跟踪文件),并让 ci-gate 的源码污染守卫报错。
110
+ // 口径与 tools/regress-fidelity.mjs 一致。
104
111
  const gen = run(node, [
105
112
  path.join(SCRIPTS, 'spec_to_schema_v3.mjs'),
106
113
  '--spec', specPath,
@@ -108,7 +115,9 @@ for (const c of cases) {
108
115
  '--cardIndex', String(c.card),
109
116
  '--out', workCards,
110
117
  '--force',
111
- ])
118
+ ], {
119
+ DSL_CARD_SLICES_DIR: workSlices,
120
+ })
112
121
  if (!gen.ok) {
113
122
  results.push({ regId: c.regId, pass: false, reason: 'generate 失败', detail: gen.output.slice(-600) })
114
123
  continue
@@ -377,7 +377,8 @@ def check_style_props(style, cn, loc, errors, warnings, style_ids=None):
377
377
  f"'{cv}'. Use one of {sorted(FLEX_ENUMS[ck])}")
378
378
 
379
379
 
380
- def check_components(components, errors, warnings, depth=0, style_ids=None, seen_ids=None, stats=None):
380
+ def check_components(components, errors, warnings, depth=0, style_ids=None, seen_ids=None, stats=None,
381
+ sibling_index=None):
381
382
  if style_ids is None:
382
383
  style_ids, _ = load_meta()
383
384
  load_style_maps()
@@ -389,6 +390,10 @@ def check_components(components, errors, warnings, depth=0, style_ids=None, seen
389
390
  warnings.append("Component tree depth exceeds 30, possible infinite nesting?")
390
391
  return
391
392
  for i, comp in enumerate(components):
393
+ # 递归下钻时按「单个子节点」传列表,enumerate 的 i 恒为 0;sibling_index 携带
394
+ # 真实兄弟下标,保证 "depth N[i]" 可区分同层兄弟(定位仍以 #componentId 为准)。
395
+ if sibling_index is not None:
396
+ i = sibling_index
392
397
  if not isinstance(comp, dict):
393
398
  errors.append(f"Component at depth {depth}[{i}] is not an object")
394
399
  continue
@@ -430,26 +435,29 @@ def check_components(components, errors, warnings, depth=0, style_ids=None, seen
430
435
  errors.append(f"Property '{pk}' in '{cn}' at depth {depth}[{i}] has itemValueFrom="
431
436
  f"'{prop.get('itemValueFrom')}' but no itemDefaultValue")
432
437
 
438
+ # Slots / children —— 检查须在下方 tag_messages 之前 append,"has no slots" /
439
+ # "has child components" 才能吃到本组件的 #cid 定位标记(此前检查在 tag 之后,
440
+ # 消息漏挂标记,只剩裸 depth[i])
441
+ slots = comp.get("slots", [])
442
+ if cn in CONTAINER_TYPES or cn == "Select":
443
+ if not slots:
444
+ warnings.append(f"Container '{cn}' at depth {depth}[{i}] has no slots")
445
+ else:
446
+ for slot in slots:
447
+ if slot.get("components"):
448
+ warnings.append(f"Leaf component '{cn}' at depth {depth}[{i}] has child components")
449
+
433
450
  # 到这里为止都是「本组件自身」的问题,统一挂上定位标记;子组件的消息由下面递归时
434
451
  # 各自挂自己的标记,不能被父级污染(否则点一下会选到父节点)
435
452
  tag_messages(errors, err_mark, cid_tag(cid))
436
453
  tag_messages(warnings, warn_mark, cid_tag(cid))
437
454
 
438
- # Slots / children
455
+ # 子组件下钻:enumerate 携带真实兄弟下标(sibling_index),否则嵌套层 i 恒为 0
439
456
  if cn in CONTAINER_TYPES or cn == "Select":
440
- slots = comp.get("slots", [])
441
- if not slots:
442
- warnings.append(f"Container '{cn}' at depth {depth}[{i}] has no slots")
443
- else:
444
- for slot in slots:
445
- for child in slot.get("components", []):
446
- check_components([child], errors, warnings, depth + 1, style_ids, seen_ids)
447
- else:
448
- slots = comp.get("slots", [])
449
- if slots:
450
- for slot in slots:
451
- if slot.get("components"):
452
- warnings.append(f"Leaf component '{cn}' at depth {depth}[{i}] has child components")
457
+ for slot in slots:
458
+ for idx, child in enumerate(slot.get("components", [])):
459
+ check_components([child], errors, warnings, depth + 1, style_ids, seen_ids,
460
+ stats=stats, sibling_index=idx)
453
461
 
454
462
 
455
463
  def check_data_json(schema, path, warnings):
@@ -740,8 +740,52 @@ async function syncBlankCard(page, card, { cardDir, appId, workspaceId }) {
740
740
  };
741
741
  }
742
742
 
743
- /** 最小合法空白 schema:满足 validate_schema.py 的顶层必填(version/pageId/name/dictionary/view)。 */
743
+ /**
744
+ * 最小合法空白 schema:满足 validate_schema.py 的顶层必填(version/pageId/name/dictionary/view)。
745
+ * 根样式 margin / padding / gap 显式归零,压掉渲染器对无样式容器的默认注入
746
+ * (padding:2px / gap:4px / justify-content:center)——形状与存量卡根节点一致
747
+ * (style-meta.json:marginType / paddingType,'0' = 全边统一值)。
748
+ * 同一形状还有两份内联副本(禁跨包 import):server/core/cardFiles.js 的 blankResetStyle、
749
+ * skills/dsl-card-generator lib/scaffold.mjs —— 改这里必须同步改那两处。
750
+ */
744
751
  function buildBlankSchema(card) {
752
+ const blankResetStyle = () => ({
753
+ properties: [
754
+ {
755
+ itemId: '100',
756
+ itemKey: 'flex',
757
+ itemValueFrom: '0',
758
+ itemValue: {},
759
+ itemChildren: {
760
+ properties: [{ itemId: '003', itemKey: 'gap', itemValueFrom: '0', itemValue: '0' }],
761
+ },
762
+ },
763
+ {
764
+ itemId: '400',
765
+ itemKey: 'padding',
766
+ itemValueFrom: '0',
767
+ itemValue: {},
768
+ itemChildren: {
769
+ properties: [
770
+ { itemId: '001', itemKey: 'paddingType', itemValueFrom: '0', itemValue: '0' },
771
+ { itemId: '002', itemKey: 'padding', itemValueFrom: '0', itemValue: '0' },
772
+ ],
773
+ },
774
+ },
775
+ {
776
+ itemId: '500',
777
+ itemKey: 'margin',
778
+ itemValueFrom: '0',
779
+ itemValue: {},
780
+ itemChildren: {
781
+ properties: [
782
+ { itemId: '001', itemKey: 'marginType', itemValueFrom: '0', itemValue: '0' },
783
+ { itemId: '002', itemKey: 'margin', itemValueFrom: '0', itemValue: '0' },
784
+ ],
785
+ },
786
+ },
787
+ ],
788
+ });
745
789
  return {
746
790
  version: '1.0.0',
747
791
  pageId: String(card.cardId),
@@ -752,7 +796,7 @@ function buildBlankSchema(card) {
752
796
  view: {
753
797
  width: '375',
754
798
  className: 'Root',
755
- style: { properties: [] },
799
+ style: blankResetStyle(),
756
800
  properties: [],
757
801
  eventactions: [],
758
802
  components: [],
@@ -0,0 +1,76 @@
1
+ ---
2
+ name: mbank-design-gen
3
+ description: MBank 手机银行 AI 助手风格的高保真效果图生成技能。以手绘草图/线框图为输入,按从两套银行 AI 助手设计稿(45 个画板)提炼的设计规范(卡片/尺寸/节奏/配色/层级/布局/风格化七类 token)产出风格统一的高保真 UI 效果图(HTML 精确渲染 + @2x PNG 截图,插画元素可选 ImageGen 补齐)。触发词:银行风格效果图, 高保真稿, 草图转效果图, 线框图上色, mbank 风格, 按设计规范出图, 设计稿风格生成, 效果图生成.
4
+ ---
5
+
6
+ # MBank Design Gen — 草图 → 高保真效果图
7
+
8
+ 以**手绘草图 / 线框图**为输入,套用本技能提炼的设计规范,产出与源设计稿风格一致的高保真手机 UI 效果图。
9
+
10
+ ## 0. 铁律
11
+
12
+ 1. **token 只认 `references/design-spec.md`**:所有色值/字号/圆角/间距/阴影必须来自该文件,禁止凭感觉造值;模板 `templates/mockup-template.html` 的 `:root` 是 CSS 侧唯一取值处。
13
+ 2. **先读草图结构,再套组件**:用 Read 工具读草图图片 → 逐区块标注「这是什么组件」(对照 `references/component-library.md` A–J)→ 缺失形态才允许新建组件(新建时必须全部复用既有 token)。
14
+ 3. **签名特征不可丢**:左冷蓝右暖奶油的氛围光背景、气泡非对称圆角(AI 左上直角 / 用户右上直角)、利率红 `#F3464A`、奶油促销卡、3D 金融插画溢出卡缘——这五项是风格一致性的底线,校验清单逐项查。
15
+ 4. **布局精确优先于美感发挥**:草图画的区块顺序、层级、数量照搬,不做「顺手优化」;草图没画的固定框架(状态栏/导航/输入条/Home Indicator)按组件库 A 补齐。
16
+ 5. **不硬编码业务文案**:效果图文案来自草图/用户输入;生成脚本类产物报错文案禁止写死业务实体名。
17
+
18
+ ## 1. 文件地图
19
+
20
+ ```
21
+ mbank-design-gen/
22
+ ├── SKILL.md ← 本文件(工作流入口)
23
+ ├── references/
24
+ │ ├── design-spec.md ← 权威 token 源(7 大规范 + 背景 CSS + 来源可信度)
25
+ │ └── component-library.md ← 组件拼装规范(A 全局框架 ~ J 徽标)
26
+ ├── templates/
27
+ │ └── mockup-template.html ← 375×812 画布骨架,token 已内嵌 :root
28
+ ├── tools/
29
+ │ └── screenshot.mjs ← HTML → @2x PNG(playwright,750×1624)
30
+ └── assets/
31
+ ├── robot.png ← 吉祥物(直接引用,勿重绘)
32
+ ├── icons/*.png ← 声音/设置/语音/箭头/对勾/九宫格/VS/标签底/进度 thumb
33
+ └── ref/*.png ← 4 张风格参考图(首页/对话/表格/长详情)
34
+ ```
35
+
36
+ ## 2. 工作流
37
+
38
+ ### Step 1 读草图,产出区块清单
39
+ Read 草图图片;对每个区块输出一行:`序号 | 区块类型(组件库编号,如 C 选项列表)| 内容摘要`。拿不准的区块对照 `assets/ref/` 四张参考图定形。
40
+
41
+ ### Step 2 生成 HTML
42
+ 复制 `templates/mockup-template.html` 到产物目录(如 `<工作目录>/mockup.html`),在 `.content` 的 SLOT 区按区块清单拼装组件;assets 引用改为相对/绝对路径指向本技能 `assets/`。规则:
43
+ - 只用模板 `:root` 的 token,不写裸 hex(模板外的例外仅限 design-spec 里给出的渐变组合)。
44
+ - 每个组件照 `component-library.md` 的结构/间距/字阶拼装。
45
+ - 文案用草图里的文字;草图字迹不清时按语境补全并在交付说明里列出。
46
+
47
+ ### Step 3 截图导出
48
+ ```bash
49
+ node <skill 路径>/tools/screenshot.mjs mockup.html mockup.png # 标准 375×812
50
+ node <skill 路径>/tools/screenshot.mjs mockup.html mockup.png --full # 长页整页
51
+ ```
52
+ 输出即 @2x 750 宽 PNG,与源设计稿同规格。
53
+
54
+ ### Step 4 校验清单(交付前逐项打勾)
55
+ - [ ] 背景有左冷蓝 `#DBE3F5` / 右暖奶油 `#EEE6D9` 氛围光,向下渐隐至 `#F7F8FA+`
56
+ - [ ] AI 气泡 `#FEFBF7` 左上直角;用户气泡品牌渐变右上直角
57
+ - [ ] 圆角只用 4/8/12/20/22/pill 档位;卡片 radius 20
58
+ - [ ] 字阶不超出 24/20/18/17/16/15/14/13/12/10;金额数字用 DIN
59
+ - [ ] 利率/关键涨跌数字为红 `#F3464A`;链接/可点为 `#3B73FF`
60
+ - [ ] 间距全部落在 4 的倍数上
61
+ - [ ] 底部输入条 + Home Indicator 齐全,导航双 tab + 声音/设置齐全
62
+ - [ ] 3D 插画(如有)为暖金色系且溢出卡缘;吉祥物用 `assets/robot.png` 原图
63
+ - [ ] 截图 PNG 宽 750(@2x 生效)
64
+
65
+ ### Step 5(可选)插画元素
66
+ 草图含 3D 金融插画而手头无素材时,用 ImageGen 以 design-spec §7 关键词生成:`3D render, soft studio light, glossy financial objects, gold coins, warm orange palette, soft shadows, transparent background, C4D style`,落盘后 `<img>` 引入。**UI 面板永远不用 ImageGen 生成**(文字不可控),只用于装饰插画/人物照片。
67
+
68
+ ## 3. 产物清单
69
+
70
+ | 文件 | 说明 |
71
+ |---|---|
72
+ | `mockup.html` | 高保真稿源(token 化,可继续手改) |
73
+ | `mockup.png` | @2x 效果图(750×1624 或长页等比) |
74
+ | (可选)`assets-*.png` | ImageGen 补生成的插画元素 |
75
+
76
+ 交付时在回复中列出:区块清单 → 产物路径 → 校验清单结果;若草图有歧义取舍,逐条说明。