cardbuddy 0.11.0 → 0.12.1
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/README.md +46 -5
- package/dist/cli.js +51 -1
- package/dist/config.js +51 -16
- package/dist/core.js +2 -2
- package/dist/init.js +425 -0
- package/dist/preview-editor/assets/index-CHuGGIR3.js +276 -0
- package/dist/preview-editor/assets/{index-B4VZgNSK.css → index-CQScMhyg.css} +1 -1
- package/dist/preview-editor/index.html +2 -2
- package/dist/standalone.js +8 -0
- package/dist/vendored/mcp/client.mjs +537 -0
- package/dist/vendored/mcp/tools.mjs +268 -0
- package/dist/vendored/preview/assets/default-image.png +0 -0
- package/dist/{server-core → vendored/server/core}/ai-chat.js +82 -38
- package/dist/{server-core → vendored/server/core}/browser.js +1 -1
- package/dist/{server-core → vendored/server/core}/cardSave.js +8 -3
- package/dist/{server-core → vendored/server/core}/cardSync.js +6 -14
- package/dist/{server-core → vendored/server/core}/cardValidate.js +11 -8
- package/dist/{server-core → vendored/server/core}/index.js +5 -3
- package/dist/vendored/server/core/skillPaths.js +124 -0
- package/dist/{server-core → vendored/server/core}/sliceUpload.js +5 -8
- package/dist/vendored/skills/README.md +93 -0
- package/dist/vendored/skills/card-doctor/SKILL.md +52 -0
- package/dist/vendored/skills/card-skill-trainer/SKILL.md +312 -0
- package/dist/vendored/skills/card-skill-trainer/baselines/v3-r038n.json +43 -0
- package/dist/vendored/skills/card-skill-trainer/baselines/v3-r039n.json +47 -0
- package/dist/vendored/skills/card-skill-trainer/baselines/v3-r050n.json +48 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/build_dataset.py +472 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/build_sample.mjs +162 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/diagnose_case.mjs +241 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs +525 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/round_diff.mjs +133 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/run_round.mjs +1043 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/score_round.mjs +195 -0
- package/dist/vendored/skills/card-skill-trainer/scripts/test_missing_slice.py +122 -0
- package/dist/vendored/skills/dsl-card-ai/SKILL.md +191 -0
- package/dist/vendored/skills/dsl-card-generator/SKILL.md +480 -0
- package/dist/vendored/skills/dsl-card-generator/config/render-contract.json +11 -0
- package/dist/vendored/skills/dsl-card-generator/references/amount_formatting.md +138 -0
- package/dist/vendored/skills/dsl-card-generator/references/card_index.json +1597 -0
- package/dist/vendored/skills/dsl-card-generator/references/card_templates.json +384 -0
- package/dist/vendored/skills/dsl-card-generator/references/card_to_summary.md +56 -0
- package/dist/vendored/skills/dsl-card-generator/references/component_rules.md +76 -0
- package/dist/vendored/skills/dsl-card-generator/references/component_specs.md +393 -0
- package/dist/vendored/skills/dsl-card-generator/references/dsl_structure.md +208 -0
- package/dist/vendored/skills/dsl-card-generator/references/event_patterns.md +287 -0
- package/dist/vendored/skills/dsl-card-generator/references/expression_engine.md +121 -0
- package/dist/vendored/skills/dsl-card-generator/references/field_name_dict.json +34 -0
- package/dist/vendored/skills/dsl-card-generator/references/field_naming.md +101 -0
- package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md +928 -0
- package/dist/vendored/skills/dsl-card-generator/references/handcrafted/README.md +69 -0
- package/dist/vendored/skills/dsl-card-generator/references/handcrafted/examples_index.json +2967 -0
- package/dist/vendored/skills/dsl-card-generator/references/handcrafted/patterns.json +2835 -0
- package/dist/vendored/skills/dsl-card-generator/references/handcrafted/recipes_v2.json +648 -0
- package/dist/vendored/skills/dsl-card-generator/references/handcrafted/recipes_v2_schema.md +295 -0
- package/dist/vendored/skills/dsl-card-generator/references/image_diff.md +48 -0
- package/dist/vendored/skills/dsl-card-generator/references/image_to_card.md +129 -0
- package/dist/vendored/skills/dsl-card-generator/references/ir-format.md +212 -0
- package/dist/vendored/skills/dsl-card-generator/references/message-center-pattern.md +149 -0
- package/dist/vendored/skills/dsl-card-generator/references/platform_jsapi.md +196 -0
- package/dist/vendored/skills/dsl-card-generator/references/previewer_contract.md +54 -0
- package/dist/vendored/skills/dsl-card-generator/references/quickref.md +197 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/absolute-badge.json +84 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/accordion-group-toggle.json +18 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/alertCard-pair.json +12 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/alertDialog-call.json +12 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-countdown.json +15 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-donut.json +15 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-gauge-score.json +11 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-radar.json +10 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-title-head.json +13 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/globalSet.json +12 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/label-col-modes.json +21 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/list-expand-collapse.json +17 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/money-format.json +11 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/opacity-switch.json +130 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/progress-bar.json +25 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/tab-billMode.json +15 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/title-underline-overlay.json +21 -0
- package/dist/vendored/skills/dsl-card-generator/references/recipes.md +797 -0
- package/dist/vendored/skills/dsl-card-generator/references/rules.md +235 -0
- package/dist/vendored/skills/dsl-card-generator/references/slices_convention.md +177 -0
- package/dist/vendored/skills/dsl-card-generator/references/spec_to_schema_patterns.md +609 -0
- package/dist/vendored/skills/dsl-card-generator/references/ui_fidelity_rules.md +131 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/add_component.mjs +118 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/analyze_component_usage.mjs +153 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/apply_opacity_pattern.mjs +343 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/build_card_index.mjs +108 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/build_card_templates.mjs +190 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/check_fidelity.mjs +257 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/check_magic_values.mjs +79 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/crop_slices.mjs +98 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/describe_card.mjs +265 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/diff_bands.mjs +257 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/diff_card.mjs +316 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/expand_ir.mjs +873 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/extract_handcrafted.py +1199 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/extract_subtree.mjs +191 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/generate_cards.mjs +389 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/inventory_schemas.py +160 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/iterate.mjs +700 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/design_image.mjs +56 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/design_sample.mjs +328 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/layout-tokens.mjs +79 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.mjs +103 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/scaffold.mjs +575 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/slicePath.mjs +81 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lib/slice_dedupe.mjs +147 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lint_autofix.mjs +363 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/lint_card.mjs +1399 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/preflight.mjs +249 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/register_card_template.mjs +208 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/render_baseline.mjs +231 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/render_card.mjs +801 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/render_diff.mjs +239 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/resolve_card_template.mjs +73 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs +447 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/scaffold_card.mjs +81 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/slices_normalize.mjs +316 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/spec_audit.mjs +462 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/spec_to_schema_v3.mjs +7735 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/spec_tree.mjs +355 -0
- package/dist/vendored/skills/dsl-card-generator/scripts/validate_all_schemas.py +71 -0
- package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/default-image-wzZYQ86K.png +0 -0
- package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/standalone-C9k-07y7.css +1 -0
- package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/standalone-oFRM4f4V.js +55 -0
- package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/svg-symbols-B2exBrAr.svg +118 -0
- package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/component-meta.json +2714 -0
- package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/directive-meta.json +40 -0
- package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/style-meta.json +1086 -0
- package/dist/vendored/{standalone.html → skills/dsl-card-generator/vendor/preview/standalone.html} +2 -1
- package/dist/vendored/skills/finmall-card-sync/SKILL.md +262 -0
- package/dist/vendored/skills/finmall-session-navigator/SKILL.md +169 -0
- package/dist/vendored/skills/finmall-session-navigator/scripts/finmall_login.mjs +882 -0
- package/dist/vendored/skills/finmall-session-navigator/scripts/package-lock.json +59 -0
- package/dist/vendored/skills/finmall-session-navigator/scripts/package.json +10 -0
- package/dist/vendored/skills/finmall-session-navigator/scripts/session-manager.mjs +96 -0
- package/dist/vendored/skills/shared/README.md +55 -0
- package/dist/vendored/skills/shared/auth-model.md +79 -0
- package/dist/vendored/skills/sketch-spec-to-card/SKILL.md +329 -0
- package/dist/vendored/skills/sketch-spec-to-card/references/boundary.json +14 -0
- package/dist/vendored/skills/sketch-spec-to-card/references/card_refs.json +13 -0
- package/dist/vendored/skills/sketch-spec-to-card/references/spec-schema.md +103 -0
- package/dist/vendored/skills/sketch-spec-to-card/scripts/build_prompt.py +797 -0
- package/dist/vendored/skills/sketch-spec-to-card/scripts/card_refs.py +94 -0
- package/dist/vendored/skills/sketch-spec-to-card/scripts/cluster_states.py +706 -0
- package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py +1781 -0
- package/dist/vendored/skills/sketch-spec-to-card/scripts/png_utils.py +318 -0
- package/dist/vendored/skills/sketch-spec-to-card/scripts/vision.py +1118 -0
- package/dist/vendored/templates/helloCard/data.json +10 -0
- package/dist/vendored/templates/helloCard/schema.json +238 -0
- package/dist/vendored/tools/link-skills.mjs +485 -0
- package/package.json +2 -1
- package/dist/preview-editor/assets/index-jl4YJzKv.js +0 -180
- package/dist/vendored/App.vue +0 -2858
- package/dist/vendored/ansi.js +0 -185
- package/dist/vendored/assets/apple-touch-icon.png +0 -0
- package/dist/vendored/assets/default-image.png +0 -0
- package/dist/vendored/assets/favicon-16.png +0 -0
- package/dist/vendored/assets/favicon-32.png +0 -0
- package/dist/vendored/assets/site-icon.png +0 -0
- package/dist/vendored/assets/svgIcons/icons.svg +0 -87
- package/dist/vendored/assets/svgIcons/index.js +0 -39
- package/dist/vendored/components/AiSettings.vue +0 -392
- package/dist/vendored/components/AlertCardInstance.vue +0 -58
- package/dist/vendored/components/AlertCardLayer.vue +0 -59
- package/dist/vendored/components/ApiCallPanel.vue +0 -127
- package/dist/vendored/components/ApiPayloadTree.vue +0 -201
- package/dist/vendored/components/AppToast.vue +0 -37
- package/dist/vendored/components/CardGallery.vue +0 -291
- package/dist/vendored/components/CardPreview.vue +0 -72
- package/dist/vendored/components/CardSelect.vue +0 -206
- package/dist/vendored/components/ChatComposer.vue +0 -413
- package/dist/vendored/components/ChatMessage.vue +0 -383
- package/dist/vendored/components/ChatPanel.vue +0 -937
- package/dist/vendored/components/ComponentPalette.vue +0 -301
- package/dist/vendored/components/ConfirmDialog.vue +0 -54
- package/dist/vendored/components/DatePickerOverlay.vue +0 -345
- package/dist/vendored/components/DebugPanel.vue +0 -1734
- package/dist/vendored/components/DeviceOverlay.vue +0 -70
- package/dist/vendored/components/Dropdown.vue +0 -193
- package/dist/vendored/components/EventEditor.vue +0 -273
- package/dist/vendored/components/HoverGuides.vue +0 -122
- package/dist/vendored/components/JsonTree.vue +0 -547
- package/dist/vendored/components/LogValue.vue +0 -52
- package/dist/vendored/components/MarkdownBody.vue +0 -64
- package/dist/vendored/components/NewCardDialog.vue +0 -132
- package/dist/vendored/components/NodeInspector.vue +0 -295
- package/dist/vendored/components/NumberStepper.vue +0 -125
- package/dist/vendored/components/PickerOverlay.vue +0 -131
- package/dist/vendored/components/PropControl.vue +0 -245
- package/dist/vendored/components/PropTree.vue +0 -128
- package/dist/vendored/components/RemotePreview.vue +0 -173
- package/dist/vendored/components/SelectionOverlay.vue +0 -105
- package/dist/vendored/components/StructureTree.vue +0 -1002
- package/dist/vendored/components/Switch.vue +0 -38
- package/dist/vendored/components/setters/SetBgPosition.vue +0 -64
- package/dist/vendored/components/setters/SetBgSize.vue +0 -90
- package/dist/vendored/components/setters/SetCode.vue +0 -198
- package/dist/vendored/components/setters/SetColor.vue +0 -244
- package/dist/vendored/components/setters/SetCustomSelect.vue +0 -58
- package/dist/vendored/components/setters/SetExpr.vue +0 -107
- package/dist/vendored/components/setters/SetGradient.vue +0 -125
- package/dist/vendored/components/setters/SetGrid9.vue +0 -68
- package/dist/vendored/components/setters/SetIconSelect.vue +0 -67
- package/dist/vendored/components/setters/SetIfForm.vue +0 -61
- package/dist/vendored/components/setters/SetImage.vue +0 -43
- package/dist/vendored/components/setters/SetList.vue +0 -139
- package/dist/vendored/components/setters/SetNumber.vue +0 -118
- package/dist/vendored/components/setters/SetNumberStyle.vue +0 -113
- package/dist/vendored/components/setters/SetPadding.vue +0 -77
- package/dist/vendored/components/setters/SetSegment.vue +0 -160
- package/dist/vendored/components/setters/SetSelect.vue +0 -51
- package/dist/vendored/components/setters/SetSwitch.vue +0 -49
- package/dist/vendored/components/setters/SetText.vue +0 -52
- package/dist/vendored/components/setters/props.js +0 -23
- package/dist/vendored/fidelity/baseline-messageOverview.json +0 -87
- package/dist/vendored/fidelity/calibration.json +0 -29
- package/dist/vendored/fidelity/fidelity-messageOverview-after.html +0 -114
- package/dist/vendored/fidelity/fidelity-messageOverview-after.json +0 -272
- package/dist/vendored/fidelity/fidelity-messageOverview.html +0 -185
- package/dist/vendored/fidelity/fidelity-messageOverview.json +0 -336
- package/dist/vendored/fidelity/fidelity-messageOverview_v2.html +0 -262
- package/dist/vendored/fidelity/fidelity-messageOverview_v2.json +0 -502
- package/dist/vendored/fidelity/fidelity-messageOverview_v3.html +0 -201
- package/dist/vendored/fidelity/fidelity-messageOverview_v3.json +0 -417
- package/dist/vendored/fidelity/fidelity-messageOverview_visual.html +0 -125
- package/dist/vendored/fidelity/fidelity-messageOverview_visual.json +0 -338
- package/dist/vendored/index.html +0 -16
- package/dist/vendored/main.js +0 -37
- package/dist/vendored/runtime/ai-api.js +0 -165
- package/dist/vendored/runtime/alert-card.js +0 -125
- package/dist/vendored/runtime/app-toast.js +0 -33
- package/dist/vendored/runtime/clipboard-node.js +0 -78
- package/dist/vendored/runtime/clipboard.js +0 -29
- package/dist/vendored/runtime/event-model.js +0 -300
- package/dist/vendored/runtime/hoverGuide.js +0 -31
- package/dist/vendored/runtime/jsapi-mock.js +0 -256
- package/dist/vendored/runtime/markdown.js +0 -140
- package/dist/vendored/runtime/node-model.js +0 -217
- package/dist/vendored/skills/.manifest.json +0 -1101
- package/dist/vendored/standalone-main.js +0 -36
- package/dist/vendored/styles/ai-chat.css +0 -1850
- package/dist/vendored/styles/app.css +0 -3648
- package/dist/vendored/styles/card-gallery.css +0 -285
- package/dist/vendored/styles/card-select.css +0 -288
- package/dist/vendored/styles/components.css +0 -383
- package/dist/vendored/styles/dropdown.css +0 -324
- package/dist/vendored/styles/json-tree.css +0 -308
- package/dist/vendored/styles/node-inspector.css +0 -800
- package/dist/vendored/styles/setters.css +0 -1050
- package/dist/vendored/styles/standalone.css +0 -27
- package/dist/vendored/styles/structure-tree.css +0 -460
- /package/dist/vendored/{api.js → preview/api.js} +0 -0
- /package/dist/vendored/{assets → preview/assets}/svg-symbols.svg +0 -0
- /package/dist/vendored/{components → preview/components}/AbsoluteLayout.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Button.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Canvas.vue +0 -0
- /package/dist/vendored/{components → preview/components}/CheckGroup.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Column.vue +0 -0
- /package/dist/vendored/{components → preview/components}/CustomPlaceholder.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Divider.vue +0 -0
- /package/dist/vendored/{components → preview/components}/GridLayout.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Icon.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Image.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Input.vue +0 -0
- /package/dist/vendored/{components → preview/components}/ListLayout.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Map.vue +0 -0
- /package/dist/vendored/{components → preview/components}/MultiColumn.vue +0 -0
- /package/dist/vendored/{components → preview/components}/MultiText.vue +0 -0
- /package/dist/vendored/{components → preview/components}/ProgressSlider.vue +0 -0
- /package/dist/vendored/{components → preview/components}/RadioButton.vue +0 -0
- /package/dist/vendored/{components → preview/components}/RenderTree.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Root.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Row.vue +0 -0
- /package/dist/vendored/{components → preview/components}/SvgCode.vue +0 -0
- /package/dist/vendored/{components → preview/components}/SvgSymbols.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Text.vue +0 -0
- /package/dist/vendored/{components → preview/components}/Video.vue +0 -0
- /package/dist/vendored/{components → preview/components}/ViewContainer.vue +0 -0
- /package/dist/vendored/{components → preview/components}/base.js +0 -0
- /package/dist/vendored/{components → preview/components}/icons.js +0 -0
- /package/dist/vendored/{components → preview/components}/index.js +0 -0
- /package/dist/vendored/{meta → preview/meta}/component-meta.json +0 -0
- /package/dist/vendored/{meta → preview/meta}/directive-meta.json +0 -0
- /package/dist/vendored/{meta → preview/meta}/style-meta.json +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/StyleParser.js +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/adapter.js +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/assets.js +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/canvas-context.js +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/card-runtime.js +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/evaluate.js +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/property.js +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/selectionOverlay.js +0 -0
- /package/dist/vendored/{runtime → preview/runtime}/toPreview.js +0 -0
- /package/dist/{server-core → vendored/server/core}/assetProxy.js +0 -0
- /package/dist/{server-core → vendored/server/core}/bbox.js +0 -0
- /package/dist/{server-core → vendored/server/core}/buildDataFromSchema.js +0 -0
- /package/dist/{server-core → vendored/server/core}/cardFiles.js +0 -0
- /package/dist/{server-core → vendored/server/core}/cardHistory.js +0 -0
- /package/dist/{server-core → vendored/server/core}/cardImage.js +0 -0
- /package/dist/{server-core → vendored/server/core}/cardImportMeta.js +0 -0
- /package/dist/{server-core → vendored/server/core}/cardListCache.js +0 -0
- /package/dist/{server-core → vendored/server/core}/cardOpenFolder.js +0 -0
- /package/dist/{server-core → vendored/server/core}/cardSidecar.js +0 -0
- /package/dist/{server-core → vendored/server/core}/codeBridge.js +0 -0
- /package/dist/{server-core → vendored/server/core}/logStream.js +0 -0
- /package/dist/{server-core → vendored/server/core}/logger.js +0 -0
- /package/dist/{server-core → vendored/server/core}/nodeModels.js +0 -0
- /package/dist/{server-core → vendored/server/core}/renderStatus.js +0 -0
- /package/dist/{server-core → vendored/server/core}/screenshot.js +0 -0
- /package/dist/{server-core → vendored/server/core}/sliceStatic.js +0 -0
- /package/dist/vendored/{meta → skills/dsl-card-generator/vendor/preview/meta}/action-meta.json +0 -0
- /package/dist/{server-core/_vendor → vendored/tools}/finmall-env.mjs +0 -0
|
@@ -0,0 +1,609 @@
|
|
|
1
|
+
# spec_to_schema 转换器范式集(已验证要点)
|
|
2
|
+
|
|
3
|
+
> 本文件汇总 `scripts/spec_to_schema_v3.mjs` 在真实生成任务中验证过的关键范式与技巧。
|
|
4
|
+
> 适用于任何"读 spec.json 结构化产物 → 直组装 schema"场景,减少决策思考消耗。
|
|
5
|
+
|
|
6
|
+
## 0. 界面生成三段式(总纲,适用所有 section 构建)
|
|
7
|
+
|
|
8
|
+
**节点结构生成一律遵循「从外到内」原则,严格分三阶段,禁止跳步、禁止扁平堆放:**
|
|
9
|
+
|
|
10
|
+
1. **① 结构关系(先搭容器骨架)**:依据设计稿实际要素的**空间拓扑**(位置/尺寸/类型/相对关系)决定嵌套层级。先确定有哪些容器、谁套谁。拓扑来自几何分析,**不依赖字段名词典或标注文案**。
|
|
11
|
+
2. **② 布局关系(再定容器如何排布)**:在每个容器上设置 `flexDirection / justifyContent / alignItems / gap`,决定子节点是横排还是竖排、两端对齐还是居中。
|
|
12
|
+
3. **③ 细节样式(最后才上标注)**:叶子节点(Text/Image/Input)的字号、颜色、加粗、padding、对齐,全部来自 spec 的 `textStyle` 等标注信息,在结构布局确定后再注入。
|
|
13
|
+
|
|
14
|
+
> 反例(禁止):把"label / 主值 / 副值 / 箭头"拍平成外层 Row 的兄弟节点,没有右侧套容器。这是"毫无章法"的根因。
|
|
15
|
+
|
|
16
|
+
**拓扑铁律(本轮回填,最高优先级)**:结构(谁套谁)的唯一依据是设计稿**实际要素的几何关系**(坐标/尺寸/类型/空间相邻),**绝不能是有限的标注信息**(字段名词典、标注文案、人工列举的"有哪些字段")。标注只用于③细节样式,不可反推结构。提取阶段若发现自己在用"这个文本叫什么名字"来决定嵌套,立即停止——改为"这个文本在哪儿、和谁挨着"来决定。
|
|
17
|
+
|
|
18
|
+
### 0.1 canonical 示例:键值字段行(KeyValue Row — 任何"标签 : 值"结构的通用范式)
|
|
19
|
+
|
|
20
|
+
> 以下以"左标签 + 右簇[主值 / 副值行 / 箭头]"为例。该结构适用于账户行、地址行、设置项、列表次级信息等一切 label:value UI,**与具体业务字段无关**。
|
|
21
|
+
|
|
22
|
+
设计稿真实拓扑(来自要素坐标,非标注):
|
|
23
|
+
- 左标签 `字段名`(x 最小)
|
|
24
|
+
- 右簇:主值 `主值文本`(y 最小)在上;副值行 `副值标签:`+`副值`(y 较大)在下;箭头切片(最右 x)在最右端
|
|
25
|
+
|
|
26
|
+
**正确结构(从外到内):**
|
|
27
|
+
```
|
|
28
|
+
Row (space-between, align-center) ← ① 外层:左标签 与 右簇 两端对齐
|
|
29
|
+
├─ Text "字段名" ← 左叶子(③ 细节来自 textStyle),固定型 shrink:0
|
|
30
|
+
└─ Row (align-center, gap) ← ② 右簇:箭头 与 [值+副值] 并列
|
|
31
|
+
├─ Column (align-flex-end, gap) ← ① [值+副值] 套一层 Column 成为整体节点
|
|
32
|
+
│ ├─ Text "主值文本" ← 主值(③)
|
|
33
|
+
│ └─ Row (align-center, gap) ← ② 副值行:同 y 多文本横排
|
|
34
|
+
│ ├─ Text "副值标签:" ← ③ 副值按 x 从左到右排列
|
|
35
|
+
│ └─ Text "副值"
|
|
36
|
+
└─ Image "箭头切片" ← 右簇右端箭头,固定型 shrink:0
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
**落地纪律(脚本内 `buildSchemaFromSemantics` 已实现,适用于所有表单行):**
|
|
40
|
+
- 提取阶段:表单行 = 表单带内**左锚定文本**为 label,其右侧同一竖直窗口内的全部文本(含下方堆叠副值)与图标切片聚为**右簇**;右簇内 y 最小者=主值、其余=副值、最右箭头切片=arrow。**不吃字段名词典、不看标注文案**(见上方拓扑铁律)。
|
|
41
|
+
- 渲染阶段:先建外层 `Row(space-between)`,再建右簇 `Row(align-center,gap)`,主值+副值再套 `Column`;副值同 y 多文本按 **x 升序**横排。最后才 `textFromSpec()` 注入字号/颜色/加粗。
|
|
42
|
+
|
|
43
|
+
### 0.2 通用 flex 规则:撑满型 vs 固定型(兄弟节点共存时必须区分)
|
|
44
|
+
|
|
45
|
+
当一行内**撑满型内容节点**与**固定型兄弟节点**(图标/切片 Image、金额标签等)共存时,必须明确二者角色,禁止拍脑袋写死百分比(如 `60%`):
|
|
46
|
+
|
|
47
|
+
- **撑满型内容节点**(Input、值列 Column 等应占满剩余空间的节点):`rect.width = '100%'` + `flex.flexShrink = '1'`。`100%` 提供基准宽度,`shrink:1` 允许在兄弟占用后压缩到剩余空间,从而自然撑满"除兄弟外的全部空间"。
|
|
48
|
+
- **固定型兄弟节点**(所有切片 Image / 图标):`flex.flexShrink = '0'`。固定尺寸、绝不挤压变形。
|
|
49
|
+
- **外层 label(左锚定文本)**:同属固定型,`flexShrink = '0'`,不被右侧撑满节点挤压。
|
|
50
|
+
|
|
51
|
+
> 落地位置:
|
|
52
|
+
> - `imageFromSlice()` 内统一 `setStyleChild(img,'flex','flexShrink','0')` —— 所有切片图标默认不收缩(**一处统管,全场景生效**)。
|
|
53
|
+
> - 表单行:`outer Row(space-between)` 的 label `shrink:0`;右簇 `Row width:100%+shrink:1`;值列 `Column width:100%+shrink:1`;Input 同 `width:100%+shrink:1`。
|
|
54
|
+
> - 反例:`setStyleChild(inp,'rect','width','60%')` 是错误写法——百分比写死无法随兄弟节点尺寸自适应,必须改为 `100%+shrink:1`。
|
|
55
|
+
|
|
56
|
+
### 0.2.1 flex 左右对齐两方案(标题行/操作行的标准做法,2026-08-17 沉淀)
|
|
57
|
+
|
|
58
|
+
行内一左一右两簇(如标题行"主标题 + 右侧动作"、操作行"主功能 + 副操作"),要实现"左靠左、右靠右"有两种等价做法,根据场景选用:
|
|
59
|
+
|
|
60
|
+
- **方案 A · 左撑满 + 右固定**(推荐用于"左侧文本需自适应伸缩")
|
|
61
|
+
- 左 Row:`rect.width = '100%'` + `flex.flexShrink = '1'`(占满剩余空间,自动吸收父容器宽度变化)
|
|
62
|
+
- 右 Row:**显式 `rect.width = 'auto'`** + `flex.flexShrink = '0'`(按内容尺寸固定,靠右贴边;用户 2026-08-17 定稿:必须 width:auto+shrink:0,不能只设 shrink:0 不设 width,否则左 100% 会被挤)
|
|
63
|
+
- 父 Row:`justifyContent = 'space-between'`
|
|
64
|
+
- **典型场景**:标题行(左标题可能很长 + 右侧短动作"查看全部");表单单行(左 label + 右 value,value 是固定字段名)
|
|
65
|
+
- **易错点**:右 Row 如果设了 `width: 100%`,父 space-between 失效(两子都被撑满无处 space),右簇被推到中间;右簇必须 **不设宽度** 才会被父容器当作"按内容尺寸"贴右
|
|
66
|
+
|
|
67
|
+
- **方案 B · 父 space-between + 两侧都不设宽度**(推荐用于"两侧都是固定内容、宽度都不会变")
|
|
68
|
+
- 左/右 Row:都 <u>不设置</u> `rect.width`
|
|
69
|
+
- 父 Row:`justifyContent = 'space-between'`
|
|
70
|
+
- **典型场景**:按钮行("取消" + "确认",两边都是固定长度);纯图标+文字的等长操作行
|
|
71
|
+
- **易错点**:当一侧文本长度会变(如标题行"未读数"+右侧动作),不要用方案 B —— 没有 `width:100%` 撑满,文本过长时父容器可能溢出或两簇重叠
|
|
72
|
+
|
|
73
|
+
> 反例(直接写 `width:60%`):左侧宽度写死百分比无法应对右侧变化,是常见错误。flex 的本质是"按内容比例分配剩余",百分比写死违反这一原则,必须用 `width:100% + flexShrink` 替代。
|
|
74
|
+
|
|
75
|
+
### 0.3 通用输入表单范式(Form Area:展示行 + 编辑行的统一处理)
|
|
76
|
+
|
|
77
|
+
任何"表单区 / 信息区"在生成时都视为**若干"行"的纵向序列**,每行独立按 §0.1 的 KeyValue 范式(展示行)或 §4.3 的 Input 范式(编辑行)生成。统一纪律:
|
|
78
|
+
|
|
79
|
+
- **行的归属靠几何,不靠命名**:行的切分由元素的 y 坐标聚类决定(同一竖直带 = 同一行);行内左右角色由 x 坐标决定(左锚定=label,右区域=cluster)。绝不依赖"转账/收款/余额"等业务词来划分结构。
|
|
80
|
+
- **展示行(KeyValue Row)**:见 §0.1。左 label(shrink:0)+ 右簇(主值/副值/箭头)。
|
|
81
|
+
- **编辑行(Input Row)**:见 §4.3。左 label(shrink:0)+ 右 Input(width:100%+shrink:1)+ 可能的右端图标(shrink:0)。
|
|
82
|
+
- **空值兜底**:提取到的 label/value 若在设计稿中为空或仅为占位,仍需生成结构骨架(保留节点 + 绑定/默认空串),不要整行丢弃;结构与数据解耦,缺数据不缺骨架。
|
|
83
|
+
- **跨行对齐**:同区多行共享同一左缩进(label x 对齐)与同一右边界(cluster 右沿对齐),由外层容器统一 padding 控制,行内不各自写死边距。
|
|
84
|
+
|
|
85
|
+
## 1. spec.json 元素语义块聚类(输入侧)
|
|
86
|
+
|
|
87
|
+
按 y 坐标分段 + 几何/文本特征把 elements 聚类为以下 8 类语义块:
|
|
88
|
+
|
|
89
|
+
| 语义块 | 识别特征 | 对应组件 |
|
|
90
|
+
|---|---|---|
|
|
91
|
+
| Tab 头 | 顶部 2-3 个并列短文本(≤5 字、x 间距 ≥100、textAlign=center) | Row space-around of Text |
|
|
92
|
+
| 顶部辅助文案 | Tab 与主金额之间的短文本(还款日/标题等) | Text(按 align 决定 wrap) |
|
|
93
|
+
| 主金额 | fontSize ≥ 24 的居中文本 | Text 大字号 + 抽 inputParam |
|
|
94
|
+
| 副金额对 | 13-14px 居中标签 + 紧随其后 16px 居中值 | Row of Column(标签+值) |
|
|
95
|
+
| 按钮行 | 圆角 shape(br ≥10)+ 内嵌居中文本;宽 80-220 高 30-70;排除与 Tab 同 y | Button 组件 |
|
|
96
|
+
| 列表标题 | 按钮下方独立短文本 | Text |
|
|
97
|
+
| 列表项 | 同 y 重复出现的「左对齐首列 + 居中金额 + 左对齐时间」组合 | ListLayout slotScope=true |
|
|
98
|
+
| 查看更多 | 列表底部、蓝/绿色短文本(与 #000000 不同) | Text |
|
|
99
|
+
|
|
100
|
+
## 2. 金额字段处理(铁律,见 amount_formatting.md)
|
|
101
|
+
|
|
102
|
+
**抽 inputParam + 表达式千分号**,不要直接拼字符串进 schema。
|
|
103
|
+
|
|
104
|
+
### 2.1 模板(运行时按正负决定负号,禁止写死前缀)
|
|
105
|
+
```js
|
|
106
|
+
// 通用模板:负数显示 '-¥abs',正数显示 '¥amount'
|
|
107
|
+
"($x < 0 ? '-' : '') + '¥' + ($x < 0 ? (0 - $x) : $x).toFixed(2).replace(/\\B(?=(\\d{3})+(?!\\d))/g, ',')"
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
**关键纪律**:**禁止根据 spec 原始文本是否带负号来写死前缀**。同一变量在不同数据下可能正负切换(如账单金额、退款明细),如果按 spec 写死 `-¥`,运行时数据翻成正数会显示成 `-¥123.45`,是严重 bug。必须用三元表达式在运行时按 `$x < 0` 判断。
|
|
111
|
+
|
|
112
|
+
### 2.2 inputParam 形状
|
|
113
|
+
```js
|
|
114
|
+
{ key: 'amount', type: 'number', defaultValue: 5638 } // 主金额(最大字号居中数值,几何/尺寸驱动识别;无金额类标签时用中性 amount)
|
|
115
|
+
{ key: 'currentDueAmount', type: 'number', defaultValue: 5638 } // 副金额(标签词典命中:本期应还→currentDueAmount)
|
|
116
|
+
{ key: 'itemAmount', type: 'number', defaultValue: -23.5 } // 列表项金额(保留正负号到数据层)
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
### 2.3 变量名规则(双层命名:标签词典 + 值角色兜底,泛化非硬编码)
|
|
120
|
+
| 场景 | 变量名 | 说明 |
|
|
121
|
+
|---|---|---|
|
|
122
|
+
| 主金额 | `amount` / 金额类标签语义名 | 最大字号居中数值,几何/尺寸驱动识别;附近文本命中金额类标签(应还/总额/转账…)→ 语义名,否则 `amount` |
|
|
123
|
+
| 副金额(第 i 对) | 标签词典命中(`currentDueAmount`/`minimumDueAmount`…)| 副金额标签(本期应还/最低应还/账单金额…)命中 `field_name_dict.json` → 语义名;未命中 → `amount`(uniqueKey 自动加序号区分同构多组) |
|
|
124
|
+
| 列表项金额 | `itemAmount` | slotScope 内 `$fieldName` 自动展开 |
|
|
125
|
+
|
|
126
|
+
> ✅ **双层命名机制(v3 已实现)**:字段名由「通用标签词典 `references/field_name_dict.json` → 语义化英文驼峰」+「值格式角色兜底(amount/cardNumber/phone/name/date/code)」共同决定。词典是**领域通用词表**(账号/金额/人/日期/状态等高频标签),不针对任何具体卡片——任何卡的标签都能命中,卡片 id 永不进入命名;未命中时按值格式命名,**保证永不出现 `obj_N` / `amount_0` / `subAmount_<i>` 序号名**。
|
|
127
|
+
>
|
|
128
|
+
> ⚠️ **禁止**:把「具体某张卡的标签→变量名」映射写死(如 `transferProcessing` 的转出账号→`outAccount`)。正确的做法是**泛化规则**:`outAccount` 来自词典里「转出账号/转出账户/付款账号…」这组通用同义词,任何转账/支付卡的同类标签都命中同一命名,不绑定卡片 id。词典可增补新词条(`references/field_name_dict.json`),增补即全局生效。
|
|
129
|
+
>
|
|
130
|
+
> ⚠️ **兜底纪律**:词典未命中时只能用值格式角色名(`cardNumber`/`amount`/`phone`/`name`/`date`/`code`),不得臆造业务词,也不得回退到 `obj_N` 序号名。
|
|
131
|
+
|
|
132
|
+
### 2.4 常见踩坑
|
|
133
|
+
- **双 `$` bug**:JS 模板字符串里 `$${varName}` 不会被替换,会字面输出 `$${varName}` —— eval 时语法错。**必须用字符串拼接 `'$' + varName`**。
|
|
134
|
+
- **表达式校验**:v3 每次生成后优先调 MCP `card_render_status({id})`(需 dev server)检查 `bindingErrorCount`;未启动 dev server 时可先用 `card_validate` / `validate_schema.py` 做结构校验,视觉收口用离线 `card_screenshot`。
|
|
135
|
+
- 表达式字符串里的 `\B` 必须用双斜杠 `\\B` 转义(JSON 序列化的需要)。
|
|
136
|
+
- **负号写死陷阱**(_v3_test_v13 曾踩):曾用 `rawText` 是否带负号判断要不要写死 `'-' + '¥' + ...`,但同一变量在退款变正数时会显示成 `-¥123.45`。修正为运行时按 `$x < 0` 判断。
|
|
137
|
+
|
|
138
|
+
### 2.5 敏感字段脱敏(通用:卡号 / 手机号 / 证件号 / 姓名 — 单一数据源 + 变量引用处表达式)
|
|
139
|
+
**铁律:敏感原始数据只存【完整】值,展示态脱敏在「变量引用处」用表达式处理。绝不另存一份脱敏字符串字段(如 `numberMasked` / `phoneMasked`)。**
|
|
140
|
+
|
|
141
|
+
设计稿里的 `*` / 掩码只是脱敏占位(真实数据基本未脱敏),所以:
|
|
142
|
+
- **数据层**:只放完整未脱敏值(如卡号 `"623000001238"`、手机号 `"13800008000"`)。提取时用 `unmask()` 把 `6230 **** 1238` / `138 **** 8000` 还原成完整值。
|
|
143
|
+
- **绑定层**:敏感字段 Text 的 `value` 绑**脱敏表达式**(不是原值,也不是写死脱敏串),与金额千分号(§2.1)完全同机制——都是在「引用变量时」就地变换。
|
|
144
|
+
|
|
145
|
+
```js
|
|
146
|
+
// 卡号:保留前4后4,中间 ****;长度 ≤8 原样返回(兜底短号/部分号)
|
|
147
|
+
"($number.length > 8 ? $number.slice(0,4) + ' **** ' + $number.slice(-4) : $number)"
|
|
148
|
+
// 手机号:保留前3后4,中间 ****
|
|
149
|
+
"($phone.length === 11 ? $phone.slice(0,3) + '****' + $phone.slice(-4) : $phone)"
|
|
150
|
+
// 姓名:保留首字,其余 *
|
|
151
|
+
"($name.length > 1 ? $name.slice(0,1) + '*'.repeat($name.length - 1) : $name)"
|
|
152
|
+
// 身份证:保留前6后4,中间 ********
|
|
153
|
+
"($id.length === 18 ? $id.slice(0,6) + '********' + $id.slice(-4) : $id)"
|
|
154
|
+
```
|
|
155
|
+
- `itemDefaultValue`(绑定失败兜底)填设计稿的脱敏字面量,与表达式输出一致。
|
|
156
|
+
|
|
157
|
+
**常见踩坑**
|
|
158
|
+
- **双字段冗余**:另存 `原值` + `脱敏值` 两字段 → 数据冗余且双源易不一致。修正为单字段 + 表达式脱敏(通用做法)。
|
|
159
|
+
- **展示层直接绑原值**:会显示完整未脱敏值,与设计稿脱敏态不符。必须走脱敏表达式。
|
|
160
|
+
- **写死脱敏串当绑定**:把脱敏字面量当 `value` 常量 → 失去绑定能力。脱敏是「表达式变换」,不是「另一份常量」。
|
|
161
|
+
- **脱敏与业务字段耦合**:不要把"是否脱敏"写进数据层开关(如 `numberMasked:true`)。脱敏是**展示层关注点**,只由绑定表达式决定,数据层保持纯净完整。
|
|
162
|
+
|
|
163
|
+
## 3. 列表项模板(ListLayout slotScope)
|
|
164
|
+
|
|
165
|
+
### 3.1 必填三件套
|
|
166
|
+
- ListLayout 的 `properties.value` 绑列表变量(itemValueFrom=1):列表标题命中「明细/详情」→ `$detailList`;未命中 → 中性 `$list`(v3 不再硬编码 `billList` 业务词)
|
|
167
|
+
- `slots[0].slotScope = true`(关键,否则子项 `$` 字段不生效)
|
|
168
|
+
- itemValueFrom=1 的属性**必须**带 `itemDefaultValue`(运行时 undefined 兜底)
|
|
169
|
+
|
|
170
|
+
### 3.2 列表项结构(export-proven:creditCardBill row_5v → row_6x)
|
|
171
|
+
```
|
|
172
|
+
Column (外层, width:100%, gap:0) ← 必须 Column!否则 Divider 会与内容并排
|
|
173
|
+
├── Row (内层, width:100%, align:center, padding:12, gap:0) ← 承载原左右内容
|
|
174
|
+
│ ├── Column (左, width:100%, gap:4) ← 自撑开剩余空间
|
|
175
|
+
│ │ ├── Text ($title, defaultValue: 它本身)
|
|
176
|
+
│ │ └── Text ($time, defaultValue: 它本身)
|
|
177
|
+
│ └── Row (右, justify:flex-end, align:center, gap:4, flexShrink:0) ← 不被压缩
|
|
178
|
+
│ ├── Text ($itemAmount + 千分号表达式)
|
|
179
|
+
│ └── Image (箭头, 20x20, cropMode:01, value=slices/8.icon/通用/箭头右@3x.png) ← 设计稿是 slice 切图,必须用 Image 引用,禁止臆造 Icon 矢量字形
|
|
180
|
+
└── Divider (width:100%, height:1, bg:#E9ECF2) ← 作为 Column 子节点纵向跟随
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
**关键设计决策**:外层用 `Column` 而非 `Row`——因为列表项底部需要跟一个 `Divider` 分割线。若外层是 Row,Divider 会成为第三个子节点与 leftCol/rightRow **横向并排**(被顶到右侧),产生离谱布局。因此必须:
|
|
184
|
+
1. 外层 `Column` 纵向堆叠
|
|
185
|
+
2. 原内容包进内层 `Row` 保持横向并排
|
|
186
|
+
3. `Divider` 作为 Column 的第二个子节点纵向跟随其后
|
|
187
|
+
|
|
188
|
+
### 3.3 关键约束
|
|
189
|
+
- **列表项含 Divider 时,外层必须用 `Column`** —— Divider 作为 Column 子节点纵向跟随在内容行之后。若用 Row 外层,Divider 会与内容横向并排(_v3_test_v22 踩坑)。
|
|
190
|
+
- **不要给内层 Row 加 `justifyContent: space-between`** —— 与「左 width:100% 自撑 + 右 flexShrink:0」组合时会把右 Row 推到 Row 之外(变成下一行)。
|
|
191
|
+
- **右 Row 必须 `flexShrink:0`** —— 否则金额会被压缩成"¥"一个字符。
|
|
192
|
+
- **左 Column 必须 `width:100%`** —— 占满让右 Row 自动靠右。
|
|
193
|
+
- **左 Column 必须 `flexShrink:1`(或显式不设)** —— 否则 width:100% 与 shrink:0 同时生效,左 Column 把右 Row 顶出可视区,金额被截断成只剩前缀「¥」。
|
|
194
|
+
- 列表项金额变量名固定为 `itemAmount`(slotScope 内 `$fieldName` 自动展开为当前项的该字段)。
|
|
195
|
+
|
|
196
|
+
### 3.4 编辑器侧 flexShrink 缺省值陷阱(重要)
|
|
197
|
+
`vendor/preview/meta/style-meta.json` 中 `flex.flexShrink.itemDefaultValue='0'` —— 编辑器渲染时把「未显式设置」视为 **不可压缩**。
|
|
198
|
+
因此脚本侧组装容器节点时:
|
|
199
|
+
- **必须显式写 `flexShrink`**,缺省会被编辑器解释成 `'0'`(独占保护)。
|
|
200
|
+
- **container() 工厂默认 `flexShrink:'1'`**(允许压缩,flex 标准行为)。
|
|
201
|
+
- 仅对真正需要"独占保护"的节点(列表右侧行、固定宽度图标组等)显式传 `opts.flexShrink='0'`。
|
|
202
|
+
|
|
203
|
+
错误示范(_v3_test_v11 ~ v12 曾踩):未显式设 shrink → 编辑器解释为 0 → 左 Column(width:100%, shrink:0) 把右 Row 顶出 → 金额截断只剩「¥」。
|
|
204
|
+
|
|
205
|
+
### 3.5 容器排列方向(flexDirection)推导(重要)
|
|
206
|
+
`container()` **不会**按 className 自动设 `flexDirection`——只有显式传 `opts.direction` 才会写入。早先版本漏传时,`flexDirection` 落到 `style-meta` 默认 `row`,导致:
|
|
207
|
+
- 选了 `Column` 节点,渲染却是**横向排列**(_v3_dividerfix/v23 踩坑:itemTpl=Column 但 direction 未设=横排,Divider 与内容并排)。
|
|
208
|
+
|
|
209
|
+
**代码层已修复**:`container()` 现按 className 自动推导默认方向——`Column→'column'`、`Row→'row'`,仅在 `opts.direction` 缺省时生效(显式传仍优先)。
|
|
210
|
+
**调用约定**:仍建议对所有容器显式传 `direction`,可读性优先;`Row` 对应 `'row'`、`Column` 对应 `'column'`。
|
|
211
|
+
|
|
212
|
+
### 3.6 切图(slice)必须渲染为 Image,禁止臆造 Icon 矢量字形
|
|
213
|
+
spec 里箭头/图标常以 `type=slice`(切图/图片)出现,且卡片 `prompt.md` §5.2 明确要求「优先复用 §4 切图素材」。
|
|
214
|
+
- **错误**:写死 `comp('Icon', icon='angle_right')` 矢量字形——既忽略 spec 的 slice 元素,又违反复用切图指令(_v23+ 踩坑)。
|
|
215
|
+
- **正确**:用 `imageFromSlice(sliceEl)` 渲染 `Image`,`value=slices/<spec切片name>@3x.png`(如 `slices/8.icon/通用/箭头右@3x.png`),`cropMode=01`(contain,透明小图标不裁切)。
|
|
216
|
+
- **尺寸/间隔**:按 slice 的 `rect`(如 20x20)设 Image 的 `rect.width/height`,与相邻文本用 `Row.gap` 控制间隔即可。
|
|
217
|
+
- **图片加载**:卡片图片需手动上传服务器(`@filestore/<ns>/<ts>_<name>@3x.png`)才会在预览/运行时显示;`slices/...` 是本地引用路径,上传步骤再改写为 `@filestore` 形式。预览中加载不出来的问题属预期,可忽略——只要尺寸与间隔正确即可(creditCardBill 实例验证)。
|
|
218
|
+
|
|
219
|
+
## 4. 元素之间分隔布局(撑开 + 再包容器)
|
|
220
|
+
|
|
221
|
+
当多个元素需要"左边紧凑撑开、右边固定靠右"或"几个元素必须贴在一起":
|
|
222
|
+
|
|
223
|
+
### 4.1 两端对齐(左右撑开)
|
|
224
|
+
```
|
|
225
|
+
Row (外层)
|
|
226
|
+
├── Column (左, width:100%, gap:4) ← 自撑开
|
|
227
|
+
└── Row (右, justify:flex-end, flexShrink:0) ← 固定靠右不被压缩
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
### 4.2 几个元素必须聚一起 → 再包一层容器
|
|
231
|
+
```
|
|
232
|
+
Row (外层, padding:12)
|
|
233
|
+
├── Row (左组, gap:8)
|
|
234
|
+
│ ├── Text (标题)
|
|
235
|
+
│ └── Text (时间)
|
|
236
|
+
└── Row (右组, justify:flex-end, flexShrink:0)
|
|
237
|
+
├── Text (金额)
|
|
238
|
+
└── Image (箭头, value=切片切图路径) ← slice 切图必须用 Image 引用
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
**通用规则**:
|
|
242
|
+
- 撑开放任一边 → 用 `width:100%` 自撑(左)+ `flexShrink:0`(右)
|
|
243
|
+
- 不允许压缩的固定元素 → 单独设 `flexShrink:0`
|
|
244
|
+
- 几个元素贴一起 → 用外层 Row/Column 把它们装成一组
|
|
245
|
+
- 始终保留 `gap` 字段控制组内间距,避免元素粘连
|
|
246
|
+
|
|
247
|
+
### 4.3 输入框(Input)撑满除兄弟节点外的剩余空间(通用做法)
|
|
248
|
+
|
|
249
|
+
当 Input 与兄弟节点(如编辑图标 Image)同处一个 Row 时,**输入框必须撑满除兄弟节点外的剩余空间**,不要写死任意百分比(如 60%)。
|
|
250
|
+
|
|
251
|
+
```
|
|
252
|
+
Row (外层, gap:8)
|
|
253
|
+
├── Input (width:100%, flexShrink:1) ← 撑满剩余空间,允许压缩
|
|
254
|
+
└── Image (编辑图标, flexShrink:0) ← 固定尺寸不被压缩
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
- **错误**:硬编码 `width:'60%'` —— 与具体兄弟节点尺寸耦合,不同卡片/不同图标尺寸下表现都不对(曾踩坑:输入框被写死 60%,右侧图标变宽时溢出)。
|
|
258
|
+
- **正确**:`width:100%` + `flexShrink:1` —— 这是通用做法,与「左 width:100% 自撑 + 右 flexShrink:0 不被压缩」的 §4.1 两端对齐范式同源,只是把左侧换成 Input。
|
|
259
|
+
- **代码层**:`spec_to_schema_v3.mjs` 中 Input 节点组装已改为这两个值,不再硬编码百分比。
|
|
260
|
+
|
|
261
|
+
## 5. v3 转换器固定技巧
|
|
262
|
+
|
|
263
|
+
### 5.1 字符串拼接(避免双 `$` bug)
|
|
264
|
+
```js
|
|
265
|
+
// ❌ 用模板字符串会被字面输出 $$varName
|
|
266
|
+
return `'¥' + ($${varName} * 1).toFixed(2)...`
|
|
267
|
+
|
|
268
|
+
// ✅ 用字符串拼接 + 显式 '$' + varName
|
|
269
|
+
return "'¥' + ($" + varName + " * 1).toFixed(2).replace(/\\B(?=(\\d{3})+(?!\\d))/g, ',')"
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
### 5.2 按钮样式纪律(来自 UI/05 多轮验证踩坑)
|
|
273
|
+
|
|
274
|
+
#### backgroundType 取值(来自 style-meta `backgroundType.itemOption`)
|
|
275
|
+
|
|
276
|
+
| 值 | 含义 | 颜色字段 |
|
|
277
|
+
|---|---|---|
|
|
278
|
+
| `'00'` | 透明 | 无 |
|
|
279
|
+
| `'01'` | 纯色 | `backgroundColor` |
|
|
280
|
+
| `'02'` | 图片 | `backgroundImage` |
|
|
281
|
+
| **`'03'`** | **渐变色** | **`backgroundGradient`** |
|
|
282
|
+
|
|
283
|
+
> ⚠️ **`'02'` 不是渐变!是图片!** v15~v18 曾用错导致还款按钮不可见。
|
|
284
|
+
|
|
285
|
+
#### 背景四态(严格按 spec 决定)
|
|
286
|
+
|
|
287
|
+
| spec 填充情况 | backgroundType | 颜色/渐变字段 | border 组 | 错误做法(曾踩) |
|
|
288
|
+
|---|---|---|---|---|
|
|
289
|
+
| `fill.gradient` 非空 | **`'03'`** | `backgroundGradient` = spec gradient **原文** | 不加 | ❌ 用 `'02'`(图片类型)→ 不渲染;❌ 用 `'01'`+纯色兜底→ 失去渐变效果 |
|
|
290
|
+
| `fill.color` 非空 | `'01'` | `backgroundColor` = hexToRgba(color) | 不加 | ✓ |
|
|
291
|
+
| 都没有(描边按钮)| `'01'` 白底 | `backgroundColor` = `#FFFFFF` | **必须加**:`isBorder:'1'`, `borderColor`=字色 | ❌ 无边框 → 按钮不可见 |
|
|
292
|
+
|
|
293
|
+
#### 布局纪律
|
|
294
|
+
- **所有 Button 必须设 `width:100%` + `flexShrink:1`**:撑满宽度,多按钮时 flex 自动均分。
|
|
295
|
+
- ❌ 不设 width → 按钮不撑满;❌ 设 width 但缺 shrink=0 → 多按钮溢出。
|
|
296
|
+
|
|
297
|
+
#### 文本对齐
|
|
298
|
+
- `font.textAlign` 必须显式设置(style-meta 默认 left),按钮内嵌文本默认 `'center'`。
|
|
299
|
+
- 按钮 `rect.height` 必须按 spec shape 的 height 设置,不要写死 46。
|
|
300
|
+
|
|
301
|
+
### 5.3 居中对齐容器
|
|
302
|
+
居中文本要按设计位置精准还原时(如副金额对),**用 Row(justify:space-around, padding:4) 包 Column(align:center)**,而不是直接 Row 里两个 Column —— 后者会被 flex 默认值拉偏。
|
|
303
|
+
|
|
304
|
+
### 5.4 Active/Tab 颜色绑定
|
|
305
|
+
多 Tab 时,给每个 Text 的 font.color 写绑定表达式:
|
|
306
|
+
```js
|
|
307
|
+
itemValueFrom: '1',
|
|
308
|
+
itemValue: `$activeTab == '${i + 1}' ? '${activeColor}' : '#666666'`,
|
|
309
|
+
itemDefaultValue: activeColor,
|
|
310
|
+
```
|
|
311
|
+
同时 root 需有 initAction 设默认 activeTab。
|
|
312
|
+
|
|
313
|
+
### 5.5 查看更多按钮(spec 语义块处理)
|
|
314
|
+
|
|
315
|
+
spec 中"查看更多"是普通 text 元素,但作为独立语义块渲染时需要:
|
|
316
|
+
1. **`textAlign: center`**:textFromSpec 必须传 `align: 'center'`(编辑器 font.textAlign 默认 left)
|
|
317
|
+
2. **上下间距:从 spec 几何推导,禁止硬编码** —— `sem.viewMore.gapTop = round(viewMore.y − 正上方元素底沿)`,用 Row 容器 + `paddingType=1`(自定义)+ `paddingTop=paddingBottom=gapTop` 包裹。
|
|
318
|
+
- 例:creditCardBill 验证卡,分割线底沿 858 → 查看更多顶 872 → `gapTop=14`,上下各 14px。
|
|
319
|
+
- **反例**:曾硬编码 `padding:8 + top/bottom:16`,与 spec 实际 14px 不符。spec 几何坐标已含准确间距,提取时务必带上位置信息,不要丢弃后回退到魔数。
|
|
320
|
+
|
|
321
|
+
> 注:Divider 组件本身已在 `component_specs.md` 完整定义,本文件不重复。
|
|
322
|
+
|
|
323
|
+
### 5.6 padding 多值陷阱(⚠️ 曾引发 23000px 布局爆炸)
|
|
324
|
+
|
|
325
|
+
**现象**:卡片渲染后 `ce_root` 高度从正常 ~680px 暴涨到 23304px,所有 `ce_text` 宽度塌缩为 0(文本纵向逐字换行)、Row 宽度爆到 2432px。
|
|
326
|
+
|
|
327
|
+
**根因**:`container()` 原把 `opts.padding` 一律写入 `padding.padding` 单值字段。当调用方传**双值字符串** `'12 16'`(语义:纵 12 / 横 16)时,style-meta 的 `padding.padding` **只接受单值**,渲染器解析失败 → flex 计算崩溃级联放大。
|
|
328
|
+
|
|
329
|
+
**修复(`spec_to_schema_v3.mjs` `container()`)**:padding 支持两种语法,自动分流:
|
|
330
|
+
- 单值 `"12"` → `paddingType='0'` + `padding=12`
|
|
331
|
+
- 双值/四值 `"12 16"` / `"8 16"` → `paddingType='1'` + `paddingTop/Bottom/Left/Right` 各边独立设值
|
|
332
|
+
|
|
333
|
+
**纪律**:凡需要纵向≠横向的留白,必须走 `paddingType=1` 各边独立;不要往 `padding.padding` 单值字段塞 `"N M"` 字符串。
|
|
334
|
+
|
|
335
|
+
### 5.7 底部收起/展开按钮(纯几何/命名驱动,泛化)**信号**(v3 `extractSemantics` 的 `collapseBtn`):卡片底部**按钮区底沿之下**的
|
|
336
|
+
- 方向图标 slice(name 含 箭头下/收起/arrow.*down/chevron.*down/angle.*down),或
|
|
337
|
+
- 「收起/展开/收起全部/展开全部」等短文案(2-6 字)
|
|
338
|
+
|
|
339
|
+
**渲染**(页脚辅助文案之后):居中 `Row` = [可选「收起」Text] + [方向图标]。
|
|
340
|
+
|
|
341
|
+
**素材纪律(关键,曾漏还原)**:`8.icon/通用/箭头下` 这类**功能图标** slice 即使未导出 PNG,也必须还原——用 Icon glyph 兜底(`angle_down` 收起 / `angle_up` 展开,export-proven 于存量列表展开卡),**绝不静默丢弃**。仅装饰性切片(顶部弥散背景等)跳过。判定方向按 slice 名:含 down/箭头下/收起 → `angle_down`,否则 `angle_up`。
|
|
342
|
+
|
|
343
|
+
```js
|
|
344
|
+
// 兜底结构(未导出时的 Icon 节点)
|
|
345
|
+
Icon { properties: [{ itemKey: 'icon', itemValue: 'angle_down' }], rect: 18x18, font.color: #999999 }
|
|
346
|
+
```
|
|
347
|
+
|
|
348
|
+
## 6. 闭环验证
|
|
349
|
+
|
|
350
|
+
每轮生成后必须执行三步:
|
|
351
|
+
|
|
352
|
+
```bash
|
|
353
|
+
# 1. 校验合法性
|
|
354
|
+
python skills/dsl-card-generator/scripts/validate_schema.py src/cards/<id>/schema.json
|
|
355
|
+
|
|
356
|
+
# 2. 渲染截图(离线独立渲染器,不启动 dev server)
|
|
357
|
+
node skills/dsl-card-generator/scripts/render_card.mjs --id <id> --width 375 --out render.png
|
|
358
|
+
|
|
359
|
+
# 3. 表达式错误统计
|
|
360
|
+
# /__render-status 仍需要 dev server(或 npm run dev);截图视觉收口可离线完成
|
|
361
|
+
# curl -s "http://127.0.0.1:8787/__render-status/<id>" | python -c "import json,sys; print('errors:', json.loads(sys.stdin.read())['bindingErrorCount'])"
|
|
362
|
+
```
|
|
363
|
+
|
|
364
|
+
> ⚠️ **截图裁剪陷阱**:独立渲染器默认截整卡 `.phone__screen` 真实高度,不再有旧端点的固定 800px 设备框裁剪;若做旧版端点对比,仍要注意旧端点超出部分会被裁掉。布局异常优先查 `ce_root` 的 `getBoundingClientRect().height`(见 §5.6)。
|
|
365
|
+
|
|
366
|
+
像素比对(Pillow):阈值 24,差异 < 9% 视为良好还原,>12% 进入多模态精修阶段。
|
|
367
|
+
## 7. 文本对齐还原(listTitle 误判与主金额短数字)
|
|
368
|
+
|
|
369
|
+
**问题**(transferDetail 状态卡曾踩):设计稿居中标题被渲染成左对齐。
|
|
370
|
+
- spec 的 `textStyle.textAlign` 信息**是正确的**(`交易正在处理中` align=center),问题在 v3 提取链路。
|
|
371
|
+
|
|
372
|
+
**根因与修复(v3 已实现,泛化)**:
|
|
373
|
+
1. **listTitle 丢失 textAlign**:提取时只存 text/color/fontSize/fontWeight,丢了 align → 渲染恒为左对齐。修复:提取补 `align`,渲染 `align==='center'` 时容器 `justify=center` + `font.textAlign=center`。
|
|
374
|
+
2. **无列表标题误判**:标题尺寸(15-18px)+下方**无列表行**也被当列表标题(状态卡"交易正在处理中"),且其 y 被当作 postAmountTexts 上界 → 更下方的提示文案被挤出渲染。修复:listTitle 判定要求**下方存在 ≥2 个文本元素**(列表行特征)。
|
|
375
|
+
3. **主金额短数字误判**:倒计时/序号/角标("2"、"S",fontSize≥24)被当主金额 → `¥2.00` 错误绑定。修复:主金额须含金额特征(`¥/元/小数点/千分位`)或去符号后 ≥3 位。
|
|
376
|
+
|
|
377
|
+
**纪律**:spec 的 textAlign 是权威信息,任何语义块提取/渲染都要**原样传递 align**;主金额必须是金额(不是任何大字号数字)。
|
|
378
|
+
|
|
379
|
+
## 8. 闭环验证(同 §6)
|
|
380
|
+
|
|
381
|
+
|
|
382
|
+
## 8. 环形倒计时(Canvas 自绘,v3 自动识别)
|
|
383
|
+
|
|
384
|
+
**识别信号**(`extractSemantics` 的 `countdown`,纯几何/格式,泛化):
|
|
385
|
+
1. ≥2 个**近似正方形**(w≈h,|w-h|<8)的 shape 两两**同心**(中心距 <10px)→ 圆环组(外环/内环/进度弧)
|
|
386
|
+
2. 环中心 ±(半径+8) 内存在**独立数字文本**(fontSize≥20,1-3 位纯数字)→ 倒计时数值
|
|
387
|
+
3. 数字附近(±40x/±30y)的**单位短文本**(S/s/秒/分)→ 单位
|
|
388
|
+
|
|
389
|
+
**命中后**:数字/单位文本从常规渲染排除(postAmountTexts 过滤),自动生成:
|
|
390
|
+
- `Canvas` 节点(直径=环形尺寸,flexShrink:0,背景透明),外层 Row 居中
|
|
391
|
+
- inputParams:`countdownTotal:number=10`(**绑定字段,desc 标注"倒计时总秒数",外部可配置**)、`countdownElapsed:number=0`(已流逝秒数);绘制代码从 `self.data.countdownTotal/countdownElapsed` 读取(绑定数据优先,缺省兜底 10/0),外部改 data.json/绑定面板即可调整秒数
|
|
392
|
+
- onMeasured:画浅色背景环(bgColor,lineWidth 4)→ 深色进度弧(progressColor,从 -π/2 顺时针 ratio×2π,lineCap round)→ 中心剩余秒数(**常规字重**,两位数补零 padStart(2,'0'))+ 单位(12px);启动 `setInterval(1000ms)` 每秒 `elapsed++` → `setData` + 手动 `drawRing` 重绘(onMeasured 是生命周期只触发一次,重绘不依赖渲染器自动重触发)
|
|
393
|
+
- 进度语义:`ratio = elapsed/total`(0%→100% 顺时针);中心显示 `total - elapsed`(10→0);**数字与单位间距**:数字中心 cx-4(28px 两数字右缘≈cx+11),单位中心 **cx+20**(右移,cx+14 时 12px 单位左缘≈cx+8 与数字重叠)
|
|
394
|
+
|
|
395
|
+
**配色来源**:环形组中 border.color 非浅灰(#F0F0F0)描边 → 进度色;浅灰描边 → 背景环色;中心数字色 → 数字色。
|
|
396
|
+
|
|
397
|
+
**坑位**:① 普通 Text/样式无法表达环形进度动画,必须 Canvas 自绘;② 主金额判定需排除倒计时短数字(§7 已处理:金额特征或 ≥3 位);③ Canvas style 必须完整(rect 方形、flex flexShrink:0、background 透明),flex 子项 itemId 按 style-meta(justifyContent=001/alignItems=002/flexShrink=005/gap=003/flexDirection=006);④ customAction 闭包 `var self = this`,timer 回调保持 this;⑤ 终止条件 `elapsed > total`。
|
|
398
|
+
|
|
399
|
+
## 9. 辅助文案垂直间距与倒计时环粗细几何化(还原精度)
|
|
400
|
+
|
|
401
|
+
**问题**(transferDetail 复核):红字距卡片底部只有 6px(设计稿 ~20px);倒计时环 lineWidth 固定 4px(设计稿描边 1px)明显偏粗。
|
|
402
|
+
|
|
403
|
+
**根因**:v3 对辅助文案用固定 padding(6/12/8),对倒计时环用固定 lineWidth=4,均未消费 spec 几何信息。
|
|
404
|
+
|
|
405
|
+
**修复(v3 已实现)**:
|
|
406
|
+
1. **辅助文案垂直间距几何化**:`sem.cardRect`(spec.cards[0].rect)→ cardBottom = y+height;每行 paddingTop = 本行 y − 上一行底沿(行高≈fontSize×1.4);末行 paddingBottom = cardBottom − 本行底沿。取不到回退固定值。
|
|
407
|
+
2. **倒计时环粗细几何化**:`strokeWidth` 取环形描边 shape 的 border.width(设计稿 1-2px),缺省按直径 2.5% 兜底;drawRing 的 radius = 半径 − lineWidth/2 − 1(外圈不裁切);字号随直径缩放(80px 环 → 数字 28px/单位 12px,scale=size/80)。
|
|
408
|
+
3. **倒计时顶部留白几何化**:Canvas Row paddingTop = 环顶 y − 卡片顶 y(如 696−668=28)。
|
|
409
|
+
|
|
410
|
+
**坑位**:container 双值 padding `"a b"` 语义 = top/right(bottom 回退 top),几何间距必须用**四值显式** `"top 0 bottom 0"`,否则 bottom 失效(曾把 20 回退成 top=7)。
|
|
411
|
+
|
|
412
|
+
## 10. 动态参数提取(姓名/卡号等运行期数据必须绑定,不写死)
|
|
413
|
+
|
|
414
|
+
**问题**(transferProcessing 复核):「转账给张欣然」整行被当常量 Text——收款人姓名是运行期数据,不可能写死。
|
|
415
|
+
|
|
416
|
+
**双层机制**:
|
|
417
|
+
1. **脚本确定性兜底(v3 已实现)**:4a 多值行绑定条件扩展为「强值信号实体行」或「**动词前缀 + 纯姓名**」(转账给张三 → 剥离动词为常量,姓名绑 `$payeeName`);单字段语义实体提升命名组合(payee+name→`payeeName`,避免裸 `name`)。
|
|
418
|
+
2. **智能体主判(SKILL.md 规则,生成后必做)**:Agent 通读全部常量文本,按「运行时是否随用户/业务数据变化」判定——姓名/卡号/手机号/账号/金额/余额/日期/订单号/验证码/备注等动态字段 → 提取 `$变量` 绑定 + 同步 data.json;纯静态文案(标题/标签/提示/银行名)保持常量。
|
|
419
|
+
|
|
420
|
+
**判定标准**:会随用户/业务数据变化 → 绑定;不变 → 常量。禁止把明显动态的字段留成字符串常量(数据无法下发替换)。
|
|
421
|
+
|
|
422
|
+
**坑位**:① 动词前缀(转账给/收款人/付款人…)是常量展示段,姓名是绑定段——用 multiToken 分段渲染(字面量 + $var);② 提取后必须同步 data.json(默认值=设计稿原文/还原值)+ 表达式 + validate;③ 单字段语义实体提升时用「实体名+字段名」组合(payeeName),不用裸角色名(name 太泛易撞名)。
|
|
423
|
+
|
|
424
|
+
## 11. 功能图标未导出 → 占位图还原(不静默丢弃)
|
|
425
|
+
|
|
426
|
+
**问题**(transferProcessing 复核):招商银行前的银行 logo(`8.icon/成都农商银行logo-26`,18x18)未还原。根因:该 slice **未导出 PNG**(spec.slices 清单缺失),`imageFromSlice` 按「仅引用已导出」返回 null → midCluster 渲染处 `if (logo)` 静默跳过。
|
|
427
|
+
|
|
428
|
+
**修复(v3 已实现,泛化)**:新增 `placeholderImage(sliceEl)`(rect 取 sliceEl 尺寸、flexShrink:0、cropMode 01、**value 空串** → 渲染器自动 `DEFAULT_IMAGE_URL` 占位图)+ `imageOrPlaceholder(sliceEl, specSlices)`(已导出→真实 Image;未导出→占位)。应用到全部功能图标:midCluster logo、表单行 arrowSlice/editSlice、顶部返回。
|
|
429
|
+
|
|
430
|
+
**纪律**:**功能图标**(logo/箭头/修改/返回,小尺寸与文本/控件同行)未导出时**必须占位还原位置**,绝不静默丢弃(用户可见元素缺失);仅**装饰性大切片**(弥散背景等)才允许跳过。占位图尺寸=sliceEl rect,与真实切片同位置同大小,素材导出后可无缝替换。
|
|
431
|
+
|
|
432
|
+
## 12. 切图匹配宽松化(导出文件名 ≠ 图层名)
|
|
433
|
+
|
|
434
|
+
**问题**(transferProcessing 复核):银行 logo 图层 `8.icon/成都农商银行logo-26` 在原始导出包 assets 里有文件(`8.icon/成都农商银行logo/单logo26@3x.png`),但**导出文件名与图层名不一致**(单logo26 vs 成都农商银行logo-26),basename 精确匹配失败 → spec.slices 无 logo → 卡片丢图标(曾退化为占位图)。
|
|
435
|
+
|
|
436
|
+
**修复(双端对称)**:
|
|
437
|
+
1. **sketch-spec-to-card `parse_meaxure.py::collect_slice_files`**:精确匹配未命中时,用图层名「语义段」(去尾部 -N/_N 数字后缀)匹配**文件路径目录**(成都农商银行logo ∈ 8.icon/成都农商银行logo/)→ 收入 spec.slices + 拷贝到 UI/<画板>/slices/
|
|
438
|
+
2. **dsl-card-generator `lib/slicePath.mjs::resolveSliceExport`**:同规则宽松匹配(图层语义段 ∈ 导出文件目录),v3 才能真实引用
|
|
439
|
+
3. **v3 `copyReferencedSlices` 传 `schema.view`**(原传整个 schema,walk 只递归 components/slots 收不到 view 顶层 → referenced 恒空 → 永不拷贝)
|
|
440
|
+
|
|
441
|
+
**纪律**:MeaXure 导出文件名常与图层名不一致(设计师导出重命名/按 slice 组导出),切图匹配必须「精确 basename → 语义段∈目录」两级兜底,缺一即丢图。
|
|
442
|
+
|
|
443
|
+
## 13. 卡片顶部装饰背景(弥散纹理层 → 顶部/底部两块划分)
|
|
444
|
+
|
|
445
|
+
**问题**(transferProcessing 复核):设计稿卡片顶部 140px 配置了背景图(`顶部-弥散`,y=158 h=140),生成后忽略;且没有明确的顶部(渐变区)/底部(白色内容区)两块划分。
|
|
446
|
+
|
|
447
|
+
**根因**:v3 只消费 slices 数组做 logo/箭头/修改/返回查找,「顶部-弥散」不匹配任何语义块 → 完全忽略(被当作装饰切片)。
|
|
448
|
+
|
|
449
|
+
**修复(v3 已实现,泛化)**:
|
|
450
|
+
1. **识别 `topDecoration`**:卡片顶部(y≈卡片顶 ±30)的 slice/group,name 含 弥散/渐变/光晕/顶部背景,宽≥卡宽 80%、高 60-220 → 顶部装饰背景
|
|
451
|
+
2. **渲染两块结构**:卡片 Column 首个子节点 = 图片背景容器(Column 固定高度=装饰层高度,backgroundType 02 + backgroundImage=/slices/… + backgroundSize 100% 100% + no-repeat);**顶部内容(auxTexts/midCluster/主金额)渲染进该容器**(背景不占流、内容叠加其上),其余(mid 文案/表单/按钮/页脚)留在卡片底部白色区
|
|
452
|
+
3. **copyReferencedSlices 补扫 style 背景图**:backgroundType 02 的 backgroundImage 也是 /slices/ 引用(原只扫 properties.value,导致背景图不落盘)
|
|
453
|
+
|
|
454
|
+
**纪律**:① 顶部装饰背景不参与「装饰切片跳过」规则(它是卡片设计内容,必须还原);② 渲染器不支持 position 绝对定位,叠加靠「背景容器 backgroundImage + 内容为容器子节点」实现;③ backgroundSize 支持两值(如 100% 100% / 100% 140px),StyleParser 会 split 转换。
|
|
455
|
+
|
|
456
|
+
## 14. 拓扑哲学:设计稿节点结构 ≠ 卡片节点拓扑(几何分段驱动)
|
|
457
|
+
|
|
458
|
+
**核心认知(用户 2026-08-16 确认)**:设计稿(MeaXure spec)是**扁平绝对定位画布**——每个元素靠绝对坐标定位,group/编组只是设计师的编辑组织(便于选中/移动),**不代表渲染层级**;它能"跳出元素间节点关系"直接摆放所有视觉元素。而 DSL 卡片是**流式 flex 容器树**——节点关系(谁套谁)直接决定渲染位置,没有绝对定位。因此:
|
|
459
|
+
|
|
460
|
+
> **卡片的节点拓扑只能从「视觉几何(y 轴分段、x 轴并排、间距 gap)」推导,绝不能用 spec 的元素/组嵌套结构、也不能按语义块类型硬编码归属。**
|
|
461
|
+
|
|
462
|
+
**案例**(transferProcessing):顶部渐变层(y=158 h=140,底沿 298)。内容归属曾按语义块类型硬编码(auxTexts/midCluster/主金额→顶部,postAmountTexts→底部),导致 y=264(卡内 106,在渐变区 0-140 内)的「实时到账」被错误留在底部。
|
|
463
|
+
|
|
464
|
+
**修复(v3 已实现)**:`topBoundary = 装饰层 y + height`;`hostFor(y) = y < topBoundary ? 顶部渐变容器 : 卡片底部区`。auxTexts(补 y)/midCluster/主金额/midAux 逐项按 **y 坐标**归属,与语义块类型无关。
|
|
465
|
+
|
|
466
|
+
**通用规则**:
|
|
467
|
+
1. 提取阶段给每个语义块带 **y**(auxTexts/midCluster/primaryAmount/postAmountTexts/表单/按钮均已带)
|
|
468
|
+
2. 分块边界 = 视觉分段边界(背景层底沿 / 大间距 / 类型切换),不用 spec group 结构
|
|
469
|
+
3. 任何「某类内容进某容器」的硬编码都是可疑的——先问几何边界在哪
|
|
470
|
+
|
|
471
|
+
## 15. 上游 sketch-spec-to-card 视觉分段(两 skill 结合,几何拓扑闭环)
|
|
472
|
+
|
|
473
|
+
**配合关系**:拓扑生成不应只靠下游自算——上游(sketch-spec-to-card)在解析阶段就按**几何 y 聚类**产出每卡的视觉分段,下游直接消费,两端同一套哲学(设计稿节点结构不作拓扑依据)。
|
|
474
|
+
|
|
475
|
+
**上游产出(parse_meaxure.py::detect_segments + build_prompt.py)**:
|
|
476
|
+
- `spec.json` 每卡新增 `segments[]`:`[{y, height, gap_top, hint, items}]`(卡内相对坐标)。hint ∈ decor-bg(装饰背景层,强制独立段)/ button / content。
|
|
477
|
+
- 排除:卡片容器本身(symbol 尺寸≈整卡)、卡外装饰(全屏背景/蒙版,卡 y 轴交集<50%)、元素 gap 阈值=卡高 2%。
|
|
478
|
+
- `prompt.md` §3 新增「视觉分段(几何推断,供拓扑生成)」段,并写明「设计稿 group/编组结构不作卡片拓扑依据」。
|
|
479
|
+
|
|
480
|
+
**下游消费(v3 extractSemantics)**:`topDecoration` 优先读 `spec.cards[0].segments`(hint=decor-bg 且卡内 y≤30 → 顶背景层),无 segments 时自算兜底;其余分段供未来细化拓扑。
|
|
481
|
+
|
|
482
|
+
**验证**:card-1 分段 = [0-140 decor-bg] [16-124 content 顶部内容9项] [140-436 content 表单24项] [302-348 button] [364-432 content 页脚] —— 与设计稿视觉分区一致;transferProcessing/transferDetail 双卡 validate OK。
|
|
483
|
+
|
|
484
|
+
## 16. 反馈详情卡生成要点(creditCardRepaySuccess 验证)
|
|
485
|
+
|
|
486
|
+
**场景**:还款成功等「反馈/结果卡」= 顶部渐变背景 + 状态图标 + 标题 + 下方 label:value 字段行。曾踩 5 处 skill 缺陷,全部修复:
|
|
487
|
+
|
|
488
|
+
1. **midCluster 无主金额 → null**:原 y 上界=∞,把下方字段行误收进 midCluster → 重复渲染 + 绑定混乱。
|
|
489
|
+
2. **listTitle 排除表单消费文本**:下方 ≥2 个**未被 formConsumed 消费**的文本才算列表行——「还款成功」下方是表单字段,不再误判为列表标题(否则渲染位置错 + 丢失顶部归属)。
|
|
490
|
+
3. **formRows 右簇窗口 ly+35**(原 +60):字段行距 ~40px 时 +60 跨行捕获下一行值/卡号(5,074.20 被两行渲染、卡号混入金额行产生 dueCardNumber 冗余)。
|
|
491
|
+
4. **classifyValue 金额支持小数+元**:`563.80元`/`5,074.20元`(原只匹配整数元)→ role=text 不绑定;正则 `^[\d,]+(\.\d+)?元$`。
|
|
492
|
+
5. **顶部状态图标**:卡片顶部 45% 内近似方形(40-130px)独立 slice(成功/失败/提示)→ 渐变容器内顶部居中 Image(未导出占位)。
|
|
493
|
+
|
|
494
|
+
**产物**:`currentDueAmount=563.8` / `remainingDueAmount=5074.2`(词典 还款金额→currentDueAmount、剩余应还金额→remainingDueAmount)/ `repayAccountNo=603300006492`(脱敏表达式)+ 渐变层(顶部-弥散1)+ 成功图标 + 还款成功标题。validate OK、data.json 一致。
|
|
495
|
+
|
|
496
|
+
## 17. 渐变层内子节点间距与金额单位(2026-08-16 反馈卡核验)
|
|
497
|
+
|
|
498
|
+
**问题**(creditCardRepaySuccess 截图核验):渐变层内「成功」图标 90×90 紧贴底部、「还款成功」标题被挤压几乎不可见;字段金额「563.80元」被加 ¥ 前缀(与设计稿原文「563.80元」不一致)。
|
|
499
|
+
|
|
500
|
+
**根因**:
|
|
501
|
+
- 渐变容器默认 `gap:0 padding:0` —— 子节点(图标 + 标题 Row)垂直挤堆,标题紧挨图标。
|
|
502
|
+
- `amountExpr` 强加 `'¥'+千分号`,无视 spec 原文是否含汉字单位词。
|
|
503
|
+
|
|
504
|
+
**修复(v3 已实现,泛化)**:
|
|
505
|
+
1. **渐变容器**:gap=12 + padding=`16 0 8 0` + justify=flex-start → 图标→标题自然间距,标题不再被挤。
|
|
506
|
+
2. **amountExpr(varName, srcText)** 重构:正则检测末尾汉字单位(`/([\d,.\-]+)([\u4e00-\u9fa5]+)$/`):
|
|
507
|
+
- **含汉字单位**(如「563.80元」)→ 仅输出千分号数字 + 单位后缀(不输出 ¥,保留原文「元」)
|
|
508
|
+
- **纯数字 / 带 ¥ 前缀**(如「¥500.00」)→ 维持原版 `'¥'+千分号`
|
|
509
|
+
3. 传递 srcText 给所有调用点:valueExpr('amount', text)、主金额、subAmounts、itemAmount。
|
|
510
|
+
|
|
511
|
+
**回归**:transferProcessing 主金额(spec 含 ¥)仍输出 ¥ ✓;可用余额「¥13,382.98」保持 ¥ ✓;transferDetail 状态卡 OK;creditCardRepaySuccess 金额展示「563.80元」/「5,074.20元」「6033 **** 6492」。
|
|
512
|
+
|
|
513
|
+
### 17.1 渐变容器内行间距归零(容器统一 gap/padding,防 169px 爆炸)
|
|
514
|
+
|
|
515
|
+
**问题**(creditCardRepaySuccess 复核):标题「还款成功」Row 出现 `paddingBottom=169px`——midAux 循环里 `isLast = i===len-1 && footAux.length===0` 把**渐变容器内的标题行**误判为卡片末行,`paddingBottom = 卡底(1838) − 行底(1669) = 169`。
|
|
516
|
+
|
|
517
|
+
**修复(v3 已实现)**:
|
|
518
|
+
1. `hostFor(y)` 判定行是否进渐变容器(`inTopHost`);**容器内行 padding 归零**,间距全部交给容器 gap=12 / padding=`16 0 8 0`。
|
|
519
|
+
2. midAux 末行贴底计算只在**其后无任何内容块**时生效:`hasBlocksAfter = formRows || buttons || footAux`,`isLast = 末行 && !hasBlocksAfter`——渐变区后还有表单/按钮/footAux 的行绝不计算 paddingBottom。
|
|
520
|
+
|
|
521
|
+
**纪律**:容器负责的子节点间距不要重复在子节点 padding 上叠加;"卡片末行"必须验证其后真的没有其他内容块。
|
|
522
|
+
|
|
523
|
+
## 18. 同构节点统一收进父容器(表单行/列表行分组维护)
|
|
524
|
+
|
|
525
|
+
**问题**(creditCardRepaySuccess 复核):同类的表单行(label:value 行,仅文本内容/值不同,样式完全一致)此前被平铺为卡片根的独立 Row(comp_6/comp_11/comp_16)——无法整体移动/替换,也不符合组件树"同构子节点应收进同一容器"的维护原则。
|
|
526
|
+
|
|
527
|
+
**修复(v3 已实现,泛化)**:formRows 渲染时先建**表单父容器**(Column width:100% align:stretch gap:0 padding:0),所有表单行 outer push 进该容器,最后按**首个表单行的 y** 走 `hostFor`(几何拓扑驱动:渐变区或底部区)。
|
|
528
|
+
|
|
529
|
+
**结构**:
|
|
530
|
+
```
|
|
531
|
+
Column comp_6(表单容器)
|
|
532
|
+
├── Row comp_7 还款金额 → 值
|
|
533
|
+
├── Row comp_12 剩余应还金额 → 值
|
|
534
|
+
└── Row comp_17 还款账户 → 值
|
|
535
|
+
```
|
|
536
|
+
|
|
537
|
+
**验证**:creditCardRepaySuccess(3 行收进 comp_6)、transferProcessing(转出账号/附言收进 comp_14)、transferDetail 均 validate OK,inputParams/绑定不变。
|
|
538
|
+
|
|
539
|
+
## 19. 枚举统计行(Enum-Stat Strip):类型标签 + 数字 → 结构化数组字段
|
|
540
|
+
|
|
541
|
+
**问题**(messageOverview 复核,用户 2026-08-19 定稿):副标题 `动账 5 · 转账 2 · 站内 1 · 其他 4` 四个数字是对应四个类型的**独立变量**,但旧实现把整行绑成一个**字符串字段**(`unreadBreakdown: string`)——数字无法单点取值、下游无法按类型统计/过滤。必须提取为**结构化数组**。
|
|
542
|
+
|
|
543
|
+
**泛用性铁律**:本模式适用于**任何**「类型/分类标签 + 数量/金额」的枚举统计文本(未读分类、状态计数、分类金额、占比分布、Tab 统计等),**不依赖任何业务词**——识别只看**结构信号**,命名只看**泛化规则**,禁止写死"动账/转账/站内/其他"或"消息中心"。
|
|
544
|
+
|
|
545
|
+
### 19.1 识别信号(纯结构特征,LLM/Agent 与脚本共用)
|
|
546
|
+
|
|
547
|
+
单行文本同时满足以下**全部**条件即判定为枚举统计行:
|
|
548
|
+
|
|
549
|
+
1. 整行由 **≥2 段**「短标签 + 数字」构成;
|
|
550
|
+
2. 段间用**统一分隔符**(`·`、`、`、`,`、`|`、`/`、空格等,分隔符在整行内一致不变);
|
|
551
|
+
3. 每段数字是**正整数计数**(如 `5`/`12`)或**金额**(如 `¥1,280.00`、`2.5万`);
|
|
552
|
+
4. 每段标签是**分类词**(1-6 字,如"动账""转账""站内""其他")——排除量词("第 5 名")、序号("1)xxx")、单位("金额 5 元"中"5"是单值不算枚举)。
|
|
553
|
+
|
|
554
|
+
**反例(不判定)**:
|
|
555
|
+
- `共 12 条未读消息`(单个数字,无多段枚举结构);
|
|
556
|
+
- `第 5 名 / 第 1 期`(数字是序数词,不是分类计数);
|
|
557
|
+
- `金额 5,000.00 元`(单值金额,已有 amount 规范处理);
|
|
558
|
+
- `剩余 3 天`(单段,量纲单一)。
|
|
559
|
+
|
|
560
|
+
### 19.2 数据结构(泛用形态)
|
|
561
|
+
|
|
562
|
+
```jsonc
|
|
563
|
+
// inputParams(dictionary.inputParams[])
|
|
564
|
+
{ "key": "unreadBreakdown", "type": "array",
|
|
565
|
+
"defaultValue": [ { "label": "动账", "value": 5 }, { "label": "转账", "value": 2 },
|
|
566
|
+
{ "label": "站内", "value": 1 }, { "label": "其他", "value": 4 } ],
|
|
567
|
+
"desc": "未读消息分类统计(枚举统计行:标签+数量)" }
|
|
568
|
+
|
|
569
|
+
// data.json 逐字节一致
|
|
570
|
+
"unreadBreakdown": [ { "label": "动账", "value": 5 }, { "label": "转账", "value": 2 },
|
|
571
|
+
{ "label": "站内", "value": 1 }, { "label": "其他", "value": 4 } ]
|
|
572
|
+
```
|
|
573
|
+
|
|
574
|
+
- **项内字段固定**:`label`(设计稿标签原文,中文数据值,非 key——不违反"无中文 key"铁律)、`value`(数字,number)。
|
|
575
|
+
- **量纲说明**:计数用 `value: number`;分类金额可加 `unit` 字段("元"/"万")或在 label 保留单位,字段形状保持 `{label, value[, unit]}`。
|
|
576
|
+
- 类型数可变(2 个或 8 个都行),增删类型只需改数组项,不新增变量。
|
|
577
|
+
|
|
578
|
+
### 19.3 渲染表达式(还原设计稿原文)
|
|
579
|
+
|
|
580
|
+
Text 的 `value`(`itemValueFrom:"1"`)绑:
|
|
581
|
+
|
|
582
|
+
```js
|
|
583
|
+
// 分隔符从设计稿原文提取(本例 " · ");map/join 是标准 JS 数组方法,表达式引擎可求值
|
|
584
|
+
"$unreadBreakdown.map(i => i.label + ' ' + i.value).join(' · ')"
|
|
585
|
+
```
|
|
586
|
+
|
|
587
|
+
- `itemDefaultValue` = 设计稿原文(如 `"动账 5 · 转账 2 · 站内 1 · 其他 4"`),兜底渲染不空。
|
|
588
|
+
- 需要数字参与计算(如角标、点击过滤、Canvas 绘制)时,数组项直接取 `$x[0].value` / `$$.value`(ListLayout slotScope 内)或 `$x.find(i => i.label === '动账').value`。
|
|
589
|
+
- **双 `$` 纪律**:脚本内拼接表达式用 `'$' + varName`,不要用模板字符串 `$${varName}`(字面输出)。
|
|
590
|
+
|
|
591
|
+
### 19.4 双层机制(与字段命名同构)
|
|
592
|
+
|
|
593
|
+
1. **脚本确定性兜底(v3 `detectEnumStatStrip`)**:对 `postAmountTexts`/`auxTexts` 逐文本跑正则(≥2 段 `标签+数字` + 统一分隔符)→ 命中即生成数组 inputParams(变量名 = `fieldKeyFor(标签文本) + 'Breakdown'` 或兜底 `statBreakdown`)+ Text 绑 `map/join` 表达式。
|
|
594
|
+
2. **LLM/Agent 主判(SKILL.md 规则,生成后必做)**:通读**每个**文本,判定是否枚举统计结构、分隔符、量纲(计数/金额)、类型标签含义;脚本未覆盖的(分隔符不规则、金额量纲、标签含数字等)按结构特征手动提取。命名与同步规则见 `field_naming.md §3.1`。
|
|
595
|
+
|
|
596
|
+
### 19.5 命名(进 field_naming.md §3.1,泛用)
|
|
597
|
+
|
|
598
|
+
- 数组字段名:`<类型域语义>Breakdown`(如 `unreadBreakdown` 未读分类、`statusBreakdown` 状态计数、`categoryStats` 分类统计)——**类型名永不进变量名**("动账"→ 不生成 `dongZhangCount`)。
|
|
599
|
+
- 未命中语义域 → 兜底 `statBreakdown` / `categoryStats`。
|
|
600
|
+
- 值字段固定 `label`/`value`(+可选 `unit`),不随业务变。
|
|
601
|
+
|
|
602
|
+
### 19.6 坑位
|
|
603
|
+
|
|
604
|
+
- **勿把整行绑成一个字符串变量**(旧 messageOverview 做法):数字失去结构化,下游无法按类型取数。这是本模式要消除的。
|
|
605
|
+
- **勿把类型词写进 key**(`dongZhangCount`):类型是数据不是结构,类型可变、业务词不可泛化。
|
|
606
|
+
- **map/join 表达式里的 `i` 是回调局部变量**,不与 `$` 前缀变量冲突,可放心用。
|
|
607
|
+
- **转义**:写进 schema `itemValue` 时若含正则须双反斜杠(`\d`→`\\d`);本表达式无正则,直接可用。
|
|
608
|
+
- **同步 data.json**:新增数组字段后跑 `derive_data_json.py --overwrite` + validate。
|
|
609
|
+
- **分隔符保留**:join 参数必须用设计稿原文分隔符(含前后空格 `" · "`),否则视觉与设计稿不符。
|