cardbuddy 0.11.0 → 0.12.1

package/dist/vendored/skills/sketch-spec-to-card/scripts/card_refs.py

@@ -0,0 +1,94 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""card_refs.py — alertCard / alertDialog 参考存量卡配置（单一可编辑源）。
+
+默认参考卡来自 references/card_refs.json（金融稿已验证）。可被覆盖，实现跨业务域通用：
+  --card-refs <path.json> : 直接指定参考卡 JSON，结构 {alertDialog:[...], alertCard:[...]}
+  --auto-refs             : 从 src/cards 动态探测存量卡中的 alertCard/alertDialog 用法，
+                            自动生成参考卡（不再写死金融稿）
+  --src-cards <dir>       : --auto-refs 扫描目录（缺省自动定位仓库根/src/cards）
+"""
+import glob
+import json
+import os
+import re
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+SKILL_DIR = os.path.dirname(HERE)
+DEFAULT_CARD_REFS_JSON = os.path.join(SKILL_DIR, "references", "card_refs.json")
+
+# 内置兜底（与默认 JSON 一致；JSON 缺失时回退，保证脚本永不因缺文件报错）
+BUILTIN_CARD_REFS = {
+    "alertDialog": [
+        "budgetAnalysis（alertDialog）",
+        "creditCardPayment（alertDialog）",
+    ],
+    "alertCard": [
+        "monthlyBill→monthlyBillDialog",
+        "creditCardBill→billListDialog",
+        "activityLevel→activityLevelDialog",
+        "accountDialog",
+    ],
+}
+
+
+def load_default():
+    """加载 references/card_refs.json；缺失或损坏时回退内置兜底。"""
+    try:
+        with open(DEFAULT_CARD_REFS_JSON, encoding="utf-8") as f:
+            data = json.load(f)
+        return {
+            "alertDialog": data.get("alertDialog", BUILTIN_CARD_REFS["alertDialog"]),
+            "alertCard": data.get("alertCard", BUILTIN_CARD_REFS["alertCard"]),
+        }
+    except Exception:
+        return {k: list(v) for k, v in BUILTIN_CARD_REFS.items()}
+
+
+def detect_from_src(src_cards_dir):
+    """扫描 src/cards 下 schema.json，发现 alertCard/alertDialog 用法，生成参考卡。
+
+    返回 {alertDialog:[...], alertCard:[...]}；未发现任何用法时返回 None。
+    """
+    if not src_cards_dir or not os.path.isdir(src_cards_dir):
+        return None
+    alertcard_map = {}   # dialog cardCode -> [parent keys]
+    alertdialog_parents = set()
+    for sp in sorted(glob.glob(os.path.join(src_cards_dir, "*", "schema.json"))):
+        key = os.path.basename(os.path.dirname(sp))
+        txt = open(sp, encoding="utf-8").read()
+        if "alertDialog" in txt:
+            alertdialog_parents.add(key)
+        if "alertCard" in txt:
+            for m in re.finditer(
+                r"alertCard\s*\(?\s*\{?[^}]*?cardCode\s*[:=]\s*['\"]([^'\"]+)", txt
+            ):
+                code = m.group(1)
+                if code and code != key:   # 跳过 dialog 卡自身的 pageId（噪声）
+                    alertcard_map.setdefault(code, []).append(key)
+    if not alertcard_map and not alertdialog_parents:
+        return None
+
+    def rep_parent(ps):
+        return sorted(set(ps))[0]
+
+    alert_card_refs = [f"{rep_parent(ps)}→{code}" for code, ps in sorted(alertcard_map.items())]
+    alert_dialog_refs = [f"{k}（alertDialog）" for k in sorted(alertdialog_parents)]
+    return {"alertDialog": alert_dialog_refs, "alertCard": alert_card_refs}
+
+
+def load_card_refs(card_refs_path=None, auto_refs=False, src_cards=None):
+    """解析参考卡配置，优先级：card_refs_path > auto_refs > 默认 JSON。"""
+    if card_refs_path:
+        with open(card_refs_path, encoding="utf-8") as f:
+            data = json.load(f)
+        return {
+            "alertDialog": data.get("alertDialog", []),
+            "alertCard": data.get("alertCard", []),
+        }
+    if auto_refs:
+        detected = detect_from_src(src_cards)
+        if detected:
+            return detected
+        # 探测失败（目录不存在/无用法）回退默认
+    return load_default()