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.
Files changed (313) hide show
  1. package/README.md +46 -5
  2. package/dist/cli.js +51 -1
  3. package/dist/config.js +51 -16
  4. package/dist/core.js +2 -2
  5. package/dist/init.js +425 -0
  6. package/dist/preview-editor/assets/index-CHuGGIR3.js +276 -0
  7. package/dist/preview-editor/assets/{index-B4VZgNSK.css → index-CQScMhyg.css} +1 -1
  8. package/dist/preview-editor/index.html +2 -2
  9. package/dist/standalone.js +8 -0
  10. package/dist/vendored/mcp/client.mjs +537 -0
  11. package/dist/vendored/mcp/tools.mjs +268 -0
  12. package/dist/vendored/preview/assets/default-image.png +0 -0
  13. package/dist/{server-core → vendored/server/core}/ai-chat.js +82 -38
  14. package/dist/{server-core → vendored/server/core}/browser.js +1 -1
  15. package/dist/{server-core → vendored/server/core}/cardSave.js +8 -3
  16. package/dist/{server-core → vendored/server/core}/cardSync.js +6 -14
  17. package/dist/{server-core → vendored/server/core}/cardValidate.js +11 -8
  18. package/dist/{server-core → vendored/server/core}/index.js +5 -3
  19. package/dist/vendored/server/core/skillPaths.js +124 -0
  20. package/dist/{server-core → vendored/server/core}/sliceUpload.js +5 -8
  21. package/dist/vendored/skills/README.md +93 -0
  22. package/dist/vendored/skills/card-doctor/SKILL.md +52 -0
  23. package/dist/vendored/skills/card-skill-trainer/SKILL.md +312 -0
  24. package/dist/vendored/skills/card-skill-trainer/baselines/v3-r038n.json +43 -0
  25. package/dist/vendored/skills/card-skill-trainer/baselines/v3-r039n.json +47 -0
  26. package/dist/vendored/skills/card-skill-trainer/baselines/v3-r050n.json +48 -0
  27. package/dist/vendored/skills/card-skill-trainer/scripts/build_dataset.py +472 -0
  28. package/dist/vendored/skills/card-skill-trainer/scripts/build_sample.mjs +162 -0
  29. package/dist/vendored/skills/card-skill-trainer/scripts/diagnose_case.mjs +241 -0
  30. package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs +525 -0
  31. package/dist/vendored/skills/card-skill-trainer/scripts/round_diff.mjs +133 -0
  32. package/dist/vendored/skills/card-skill-trainer/scripts/run_round.mjs +1043 -0
  33. package/dist/vendored/skills/card-skill-trainer/scripts/score_round.mjs +195 -0
  34. package/dist/vendored/skills/card-skill-trainer/scripts/test_missing_slice.py +122 -0
  35. package/dist/vendored/skills/dsl-card-ai/SKILL.md +191 -0
  36. package/dist/vendored/skills/dsl-card-generator/SKILL.md +480 -0
  37. package/dist/vendored/skills/dsl-card-generator/config/render-contract.json +11 -0
  38. package/dist/vendored/skills/dsl-card-generator/references/amount_formatting.md +138 -0
  39. package/dist/vendored/skills/dsl-card-generator/references/card_index.json +1597 -0
  40. package/dist/vendored/skills/dsl-card-generator/references/card_templates.json +384 -0
  41. package/dist/vendored/skills/dsl-card-generator/references/card_to_summary.md +56 -0
  42. package/dist/vendored/skills/dsl-card-generator/references/component_rules.md +76 -0
  43. package/dist/vendored/skills/dsl-card-generator/references/component_specs.md +393 -0
  44. package/dist/vendored/skills/dsl-card-generator/references/dsl_structure.md +208 -0
  45. package/dist/vendored/skills/dsl-card-generator/references/event_patterns.md +287 -0
  46. package/dist/vendored/skills/dsl-card-generator/references/expression_engine.md +121 -0
  47. package/dist/vendored/skills/dsl-card-generator/references/field_name_dict.json +34 -0
  48. package/dist/vendored/skills/dsl-card-generator/references/field_naming.md +101 -0
  49. package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md +928 -0
  50. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/README.md +69 -0
  51. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/examples_index.json +2967 -0
  52. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/patterns.json +2835 -0
  53. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/recipes_v2.json +648 -0
  54. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/recipes_v2_schema.md +295 -0
  55. package/dist/vendored/skills/dsl-card-generator/references/image_diff.md +48 -0
  56. package/dist/vendored/skills/dsl-card-generator/references/image_to_card.md +129 -0
  57. package/dist/vendored/skills/dsl-card-generator/references/ir-format.md +212 -0
  58. package/dist/vendored/skills/dsl-card-generator/references/message-center-pattern.md +149 -0
  59. package/dist/vendored/skills/dsl-card-generator/references/platform_jsapi.md +196 -0
  60. package/dist/vendored/skills/dsl-card-generator/references/previewer_contract.md +54 -0
  61. package/dist/vendored/skills/dsl-card-generator/references/quickref.md +197 -0
  62. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/absolute-badge.json +84 -0
  63. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/accordion-group-toggle.json +18 -0
  64. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/alertCard-pair.json +12 -0
  65. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/alertDialog-call.json +12 -0
  66. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-countdown.json +15 -0
  67. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-donut.json +15 -0
  68. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-gauge-score.json +11 -0
  69. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-radar.json +10 -0
  70. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-title-head.json +13 -0
  71. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/globalSet.json +12 -0
  72. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/label-col-modes.json +21 -0
  73. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/list-expand-collapse.json +17 -0
  74. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/money-format.json +11 -0
  75. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/opacity-switch.json +130 -0
  76. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/progress-bar.json +25 -0
  77. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/tab-billMode.json +15 -0
  78. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/title-underline-overlay.json +21 -0
  79. package/dist/vendored/skills/dsl-card-generator/references/recipes.md +797 -0
  80. package/dist/vendored/skills/dsl-card-generator/references/rules.md +235 -0
  81. package/dist/vendored/skills/dsl-card-generator/references/slices_convention.md +177 -0
  82. package/dist/vendored/skills/dsl-card-generator/references/spec_to_schema_patterns.md +609 -0
  83. package/dist/vendored/skills/dsl-card-generator/references/ui_fidelity_rules.md +131 -0
  84. package/dist/vendored/skills/dsl-card-generator/scripts/add_component.mjs +118 -0
  85. package/dist/vendored/skills/dsl-card-generator/scripts/analyze_component_usage.mjs +153 -0
  86. package/dist/vendored/skills/dsl-card-generator/scripts/apply_opacity_pattern.mjs +343 -0
  87. package/dist/vendored/skills/dsl-card-generator/scripts/build_card_index.mjs +108 -0
  88. package/dist/vendored/skills/dsl-card-generator/scripts/build_card_templates.mjs +190 -0
  89. package/dist/vendored/skills/dsl-card-generator/scripts/check_fidelity.mjs +257 -0
  90. package/dist/vendored/skills/dsl-card-generator/scripts/check_magic_values.mjs +79 -0
  91. package/dist/vendored/skills/dsl-card-generator/scripts/crop_slices.mjs +98 -0
  92. package/dist/vendored/skills/dsl-card-generator/scripts/describe_card.mjs +265 -0
  93. package/dist/vendored/skills/dsl-card-generator/scripts/diff_bands.mjs +257 -0
  94. package/dist/vendored/skills/dsl-card-generator/scripts/diff_card.mjs +316 -0
  95. package/dist/vendored/skills/dsl-card-generator/scripts/expand_ir.mjs +873 -0
  96. package/dist/vendored/skills/dsl-card-generator/scripts/extract_handcrafted.py +1199 -0
  97. package/dist/vendored/skills/dsl-card-generator/scripts/extract_subtree.mjs +191 -0
  98. package/dist/vendored/skills/dsl-card-generator/scripts/generate_cards.mjs +389 -0
  99. package/dist/vendored/skills/dsl-card-generator/scripts/inventory_schemas.py +160 -0
  100. package/dist/vendored/skills/dsl-card-generator/scripts/iterate.mjs +700 -0
  101. package/dist/vendored/skills/dsl-card-generator/scripts/lib/design_image.mjs +56 -0
  102. package/dist/vendored/skills/dsl-card-generator/scripts/lib/design_sample.mjs +328 -0
  103. package/dist/vendored/skills/dsl-card-generator/scripts/lib/layout-tokens.mjs +79 -0
  104. package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.mjs +103 -0
  105. package/dist/vendored/skills/dsl-card-generator/scripts/lib/scaffold.mjs +575 -0
  106. package/dist/vendored/skills/dsl-card-generator/scripts/lib/slicePath.mjs +81 -0
  107. package/dist/vendored/skills/dsl-card-generator/scripts/lib/slice_dedupe.mjs +147 -0
  108. package/dist/vendored/skills/dsl-card-generator/scripts/lint_autofix.mjs +363 -0
  109. package/dist/vendored/skills/dsl-card-generator/scripts/lint_card.mjs +1399 -0
  110. package/dist/vendored/skills/dsl-card-generator/scripts/preflight.mjs +249 -0
  111. package/dist/vendored/skills/dsl-card-generator/scripts/register_card_template.mjs +208 -0
  112. package/dist/vendored/skills/dsl-card-generator/scripts/render_baseline.mjs +231 -0
  113. package/dist/vendored/skills/dsl-card-generator/scripts/render_card.mjs +801 -0
  114. package/dist/vendored/skills/dsl-card-generator/scripts/render_diff.mjs +239 -0
  115. package/dist/vendored/skills/dsl-card-generator/scripts/resolve_card_template.mjs +73 -0
  116. package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs +447 -0
  117. package/dist/vendored/skills/dsl-card-generator/scripts/scaffold_card.mjs +81 -0
  118. package/dist/vendored/skills/dsl-card-generator/scripts/slices_normalize.mjs +316 -0
  119. package/dist/vendored/skills/dsl-card-generator/scripts/spec_audit.mjs +462 -0
  120. package/dist/vendored/skills/dsl-card-generator/scripts/spec_to_schema_v3.mjs +7735 -0
  121. package/dist/vendored/skills/dsl-card-generator/scripts/spec_tree.mjs +355 -0
  122. package/dist/vendored/skills/dsl-card-generator/scripts/validate_all_schemas.py +71 -0
  123. package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/default-image-wzZYQ86K.png +0 -0
  124. package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/standalone-C9k-07y7.css +1 -0
  125. package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/standalone-oFRM4f4V.js +55 -0
  126. package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/svg-symbols-B2exBrAr.svg +118 -0
  127. package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/component-meta.json +2714 -0
  128. package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/directive-meta.json +40 -0
  129. package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/style-meta.json +1086 -0
  130. package/dist/vendored/{standalone.html → skills/dsl-card-generator/vendor/preview/standalone.html} +2 -1
  131. package/dist/vendored/skills/finmall-card-sync/SKILL.md +262 -0
  132. package/dist/vendored/skills/finmall-session-navigator/SKILL.md +169 -0
  133. package/dist/vendored/skills/finmall-session-navigator/scripts/finmall_login.mjs +882 -0
  134. package/dist/vendored/skills/finmall-session-navigator/scripts/package-lock.json +59 -0
  135. package/dist/vendored/skills/finmall-session-navigator/scripts/package.json +10 -0
  136. package/dist/vendored/skills/finmall-session-navigator/scripts/session-manager.mjs +96 -0
  137. package/dist/vendored/skills/shared/README.md +55 -0
  138. package/dist/vendored/skills/shared/auth-model.md +79 -0
  139. package/dist/vendored/skills/sketch-spec-to-card/SKILL.md +329 -0
  140. package/dist/vendored/skills/sketch-spec-to-card/references/boundary.json +14 -0
  141. package/dist/vendored/skills/sketch-spec-to-card/references/card_refs.json +13 -0
  142. package/dist/vendored/skills/sketch-spec-to-card/references/spec-schema.md +103 -0
  143. package/dist/vendored/skills/sketch-spec-to-card/scripts/build_prompt.py +797 -0
  144. package/dist/vendored/skills/sketch-spec-to-card/scripts/card_refs.py +94 -0
  145. package/dist/vendored/skills/sketch-spec-to-card/scripts/cluster_states.py +706 -0
  146. package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py +1781 -0
  147. package/dist/vendored/skills/sketch-spec-to-card/scripts/png_utils.py +318 -0
  148. package/dist/vendored/skills/sketch-spec-to-card/scripts/vision.py +1118 -0
  149. package/dist/vendored/templates/helloCard/data.json +10 -0
  150. package/dist/vendored/templates/helloCard/schema.json +238 -0
  151. package/dist/vendored/tools/link-skills.mjs +485 -0
  152. package/package.json +2 -1
  153. package/dist/preview-editor/assets/index-jl4YJzKv.js +0 -180
  154. package/dist/vendored/App.vue +0 -2858
  155. package/dist/vendored/ansi.js +0 -185
  156. package/dist/vendored/assets/apple-touch-icon.png +0 -0
  157. package/dist/vendored/assets/default-image.png +0 -0
  158. package/dist/vendored/assets/favicon-16.png +0 -0
  159. package/dist/vendored/assets/favicon-32.png +0 -0
  160. package/dist/vendored/assets/site-icon.png +0 -0
  161. package/dist/vendored/assets/svgIcons/icons.svg +0 -87
  162. package/dist/vendored/assets/svgIcons/index.js +0 -39
  163. package/dist/vendored/components/AiSettings.vue +0 -392
  164. package/dist/vendored/components/AlertCardInstance.vue +0 -58
  165. package/dist/vendored/components/AlertCardLayer.vue +0 -59
  166. package/dist/vendored/components/ApiCallPanel.vue +0 -127
  167. package/dist/vendored/components/ApiPayloadTree.vue +0 -201
  168. package/dist/vendored/components/AppToast.vue +0 -37
  169. package/dist/vendored/components/CardGallery.vue +0 -291
  170. package/dist/vendored/components/CardPreview.vue +0 -72
  171. package/dist/vendored/components/CardSelect.vue +0 -206
  172. package/dist/vendored/components/ChatComposer.vue +0 -413
  173. package/dist/vendored/components/ChatMessage.vue +0 -383
  174. package/dist/vendored/components/ChatPanel.vue +0 -937
  175. package/dist/vendored/components/ComponentPalette.vue +0 -301
  176. package/dist/vendored/components/ConfirmDialog.vue +0 -54
  177. package/dist/vendored/components/DatePickerOverlay.vue +0 -345
  178. package/dist/vendored/components/DebugPanel.vue +0 -1734
  179. package/dist/vendored/components/DeviceOverlay.vue +0 -70
  180. package/dist/vendored/components/Dropdown.vue +0 -193
  181. package/dist/vendored/components/EventEditor.vue +0 -273
  182. package/dist/vendored/components/HoverGuides.vue +0 -122
  183. package/dist/vendored/components/JsonTree.vue +0 -547
  184. package/dist/vendored/components/LogValue.vue +0 -52
  185. package/dist/vendored/components/MarkdownBody.vue +0 -64
  186. package/dist/vendored/components/NewCardDialog.vue +0 -132
  187. package/dist/vendored/components/NodeInspector.vue +0 -295
  188. package/dist/vendored/components/NumberStepper.vue +0 -125
  189. package/dist/vendored/components/PickerOverlay.vue +0 -131
  190. package/dist/vendored/components/PropControl.vue +0 -245
  191. package/dist/vendored/components/PropTree.vue +0 -128
  192. package/dist/vendored/components/RemotePreview.vue +0 -173
  193. package/dist/vendored/components/SelectionOverlay.vue +0 -105
  194. package/dist/vendored/components/StructureTree.vue +0 -1002
  195. package/dist/vendored/components/Switch.vue +0 -38
  196. package/dist/vendored/components/setters/SetBgPosition.vue +0 -64
  197. package/dist/vendored/components/setters/SetBgSize.vue +0 -90
  198. package/dist/vendored/components/setters/SetCode.vue +0 -198
  199. package/dist/vendored/components/setters/SetColor.vue +0 -244
  200. package/dist/vendored/components/setters/SetCustomSelect.vue +0 -58
  201. package/dist/vendored/components/setters/SetExpr.vue +0 -107
  202. package/dist/vendored/components/setters/SetGradient.vue +0 -125
  203. package/dist/vendored/components/setters/SetGrid9.vue +0 -68
  204. package/dist/vendored/components/setters/SetIconSelect.vue +0 -67
  205. package/dist/vendored/components/setters/SetIfForm.vue +0 -61
  206. package/dist/vendored/components/setters/SetImage.vue +0 -43
  207. package/dist/vendored/components/setters/SetList.vue +0 -139
  208. package/dist/vendored/components/setters/SetNumber.vue +0 -118
  209. package/dist/vendored/components/setters/SetNumberStyle.vue +0 -113
  210. package/dist/vendored/components/setters/SetPadding.vue +0 -77
  211. package/dist/vendored/components/setters/SetSegment.vue +0 -160
  212. package/dist/vendored/components/setters/SetSelect.vue +0 -51
  213. package/dist/vendored/components/setters/SetSwitch.vue +0 -49
  214. package/dist/vendored/components/setters/SetText.vue +0 -52
  215. package/dist/vendored/components/setters/props.js +0 -23
  216. package/dist/vendored/fidelity/baseline-messageOverview.json +0 -87
  217. package/dist/vendored/fidelity/calibration.json +0 -29
  218. package/dist/vendored/fidelity/fidelity-messageOverview-after.html +0 -114
  219. package/dist/vendored/fidelity/fidelity-messageOverview-after.json +0 -272
  220. package/dist/vendored/fidelity/fidelity-messageOverview.html +0 -185
  221. package/dist/vendored/fidelity/fidelity-messageOverview.json +0 -336
  222. package/dist/vendored/fidelity/fidelity-messageOverview_v2.html +0 -262
  223. package/dist/vendored/fidelity/fidelity-messageOverview_v2.json +0 -502
  224. package/dist/vendored/fidelity/fidelity-messageOverview_v3.html +0 -201
  225. package/dist/vendored/fidelity/fidelity-messageOverview_v3.json +0 -417
  226. package/dist/vendored/fidelity/fidelity-messageOverview_visual.html +0 -125
  227. package/dist/vendored/fidelity/fidelity-messageOverview_visual.json +0 -338
  228. package/dist/vendored/index.html +0 -16
  229. package/dist/vendored/main.js +0 -37
  230. package/dist/vendored/runtime/ai-api.js +0 -165
  231. package/dist/vendored/runtime/alert-card.js +0 -125
  232. package/dist/vendored/runtime/app-toast.js +0 -33
  233. package/dist/vendored/runtime/clipboard-node.js +0 -78
  234. package/dist/vendored/runtime/clipboard.js +0 -29
  235. package/dist/vendored/runtime/event-model.js +0 -300
  236. package/dist/vendored/runtime/hoverGuide.js +0 -31
  237. package/dist/vendored/runtime/jsapi-mock.js +0 -256
  238. package/dist/vendored/runtime/markdown.js +0 -140
  239. package/dist/vendored/runtime/node-model.js +0 -217
  240. package/dist/vendored/skills/.manifest.json +0 -1101
  241. package/dist/vendored/standalone-main.js +0 -36
  242. package/dist/vendored/styles/ai-chat.css +0 -1850
  243. package/dist/vendored/styles/app.css +0 -3648
  244. package/dist/vendored/styles/card-gallery.css +0 -285
  245. package/dist/vendored/styles/card-select.css +0 -288
  246. package/dist/vendored/styles/components.css +0 -383
  247. package/dist/vendored/styles/dropdown.css +0 -324
  248. package/dist/vendored/styles/json-tree.css +0 -308
  249. package/dist/vendored/styles/node-inspector.css +0 -800
  250. package/dist/vendored/styles/setters.css +0 -1050
  251. package/dist/vendored/styles/standalone.css +0 -27
  252. package/dist/vendored/styles/structure-tree.css +0 -460
  253. /package/dist/vendored/{api.js → preview/api.js} +0 -0
  254. /package/dist/vendored/{assets → preview/assets}/svg-symbols.svg +0 -0
  255. /package/dist/vendored/{components → preview/components}/AbsoluteLayout.vue +0 -0
  256. /package/dist/vendored/{components → preview/components}/Button.vue +0 -0
  257. /package/dist/vendored/{components → preview/components}/Canvas.vue +0 -0
  258. /package/dist/vendored/{components → preview/components}/CheckGroup.vue +0 -0
  259. /package/dist/vendored/{components → preview/components}/Column.vue +0 -0
  260. /package/dist/vendored/{components → preview/components}/CustomPlaceholder.vue +0 -0
  261. /package/dist/vendored/{components → preview/components}/Divider.vue +0 -0
  262. /package/dist/vendored/{components → preview/components}/GridLayout.vue +0 -0
  263. /package/dist/vendored/{components → preview/components}/Icon.vue +0 -0
  264. /package/dist/vendored/{components → preview/components}/Image.vue +0 -0
  265. /package/dist/vendored/{components → preview/components}/Input.vue +0 -0
  266. /package/dist/vendored/{components → preview/components}/ListLayout.vue +0 -0
  267. /package/dist/vendored/{components → preview/components}/Map.vue +0 -0
  268. /package/dist/vendored/{components → preview/components}/MultiColumn.vue +0 -0
  269. /package/dist/vendored/{components → preview/components}/MultiText.vue +0 -0
  270. /package/dist/vendored/{components → preview/components}/ProgressSlider.vue +0 -0
  271. /package/dist/vendored/{components → preview/components}/RadioButton.vue +0 -0
  272. /package/dist/vendored/{components → preview/components}/RenderTree.vue +0 -0
  273. /package/dist/vendored/{components → preview/components}/Root.vue +0 -0
  274. /package/dist/vendored/{components → preview/components}/Row.vue +0 -0
  275. /package/dist/vendored/{components → preview/components}/SvgCode.vue +0 -0
  276. /package/dist/vendored/{components → preview/components}/SvgSymbols.vue +0 -0
  277. /package/dist/vendored/{components → preview/components}/Text.vue +0 -0
  278. /package/dist/vendored/{components → preview/components}/Video.vue +0 -0
  279. /package/dist/vendored/{components → preview/components}/ViewContainer.vue +0 -0
  280. /package/dist/vendored/{components → preview/components}/base.js +0 -0
  281. /package/dist/vendored/{components → preview/components}/icons.js +0 -0
  282. /package/dist/vendored/{components → preview/components}/index.js +0 -0
  283. /package/dist/vendored/{meta → preview/meta}/component-meta.json +0 -0
  284. /package/dist/vendored/{meta → preview/meta}/directive-meta.json +0 -0
  285. /package/dist/vendored/{meta → preview/meta}/style-meta.json +0 -0
  286. /package/dist/vendored/{runtime → preview/runtime}/StyleParser.js +0 -0
  287. /package/dist/vendored/{runtime → preview/runtime}/adapter.js +0 -0
  288. /package/dist/vendored/{runtime → preview/runtime}/assets.js +0 -0
  289. /package/dist/vendored/{runtime → preview/runtime}/canvas-context.js +0 -0
  290. /package/dist/vendored/{runtime → preview/runtime}/card-runtime.js +0 -0
  291. /package/dist/vendored/{runtime → preview/runtime}/evaluate.js +0 -0
  292. /package/dist/vendored/{runtime → preview/runtime}/property.js +0 -0
  293. /package/dist/vendored/{runtime → preview/runtime}/selectionOverlay.js +0 -0
  294. /package/dist/vendored/{runtime → preview/runtime}/toPreview.js +0 -0
  295. /package/dist/{server-core → vendored/server/core}/assetProxy.js +0 -0
  296. /package/dist/{server-core → vendored/server/core}/bbox.js +0 -0
  297. /package/dist/{server-core → vendored/server/core}/buildDataFromSchema.js +0 -0
  298. /package/dist/{server-core → vendored/server/core}/cardFiles.js +0 -0
  299. /package/dist/{server-core → vendored/server/core}/cardHistory.js +0 -0
  300. /package/dist/{server-core → vendored/server/core}/cardImage.js +0 -0
  301. /package/dist/{server-core → vendored/server/core}/cardImportMeta.js +0 -0
  302. /package/dist/{server-core → vendored/server/core}/cardListCache.js +0 -0
  303. /package/dist/{server-core → vendored/server/core}/cardOpenFolder.js +0 -0
  304. /package/dist/{server-core → vendored/server/core}/cardSidecar.js +0 -0
  305. /package/dist/{server-core → vendored/server/core}/codeBridge.js +0 -0
  306. /package/dist/{server-core → vendored/server/core}/logStream.js +0 -0
  307. /package/dist/{server-core → vendored/server/core}/logger.js +0 -0
  308. /package/dist/{server-core → vendored/server/core}/nodeModels.js +0 -0
  309. /package/dist/{server-core → vendored/server/core}/renderStatus.js +0 -0
  310. /package/dist/{server-core → vendored/server/core}/screenshot.js +0 -0
  311. /package/dist/{server-core → vendored/server/core}/sliceStatic.js +0 -0
  312. /package/dist/vendored/{meta → skills/dsl-card-generator/vendor/preview/meta}/action-meta.json +0 -0
  313. /package/dist/{server-core/_vendor → vendored/tools}/finmall-env.mjs +0 -0
@@ -4,9 +4,10 @@
4
4
  <meta charset="UTF-8" />
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <title>CardBuddy Standalone Card Preview</title>
7
+ <script type="module" crossorigin src="/assets/standalone-oFRM4f4V.js"></script>
8
+ <link rel="stylesheet" crossorigin href="/assets/standalone-C9k-07y7.css">
7
9
  </head>
8
10
  <body>
9
11
  <div id="app"></div>
10
- <script type="module" src="/standalone-main.js"></script>
11
12
  </body>
12
13
  </html>
@@ -0,0 +1,262 @@
1
+ ---
2
+ name: finmall-card-sync
3
+ description: 通过 API 把 FinMall UAT 卡片列表项纯接口同步进本工程的 src/cards(card-list IDC10001.do + 按 cardId 取 schema 的 IDC10012.do),从已登录的浏览器页面拉取,下载封面图、根据卡片变量派生运行时 data.json 并保存可复用产物;也负责把卡片引用的 src/slices 切图上传到 FinMall 图片库(CC0000.do)并把 schema 里的 /slices/ 引用改写为 @filestore/ 线上地址(scripts/slice_upload.mjs)。不依赖编辑器 UI,也不做 Monaco DOM 抓取。当 Codex 需要拉取或刷新 FinMall 卡片的封面 / schema / data 文件,或需要上传切图拿到图片在线地址时使用。
4
+ ---
5
+
6
+ # FinMall 卡片同步
7
+
8
+ 通过 API 把 FinMall 的卡片从 UAT 卡片列表同步进 `src/cards/<englishCardId>/`。
9
+
10
+ ## 前置条件
11
+
12
+ 1. 先使用 `finmall-session-navigator` 打开并鉴权卡片列表页。
13
+ 2. 保持已启动的 Chrome 以远程调试模式运行(端口由 `FINMALL_CDP_PORT` 配置,默认 `9222`)。
14
+ 3. 确保 `skills/finmall-session-navigator/scripts/node_modules/playwright` 存在;本 skill 复用该依赖。
15
+
16
+ ## 环境配置
17
+
18
+ 域名、appId、workspaceId 等从工程环境配置读取。优先级:环境变量 > `.env.cb.local` > `.env.cb` > 内置默认值。
19
+
20
+ 完整配置表见 `finmall-session-navigator` 的 SKILL.md。每次运行通过下方 CLI 参数覆盖时,参数优先于配置文件。
21
+
22
+ ## 快速开始
23
+
24
+ 所有卡片数据都通过已鉴权浏览器页面的 API 拉取——没有编辑器 UI,没有 Monaco DOM 抓取,也不用点击翻页。浏览器页面仅作为已鉴权的传输通道:卡片列表来自 `IDC10001.do`,schema 来自按 cardId 取的 `IDC10012.do`,封面从列表的 `picUrl` 下载。
25
+
26
+ 在工程根目录运行批量同步:
27
+
28
+ ```bash
29
+ node skills/finmall-card-sync/scripts/api_batch_sync.mjs --startPage 1
30
+ ```
31
+
32
+ > 使用任意 Node 22+(如托管运行时 `~/.workbuddy/binaries/node/versions/<ver>/bin/node`)。脚本会自动把 `127.0.0.1` 从 `HTTP_PROXY` 中排除,以便访问本地 Chrome 调试端口。
33
+
34
+ 常用选项:
35
+
36
+ - `--cardCode activityLevel`:按英文 ID 同步单张卡片。脚本通过列表接口 `searchValue` 定位它,再用该卡的**数字** `cardId` 拉取 schema——无需索引计算,也无需编辑器。替代了旧的 `--cardId` / `--index` 编辑器流程。
37
+ - `--startPage 1 --startIndex 1`:从第 1 页开始批量同步,跳过第一张卡片。
38
+ - `--maxCards 10`:限制同步卡片数量(便于冒烟测试)。
39
+ - `--outRoot src/cards`:覆盖输出根目录(相对于工程根)。
40
+ - `--cdpUrl http://127.0.0.1:9222`:覆盖 Chrome CDP 端点。
41
+ - `--appId 100042 --workspaceId dev`:覆盖 FinMall 应用 / 工作空间标识(默认来自 `.env.cb`)。
42
+
43
+ ## 鉴权
44
+
45
+ **完整鉴权模型(不用 Cookie / `_sessionId` 双层编码 / 列表接口不鉴权的坑 / `_sessionId` 存在 ≠ 服务端有效 / token 头使用纪律 / Playwright Chrome 150 兼容性补丁)见 `shared/auth-model.md` §一、§二**——跨 skill 集中陈述的权威方。本节只列与本同步 skill 直接相关的操作要点:
46
+
47
+ - 每个 `IDC1xxxx.do` 调用都必须带 `token` 请求头(取 localStorage `_sessionId`,双层编码,仅在页面上下文内使用)。本 skill 的 `finmallPost` 在 `page.evaluate` 内部读取它并直接使用——**绝不要**把该值拷贝到 Node 侧、打印日志或落盘。
48
+ - `IDC10001.do`(卡片列表)**不**鉴权,所以会话早已失效时列表页仍能完整渲染。而 `IDC10012.do` 这类鉴权接口随后就会报 `BLEC0006 会话超时`。仅凭可见页面内容判断登录状态是不可靠的。
49
+ - **同步时遇到 `会话超时`**:重新运行 `finmall-session-navigator` 刷新会话即可;若导航器报告 `hasSession:true / attempts:0` 但同步仍报超时,按 `auth-model.md` §1.4 的指引——`localStorage.clear()` 后重登。
50
+
51
+ ## 输出约定
52
+
53
+ 对于英文 ID 为 `accountDialog` 的卡片,保存:
54
+
55
+ - `src/cards/accountDialog/accountDialog.png`:封面图,以英文 ID 命名。
56
+ - `src/cards/accountDialog/schema.json`:解析并格式化后的完整 schema JSON。
57
+ - `src/cards/accountDialog/data.json`:根据 `schema.dictionary.inputParams` 派生的运行时变量数据。
58
+
59
+ ## 抽取规则
60
+
61
+ 使用 `IDC10001.do` 列表响应中的 `code` 字段作为文件夹与封面图的基名(即英文卡片 ID)。不要用中文的 `cardName` 做文件系统命名。
62
+
63
+ 优先使用从已鉴权浏览器会话观察到的 API:
64
+
65
+ - `IDC10001.do`:分页列出卡片,参数含 `pageNo`、`pageSize`、`cardClassId`、`searchValue`、`sassAppId`、`sassWorkspaceId`;响应 `body.cardList[]` 含 `cardId`、`cardName`、`code`、`picUrl`。
66
+ - `IDC10012.do`:根据列表响应中的数字 **`cardId`** 拉取卡片 schema,并带 `sassAppId`、`sassWorkspaceId`;响应 `body.schemaValue` 是完整的 schema JSON 字符串。
67
+
68
+ > **不要用 `cardCode` 作为 `IDC10012.do` 的键。** 已验证行为:传 `cardCode` 会返回 `errorCode: "0"` / `交易成功`,但响应体**完全不含 `schemaValue`**——这是一个容易被误判为成功的静默空响应。只有 `cardId` 可用。
69
+ >
70
+ > 同一页面卡片与其弹窗变体已经拥有不同的 `cardId`(例如 `activityLevel` = `10000840`,`activityLevelDialog` = `10000841`),并返回不同的 schema,因此按 `cardId` 取**不会**造成跨卡污染。之前在 `src/cards` 中发现的重复 schema 来自已废弃的编辑器 / Monaco DOM 抓取路径,而非 `cardId`。
71
+
72
+ 同步脚本通过两种方式防止污染:拒绝回显的 `cardId` 与请求不符的响应,并对每个 schema 做 MD5;两个不同的卡片若解析出完全相同的字节,会在 `duplicates` 中报告并导致本次运行失败。
73
+
74
+ ### 空白卡片(远端无 schemaValue)
75
+
76
+ `IDC10012.do` 返回 `errorCode: "0"` 但**没有 `schemaValue`**,不一定是入参主键错误——卡片在 FinMall 侧新建后从未保存过 schema(空白卡)时就是这个响应。这是**合法状态**,必须允许同步到本地,不能整批失败。
77
+
78
+ 判定与落盘规则(`scripts/api_batch_sync.mjs`):
79
+
80
+ 1. `fetchCardSchema` 遇到无 `schemaValue`(或响应体整体缺失)时返回 `null`,`syncCard` 转交 `syncBlankCard`,不再抛错。
81
+ 2. **本地已有同名卡片**(`schema.json` 可解析)→ 以本地 `schema.json` / `data.json` 为准,远端空白绝不覆盖;只把 `pageId` 对齐远端返回的 `cardId`(保存 IDC10010 / 预览 10015·10020·10021 全链路按这个数字主键定位线上卡片)。
82
+ 3. **本地无实体卡片** → 落一份最小合法空白 schema(`pageId` = 远端 `cardId`,`view.components: []`)+ `data.json = {}`,保证目录可被编辑器/预览加载,且能通过 `validate_schema.py`。
83
+ 4. **预览图**:本地已有同名图(`<cardCode>.<ext>`)则跳过下载,否则照常同步;下载失败只告警,不算同步失败。
84
+ 5. 空白卡同样写 `.import-meta.json` 侧车——`pageId` 已对齐远端,属于合法远端来源卡,允许后续推送。
85
+ 6. 结果里 `synced[]` 带 `blank: true` / `keptLocal` 标记,日志与 CLI 汇总单列「空白卡片 N 张」,不与正常卡混为一谈。
86
+
87
+ > 注意:有 `schemaValue` 的正常卡**不受影响**,仍是远端覆盖本地的老行为。
88
+
89
+ 这些请求用 `page.evaluate(fetch(...))` 在 FinMall 页面内发起,发送上述 `token` 请求头。以 `@filestore/` 开头的封面路径用 `finmallConfig.filestoreUrl()`(基址来自环境配置)拼成完整 URL。
90
+
91
+ ### 网络超时闸门(必须保留)
92
+
93
+ `page.evaluate` **没有默认超时**:页面里一个永不 settle 的 `fetch` 会让整次同步永久挂起,没有任何日志——实测一次全量同步因此卡死 6 分钟以上且零输出。FinMall 后端与 Filestore 对不存在的对象都可能不响应(既不返回也不报错)。
94
+
95
+ 因此 `finmallPost` 与 `saveCover` 都做了**内层 `AbortController` + 外层 `Promise.race`** 双重设防:
96
+
97
+ | 环境变量 | 默认值 | 作用 |
98
+ |---|---|---|
99
+ | `CARDBUDDY_POST_TIMEOUT_MS` | 30000 | `IDC10001.do` / `IDC10012.do` 交易请求 |
100
+ | `CARDBUDDY_COVER_TIMEOUT_MS` | 15000 | 预览图下载 |
101
+
102
+ 新增任何 `page.evaluate` 里的网络请求,都必须套同一个 `withTimeout`;否则就是埋一颗静默挂起的雷。
103
+
104
+ ### 排障:脚本一跑就报 `Cannot access 'X' before initialization`
105
+
106
+ 这是顶层 `await` 造成的 TDZ,不是拼写错误。`api_batch_sync.mjs` 的 CLI 执行块(`if (isMain) { await syncCards(...) }`)**必须留在文件最末尾**:模块顶层执行到那里就真的开始跑同步了,任何定义在它之后的 `const`(如 `IMAGE_EXTS`)此时还在 TDZ 里,一旦被代码路径访问就抛错。
107
+
108
+ 坑在于它**不一定每次都炸**——只有走到相关分支才暴露(例如本地目录非空时 `findExistingCover` 才会读 `IMAGE_EXTS`)。所以单测用桩把模块完整 import 后再调用是测不出来的,必须真跑一次 CLI。
109
+
110
+ ### 跑回归前先看一眼 `src/slices`
111
+
112
+ `npm run regress` 的 L1 保真度回归会调用 `generate_cards.mjs`,其中 `rmSync(src/slices)` 会**清空全局切图目录**(已知坑,非本次改动引入)。跑完若发现文件减少,用 `git checkout -- src/slices/` 还原纳入版本控制的切图;未跟踪的生成物是 draft 产物,重跑 full-run 可重建(先确认无卡片 schema 引用丢失)。
113
+
114
+ ## 切图上传(`/slices/` → `@filestore/` 线上地址)
115
+
116
+ `scripts/slice_upload.mjs` 实现 `slices_convention.md` 的「③ 远程同步」阶段:把卡片引用的
117
+ `src/slices/` 切图上传到 FinMall 图片库,产出「本地文件 ↔ 线上地址」映射,并把卡片里的
118
+ `/slices/<name>` 引用改写为线上地址,使卡片推到远端后取得到图。
119
+
120
+ ### 触发方式(**没有任何自动上传路径**)
121
+
122
+ | 入口 | 范围 | 说明 |
123
+ |---|---|---|
124
+ | 编辑器顶栏「远端 → 切图上传」 | 当前卡片 | 用户点击才执行,先二次确认;`preview/App.vue → uploadCardSlices()` → `POST /__slice-upload` |
125
+ | MCP `card_slice_upload` | 单卡(`cardId` 必填) | 需 dev server + FinMall 登录态,不支持离线降级 |
126
+ | CLI(下方命令) | 默认全部卡片,可 `--cardId` 收窄 | 批量补做 / 排障用 |
127
+
128
+ 保存、版本推送、同步都**不会**顺带上传切图。若卡片仍引用 `/slices/`,推上去线上就是取不到图——
129
+ 推送前先跑一次本工具。
130
+
131
+ ```bash
132
+ # 单卡(等价于顶栏按钮)
133
+ node skills/finmall-card-sync/scripts/slice_upload.mjs --cardId pointsDetail
134
+ # 全部卡片里仍引用 /slices/ 的切图
135
+ node skills/finmall-card-sync/scripts/slice_upload.mjs
136
+ # 只看计划不上传不写盘
137
+ node skills/finmall-card-sync/scripts/slice_upload.mjs --dry-run
138
+ ```
139
+
140
+ 常用选项:`--only=a.png,b.png`(指定文件)、`--all`(连未被引用的切图一起传)、
141
+ `--force`(忽略 sha256 判重强制重传,会得到新地址)、`--no-rewrite`(只上传 + 写映射,不改卡片)、
142
+ `--appId / --workspaceId`(覆盖 `sassAppId` / `sassWorkspaceId`,默认取 `.env.cb`,**不是固定值**)、
143
+ `--slicesRoot / --cardsRoot`(换目录,便于沙箱试跑)。
144
+
145
+ ### 接口契约(`CC0000.do`,已实测)
146
+
147
+ ```
148
+ POST {baseUrl}/ubomp-web/CC0000.do?sassAppId=<FINMALL_APP_ID>&sassWorkspaceId=<FINMALL_WORKSPACE_ID>
149
+ Content-Type: multipart/form-data
150
+ fileName = 客服.png # 纯文本原文件名
151
+ file = <二进制> # 带 filename 与 Content-Type: image/png
152
+ headers: token / iCIFID / eCIFID = localStorage._sessionId(只在页面上下文内读取)
153
+ ```
154
+
155
+ 成功响应(`errorCode:"0"`):
156
+
157
+ ```json
158
+ { "header": { "errorCode": "0" },
159
+ "body": { "errorCode": "0", "uploadFileList": [
160
+ { "fileName": "客服.png",
161
+ "filePath": "@filestore/dzqd-download/20260909144246_客服.png",
162
+ "size": "443", "dimensions": "60x60" } ] } }
163
+ ```
164
+
165
+ - 要取的字段是 **`body.uploadFileList[].filePath`**,它本身就是可直接写进 schema 的 `@filestore/...`;
166
+ 运行时 `adapter.doReplaceUrl` 把它换成 `/minio/...`,本地预览经 assetProxy 回源,**预览链路无需改动**。
167
+ - 服务端会给文件名加时间戳前缀(`<yyyyMMddHHmmss>_`),所以**同一张图重复上传会得到不同地址**——
168
+ 必须靠映射清单判重,不能「每次都传」。
169
+ - 会话失效时 `header/body.errorCode = BLEC0006`,脚本自动清 session 重登并重试一次(与同步一致)。
170
+
171
+ ### 映射清单 `src/slices/manifest.json`
172
+
173
+ ```json
174
+ { "version": 1, "updatedAt": "2026-09-09T07:09:37.587Z",
175
+ "files": { "arrowRightSmall.png": {
176
+ "url": "@filestore/dzqd-download/20260909150937_arrowRightSmall.png",
177
+ "httpUrl": "https://uat-pkg.finmall.com/minio/dzqd-download/20260909150937_arrowRightSmall.png",
178
+ "sha256": "bdc6e0…", "size": 530, "dimensions": "40x40",
179
+ "uploadedAt": "2026-09-09T07:09:37.175Z",
180
+ "cards": ["demoCard", "demoCard2"],
181
+ "superseded": ["@filestore/dzqd-download/20260909144246_arrowRightSmall.png"] } } }
182
+ ```
183
+
184
+ - `url` 是写进 schema 的值,`httpUrl` 是给人核对用的完整地址,`cards` 回答「这张图被哪些卡用」。
185
+ - `reusedFrom` 表示**本文件与另一份切图内容完全相同(sha256 一致),直接复用了它的线上地址**(未单独上传);
186
+ 看到它说明 `src/slices` 里存在同内容副本,应按 `slices_convention.md §3.1` 合并成一份语义名文件。
187
+ - `superseded` 是**被替换掉的旧线上地址**(最多留 5 个):切图内容变了会重传得到新地址,改写阶段
188
+ 连旧地址一起替换,避免卡片继续指向过期图。
189
+ - 清单随 `src/` 入库;本地切图 PNG **真源保留不动**(约定见 `slices_convention.md`)。
190
+
191
+ ### 幂等与共享切图
192
+
193
+ - 判重按 **内容 sha256**:内容未变 → 跳过上传、直接复用清单里的地址(多卡共享同一张图只传一次)。
194
+ - **判重不认文件名(共用切图只上传一次)**:`src/slices` 里内容相同但命名不同的副本、以及**同一批次内**
195
+ 的同内容文件,都按 sha256 命中已上传/待上传的那一份并复用其线上地址(清单记 `reusedFrom`,批次内延后写映射),
196
+ **绝不为同一张图产生第二个 `@filestore` 地址**;只有 `--force` 才强制重传。`--dry-run` 会先把复用对报出来
197
+ (形如 `编组 4.png≡assetAllocRadar_arrow_right.png`),`跳过:N 个(内容未变 x;同内容复用已上传地址 y)`。
198
+ - 单卡模式(`--cardId <id>`)同样命中复用:该卡引用的共享切图若已被别的卡上传过,直接改写为既有地址,不重传。
199
+ - 上传阶段的复用是**兜底**,不是许可:切图在落地 `src/slices/` 时就该按内容去重 + 语义化命名
200
+ (`dsl-card-generator/references/slices_convention.md §1.1 / §3.1`,lint `r59-slice-semantic-name` / `r60-slice-duplicate-content` 会告警)。
201
+ - 已改写过的卡片引用的是线上地址而非 `/slices/`,扫描时会用清单**反查**回本地文件名,
202
+ 所以二次点击不会误报「该卡没引用切图」,也不会把 `cards` 关联抹掉。
203
+ - 引用改写是「JSON 解析定位 + 原文精确替换」:只替换 `"/slices/<name>"` 这个字面量,
204
+ **不重新序列化文件**,缩进 / 键序 / 末尾换行(仓库约定 schema.json 无末尾换行)全部原样保留。
205
+
206
+ ### 排障
207
+
208
+ | 现象 | 原因 / 处理 |
209
+ |---|---|
210
+ | `FinMall 上传失败 [errorCode=BLEC0006]` | 会话超时;脚本已自动重登重试,仍失败就重跑 `finmall-session-navigator` |
211
+ | 汇总里出现「悬空引用」 | schema 引用了 `src/slices` 下不存在的文件(常见于 `generate_cards.mjs` 全量运行清空过切图),先 `git checkout -- src/slices/` 或重跑生成 |
212
+ | CLI 跑完进程不退出 | 已修:CLI 末尾显式 `process.exit`(后台 Chrome 的 CDP 连接会挂住事件循环);Chrome 进程本身按约定常驻不关 |
213
+ | 想撤销改写 | `git checkout -- src/cards/<id>/`;清单里的地址仍有效,重跑一次即可再改写回来 |
214
+
215
+ ## 变量与数据规则
216
+
217
+ 编辑器变量面板是 `schema.dictionary.inputParams[]` 的 UI 呈现:
218
+
219
+ - `key` 是运行时数据键。
220
+ - `type` 是展示的变量类型。
221
+ - `defaultValue` 是 `data.json` 的运行时值。
222
+ - `children` 描述在作用域插槽内展示或被引用的嵌套对象 / 数组字段。
223
+ - 若 `defaultValue` 为空且 `desc` 是包含相同 key 的 JSON 对象,则用 `desc[key]` 作兜底。这用于处理把 i18n 标签存在 `desc` 中的情况。
224
+
225
+ 组件绑定使用 `$key` 表达式。在列表插槽中,子字段如 `$account_type_cn`、`$balanceList` 从 `ListLayout` 绑定的列表变量的当前项解析(例如 `$account_details`)。顶层变量绑定路径可通过扫描 `schema.view` 中的 `$key` 表达式来审计。
226
+
227
+ ## 校验
228
+
229
+ 同步后,验证:
230
+
231
+ ```bash
232
+ # 1. 文件就位
233
+ ls src/cards/<cardCode>
234
+
235
+ # 2. 硬契约校验(结构合法、组件嵌套、属性/事件键、itemValueFrom、data.json 一致性、componentId 唯一)
236
+ python3 skills/dsl-card-generator/scripts/validate_schema.py src/cards/<cardCode>/schema.json
237
+ # 或全量校验:
238
+ python3 skills/dsl-card-generator/scripts/validate_all_schemas.py src/cards
239
+ ```
240
+
241
+ **校验通过标准**:`All schemas passed`(0 ERROR;WARNING 可接受,但需人工确认非新组件缺 slots 这类真问题)。
242
+
243
+ 同时确认本次运行的 JSON 摘要中 `duplicates` 数组为空。非空的 `duplicates` 意味着两个卡片 code 解析出了字节完全相同的 schema,其数据不可信。
244
+
245
+ > 早期版本用 `node -e "JSON.parse(...)"` 兜底校验——只能确认"JSON 语法合法",无法发现组件嵌套错误、属性键缺失、data.json 漂移等真问题。**已弃用**,统一走 `validate_schema.py`。校验器白名单从 `preview/meta/component-meta.json` 动态加载(P0 修复),新组件不会误报。
246
+
247
+ 把无法解析 `schema.json` 或 `data.json`、或 `validate_schema.py` 报 ERROR 视为硬性失败;不要仅凭可见的页面文本就报告成功。
248
+
249
+ ## 产物健康度清单
250
+
251
+ 每张卡同步完成后,按下表逐项核对。任一项不过都意味着产物有问题,不应入库。
252
+
253
+ | # | 检查项 | 命令 / 判定 | 失败原因 |
254
+ |---|---|---|---|
255
+ | 1 | **schema.json 结构合法** | `python3 skills/dsl-card-generator/scripts/validate_schema.py src/cards/<id>/schema.json` → `All schemas passed` | 远端 schema 字段缺失、组件嵌套错误 |
256
+ | 2 | **data.json 字段集 = inputParams key 集** | `python3 skills/dsl-card-generator/scripts/derive_data_json.py src/cards/<id>/schema.json --check` → 0 diff | 同步时 inputParams 改了但 data.json 没派生 |
257
+ | 3 | **封面 PNG 非空** | `ls -la src/cards/<id>/<id>.png` → 字节数 > 0 | picUrl 失效、@filestore 拼接错、下载超时 |
258
+ | 4 | **文件名 = 英文 ID** | 文件夹名 = 列表响应的 `code` 字段(不是中文 `cardName`) | 早期 Monaco DOM 抓取路径遗留 |
259
+ | 5 | **duplicates 数组为空** | 同步 JSON 摘要 `duplicates` 字段 = `[]` | 两张卡解析出字节相同的 schema(数据不可信) |
260
+ | 6 | **三件套齐全** | `ls src/cards/<id>/` 含 `<id>.png` / `schema.json` / `data.json` | 同步中断、IO 错误 |
261
+
262
+ > 可选:跑 `node skills/dsl-card-generator/scripts/lint_card.mjs --id <id>` 做体验级体检——能发现"脚手架占位文本残留"、"Button 缺 click"、"Text 缺 font.color"等同步进来的卡可能带的体验问题(导出卡通常 0 error,但偶尔有 info 提醒)。
@@ -0,0 +1,169 @@
1
+ ---
2
+ name: finmall-session-navigator
3
+ description: 使用 Playwright 独立启动 Chrome,自动登录 FinMall UAT 并打开卡片列表页,恢复超时会话并验证数据列表。不依赖 Codex 或任何浏览器插件,用户无需附加 @Chrome chip。
4
+ ---
5
+
6
+ # FinMall 会话导航
7
+
8
+ 通过 Playwright 独立启动 Chrome 浏览器,自动登录 FinMall 并打开卡片列表页。
9
+
10
+ ## 环境配置
11
+
12
+ 域名、appId、workspaceId 等参数从工程环境配置读取,优先级:环境变量 > `.env.cb.local` > `.env.cb` > 内置默认值。
13
+
14
+ 配置文件位于项目根目录:
15
+
16
+ - `.env.cb`:默认配置(已提交,UAT 环境)
17
+ - `.env.cb.local`:本地覆盖(已 gitignore,不入库)
18
+
19
+ 配置项:
20
+
21
+ | 变量名 | 说明 | 默认值 |
22
+ |---------|------|--------|
23
+ | `FINMALL_BASE_URL` | 服务域名 | `https://uat-pkg.finmall.com` |
24
+ | `FINMALL_APP_ID` | 应用 ID | `100042` |
25
+ | `FINMALL_WORKSPACE_ID` | 工作空间 ID | `dev` |
26
+ | `FINMALL_CDP_PORT` | Chrome 调试端口 | `9222` |
27
+
28
+ 切换环境(如生产/测试)只需修改 `.env.cb.local`,无需改动代码。
29
+
30
+ ## 架构概要
31
+
32
+ 本 skill 自带 Playwright 依赖(`scripts/node_modules/playwright`),通过以下方式实现无插件自动登录:
33
+
34
+ 1. 以独立进程启动系统 Chrome(或 Playwright 内置 Chromium),开启 `--remote-debugging-port=9222`。
35
+ 2. 使用 Playwright `connectOverCDP` 连接到该 Chrome 实例。
36
+ 3. 在 FinMall 同源页面上下文中通过 `page.evaluate()` 注入登录请求。
37
+ 4. 登录后刷新页面、验证列表渲染完成。
38
+ 5. 脚本退出后 Chrome 进程继续运行,用户可直接操作页面。
39
+
40
+ Chrome 使用独立持久化用户数据目录(`.local/browser-data/`),localStorage 跨会话保留,后续调用若会话仍有效则秒开。
41
+
42
+ ## 鉴权模型(关键)
43
+
44
+ **完整鉴权模型(不用 Cookie / `_sessionId` 双层编码 / 列表接口不鉴权的坑 / `_sessionId` 存在 ≠ 服务端有效 / token 头使用纪律)见 `shared/auth-model.md` §一**——跨 skill 集中陈述,本节只强调与本 skill 执行直接相关的:
45
+
46
+ - **成功判定必须同时满足**:URL 是卡片列表路由 + 页面无可见密码框 + localStorage 有非空 `_sessionId` + 页面可见文本含 `新建卡片` / `持有理财产品` / `卡片编辑器` / `共 N 条` 或存在非空数据表格 + 登录后必须重新加载并等列表渲染完成。
47
+ - **`_sessionId` 缺失必须重新登录**,即使卡片列表已渲染(列表接口不鉴权,列表看得见 ≠ 会话有效)。
48
+ - **`_sessionId` 存在但鉴权接口报 `BLEC0006`**:本地 token 在服务端已过期。修复方法按 `auth-model.md` §1.4——`localStorage.clear()` 后重登。
49
+
50
+ ## 硬性约束
51
+
52
+ - 不依赖 Codex、Chrome 插件、`@Chrome` chip、`mcp__node_repl__js` 或任何外部浏览器控制工具。
53
+ - 不使用终端 curl 代替浏览器内请求——curl 的 Cookie 会话不会同步回 Chrome。
54
+ - 登录请求必须在当前 FinMall Chrome 页面的同源上下文中执行,确保浏览器 Cookie 和会话状态被更新。
55
+ - 不读取 Chrome Cookie、密码库或用户配置文件。
56
+ - localStorage 中的 `_sessionId` 只允许在页面上下文内读取,用途仅限两项:判断会话是否存在、作为 `token` 请求头发出。**禁止**把它回传到 Node 侧、打印到日志、写入文件或硬编码。
57
+ - 不输出账号、密码哈希、会话 token 或登录接口完整响应。
58
+ - 若系统未安装 Chrome 且 Playwright 内置 Chromium 不可用,立即停止并提示用户安装 Chrome 或运行 `npx playwright install chromium`。
59
+
60
+ ## 前置检查
61
+
62
+ 运行脚本前需确认依赖就绪:
63
+
64
+ 1. 检查 `scripts/node_modules/playwright` 是否存在。
65
+ 2. 若不存在,在 `scripts/` 目录下执行安装:
66
+ ```bash
67
+ cd skills/finmall-session-navigator/scripts
68
+ npm install
69
+ ```
70
+ 3. 若系统无 Chrome 且需要内置 Chromium,执行:
71
+ ```bash
72
+ npx playwright install chromium
73
+ ```
74
+
75
+ 使用 Node 22+;托管 Node 位于 `~/.workbuddy/binaries/node/versions/22.22.2/bin/node`。
76
+
77
+ ## 执行流程
78
+
79
+ 一条命令完成全部操作:
80
+
81
+ ```bash
82
+ node skills/finmall-session-navigator/scripts/finmall_login.mjs
83
+ ```
84
+
85
+ 脚本内部执行:
86
+
87
+ 1. 读取 `.local/credentials.json` 中的登录凭据(`loginName` + `loginPassword`,后者为 MD5 小写哈希)。
88
+ 2. 尝试连接 `http://127.0.0.1:9222`(用 IP 而非 `localhost`,避免 Node 解析到 IPv6 `::1` 连不上)。若已有 Chrome 实例运行则复用,否则启动新的 Chrome 进程(detached,持久化用户数据目录)。
89
+ 3. 导航到目标卡片列表页。
90
+ 4. 检查页面状态——列表可见**且** `_sessionId` 存在时,直接返回成功。
91
+ 5. 若页面显示登录表单,或 `_sessionId` 缺失:
92
+ - 关闭超时弹框(原生 JS 对话框通过 `page.on("dialog")` 自动 accept + 页面内含「会话超时」「登录超时」「登录已过期」的可见模态框)。
93
+ - 在页面同源上下文中通过 `page.evaluate(fetch(...))` 发起 `IM01001.do` 登录请求;请求体含 `loginName`、`loginPassword`(MD5 小写)、`requestTime`(当前毫秒时间戳,每次生成);**登录请求不需要 `token` 请求头**。
94
+ - 注入脚本只显式设置 `Accept: application/json, text/plain, */*` 和 `Content-Type: application/json;charset=UTF-8`;`Origin` / `Referer` / `User-Agent` / `Sec-Fetch-*` / `sec-ch-ua*` / `Connection` 属于浏览器管理或受限请求头,由 Chrome 在同源上下文自动生成,不要在 page.evaluate 里手设。
95
+ - 读取响应头中的新会话 token,按 FinMall 前端格式保存为 `_sessionId`(双层编码 `{"value":"\"<uuid>\""}`),同时保存 `_userInfo`。
96
+ - 调用 `IM01002.do` 获取权限菜单,写入 `__menuList`、`__menuItemList`。
97
+ - 刷新页面,等待应用重新初始化并验证列表渲染完成。
98
+ 6. 失败后间隔 1 秒重试,最多执行 3 次。
99
+ 7. 脚本退出后 Chrome 继续运行,用户可直接操作页面。
100
+
101
+ ### 可选参数
102
+
103
+ - `--close-browser`:完成后关闭浏览器(默认不关闭,保留页面供用户操作)。
104
+ - `--self-test`:仅运行自检,不执行登录。
105
+
106
+ ## 输出格式
107
+
108
+ 脚本退出时输出 JSON 到 stdout,退出码 0 表示成功、1 表示失败:
109
+
110
+ ```json
111
+ {
112
+ "success": true,
113
+ "attempts": 1,
114
+ "dismissed": 0,
115
+ "state": {
116
+ "href": "https://uat-pkg.finmall.com/...",
117
+ "routeMatches": true,
118
+ "rowCount": 5,
119
+ "listSignal": true,
120
+ "loginSignal": false,
121
+ "captchaSignal": false,
122
+ "hasSession": true,
123
+ "success": true
124
+ },
125
+ "reason": "已是登录状态,卡片列表可见"
126
+ }
127
+ ```
128
+
129
+ 失败时:
130
+
131
+ ```json
132
+ {
133
+ "success": false,
134
+ "attempts": 3,
135
+ "terminal": true,
136
+ "reason": "登录重试 3 次仍失败,服务端可能异常",
137
+ "failures": [...]
138
+ }
139
+ ```
140
+
141
+ ## 成功判定
142
+
143
+ 不能仅依赖 HTTP 200、页面标题、Chrome 进程存在**或页面上能看到卡片列表**。必须同时满足:
144
+
145
+ - 当前 URL 是卡片列表路由(`#/inner_flamePublish/card/list`);
146
+ - 页面不包含可见密码输入框;
147
+ - **localStorage 中存在非空的 `_sessionId`**(`state.hasSession`)——列表接口不鉴权,缺了这一条就会把失效会话判成已登录;
148
+ - 页面可见文本包含 `新建卡片`、`持有理财产品`、`卡片编辑器` 或 `共 N 条`,或者存在明确的数据表格行;
149
+ - 登录成功后必须重新加载页面并等待列表渲染完成;只看到已写入本地状态不算成功。
150
+
151
+ 反之,只要 `_sessionId` 缺失就必须重新登录,**即使卡片列表已经渲染出来**。此时页面通常不是登录页,`performLogin` 走同源 fetch、不依赖登录表单 DOM,可以直接调用。
152
+
153
+ ## 故障处理
154
+
155
+ **鉴权与 Playwright 工程类故障(`_sessionId` 存在但 `BLEC0006` / `setDownloadBehavior` 报错 / 本地 CDP 502 / Chrome 启动崩溃)见 `shared/auth-model.md` §一、§二**——跨 skill 集中陈述,本节只列本 skill 执行级独有的问题:
156
+
157
+ - **端口 9222 未就绪**:可能已有 Chrome 进程使用相同的用户数据目录(`.local/browser-data/`)。提示用户关闭该 Chrome 窗口后重试。
158
+ - **Chrome 未找到**:提示用户安装 Google Chrome,或在 `scripts/` 目录运行 `npx playwright install chromium`。
159
+ - **页面出现验证码**:停止自动登录,保留页面并通知用户手动处理验证码。
160
+ - **三次请求或列表验证均失败**:停止重试,提示服务端可能异常。
161
+ - **`_sessionId` 已写入但页面仍显示登录**:不能立即报告失败——先刷新页面并等待前端初始化菜单和列表。
162
+
163
+ ## 资源
164
+
165
+ - `scripts/finmall_login.mjs`:主脚本——读取凭据、启动/连接 Chrome、注入登录请求、处理弹框、重试并验证列表。
166
+ - `scripts/session-manager.mjs`:会话管理辅助脚本(如需要复用同一 Chrome 实例多次评估页面状态可用)。
167
+ - `scripts/package.json`:Playwright 依赖声明。
168
+ - `.local/credentials.json`:登录凭据(被 Git 忽略)。
169
+ - `.local/browser-data/`:Chrome 持久化用户数据目录(被 Git 忽略)。