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.
- package/dist/init.js +0 -2
- package/dist/preview-editor/assets/index-CXDf5tVg.css +1 -0
- package/dist/preview-editor/assets/{index-CIIfMlwI.js → index-DLQkCPLT.js} +113 -86
- package/dist/preview-editor/index.html +2 -2
- package/dist/vendored/card-editor/runtime/adapter.js +2 -2
- package/dist/vendored/mcp/client.mjs +1 -1
- package/dist/vendored/server/core/ai-chat.js +251 -80
- package/dist/vendored/server/core/browser.js +17 -0
- package/dist/vendored/server/core/cardFiles.js +49 -1
- package/dist/vendored/server/core/cardImage.js +103 -2
- package/dist/vendored/server/core/cardValidate.js +16 -5
- package/dist/vendored/server/core/screenshot.js +94 -0
- package/dist/vendored/skills/card-skill-trainer/SKILL.md +68 -13
- package/dist/vendored/skills/card-skill-trainer/scripts/diagnose_case.mjs +14 -82
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/diagnosis.mjs +207 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/layout-correction-sim.mjs +62 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/paradigm-router.mjs +76 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/pixel-worker-runner.mjs +31 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/pixel-worker.mjs +138 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs +24 -20
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/telemetry.mjs +46 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/plan_next_round.mjs +5 -2
- package/dist/vendored/skills/card-skill-trainer/scripts/run_round.mjs +286 -92
- package/dist/vendored/skills/card-skill-trainer/scripts/score_round.mjs +74 -2
- package/dist/vendored/skills/card-skill-trainer/scripts/sink_rules.mjs +127 -0
- package/dist/vendored/skills/dsl-card-generator/SKILL.md +93 -27
- package/dist/vendored/skills/dsl-card-generator/references/component_rules.md +14 -0
- package/dist/vendored/skills/dsl-card-generator/references/dsl_structure.md +1 -15
- package/dist/vendored/skills/dsl-card-generator/references/expression_engine.md +11 -20
- package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md +217 -44
- package/dist/vendored/skills/dsl-card-generator/references/ir-format.md +87 -3
- package/dist/vendored/skills/dsl-card-generator/references/iteration_protocol.md +35 -6
- package/dist/vendored/skills/dsl-card-generator/references/previewer_contract.md +21 -0
- package/dist/vendored/skills/dsl-card-generator/references/quickref.md +28 -27
- package/dist/vendored/skills/dsl-card-generator/references/recipes.md +30 -8
- package/dist/vendored/skills/dsl-card-generator/references/rules.md +3 -2
- package/dist/vendored/skills/dsl-card-generator/references/scripts_reference.md +5 -2
- package/dist/vendored/skills/dsl-card-generator/references/slices_convention.md +2 -3
- package/dist/vendored/skills/dsl-card-generator/references/spec_to_schema_patterns.md +1 -4
- package/dist/vendored/skills/dsl-card-generator/scripts/add_component.mjs +5 -14
- package/dist/vendored/skills/dsl-card-generator/scripts/autofix_schema.py +88 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/check_fidelity.mjs +143 -42
- package/dist/vendored/skills/dsl-card-generator/scripts/check_topology.py +0 -35
- package/dist/vendored/skills/dsl-card-generator/scripts/expand_ir.mjs +99 -53
- package/dist/vendored/skills/dsl-card-generator/scripts/gate.mjs +5 -2
- package/dist/vendored/skills/dsl-card-generator/scripts/iterate.mjs +388 -29
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/component_contract.mjs +315 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/layout-tokens.mjs +1 -1
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.mjs +23 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.py +0 -37
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/python.mjs +99 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/adaptive-width.mjs +105 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/bindings.mjs +260 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/expr.mjs +52 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/image.mjs +96 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/registry.mjs +166 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/structure.mjs +127 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/walk.mjs +61 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/scaffold.mjs +48 -1
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/scope_alias.mjs +125 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_assemble.mjs +366 -45
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_extract.mjs +169 -12
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_shared.mjs +17 -9
- package/dist/vendored/skills/dsl-card-generator/scripts/lint_card.mjs +119 -78
- package/dist/vendored/skills/dsl-card-generator/scripts/preflight.mjs +48 -50
- package/dist/vendored/skills/dsl-card-generator/scripts/readiness.mjs +634 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/register_card_template.mjs +5 -8
- package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs +5 -10
- package/dist/vendored/skills/dsl-card-generator/scripts/spec_audit.mjs +122 -8
- package/dist/vendored/skills/dsl-card-generator/scripts/v3_regression.mjs +11 -2
- package/dist/vendored/skills/dsl-card-generator/scripts/validate_schema.py +23 -15
- package/dist/vendored/skills/finmall-card-sync/scripts/api_batch_sync.mjs +46 -2
- package/dist/vendored/skills/mbank-design-gen/SKILL.md +76 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-apps.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-arrow-right-blue.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-check.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-settings.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-sound.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-voice-switch.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/progress-thumb.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/tag-bg.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/icons/vs-badge.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-chat-options.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-home-scene.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-product-detail.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-rate-table.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/assets/robot.png +0 -0
- package/dist/vendored/skills/mbank-design-gen/references/component-library.md +127 -0
- package/dist/vendored/skills/mbank-design-gen/references/design-spec.md +261 -0
- package/dist/vendored/skills/mbank-design-gen/templates/mockup-template.html +138 -0
- package/dist/vendored/skills/mbank-design-gen/tools/screenshot.mjs +34 -0
- package/dist/vendored/skills/shared/exit-codes.md +79 -0
- package/dist/vendored/skills/shared/spec-contract.md +127 -0
- package/dist/vendored/skills/sketch-spec-to-card/SKILL.md +27 -10
- package/dist/vendored/skills/sketch-spec-to-card/references/spec-schema.md +3 -3
- package/dist/vendored/skills/sketch-spec-to-card/scripts/build_prompt.py +0 -8
- package/dist/vendored/skills/sketch-spec-to-card/scripts/cluster_states.py +14 -25
- package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py +121 -47
- package/dist/vendored/skills/sketch-spec-to-card/scripts/png_utils.py +0 -5
- package/dist/vendored/skills/sketch-spec-to-card/scripts/test_text_only_artboard.py +98 -16
- package/dist/vendored/skills/sketch-spec-to-card/scripts/vision.py +55 -37
- package/dist/vendored/templates/helloCard/schema.json +62 -1
- package/dist/vendored/tools/finmall-env.mjs +1 -18
- package/package.json +1 -1
- package/dist/preview-editor/assets/index-DQn0zQBP.css +0 -1
- package/dist/vendored/skills/card-skill-trainer/scripts/test_missing_slice.py +0 -122
- package/dist/vendored/skills/dsl-card-generator/scripts/analyze_component_usage.mjs +0 -153
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* rules/structure.mjs —— 结构与事件代码的机械判据(pitfalls 教训 → 机器 gate)。
|
|
3
|
+
*
|
|
4
|
+
* 2026-09-25 沉淀:generation_pitfalls.md 里「可机械判定、但此前只有文档约束」的 6 条。
|
|
5
|
+
* 全部消费 walkNodes/hit 工厂(lib/rules/walk.mjs),lint 与 preflight 共享同一实现。
|
|
6
|
+
*
|
|
7
|
+
* | code | severity | 来源 | 判定 |
|
|
8
|
+
* |---|---|---|---|
|
|
9
|
+
* | r65-slot-multi-children | error | pitfalls §27(汇率卡事故) | slotScope 循环插槽平铺 ≥2 子节点 |
|
|
10
|
+
* | r34-null-child | error | pitfalls R34 | 组件树含 null/undefined 子节点 |
|
|
11
|
+
* | style-duplicate-child | error | pitfalls §20.4 | style 组内同名子项重复(渲染器只取其一) |
|
|
12
|
+
* | r50c-alertdata-whole-state | warn | pitfalls §10(transfersjump 事故) | 子卡 data:this.state 整体回传 / 父卡 state.x=res.data 整体赋值 |
|
|
13
|
+
* | r20-icon-no-rect | warn | pitfalls R20 | Icon 缺显式 style.rect(默认 32×32) |
|
|
14
|
+
* | r38-root-fixed-height | warn | pitfalls R38 | 根节点写死 rect.height(应由内容撑开) |
|
|
15
|
+
*/
|
|
16
|
+
import { walkNodes, hit } from './walk.mjs'
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* §27:slotScope 循环模板的 slot 下禁止平铺 ≥2 个子节点。
|
|
20
|
+
* slot.components[] 是一个整体模板,会原样套到 value 数组每一项上重复渲染;
|
|
21
|
+
* 平铺 N 个子节点等价于每个 item 渲染 N 个并列块,行与分隔线互相穿插。
|
|
22
|
+
*/
|
|
23
|
+
export function collectSlotMultiChildren(view) {
|
|
24
|
+
const out = []
|
|
25
|
+
walkNodes(view, (n) => {
|
|
26
|
+
if (n.className !== 'ListLayout' && n.className !== 'GridLayout') return
|
|
27
|
+
for (const slot of n.slots || []) {
|
|
28
|
+
if (!slot.slotScope) continue
|
|
29
|
+
const kids = slot.components || []
|
|
30
|
+
if (kids.length <= 1) continue
|
|
31
|
+
const shapes = kids.map((k) => k && k.className).join('/')
|
|
32
|
+
out.push(hit('r65-slot-multi-children', 'error', n.componentId || '',
|
|
33
|
+
`${n.className} "${n.componentId || ''}" 的 slotScope 循环插槽平铺了 ${kids.length} 个子节点(${shapes})—— slot 是整体模板,原样套到每一项重复渲染,平铺等价于每项渲染 ${kids.length} 个并列块、互相穿插错位(pitfalls §27)。正路:全部元素包进一个 Column/Row 容器,slot children 仅此一个容器。`))
|
|
34
|
+
}
|
|
35
|
+
})
|
|
36
|
+
return out
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** R34:组件树禁止出现 null/undefined 子节点(可选 slice 为空时提供占位,禁止 null 进插槽)。 */
|
|
40
|
+
export function collectNullChildren(view) {
|
|
41
|
+
const out = []
|
|
42
|
+
walkNodes(view, (n) => {
|
|
43
|
+
const arrays = [n.components, ...(n.slots || []).map((s) => s && s.components)]
|
|
44
|
+
for (const arr of arrays) {
|
|
45
|
+
if (!Array.isArray(arr)) continue
|
|
46
|
+
const bad = arr.filter((c) => c === null || c === undefined).length
|
|
47
|
+
if (!bad) continue
|
|
48
|
+
out.push(hit('r34-null-child', 'error', n.componentId || '',
|
|
49
|
+
`${n.className || 'view'} "${n.componentId || ''}" 的子组件数组含 ${bad} 个 null/undefined —— 运行期渲染挂起(pitfalls R34:可选 slice 命中但 PNG 未导出时,禁止 imageFromSlice 的 null 直接进插槽,须可见占位或 Icon 兜底)。`))
|
|
50
|
+
}
|
|
51
|
+
})
|
|
52
|
+
return out
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** §20.4:style 组内同名子项唯一 —— 追加第二个同名子项会让渲染器取到空值/绑定串原样。 */
|
|
56
|
+
export function collectDuplicateStyleChildren(view) {
|
|
57
|
+
const out = []
|
|
58
|
+
walkNodes(view, (n) => {
|
|
59
|
+
for (const g of (n.style && n.style.properties) || []) {
|
|
60
|
+
const seen = new Set()
|
|
61
|
+
for (const c of (g.itemChildren && g.itemChildren.properties) || []) {
|
|
62
|
+
if (seen.has(c.itemKey)) {
|
|
63
|
+
out.push(hit('style-duplicate-child', 'error', n.componentId || '',
|
|
64
|
+
`${n.className || 'view'} "${n.componentId || ''}" style 组 "${g.itemKey || '?'}" 内存在重复子项 itemKey:"${c.itemKey}" —— 渲染器对同名子项只取其一,绑定值会被空值/静态默认覆盖(pitfalls §20.4:绑定必须改写既有子项,禁止追加)。`))
|
|
65
|
+
}
|
|
66
|
+
seen.add(c.itemKey)
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
})
|
|
70
|
+
return out
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* §10:子卡回传按需裁剪、父卡回调按字段提取。
|
|
75
|
+
* 子卡侧:`closeAlertCard` 的 `data: this.state` 整体回传 = 整个子卡作用域 + 父卡注入 payload 一起甩给父卡。
|
|
76
|
+
* 父卡侧:`state.X = res.data`(整体 payload 直接挂 state)—— 只拦精确整体赋值,
|
|
77
|
+
* `res.data.<字段>` 不拦(无法机械区分字段提取与子对象整体赋值,交给 AI 语义复核)。
|
|
78
|
+
*/
|
|
79
|
+
export function collectAlertDataWholeState(view) {
|
|
80
|
+
const out = []
|
|
81
|
+
walkNodes(view, (n) => {
|
|
82
|
+
for (const ea of n.eventactions || []) {
|
|
83
|
+
const act = ea && ea.action
|
|
84
|
+
if (!act || act.actionType !== 'customAction') continue
|
|
85
|
+
const fn = (act.properties || []).find((p) => p.itemKey === 'function') || {}
|
|
86
|
+
const iv = fn.itemValue || {}
|
|
87
|
+
const code = String(iv.code || iv.compiled || '')
|
|
88
|
+
if (!code) continue
|
|
89
|
+
if (/closeAlertCard[\s\S]{0,120}data:\s*this\.state\b/.test(code)) {
|
|
90
|
+
out.push(hit('r50c-alertdata-whole-state', 'warn', n.componentId || '',
|
|
91
|
+
`${n.className} "${n.componentId || ''}" closeAlertCard 用 data: this.state 整体回传 —— 会把整个子卡作用域 + 父卡注入 payload(list/title/parentInstanceId…)一起甩给父卡,父卡字段错乱(pitfalls §10 transfersjump 事故)。正路:显式构造 data,只含父卡需要的字段(如 data: { selected: { acctNum: this.state.acctNum, … } })。`))
|
|
92
|
+
}
|
|
93
|
+
const m = code.match(/(?:this|that)\.state\.[A-Za-z_$][\w$]*\s*=\s*res\.data\b(?!\s*[.[])/)
|
|
94
|
+
if (m) {
|
|
95
|
+
out.push(hit('r50c-alertdata-whole-state', 'warn', n.componentId || '',
|
|
96
|
+
`${n.className} "${n.componentId || ''}" 父卡回调整体赋值(…${m[0].replace(/\s+/g, ' ')})—— res.data 未按字段显式提取就挂上 state,子卡回传一旦裁剪/扩容即字段错乱(pitfalls §10)。正路:逐字段提取(that.state.currCard = { acctNum: res.data.selected.acctNum, … })。`))
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
})
|
|
100
|
+
return out
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** R20:Icon 必须带显式 style.rect(width+height),否则按 svg-symbols 默认尺寸(约 32×32)渲染。 */
|
|
104
|
+
export function collectIconNoRect(view) {
|
|
105
|
+
const out = []
|
|
106
|
+
walkNodes(view, (n) => {
|
|
107
|
+
if (n.className !== 'Icon') return
|
|
108
|
+
const rect = ((n.style || {}).properties || []).find((g) => g.itemKey === 'rect')
|
|
109
|
+
const kids = (rect && rect.itemChildren && rect.itemChildren.properties) || []
|
|
110
|
+
const has = (k) => kids.some((c) => c.itemKey === k && String(c.itemValue ?? '') !== '')
|
|
111
|
+
if (has('width') && has('height')) return
|
|
112
|
+
out.push(hit('r20-icon-no-rect', 'warn', n.componentId || '',
|
|
113
|
+
`Icon "${n.componentId || ''}" 缺显式 style.rect(${!has('width') ? 'width' : ''}${!has('width') && !has('height') ? '+' : ''}${!has('height') ? 'height' : ''})—— 渲染器按 svg-symbols 默认尺寸(约 32×32)渲染,与设计稿标注不符(pitfalls R20:Icon 尺寸必须读 spec 标注显式写入)。`))
|
|
114
|
+
})
|
|
115
|
+
return out
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/** R38:根节点高度由内容撑开 —— 写死 rect.height(非 auto/非表达式)在内容行数变化时裁切。 */
|
|
119
|
+
export function collectRootFixedHeight(view) {
|
|
120
|
+
if (!view || typeof view !== 'object') return []
|
|
121
|
+
const rect = ((view.style || {}).properties || []).find((g) => g.itemKey === 'rect')
|
|
122
|
+
const kids = (rect && rect.itemChildren && rect.itemChildren.properties) || []
|
|
123
|
+
const h = kids.find((c) => c.itemKey === 'height')
|
|
124
|
+
if (!h || h.itemValueFrom === '1' || h.itemValue == null || String(h.itemValue) === 'auto') return []
|
|
125
|
+
return [hit('r38-root-fixed-height', 'warn', view.componentId || '',
|
|
126
|
+
`根节点写死 rect.height="${h.itemValue}" —— 容器高度应由内容撑开(height:auto,纵向尺寸来自子内容 + gap + 标注 padding),写死整卡高度在内容行数变化时裁切或留白(pitfalls R38;禁止为了对齐截图写死整卡高度)。`)]
|
|
127
|
+
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* rules/walk.mjs —— schema 节点遍历的共享实现(lint_card / preflight / readiness 单一来源)。
|
|
3
|
+
*
|
|
4
|
+
* 三个门禁脚本各自有一份 `walk`,签名与遍历序都一致(先 components 再 slots);
|
|
5
|
+
* 抽到一处避免「同一个节点集在三处算出不同命中」。
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* 深度优先遍历 schema 节点树。
|
|
10
|
+
* @param {object} node 起始节点(通常 schema.view)
|
|
11
|
+
* @param {(node: object, parent: object|null) => void} visitor
|
|
12
|
+
* @param {object|null} parent
|
|
13
|
+
*/
|
|
14
|
+
export function walkNodes(node, visitor, parent = null) {
|
|
15
|
+
if (!node || typeof node !== 'object') return
|
|
16
|
+
visitor(node, parent)
|
|
17
|
+
for (const c of node.components || []) walkNodes(c, visitor, node)
|
|
18
|
+
for (const s of node.slots || []) for (const c of s.components || []) walkNodes(c, visitor, node)
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/** 收集树内全部节点(含起始节点),供只需平铺清单的消费方使用。 */
|
|
22
|
+
export function collectNodes(root) {
|
|
23
|
+
const out = []
|
|
24
|
+
walkNodes(root, (n) => out.push(n))
|
|
25
|
+
return out
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** 默认插槽直接子节点(Root.components 与普通节点 slots[0].components 两种形态)。 */
|
|
29
|
+
export function directChildren(node) {
|
|
30
|
+
if (!node) return []
|
|
31
|
+
const slot = (node.slots || [])[0]
|
|
32
|
+
if (slot && Array.isArray(slot.components)) return slot.components
|
|
33
|
+
return Array.isArray(node.components) ? node.components : []
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** 取 component properties 里的某个 itemKey。 */
|
|
37
|
+
export function findProp(node, key) {
|
|
38
|
+
for (const p of node?.properties || []) if (p.itemKey === key) return p
|
|
39
|
+
return null
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** 取 style.<group>.<child> 子项节点。 */
|
|
43
|
+
export function findStyleChild(node, group, child) {
|
|
44
|
+
for (const g of node?.style?.properties || []) {
|
|
45
|
+
if (g.itemKey !== group) continue
|
|
46
|
+
for (const c of g.itemChildren?.properties || []) if (c.itemKey === child) return c
|
|
47
|
+
}
|
|
48
|
+
return null
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* 归一化命中对象 —— 各门禁脚本消费同一形状:
|
|
53
|
+
* lint_card → { severity, code, message, componentId }
|
|
54
|
+
* preflight → check(code, severity, message, detail)
|
|
55
|
+
*
|
|
56
|
+
* `componentId` 刻意做成**位置参数**:早先放在 extra 里时调用方漏传过一次,
|
|
57
|
+
* 表现为 lint 报「componentId 为空」而 preflight 毫无察觉(它不消费该字段)。
|
|
58
|
+
*/
|
|
59
|
+
export function hit(code, severity, componentId, message, extra = {}) {
|
|
60
|
+
return { code, severity, componentId: componentId || '', message, detail: '', ...extra }
|
|
61
|
+
}
|
|
@@ -388,6 +388,53 @@ function inferInputParams(bindings) {
|
|
|
388
388
|
|
|
389
389
|
const INTENTS = ['blank', 'list', 'detail', 'form', 'dialog', 'tab', 'canvas-head']
|
|
390
390
|
|
|
391
|
+
/**
|
|
392
|
+
* 空白根样式:margin / padding / gap 显式归零,压掉渲染器对无样式容器的默认注入
|
|
393
|
+
* (padding:2px / gap:4px / justify-content:center)。形状与存量卡根节点一致
|
|
394
|
+
* (style-meta.json:marginType / paddingType,'0' = 全边统一值)。
|
|
395
|
+
* 同一形状还有两份内联副本(禁跨包 import):server/core/cardFiles.js 的 blankResetStyle、
|
|
396
|
+
* skills/finmall-card-sync api_batch_sync.mjs 的 buildBlankSchema —— 改这里必须同步改那两处。
|
|
397
|
+
*/
|
|
398
|
+
function blankResetStyle() {
|
|
399
|
+
return {
|
|
400
|
+
properties: [
|
|
401
|
+
{
|
|
402
|
+
itemId: '100',
|
|
403
|
+
itemKey: 'flex',
|
|
404
|
+
itemValueFrom: '0',
|
|
405
|
+
itemValue: {},
|
|
406
|
+
itemChildren: {
|
|
407
|
+
properties: [{ itemId: '003', itemKey: 'gap', itemValueFrom: '0', itemValue: '0' }],
|
|
408
|
+
},
|
|
409
|
+
},
|
|
410
|
+
{
|
|
411
|
+
itemId: '400',
|
|
412
|
+
itemKey: 'padding',
|
|
413
|
+
itemValueFrom: '0',
|
|
414
|
+
itemValue: {},
|
|
415
|
+
itemChildren: {
|
|
416
|
+
properties: [
|
|
417
|
+
{ itemId: '001', itemKey: 'paddingType', itemValueFrom: '0', itemValue: '0' },
|
|
418
|
+
{ itemId: '002', itemKey: 'padding', itemValueFrom: '0', itemValue: '0' },
|
|
419
|
+
],
|
|
420
|
+
},
|
|
421
|
+
},
|
|
422
|
+
{
|
|
423
|
+
itemId: '500',
|
|
424
|
+
itemKey: 'margin',
|
|
425
|
+
itemValueFrom: '0',
|
|
426
|
+
itemValue: {},
|
|
427
|
+
itemChildren: {
|
|
428
|
+
properties: [
|
|
429
|
+
{ itemId: '001', itemKey: 'marginType', itemValueFrom: '0', itemValue: '0' },
|
|
430
|
+
{ itemId: '002', itemKey: 'margin', itemValueFrom: '0', itemValue: '0' },
|
|
431
|
+
],
|
|
432
|
+
},
|
|
433
|
+
},
|
|
434
|
+
],
|
|
435
|
+
}
|
|
436
|
+
}
|
|
437
|
+
|
|
391
438
|
/**
|
|
392
439
|
* 装配一张合法的最小卡片骨架。
|
|
393
440
|
* @returns {{schema:object, data:object}}
|
|
@@ -402,7 +449,7 @@ export function buildCardSkeleton(intent, opts = {}) {
|
|
|
402
449
|
const view = {
|
|
403
450
|
width: '375',
|
|
404
451
|
className: 'Root',
|
|
405
|
-
style:
|
|
452
|
+
style: blankResetStyle(),
|
|
406
453
|
properties: [],
|
|
407
454
|
eventactions: [],
|
|
408
455
|
components: rootChildren,
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* scope_alias.mjs — 列表作用域别名归一化(**唯一实现**,Python 侧 autofix_schema.py 逐条对齐)。
|
|
3
|
+
*
|
|
4
|
+
* ── 为什么是「归一化」而不是「报错禁止」 ───────────────────────────────
|
|
5
|
+
* 2026-09-24 复盘:模型写出 `$item.xxx`,根因不是模型笨 —— 是**我们自己**在系统提示词 /
|
|
6
|
+
* ir-format.md 里手写了一条不存在的契约(提交 56e9894「子树内 $item.xxx / $_index」)。
|
|
7
|
+
* 权威证据:全仓 50 张真卡的 ListLayout 插槽内绑定**全部**是扁平字段名(`$name` / `$label` /
|
|
8
|
+
* `$accountNum` / `$card_name`),`$item.` 出现 **0 次**。
|
|
9
|
+
*
|
|
10
|
+
* 上一版处理方式是「expand_ir exit=3 中止 + lint 报 ERROR + 三份文档写满 ⛔ 没有 $item」——
|
|
11
|
+
* 那等于**教错了再罚学生**:模型必须先知道正确答案才不被打回,而正确答案本来就不该由它记住。
|
|
12
|
+
*
|
|
13
|
+
* 正确做法:IR 是本编译器的输入格式,编译器对**公认别名**做归一化即可。
|
|
14
|
+
* 这不是猜测 —— `$item.x` 在 listScope 里只有一种可能语义(当前项字段 x),
|
|
15
|
+
* 因为运行时 `makeSlotScope` 的作用域是 `外层 ∪ item字段展开 ∪ {$$, _index}`,
|
|
16
|
+
* **根本没有 `item` 这个键**。所以重写是语义保持的,不是"帮模型猜"。
|
|
17
|
+
*
|
|
18
|
+
* ── 契约 ─────────────────────────────────────────────────────────
|
|
19
|
+
* 规范形(落到 schema.json 的形态):`$<字段名>` / `$$` / `$_index`
|
|
20
|
+
* 可接受别名(作者侧随便写):`$item.<字段>` → `$<字段>`;`$item` → `$$`;`$item._index` → `$_index`
|
|
21
|
+
*
|
|
22
|
+
* ── 唯一的例外闸 ───────────────────────────────────────────────────
|
|
23
|
+
* 若卡片**真的声明了**名为 `item` 的根作用域变量(dictionary.inputParams[].key === 'item'),
|
|
24
|
+
* 那么 `$item.x` 是合法取值,**一律不动**。这把「归一化」与「覆盖用户数据」彻底分开。
|
|
25
|
+
*/
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* 归一化一条字符串。纯函数,无副作用。
|
|
29
|
+
*
|
|
30
|
+
* 改写顺序不可交换:`$item._index` 必须先于 `$item.`;
|
|
31
|
+
* 裸 `$item` 的规则必须最后,且带前瞻,避免把 `$itemFoo` 误当别名。
|
|
32
|
+
*
|
|
33
|
+
* ⚠️ 三条正则**必须显式写 `[A-Za-z0-9_]`,不许用 `\w` / `\b`**:
|
|
34
|
+
* JS 的 `\w` 是 ASCII 集,Python 的 `\w` 默认是 Unicode 集(含中文)。
|
|
35
|
+
* 用 `\w` 会让同一串 `$item名称` 在两边得到不同结果(JS 改写、Python 不改写),
|
|
36
|
+
* 这正是「口径同源」要防的分叉。Python 侧 autofix_schema.py 逐字复用这三条。
|
|
37
|
+
*
|
|
38
|
+
* @param {string} s 原字符串
|
|
39
|
+
* @returns {{ text: string, hits: string[] }} 归一化结果与被命中的原文(去重)
|
|
40
|
+
*/
|
|
41
|
+
export function rewriteItemAlias(s) {
|
|
42
|
+
if (typeof s !== 'string' || !s.includes('$item')) return { text: s, hits: [] }
|
|
43
|
+
const before = s
|
|
44
|
+
let out = s
|
|
45
|
+
// ⚠️ 必须用**函数替换器**,不能用字符串替换串:`String.replace` 会把替换串里的
|
|
46
|
+
// `$$` 解释成「一个字面 $」(还有 `$&`/`` $` ``/`$'`/`$1` 等模式),于是
|
|
47
|
+
// `.replace(re, '$$')` 实际只产出 `$` —— 而 Python 的 `re.sub` 里 `$` 不是特殊字符,
|
|
48
|
+
// 同一份规则在两侧结果不同(本文件的测试就是这么抓到的)。
|
|
49
|
+
// 函数替换器不做任何模式展开,天然与 Python 行为对齐。
|
|
50
|
+
out = out.replace(/\$item\._index(?![A-Za-z0-9_])/g, () => '$_index')
|
|
51
|
+
out = out.replace(/\$item\./g, () => '$')
|
|
52
|
+
out = out.replace(/\$item(?![A-Za-z0-9_$])/g, () => '$$')
|
|
53
|
+
if (out === before) return { text: s, hits: [] }
|
|
54
|
+
return { text: out, hits: [before] }
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* 不做改写的结构键:它们承载的是 id / 名称 / 类型等标识,不是绑定表达式。
|
|
59
|
+
* (JS 与 Python 两侧必须逐字一致;改动请同步 autofix_schema.py。)
|
|
60
|
+
*/
|
|
61
|
+
export const SKIP_KEYS = new Set([
|
|
62
|
+
'id',
|
|
63
|
+
'name',
|
|
64
|
+
'itemId',
|
|
65
|
+
'itemKey',
|
|
66
|
+
'itemName',
|
|
67
|
+
'itemType',
|
|
68
|
+
'itemValueFrom',
|
|
69
|
+
'componentId',
|
|
70
|
+
'className',
|
|
71
|
+
'eventKey',
|
|
72
|
+
'eventName',
|
|
73
|
+
'actionType',
|
|
74
|
+
'slotKey',
|
|
75
|
+
'type',
|
|
76
|
+
'desc',
|
|
77
|
+
'remark',
|
|
78
|
+
])
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* 递归归一化任意 IR / schema 结构里的作用域别名(原地改写)。
|
|
82
|
+
*
|
|
83
|
+
* @param {*} node 待处理结构(IR 或 schema,任意深度)
|
|
84
|
+
* @param {object} [opts]
|
|
85
|
+
* @param {Set<string>} [opts.knownRoots] 根作用域变量名集合;含 'item' 时整体跳过(见头注释「唯一的例外闸」)
|
|
86
|
+
* @param {string} [opts.at] 路径前缀(内部递归用)
|
|
87
|
+
* @returns {{ count: number, samples: Array<{ at: string, before: string, after: string }> }}
|
|
88
|
+
*/
|
|
89
|
+
export function normalizeItemAliases(node, { knownRoots, at = '' } = {}) {
|
|
90
|
+
const result = { count: 0, samples: [] }
|
|
91
|
+
if (knownRoots && knownRoots.has('item')) return result
|
|
92
|
+
walk(node, at, result)
|
|
93
|
+
return result
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function walk(node, at, result) {
|
|
97
|
+
if (typeof node === 'string') return // 由父级带 key 处理,避免丢掉 key 上下文
|
|
98
|
+
if (Array.isArray(node)) {
|
|
99
|
+
node.forEach((v, i) => {
|
|
100
|
+
if (typeof v === 'string') applyTo(node, i, `${at}[${i}]`, result)
|
|
101
|
+
else walk(v, `${at}[${i}]`, result)
|
|
102
|
+
})
|
|
103
|
+
return
|
|
104
|
+
}
|
|
105
|
+
if (node && typeof node === 'object') {
|
|
106
|
+
for (const [k, v] of Object.entries(node)) {
|
|
107
|
+
if (typeof v === 'string') {
|
|
108
|
+
if (SKIP_KEYS.has(k)) continue
|
|
109
|
+
applyTo(node, k, at ? `${at}.${k}` : k, result)
|
|
110
|
+
} else {
|
|
111
|
+
walk(v, at ? `${at}.${k}` : k, result)
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function applyTo(container, key, at, result) {
|
|
118
|
+
const { text, hits } = rewriteItemAlias(container[key])
|
|
119
|
+
if (!hits.length) return
|
|
120
|
+
container[key] = text
|
|
121
|
+
result.count += hits.length
|
|
122
|
+
if (result.samples.length < 20) {
|
|
123
|
+
result.samples.push({ at, before: hits[0], after: text })
|
|
124
|
+
}
|
|
125
|
+
}
|