cardbuddy 0.15.0 → 0.16.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 (77) hide show
  1. package/dist/preview-editor/assets/index-BkbBxDTT.css +1 -0
  2. package/dist/preview-editor/assets/{index-CIIfMlwI.js → index-Bro07DTa.js} +91 -88
  3. package/dist/preview-editor/index.html +2 -2
  4. package/dist/vendored/card-editor/runtime/adapter.js +2 -2
  5. package/dist/vendored/mcp/client.mjs +1 -1
  6. package/dist/vendored/server/core/ai-chat.js +251 -80
  7. package/dist/vendored/server/core/cardValidate.js +16 -5
  8. package/dist/vendored/skills/card-skill-trainer/SKILL.md +61 -6
  9. package/dist/vendored/skills/card-skill-trainer/scripts/diagnose_case.mjs +14 -82
  10. package/dist/vendored/skills/card-skill-trainer/scripts/lib/diagnosis.mjs +207 -0
  11. package/dist/vendored/skills/card-skill-trainer/scripts/lib/layout-correction-sim.mjs +62 -0
  12. package/dist/vendored/skills/card-skill-trainer/scripts/lib/paradigm-router.mjs +76 -0
  13. package/dist/vendored/skills/card-skill-trainer/scripts/lib/pixel-worker-runner.mjs +31 -0
  14. package/dist/vendored/skills/card-skill-trainer/scripts/lib/pixel-worker.mjs +138 -0
  15. package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs +24 -20
  16. package/dist/vendored/skills/card-skill-trainer/scripts/lib/telemetry.mjs +46 -0
  17. package/dist/vendored/skills/card-skill-trainer/scripts/plan_next_round.mjs +4 -1
  18. package/dist/vendored/skills/card-skill-trainer/scripts/run_round.mjs +279 -90
  19. package/dist/vendored/skills/card-skill-trainer/scripts/score_round.mjs +74 -2
  20. package/dist/vendored/skills/card-skill-trainer/scripts/sink_rules.mjs +127 -0
  21. package/dist/vendored/skills/dsl-card-generator/SKILL.md +93 -27
  22. package/dist/vendored/skills/dsl-card-generator/references/dsl_structure.md +1 -15
  23. package/dist/vendored/skills/dsl-card-generator/references/expression_engine.md +11 -20
  24. package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md +169 -44
  25. package/dist/vendored/skills/dsl-card-generator/references/ir-format.md +87 -3
  26. package/dist/vendored/skills/dsl-card-generator/references/iteration_protocol.md +35 -6
  27. package/dist/vendored/skills/dsl-card-generator/references/quickref.md +28 -27
  28. package/dist/vendored/skills/dsl-card-generator/references/recipes.md +30 -8
  29. package/dist/vendored/skills/dsl-card-generator/references/rules.md +3 -2
  30. package/dist/vendored/skills/dsl-card-generator/references/scripts_reference.md +5 -2
  31. package/dist/vendored/skills/dsl-card-generator/references/slices_convention.md +2 -3
  32. package/dist/vendored/skills/dsl-card-generator/references/spec_to_schema_patterns.md +1 -4
  33. package/dist/vendored/skills/dsl-card-generator/scripts/add_component.mjs +5 -14
  34. package/dist/vendored/skills/dsl-card-generator/scripts/autofix_schema.py +88 -0
  35. package/dist/vendored/skills/dsl-card-generator/scripts/check_fidelity.mjs +143 -42
  36. package/dist/vendored/skills/dsl-card-generator/scripts/check_topology.py +0 -35
  37. package/dist/vendored/skills/dsl-card-generator/scripts/expand_ir.mjs +99 -53
  38. package/dist/vendored/skills/dsl-card-generator/scripts/gate.mjs +5 -2
  39. package/dist/vendored/skills/dsl-card-generator/scripts/iterate.mjs +388 -29
  40. package/dist/vendored/skills/dsl-card-generator/scripts/lib/component_contract.mjs +315 -0
  41. package/dist/vendored/skills/dsl-card-generator/scripts/lib/layout-tokens.mjs +1 -1
  42. package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.mjs +23 -0
  43. package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.py +0 -37
  44. package/dist/vendored/skills/dsl-card-generator/scripts/lib/python.mjs +99 -0
  45. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/adaptive-width.mjs +105 -0
  46. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/bindings.mjs +260 -0
  47. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/expr.mjs +52 -0
  48. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/image.mjs +96 -0
  49. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/registry.mjs +166 -0
  50. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/structure.mjs +127 -0
  51. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/walk.mjs +61 -0
  52. package/dist/vendored/skills/dsl-card-generator/scripts/lib/scope_alias.mjs +125 -0
  53. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_assemble.mjs +325 -41
  54. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_extract.mjs +112 -6
  55. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_shared.mjs +0 -6
  56. package/dist/vendored/skills/dsl-card-generator/scripts/lint_card.mjs +119 -78
  57. package/dist/vendored/skills/dsl-card-generator/scripts/preflight.mjs +48 -50
  58. package/dist/vendored/skills/dsl-card-generator/scripts/readiness.mjs +634 -0
  59. package/dist/vendored/skills/dsl-card-generator/scripts/register_card_template.mjs +5 -8
  60. package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs +5 -10
  61. package/dist/vendored/skills/dsl-card-generator/scripts/spec_audit.mjs +122 -8
  62. package/dist/vendored/skills/dsl-card-generator/scripts/v3_regression.mjs +3 -1
  63. package/dist/vendored/skills/dsl-card-generator/scripts/validate_schema.py +23 -15
  64. package/dist/vendored/skills/shared/exit-codes.md +79 -0
  65. package/dist/vendored/skills/shared/spec-contract.md +118 -0
  66. package/dist/vendored/skills/sketch-spec-to-card/SKILL.md +26 -9
  67. package/dist/vendored/skills/sketch-spec-to-card/references/spec-schema.md +3 -3
  68. package/dist/vendored/skills/sketch-spec-to-card/scripts/build_prompt.py +0 -8
  69. package/dist/vendored/skills/sketch-spec-to-card/scripts/cluster_states.py +14 -25
  70. package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py +91 -47
  71. package/dist/vendored/skills/sketch-spec-to-card/scripts/png_utils.py +0 -5
  72. package/dist/vendored/skills/sketch-spec-to-card/scripts/test_text_only_artboard.py +75 -15
  73. package/dist/vendored/skills/sketch-spec-to-card/scripts/vision.py +40 -34
  74. package/package.json +1 -1
  75. package/dist/preview-editor/assets/index-DQn0zQBP.css +0 -1
  76. package/dist/vendored/skills/card-skill-trainer/scripts/test_missing_slice.py +0 -122
  77. package/dist/vendored/skills/dsl-card-generator/scripts/analyze_component_usage.mjs +0 -153
@@ -18,31 +18,40 @@
18
18
  * 报告里的 `elements` 是**机器门禁字段**(iterate.mjs --gate 直接读):
19
19
  * - elements.texts.missing = 设计稿里有、schema 里找不到的文案(漏建 / 被占位值顶掉)
20
20
  * - elements.texts.invented = schema 里出现、设计稿里没有的**自造文案**(占位符 / 编的样例数据)
21
- * - elements.slices = 切图覆盖(spec / audit / schema 引用三方计数,信息项)
21
+ * - elements.slices = 切图覆盖(spec / audit / schema 引用三方计数 + 逐名清单)
22
22
  * 判据只有一条:**设计稿的要素是固定真值,迭代只许改样式布局,不许丢要素、不许自造内容**。
23
23
  *
24
+ * ⚠️ 本脚本**只有 --card 一个卡号来源**(文本比对与切图计数共用它)。
25
+ * 历史上切图计数自己写死 `spec.cards[0]`,与 `--card` 打架 ⇒ 多卡画板报错卡。
26
+ * `--audit` 缺省读 `.cache/ai-scratch/<schema 目录名>.audit.json`(见 lib/paths.mjs)。
27
+ *
24
28
  * 用法:
25
29
  * node scripts/check_fidelity.mjs --spec UI/<画板>/spec.json --schema src/cards/<id>/schema.json
26
- * node scripts/check_fidelity.mjs --spec <spec.json> --schema <schema.json> --card 1 --json
27
- * node scripts/check_fidelity.mjs --spec <spec.json> --schema <schema.json> --font-tol 1 --color-tol 16
30
+ * node scripts/check_fidelity.mjs --spec <spec.json> --schema <schema.json> --card 2 --json
31
+ * node scripts/check_fidelity.mjs --spec <spec.json> --schema <schema.json> --audit <audit.json> --font-tol 1 --color-tol 16
28
32
  */
29
33
  import fs from 'node:fs'
30
34
  import path from 'node:path'
31
35
  import { pathToFileURL } from 'node:url'
36
+ import { scratchDir as SCRATCH_DIR } from './lib/paths.mjs'
37
+ import { collectSliceRefStrings } from './lib/slice_dedupe.mjs'
38
+ import { walkNodes } from './lib/rules/walk.mjs'
32
39
 
33
40
  function parseArgs(argv) {
34
- const out = { spec: '', schema: '', card: 1, json: false, fontTol: 2, colorTol: 24, data: '' }
41
+ const out = { spec: '', schema: '', card: 1, json: false, fontTol: 2, colorTol: 24, data: '', audit: '', id: '' }
35
42
  for (let i = 0; i < argv.length; i++) {
36
43
  const a = argv[i]
37
44
  if (a === '--spec') out.spec = argv[++i] || ''
38
45
  else if (a === '--schema') out.schema = argv[++i] || ''
39
46
  else if (a === '--data') out.data = argv[++i] || ''
47
+ else if (a === '--audit') out.audit = argv[++i] || ''
48
+ else if (a === '--id') out.id = argv[++i] || ''
40
49
  else if (a === '--card') out.card = Number(argv[++i]) || 1
41
50
  else if (a === '--json') out.json = true
42
51
  else if (a === '--font-tol') out.fontTol = Number(argv[++i]) || 2
43
52
  else if (a === '--color-tol') out.colorTol = Number(argv[++i]) || 24
44
53
  else if (a === '-h' || a === '--help') {
45
- console.log('Usage: node check_fidelity.mjs --spec <spec.json> --schema <schema.json> [--data data.json] [--card 1] [--json] [--font-tol 2] [--color-tol 24]')
54
+ console.log('Usage: node check_fidelity.mjs --spec <spec.json> --schema <schema.json> [--data data.json] [--card 1] [--audit .cache/ai-scratch/<id>.audit.json] [--json] [--font-tol 2] [--color-tol 24]')
46
55
  process.exit(0)
47
56
  }
48
57
  }
@@ -132,13 +141,18 @@ function lookupPath(p, values) {
132
141
  * 不解析的话「绑了变量」的卡会 100% 报 missing-text —— 门禁逼着模型把变量拆回字面量,
133
142
  * 这正是此前产物 dictionary / data.json 全空的直接推手之一。
134
143
  */
135
- function resolveExprCandidates(expr, values) {
144
+ function resolveExprCandidates(expr, values, slotFields) {
136
145
  const out = []
137
146
  const re = /\$([A-Za-z_][A-Za-z0-9_]*(?:\.[A-Za-z0-9_]+|\[\d+\])*)/g
138
147
  let m
139
148
  while ((m = re.exec(expr))) {
140
149
  const v = lookupPath(m[1], values)
141
- if (v != null && typeof v !== 'object') out.push(String(v))
150
+ if (v != null && typeof v !== 'object') {
151
+ out.push(String(v))
152
+ } else if (slotFields && slotFields.has(m[1])) {
153
+ // slotScope 行模板字段($month / $income 等):真值在数组元素每行上,不在顶层变量
154
+ for (const sv of slotFields.get(m[1])) out.push(String(sv))
155
+ }
142
156
  }
143
157
  // '$showAll ? "收起" : "查看更多"' 这类分支字面量也是真实会显示的文案
144
158
  for (const q of expr.match(/'([^']*)'|"([^"]*)"/g) || []) out.push(q.slice(1, -1))
@@ -146,10 +160,10 @@ function resolveExprCandidates(expr, values) {
146
160
  }
147
161
 
148
162
  // 一个 schema Text 节点的候选字面量:直接字面 value + 绑定解析值 + itemDefaultValue
149
- function candidates(t, values = {}) {
163
+ function candidates(t, values = {}, slotFields) {
150
164
  const c = []
151
165
  if (typeof t.value === 'string' && !t.value.includes('$') && !t.value.includes("'")) c.push(t.value)
152
- if (typeof t.value === 'string' && t.value.includes('$')) c.push(...resolveExprCandidates(t.value, values))
166
+ if (typeof t.value === 'string' && t.value.includes('$')) c.push(...resolveExprCandidates(t.value, values, slotFields))
153
167
  if (t.itemDefaultValue != null) c.push(String(t.itemDefaultValue))
154
168
  return c.map(norm).filter(Boolean)
155
169
  }
@@ -177,11 +191,14 @@ function colorClose(a, b, tol) {
177
191
  * @returns {object} report(含 elements 门禁字段)
178
192
  */
179
193
  export function buildFidelityReport(input = {}) {
180
- const args = { card: 1, fontTol: 2, colorTol: 24, data: '', ...input }
194
+ const args = { card: 1, fontTol: 2, colorTol: 24, data: '', audit: '', id: '', ...input }
181
195
  const specPath = path.resolve(args.spec)
182
196
  const schemaPath = path.resolve(args.schema)
183
197
  if (!fs.existsSync(specPath)) throw new Error(`spec.json 不存在: ${specPath}`)
184
198
  if (!fs.existsSync(schemaPath)) throw new Error(`schema.json 不存在: ${schemaPath}`)
199
+ // 卡片 id 的权威来源是 schema 所在目录名(`src/cards/<id>/schema.json`),
200
+ // 显式 --id 只用于 schema 被放到别处(如临时 out 目录)时覆盖。
201
+ const cardId = args.id || path.basename(path.dirname(schemaPath))
185
202
 
186
203
  const spec = JSON.parse(fs.readFileSync(specPath, 'utf8'))
187
204
  const schema = JSON.parse(fs.readFileSync(schemaPath, 'utf8'))
@@ -195,6 +212,27 @@ export function buildFidelityReport(input = {}) {
195
212
  } catch {
196
213
  /* data.json 坏了不阻断文本对齐检查 */
197
214
  }
215
+ // slotScope 行模板字段($month / $income 等)的真值在数组元素的每行上,不在顶层变量,
216
+ // 直接解析必然全 null ⇒ 列表行文案 100% 误报 missing-text。补齐:把顶层数组各元素的
217
+ // 字段值收集成“全部行值”候选池(口径与 lib/rules/bindings.mjs 的数组字段集合一致),
218
+ // 仅用于候选匹配,不改渲染与主流程语义。
219
+ const slotFields = new Map()
220
+ const absorbSlotArray = (arr) => {
221
+ if (!Array.isArray(arr)) return
222
+ for (const item of arr) {
223
+ if (!item || typeof item !== 'object') continue
224
+ for (const [k, v] of Object.entries(item)) {
225
+ if (v == null || typeof v === 'object') continue
226
+ if (!slotFields.has(k)) slotFields.set(k, new Set())
227
+ slotFields.get(k).add(String(v))
228
+ }
229
+ }
230
+ }
231
+ for (const src of [
232
+ ...(schema.dictionary?.inputParams || []).map((p) => p && p.defaultValue),
233
+ ...Object.values(schema.dictionary?.mocks || {}),
234
+ ...Object.values(values),
235
+ ]) absorbSlotArray(src)
198
236
  const cards = spec.cards || []
199
237
  const card = cards[args.card - 1]
200
238
  if (!card) throw new Error(`卡片序号 ${args.card} 不存在(共 ${cards.length} 张卡)`)
@@ -208,7 +246,7 @@ export function buildFidelityReport(input = {}) {
208
246
 
209
247
  for (const st of specTexts) {
210
248
  const stN = norm(st.text)
211
- const hit = schemaTexts.find((s) => candidates(s, values).some((c) => c === stN || c.includes(stN) || stN.includes(c)))
249
+ const hit = schemaTexts.find((s) => candidates(s, values, slotFields).some((c) => c === stN || c.includes(stN) || stN.includes(c)))
212
250
  if (!hit) {
213
251
  findings.push({ type: 'missing-text', spec: st.text, detail: 'schema 中无对应 Text 节点(可能漏建)' })
214
252
  continue
@@ -237,14 +275,45 @@ export function buildFidelityReport(input = {}) {
237
275
 
238
276
  // 去重:同一段文案在列表里出现 N 次(3 条产品行)只需报一次,否则清单被重复项淹没
239
277
  const missingTexts = [...new Set(findings.filter((f) => f.type === 'missing-text').map((f) => f.spec))]
278
+
279
+ // ── 全类型要素清单(2026-09-25):文本之外,图标 / 分割线也要对账 ──
280
+ // 此前 elements 只有 texts + slices:spec 的 symbol(图标)与 shape(分割线/色块)漏建
281
+ // 不触发任何门禁(用户实测抱怨「基本要素不齐全」的直接根因之一)。
282
+ // 判据只用结构特征(类型 / 几何),不用业务名(识别铁律):
283
+ // · 图标面 = spec symbol 数 vs schema Icon 组件数(symbol 走 Icon 矢量或 slice 位图两种
284
+ // 实现都合法,故数量缺口只做 warning 级提示,不进硬门禁——无金标可校准误报);
285
+ // · 分割线 = spec 细长条 shape(min(w,h)<=2 且 max(w,h)>=40)vs schema Divider 组件数
286
+ // (R-DIVIDER:列表项间分割线必须用 Divider,细长条正是它的设计稿形态)。
287
+ let symbolGap = 0
288
+ let dividerGap = 0
289
+ const specSymbols = (card.elements || []).filter((e) => e?.type === 'symbol').length
290
+ const specShapes = (card.elements || []).filter((e) => e?.type === 'shape')
291
+ const specDividerish = specShapes.filter((e) => {
292
+ const w = Number(e?.rect?.width) || 0
293
+ const h = Number(e?.rect?.height) || 0
294
+ return Math.min(w, h) <= 2 && Math.max(w, h) >= 40
295
+ }).length
296
+ let iconCount = 0
297
+ let dividerCount = 0
298
+ walkNodes(schema.view || schema, (n) => {
299
+ if (n.className === 'Icon') iconCount++
300
+ else if (n.className === 'Divider') dividerCount++
301
+ })
302
+ symbolGap = Math.max(0, specSymbols - iconCount)
303
+ dividerGap = Math.max(0, specDividerish - dividerCount)
304
+
240
305
  const elements = {
241
306
  texts: {
242
307
  total: specTexts.length,
243
308
  matched,
244
309
  missing: missingTexts,
245
- invented: inventedTexts(specTexts, schemaTexts, values),
310
+ invented: inventedTexts(specTexts, schemaTexts, values, slotFields),
246
311
  },
247
- slices: sliceCoverage({ specPath, schemaPath, schema }),
312
+ // 图标 / 形状(warning 级信息项:缺口 > 0 时提示自查,不单独判红——
313
+ // symbol 可能走 slice 位图实现、shape 可能是背景装饰,数量对账有结构性误差)
314
+ symbols: { spec: specSymbols, schemaIcon: iconCount, gap: symbolGap },
315
+ shapes: { specTotal: specShapes.length, specDividerish, schemaDivider: dividerCount, dividerGap },
316
+ slices: sliceCoverage({ specPath, cardIndex: args.card, cardId, auditPath: args.audit, schema }),
248
317
  }
249
318
  const violations = findings.length
250
319
  return {
@@ -271,12 +340,12 @@ export function buildFidelityReport(input = {}) {
271
340
  * 只统计**看起来像内容**的短文本(≥2 字、非纯符号/数字单位),避免把「%」「查看更多」这类
272
341
  * 通用 UI 文案误报成自造。
273
342
  */
274
- function inventedTexts(specTexts, schemaTexts, values) {
343
+ function inventedTexts(specTexts, schemaTexts, values, slotFields) {
275
344
  const specN = specTexts.map((t) => norm(t.text))
276
345
  const out = []
277
346
  const seen = new Set()
278
347
  for (const s of schemaTexts) {
279
- for (const c of candidates(s, values)) {
348
+ for (const c of candidates(s, values, slotFields)) {
280
349
  const v = String(c || '').trim()
281
350
  if (v.length < 2 || seen.has(v)) continue
282
351
  if (/^[%%·・\-—+*/\d.,::()()\s]+$/.test(v)) continue // 纯符号 / 数字 / 单位:不是内容要素
@@ -287,41 +356,67 @@ function inventedTexts(specTexts, schemaTexts, values) {
287
356
  return out.slice(0, 20)
288
357
  }
289
358
 
290
- /** 切图覆盖:spec 声明数 / audit 落盘数 / schema 引用数(信息项,不单独判红) */
291
- function sliceCoverage({ specPath, schemaPath, schema }) {
292
- const specDir = path.dirname(specPath)
293
- const auditPath = path.join(path.dirname(schemaPath), '.audit.json')
359
+ /** 切图覆盖:设计稿声明数 / audit 落盘数 / schema 引用数(信息项,不单独判红)。
360
+ *
361
+ * 2026-09-24 修两处取数缺陷(gen-1 实测把这两处都踩了,且**静默**给出错误结论):
362
+ *
363
+ * ① **取错卡**:原来写死 `spec.cards[0]`,而 `--card` 参数在文本比对里用的是 `cards[card-1]`。
364
+ * 37 号设计稿实测 card1 有 0 张切片、card2 有 1 张 —— gen-1 用的是 card2.png,
365
+ * 于是 `specCount` 报 0,观感是「设计稿本来就没有切图,不用补」。
366
+ * 现在与文本比对**同一 cardIndex**,卡号只有一个来源。
367
+ *
368
+ * ② **审计路径凭空拼**:原来取 `path.dirname(schemaPath)/.audit.json`(= `src/cards/<id>/.audit.json`),
369
+ * 而 S2 审计的真实落点是 `.cache/ai-scratch/<id>.audit.json`(ai-chat 的 S2 提示词 + --save 明写)。
370
+ * 那个 `.audit.json` 从来没存在过 ⇒ `auditCount` 恒为 null,且 catch 把「路径写错」和
371
+ * 「非设计稿链路无审计」当同一回事吞掉。现在走 `lib/paths.mjs` 的 `cardAuditPath()` 单源,
372
+ * 并区分 `auditMissing`(真没有)与 `auditCount`(有但为 0)。
373
+ *
374
+ * 三方计数只是**摘要**;「设计稿声明了却没被引用」的逐名比对在 `readiness.mjs` 的 slices 门禁里做
375
+ * (那里才需要给出「少了哪一张」的可执行清单)。
376
+ */
377
+ function sliceCoverage({ specPath, cardIndex = 1, cardId = '', auditPath = '', schema }) {
294
378
  let specCount = null
295
- let auditCount = null
379
+ let declared = []
296
380
  try {
297
381
  const spec = JSON.parse(fs.readFileSync(specPath, 'utf8'))
298
- const card = (spec.cards || [])[0]
299
- specCount = (card?.elements || []).filter((e) => e && e.type === 'slice').length
382
+ const card = (spec.cards || [])[cardIndex - 1]
383
+ const sliceEls = (card?.elements || []).filter((e) => e && e.type === 'slice')
384
+ specCount = sliceEls.length
385
+ declared = sliceEls.map((e) => e.name || e.slice || e.ref || '').filter(Boolean)
300
386
  } catch {
301
387
  /* 拿不到就不报 */
302
388
  }
303
- try {
304
- const audit = JSON.parse(fs.readFileSync(path.resolve(auditPath), 'utf8'))
305
- auditCount = Array.isArray(audit.slices) ? audit.slices.length : null
306
- } catch {
307
- /* 无 audit 属正常(非设计稿链路) */
308
- }
309
- const refs = new Set()
310
- const scan = (n) => {
311
- if (!n || typeof n !== 'object') return
312
- for (const p of n.properties || []) {
313
- if (typeof p.itemValue === 'string' && p.itemValue.includes('/slices/')) refs.add(p.itemValue)
314
- }
315
- for (const g of n.style?.properties || []) {
316
- for (const c of g.itemChildren?.properties || []) {
317
- if (typeof c.itemValue === 'string' && c.itemValue.includes('/slices/')) refs.add(c.itemValue)
318
- }
389
+ const resolvedAudit = auditPath || (cardId ? path.join(SCRATCH_DIR, `${cardId}.audit.json`) : '')
390
+ let auditCount = null
391
+ let auditMissing = true
392
+ let auditSlices = []
393
+ if (resolvedAudit && fs.existsSync(resolvedAudit)) {
394
+ try {
395
+ const audit = JSON.parse(fs.readFileSync(resolvedAudit, 'utf8'))
396
+ auditSlices = (Array.isArray(audit.slices) ? audit.slices : []).map((s) => ({
397
+ name: s?.name || '',
398
+ exists: s?.exists !== false,
399
+ verdict: s?.verdict || '',
400
+ baked: Boolean(s?.baked),
401
+ }))
402
+ auditCount = auditSlices.length
403
+ auditMissing = false
404
+ } catch {
405
+ /* 审计坏了:按「没有」处理,别把解析失败当成 0 张切图 */
319
406
  }
320
- for (const c of n.components || []) scan(c)
321
- for (const sl of n.slots || []) for (const c of sl.components || []) scan(c)
322
407
  }
323
- scan(schema.view || schema)
324
- return { specCount, auditCount, schemaRefs: refs.size, refs: [...refs].slice(0, 40) }
408
+ // 引用串一律走 slice_dedupe 的同一份正则(覆盖 properties + style 子键 + 表达式内嵌路径),
409
+ // 不再手写一遍 scan —— 手写版漏掉「表达式里嵌 /slices/」这种形态。
410
+ const refs = collectSliceRefStrings(schema)
411
+ return {
412
+ specCount,
413
+ auditCount,
414
+ auditPath: auditMissing ? null : resolvedAudit,
415
+ schemaRefs: refs.length,
416
+ refs,
417
+ declared,
418
+ auditSlices,
419
+ }
325
420
  }
326
421
 
327
422
  function main() {
@@ -346,6 +441,12 @@ function main() {
346
441
  console.log(`\n[自造内容] ${elements.texts.invented.length} 条 schema 里出现、设计稿里没有的文案(占位值?):`)
347
442
  for (const t of elements.texts.invented) console.log(` - "${t}"`)
348
443
  }
444
+ if (elements.symbols?.gap > 0) {
445
+ console.log(`\n[图标缺口] 设计稿 symbol ${elements.symbols.spec} 个,schema Icon 组件 ${elements.symbols.schemaIcon} 个(缺 ${elements.symbols.gap})——symbol 走 slice 位图实现也合法,请逐个核对图标是否都有落点`)
446
+ }
447
+ if (elements.shapes?.dividerGap > 0) {
448
+ console.log(`\n[分割线缺口] 设计稿细长条 shape ${elements.shapes.specDividerish} 条,schema Divider 组件 ${elements.shapes.schemaDivider} 个(缺 ${elements.shapes.dividerGap})——分割线必须用 Divider 组件(R-DIVIDER),禁止 Row+背景色模拟`)
449
+ }
349
450
  if (!violations) {
350
451
  console.log('[OK] 保真度对齐:文本覆盖完整,字号/颜色均在容差内。')
351
452
  } else {
@@ -356,27 +356,6 @@ def _walk(node, depth=0):
356
356
  yield from _walk(c, depth + 1)
357
357
 
358
358
 
359
- def _get_text_value(node):
360
- for p in node.get("properties") or []:
361
- if isinstance(p, dict) and p.get("itemKey") == "value":
362
- iv = p.get("itemValue")
363
- if isinstance(iv, str):
364
- return iv
365
- return ""
366
-
367
-
368
- def _get_font_size(node):
369
- for grp in (node.get("style") or {}).get("properties") or []:
370
- if isinstance(grp, dict) and grp.get("itemKey") == "font":
371
- for c in (grp.get("itemChildren") or {}).get("properties") or []:
372
- if isinstance(c, dict) and c.get("itemKey") == "fontSize":
373
- try:
374
- return int(c.get("itemValue"))
375
- except (TypeError, ValueError):
376
- return None
377
- return None
378
-
379
-
380
359
  def _has_event_action(node, event_key=None, action_type=None):
381
360
  for ea in node.get("eventactions") or []:
382
361
  if not isinstance(ea, dict):
@@ -391,20 +370,6 @@ def _has_event_action(node, event_key=None, action_type=None):
391
370
  return False
392
371
 
393
372
 
394
- def _get_custom_action_codes(node):
395
- codes = []
396
- for ea in node.get("eventactions") or []:
397
- if not isinstance(ea, dict):
398
- continue
399
- if (ea.get("action") or {}).get("actionType") != "customAction":
400
- continue
401
- for p in (ea.get("action") or {}).get("properties") or []:
402
- if isinstance(p, dict) and p.get("itemKey") == "function":
403
- iv = p.get("itemValue")
404
- if isinstance(iv, dict) and iv.get("code"):
405
- codes.append(iv["code"])
406
- return codes
407
-
408
373
 
409
374
  def check_v2_intent_coverage(view, schema, recipes):
410
375
  """检查生成卡命中哪些布局意图,给出 canonical 拓扑对照建议。
@@ -1,43 +1,8 @@
1
1
  #!/usr/bin/env node
2
- /**
3
- * 跨平台 Python 解释器探测:DSL_CARD_PYTHON > WORKBUDDY_PYTHON > 真探测 python3 / python / py。
4
- *
5
- * 为什么必须真跑一次 --version(而不是「能不能 spawn」):Windows 上 `python3` 常是
6
- * Microsoft Store 的应用执行别名 —— 进程能启动,却立刻以 9009 退出,**不是 ENOENT**。
7
- * 只按 spawn 异常判断就会钉死这个假解释器,autofix / validate 全部静默不执行,
8
- * 只回一句「validate 未执行(python 不可用)」,调用方(iterate / expand_ir)看到的是一个
9
- * **永远修不好**的 validate error —— 实测模型为它空转 20 轮、每轮都重跑 iterate。
10
- */
11
- function probePython(bin) {
12
- try {
13
- const r = spawnSync(bin, ['--version'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
14
- if (r.status !== 0) return false;
15
- return /Python \d/i.test(`${r.stdout || ''}${r.stderr || ''}`);
16
- } catch {
17
- return false;
18
- }
19
- }
20
-
21
- function pythonCandidates() {
22
- const out = [];
23
- const seen = new Set();
24
- const push = (bin) => {
25
- const b = String(bin || '').trim();
26
- if (!b || seen.has(b)) return;
27
- seen.add(b);
28
- out.push(b);
29
- };
30
- // 显式指定的解释器优先(可用就只认它;探测不过也保留一次机会——可能是带参数的包装器)
31
- for (const env of [process.env.DSL_CARD_PYTHON, process.env.WORKBUDDY_PYTHON]) {
32
- if (!env) continue;
33
- if (probePython(env)) { push(env); return out; }
34
- push(env);
35
- }
36
- for (const bin of ['python3', 'python', 'py']) if (probePython(bin)) push(bin);
37
- // 探测全失败:仍按常见名字逐一试跑,让报错里能看到真实失败原因(stderr 原样带出)
38
- for (const bin of ['python3', 'python']) push(bin);
39
- return out;
40
- }
2
+ // Python 解释器解析已集中到 lib/python.mjs(单一来源:四段环境变量链 + Windows Store
3
+ // 假别名识别)。本文件要的是**候选列表**(逐个试跑,好把真实 stderr 带进报错),
4
+ // 不是「最优那一个」。
5
+ import { probePython, pythonCandidates, resolvePython } from './lib/python.mjs'
41
6
  /**
42
7
  * expand_ir.mjs — 紧凑 IR(Intermediate Representation)⇄ 完整 schema 双向转换。
43
8
  *
@@ -74,6 +39,7 @@ import { copyCardDesignImage } from './lib/design_image.mjs'
74
39
  import { metaDir, projectRoot, skillRoot } from './lib/paths.mjs'
75
40
  import { buildContentIndex, rewriteSliceRefs, sha256File, sliceNameMatches } from './lib/slice_dedupe.mjs'
76
41
  import { findPixelTwin, readPng } from './lib/slice_pixels.mjs'
42
+ import { normalizeItemAliases } from './lib/scope_alias.mjs'
77
43
 
78
44
  /* ------------------------------------------------------------------ */
79
45
  /* 加载 meta → itemId 映射(与 validate_schema.py 同源,零偏离) */
@@ -150,6 +116,27 @@ export function styleKeyTableText() {
150
116
  * 静默放行是本轮 700 万 token 的主要起点之一:问题的报错信息从「flexGrow 不合法」
151
117
  * 退化成下游 validate 的「整卡 FAIL」,模型只能推倒重写整份 IR。
152
118
  */
119
+ /**
120
+ * 作用域别名归一化(**不是报错禁止**)——实现见 `lib/scope_alias.mjs`。
121
+ *
122
+ * 2026-09-24 复盘定论:`$item.xxx` 这类写法**不是模型的问题,是我们自己的问题**。
123
+ * 系统提示词与 ir-format.md 里手写了一条不存在的契约(提交 56e9894「子树内 $item.xxx /
124
+ * $_index」),模型只是老实照做。权威契约来自运行时 `card-editor/runtime/evaluate.js`
125
+ * 的 `makeSlotScope`:`slotScope = 外层 ∪ item 字段逐个展开 ∪ {$$: item, _index: 索引}`
126
+ * —— **没有 `item` 这个键**;全仓 50 张真卡的列表插槽绑定也 100% 用扁平字段名(`$name` /
127
+ * `$label` / `$accountNum`),`$item.` 出现 0 次。
128
+ *
129
+ * 上一版的处理是「写盘前 exit=3 中止 + lint 报 ERROR + 三份文档写满 ⛔ 没有 $item」——
130
+ * 那等于教错了再罚学生:模型必须先背对答案才不被退回,而答案本来就不该由它背。
131
+ *
132
+ * 正确做法是把 IR 当成**编译器输入**:编译器对公认别名做语义保持的归一化即可,
133
+ * schema 里永远只出现规范形(`$字段` / `$$` / `$_index`),模型写哪种都能过。
134
+ *
135
+ * 唯一的例外闸:卡片若真的声明了名为 `item` 的根变量(dictionary.inputParams[].key),
136
+ * 则 `$item.x` 是合法取值,整体不归一化(见 lib 头注释)。
137
+ */
138
+
139
+
153
140
  const unknownStyleKeys = []
154
141
  function resetUnknownStyleKeys() {
155
142
  unknownStyleKeys.length = 0
@@ -488,6 +475,13 @@ function applyProps(node, ir) {
488
475
  for (const ev of ir.e || []) node.eventactions.push(makeEvent(ev))
489
476
  }
490
477
 
478
+ // 容器类名单:与 validate_schema.py 的 CONTAINER_TYPES(+ Select)对齐。
479
+ // 这些 className 的节点必须始终带 slots(无子组件时兜底空 default slot)。
480
+ const CONTAINER_CLASSNAMES = new Set([
481
+ 'Root', 'Row', 'Column', 'AbsoluteLayout', 'MultiColumn',
482
+ 'ListLayout', 'GridLayout', 'SingleColumn', 'CheckGroup', 'RadioButton', 'Select',
483
+ ])
484
+
491
485
  function expandNode(ir, ctx) {
492
486
  const className = ir.c
493
487
  if (!className) throw new Error('IR 节点缺少 className (c)')
@@ -518,7 +512,14 @@ function expandNode(ir, ctx) {
518
512
  components: kids.map((k) => expandNode(k, ctx)),
519
513
  })
520
514
  }
521
- if (slotDefs.length) node.slots = slotDefs
515
+ if (slotDefs.length) {
516
+ node.slots = slotDefs
517
+ } else if (CONTAINER_CLASSNAMES.has(className)) {
518
+ // 契约(dsl_structure.md §slots / component_rules.md):容器类节点即使无子组件也须带
519
+ // 空 default slot —— 否则 validate_schema.py WARN "has no slots",且下游(check_topology、
520
+ // 预览器)按 slot 结构消费时缺字段。
521
+ node.slots = [{ slotKey: 'default', slotName: '默认插槽', slotSwitch: '1', components: [] }]
522
+ }
522
523
  return node
523
524
  }
524
525
 
@@ -603,6 +604,13 @@ function normalizeInputParams(params) {
603
604
  */
604
605
  export function expandIR(ir) {
605
606
  resetUnknownStyleKeys()
607
+ // 作用域别名归一化(**在扩展开头做**,早于 collectRootBindings 推断 inputParams)。
608
+ // 放在这里而不是 CLI 分支里:iterate.mjs 是直接 import expandIR 在进程内跑的,
609
+ // 只写在 CLI 里会让「AI 建卡主路径」(iterate)完全绕过归一化 —— 历史事故的翻版。
610
+ const knownRoots = new Set(
611
+ ((ir.dictionary && ir.dictionary.inputParams) || []).map((p) => p && p.key).filter(Boolean),
612
+ )
613
+ const aliasFixes = normalizeItemAliases(ir, { knownRoots })
606
614
  const ctx = { n: 0, nextId: () => `comp_${++ctx.n}` }
607
615
  const viewChildren = (ir.children || []).map((k) => expandNode(k, ctx))
608
616
  const dictionary = ir.dictionary
@@ -642,7 +650,7 @@ export function expandIR(ir) {
642
650
  schema.dictionary.inputParams = normalizeInputParams(schema.dictionary.inputParams)
643
651
  const data = {}
644
652
  for (const p of schema.dictionary.inputParams || []) data[p.key] = p.defaultValue
645
- return { schema, data }
653
+ return { schema, data, aliasFixes }
646
654
  }
647
655
 
648
656
  /* ------------------------------------------------------------------ */
@@ -802,6 +810,27 @@ function compareNodes(a, b, p) {
802
810
  /* ------------------------------------------------------------------ */
803
811
  /* CLI */
804
812
  /* ------------------------------------------------------------------ */
813
+ /**
814
+ * 递归枚举目录下全部文件。要素包 slices/ 是嵌套目录(如 8.icon/通用/警示-#999@3x.png),
815
+ * 旧版平铺 readdirSync 只扫顶层够不着真身 → exit=1 + fs_list 逐层摸索 + fs_copy 手工搬运
816
+ * (gen-1 实测约 10 次调用白烧,占该回合前半段 38%)。
817
+ */
818
+ function listSliceFilesDeep(dir) {
819
+ const out = []
820
+ const stack = [dir]
821
+ while (stack.length) {
822
+ const cur = stack.pop()
823
+ let entries
824
+ try { entries = fs.readdirSync(cur, { withFileTypes: true }) } catch { continue }
825
+ for (const ent of entries) {
826
+ const p = path.join(cur, ent.name)
827
+ if (ent.isDirectory()) stack.push(p)
828
+ else if (ent.isFile()) out.push(p)
829
+ }
830
+ }
831
+ return out
832
+ }
833
+
805
834
  function collectSliceRefs(node, out = new Set()) {
806
835
  if (!node || typeof node !== 'object') return out
807
836
  for (const p of node.properties || []) {
@@ -845,10 +874,17 @@ export function syncReferencedSlices(schema, irPath, slicesDirs) {
845
874
  // → 归一后逐目录再找一次。少了这步会「文件明明在、却报引用不存在」并中断整轮生成。
846
875
  if (!source) {
847
876
  for (const d of sourceDirs) {
848
- let entries = []
849
- try { entries = fs.readdirSync(d) } catch { continue }
850
- const hit = entries.find((f) => /\.(png|jpe?g|webp|svg)$/i.test(f) && sliceNameMatches(f, name))
851
- if (hit) { source = path.join(d, hit); break }
877
+ // 递归枚举(要素包 slices 嵌套子目录);命中判据沿用 sliceNameMatches(口径同源,禁另起一套)
878
+ const hits = listSliceFilesDeep(d).filter(
879
+ (f) => /\.(png|jpe?g|webp|svg)$/i.test(f) && sliceNameMatches(path.basename(f), name),
880
+ )
881
+ // 同名命中多处不猜:报错列出全部命中绝对路径,让调用方把引用改带子目录或挪走多余文件
882
+ if (hits.length > 1) {
883
+ throw new Error(
884
+ `IR 引用的切图 ${ref} 在 ${d} 下命中多个同名文件,不猜——把引用改成带子目录的相对路径,或挪走多余文件后重跑:\n${hits.map((h) => ' - ' + h).join('\n')}`,
885
+ )
886
+ }
887
+ if (hits.length === 1) { source = hits[0]; break }
852
888
  }
853
889
  }
854
890
  if (!source) {
@@ -858,12 +894,10 @@ export function syncReferencedSlices(schema, irPath, slicesDirs) {
858
894
  const words = stem.split(/[^a-z0-9\u4e00-\u9fa5]+/i).filter((w) => w.length > 1)
859
895
  const cands = []
860
896
  for (const d of sourceDirs) {
861
- let entries = []
862
- try { entries = fs.readdirSync(d) } catch { continue }
863
- for (const f of entries) {
897
+ for (const f of listSliceFilesDeep(d)) {
864
898
  if (!/\.(png|jpe?g|webp|svg)$/i.test(f)) continue
865
- const lower = f.toLowerCase()
866
- if (lower === path.basename(name).toLowerCase() || words.some((w) => lower.includes(w))) cands.push(path.join(d, f))
899
+ const lower = path.basename(f).toLowerCase()
900
+ if (lower === path.basename(name).toLowerCase() || words.some((w) => lower.includes(w))) cands.push(f)
867
901
  }
868
902
  }
869
903
  const hint = cands.length
@@ -952,8 +986,10 @@ function runPyScript(py, script, args) {
952
986
  * 历史 bug:autofix 的 exit 1 曾被当成致命异常,导致 validate 从未执行、
953
987
  * 报出误导性的「validate 未执行(未找到 python)」,模型转而信任无校验的旁路。 */
954
988
  export function resolvePythonBin() {
955
- for (const bin of pythonCandidates()) if (probePython(bin)) return bin
956
- return null
989
+ // 保留 null 语义(调用方靠它区分「没装 Python」):探测不过就明确返回 null,
990
+ // 而不是像 resolvePython() 那样回落到 'python3' 让调用方带着假解释器去试跑。
991
+ const bin = resolvePython()
992
+ return probePython(bin) ? bin : null
957
993
  }
958
994
 
959
995
  export function runAutofixAndValidate(schemaPath) {
@@ -1041,7 +1077,17 @@ function main() {
1041
1077
  }
1042
1078
  if (args.ir && args.out) {
1043
1079
  const ir = JSON.parse(fs.readFileSync(args.ir, 'utf8'))
1044
- const { schema, data } = expandIR(ir)
1080
+ const { schema, data, aliasFixes } = expandIR(ir)
1081
+ // 归一化是**静默修好**,不是拦下来让模型重写:改一个字符串的字面量而已,
1082
+ // 报一句「已归一化 N 处」让调用方知道发生了什么,但不中断流程。
1083
+ if (aliasFixes && aliasFixes.count) {
1084
+ console.error(
1085
+ `[ir] 已归一化 ${aliasFixes.count} 处列表作用域别名($item.<字段> → $<字段>、$item → $$、$item._index → $_index):schema 里只存规范形,无需重写 IR。`,
1086
+ )
1087
+ for (const s of aliasFixes.samples.slice(0, 3)) {
1088
+ console.error(` ${s.at}: ${s.before} → ${s.after}`)
1089
+ }
1090
+ }
1045
1091
  // 非法样式键:**写盘前**中止。放行的代价是「schema 写得像成功、渲染却丢样式」,
1046
1092
  // 下游 validate 只会报整卡 FAIL,模型看不出是键名错 → 推倒重写整份 IR(实测 16 次)。
1047
1093
  if (unknownStyleKeys.length) {
@@ -9,7 +9,7 @@
9
9
  * 2. validate python validate_schema.py <schema> 结构合法性(0 ERROR 0 WARN)
10
10
  * 3. data python derive_data_json.py <schema> --check data.json 一致性
11
11
  * 4. lint node lint_card.mjs --id <id> 行为规则 0 ERROR
12
- * 5. preflight node preflight.mjs --spec <spec> --id <id> 13 项机械检查(给了 --spec 才跑)
12
+ * 5. preflight node preflight.mjs --spec <spec> --id <id> 14 项机械检查(给了 --spec 才跑)
13
13
  *
14
14
  * 用法:
15
15
  * node scripts/gate.mjs --id <卡id> [--spec UI/<画板>/spec.json] [--json] [--project-root <dir>]
@@ -22,6 +22,7 @@
22
22
  import { spawnSync } from 'node:child_process'
23
23
  import path from 'node:path'
24
24
  import { cardSchemaPath, cardsDir, skillRoot } from './lib/paths.mjs'
25
+ import { resolvePython } from './lib/python.mjs'
25
26
 
26
27
  // ---------- CLI ----------
27
28
  const argv = process.argv.slice(2)
@@ -56,7 +57,9 @@ try {
56
57
  if (projectRoot) process.env.DSL_CARD_PROJECT_ROOT = projectRoot
57
58
 
58
59
  const scriptsDir = path.join(skillRoot, 'scripts')
59
- const py = process.env.PYTHON || 'python3'
60
+ // 此前是 `process.env.PYTHON || 'python3'`:既不认 DSL_CARD_PYTHON,也不做探测,
61
+ // 于是在 Windows 上会钉住 Store 假别名 python3,autofix/validate 静默不执行。
62
+ const py = resolvePython()
60
63
 
61
64
  /** 跑一步门禁。返回 { ok, code, output };output 只保留尾部的关键行(错误/摘要)。 */
62
65
  function runStep(name, cmd, args) {