cardbuddy 0.9.1 → 0.11.0

package/dist/vendored/skills/dsl-card-generator/scripts/autofix_schema.py

@@ -0,0 +1,249 @@
+#!/usr/bin/env python3
+"""
+autofix_schema.py — 机械修复「契约级」高频错误，把「校验-修复」多轮压成 1 轮。
+
+只修可由代码确定性决策的 ERROR 类问题（不臆造语义）：
+  1. itemValueFrom == "1" 但缺 itemDefaultValue  → 按值类型补兜底（字符串 '' / 数字 0 / 布尔 False / 数组 [] / 对象 {}）。
+  2. 重复 componentId                                  → 重编号为全局连续唯一 comp_N。
+  3. 缺失 data.json 或 key 与 inputParams 漂移        → 由 inputParams.defaultValue 重新派生并写回。
+
+不处理需要语义判断的 WARNING（未知样式子键、flex 枚举等）——那些留给人工/卡片作者。
+
+用法：
+  python3 autofix_schema.py <schema.json>            # 修复并写回
+  python3 autofix_schema.py <schema.json> --check    # 只报告，不写回
+  python3 autofix_schema.py <schema.json> --no-data  # 跳过 data.json 派生
+"""
+import json
+import os
+import re
+import sys
+import tempfile
+import time
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import validate_schema as V  # 复用硬契约校验
+
+
+def _fallback_for(value):
+    if isinstance(value, bool):
+        return False
+    if isinstance(value, (int, float)):
+        return 0
+    if isinstance(value, str):
+        return ''
+    if isinstance(value, list):
+        return []
+    if isinstance(value, dict):
+        return {}
+    return ''
+
+
+def _children(node):
+    kids = []
+    if isinstance(node.get('components'), list):
+        kids.extend(node['components'])
+    for s in node.get('slots', []) or []:
+        if isinstance(s, dict):
+            kids.extend(s.get('components', []) or [])
+    return kids
+
+
+def walk_fix_value_from(node, fixed):
+    """机械补 itemValueFrom：缺失/空串 → '0'（常量，最安全默认）。
+
+    运行时 property.js onPreview 只在 itemValueFrom 为 '0'/'1'/'2' 时才把属性写进预览
+    产物；缺失则整条属性被静默丢弃（背景/内边距/gap/对齐失效）。手写样式极易漏写，
+    故在此统一兜底为 '0'（按 itemValue 原值当常量用）。变量绑定('1')本就必带，不会走到这里。
+    """
+    changed = False
+    for grp in node.get('style', {}).get('properties', []) or []:
+        # 顶层样式分组对象本身也必须带 itemValueFrom（如 font/background 分组），
+        # 否则 validate 仍报 ERROR（之前 autofix 只补子项、漏补分组本体，font 分组
+        # 缺失时卡片字体/背景整组被运行时静默丢弃）。
+        if not grp.get('itemValueFrom'):
+            grp['itemValueFrom'] = '0'
+            fixed.append(f"补 itemValueFrom='0': style.{grp.get('itemKey')}(分组)")
+            changed = True
+        for ch in grp.get('itemChildren', {}).get('properties', []) or []:
+            if not ch.get('itemValueFrom'):
+                ch['itemValueFrom'] = '0'
+                fixed.append(f"补 itemValueFrom='0': style.{grp.get('itemKey')}.{ch.get('itemKey')}")
+                changed = True
+    for pr in node.get('properties', []) or []:
+        if not pr.get('itemValueFrom'):
+            pr['itemValueFrom'] = '0'
+            fixed.append(f"补 itemValueFrom='0': {node.get('className')}/{pr.get('itemKey')}")
+            changed = True
+    for d in node.get('directives', []) or []:
+        if not d.get('itemValueFrom'):
+            d['itemValueFrom'] = '0'
+            fixed.append(f"补 itemValueFrom='0': directive.{d.get('itemKey')}")
+            changed = True
+    for child in _children(node):
+        if walk_fix_value_from(child, fixed):
+            changed = True
+    return changed
+
+
+def walk_fix_defaults(node, fixed):
+    changed = False
+    for prop in node.get('properties', []) or []:
+        if prop.get('itemValueFrom') in ('1', 1) and 'itemDefaultValue' not in prop:
+            prop['itemDefaultValue'] = _fallback_for(prop.get('itemValue'))
+            fixed.append(f"补 itemDefaultValue: {node.get('className')}/{prop.get('itemKey')}")
+            changed = True
+    for grp in node.get('style', {}).get('properties', []) or []:
+        if grp.get('itemValueFrom') in ('1', 1) and 'itemDefaultValue' not in grp:
+            grp['itemDefaultValue'] = _fallback_for(grp.get('itemValue'))
+            fixed.append(f"补 style itemDefaultValue: {grp.get('itemKey')}(分组)")
+            changed = True
+        for child in grp.get('itemChildren', {}).get('properties', []) or []:
+            if child.get('itemValueFrom') in ('1', 1) and 'itemDefaultValue' not in child:
+                child['itemDefaultValue'] = _fallback_for(child.get('itemValue'))
+                fixed.append(f"补 style itemDefaultValue: {node.get('className')}/{grp.get('itemKey')}/{child.get('itemKey')}")
+                changed = True
+    for d in node.get('directives', []) or []:
+        if d.get('itemValueFrom') in ('1', 1) and 'itemDefaultValue' not in d:
+            d['itemDefaultValue'] = _fallback_for(d.get('itemValue'))
+            fixed.append(f"补 directive itemDefaultValue: {node.get('className')}/{d.get('itemKey')}")
+            changed = True
+    for child in _children(node):
+        if walk_fix_defaults(child, fixed):
+            changed = True
+    return changed
+
+
+def fix_duplicate_ids(node, fixed):
+    seen = set()
+    duplicated = False
+
+    def count(n):
+        nonlocal duplicated
+        if not isinstance(n, dict):
+            return
+        cid = n.get('componentId')
+        if cid and cid in seen:
+            duplicated = True
+        seen.add(cid)
+        for c in _children(n):
+            count(c)
+    count(node)
+    if not duplicated:
+        return False
+
+    seq = {'n': 0}
+
+    def renumber(n):
+        if not isinstance(n, dict):
+            return
+        seq['n'] += 1
+        n['componentId'] = f"comp_{seq['n']}"
+        for c in _children(n):
+            renumber(c)
+    renumber(node)
+    fixed.append("重编号全部 componentId 为连续唯一序列（修复重复）")
+    return True
+
+
+def fix_data_json(schema, schema_dir, fixed, skip=False):
+    if skip:
+        return False
+    data_path = os.path.join(schema_dir, 'data.json')
+    params = schema.get('dictionary', {}).get('inputParams', [])
+    expected = {p['key']: p.get('defaultValue') for p in params if 'key' in p}
+    if not os.path.isfile(data_path):
+        with open(data_path, 'w', encoding='utf-8') as f:
+            json.dump(expected, f, ensure_ascii=False, indent=2)
+            f.write('\n')
+        fixed.append(f"生成缺失的 data.json（{len(expected)} 个 key）")
+        return True
+    try:
+        data = json.load(open(data_path, encoding='utf-8'))
+    except Exception:
+        data = {}
+    drift = (set(expected) - set(data)) | (set(data) - set(expected))
+    if drift:
+        merged = dict(data)
+        for k, v in expected.items():
+            if k not in merged:
+                merged[k] = v
+        with open(data_path, 'w', encoding='utf-8') as f:
+            json.dump(merged, f, ensure_ascii=False, indent=2)
+            f.write('\n')
+        fixed.append(f"修正 data.json key 漂移（{len(drift)} 个 key）")
+        return True
+    return False
+
+
+def _validate_obj(schema, check_data=True):
+    fd, tmp = tempfile.mkstemp(suffix='.json')
+    try:
+        with os.fdopen(fd, 'w', encoding='utf-8') as f:
+            json.dump(schema, f, ensure_ascii=False)
+        return V.validate_schema(tmp, check_data=check_data)
+    finally:
+        try:
+            os.remove(tmp)
+        except Exception:
+            pass
+
+
+def autofix(path, check=False, no_data=False):
+    schema_dir = os.path.dirname(path)
+    with open(path, 'r', encoding='utf-8') as f:
+        schema = json.load(f)
+    fixed = []
+    walk_fix_value_from(schema.get('view', {}), fixed)
+    walk_fix_defaults(schema.get('view', {}), fixed)
+    fix_duplicate_ids(schema.get('view', {}), fixed)
+    fix_data_json(schema, schema_dir, fixed, skip=no_data)
+
+    if not check and fixed:
+        with open(path, 'w', encoding='utf-8') as f:
+            json.dump(schema, f, ensure_ascii=False, indent=2)
+            f.write('\n')
+
+    t0 = time.time()
+    ok, errors, warnings = _validate_obj(schema, check_data=not no_data)
+    duration = int((time.time() - t0) * 1000)
+    return {
+        'fixed': fixed,
+        'ok': ok,
+        'errors': errors,
+        'warnings': warnings,
+        'durationMs': duration,
+        'written': (not check and bool(fixed)),
+    }
+
+
+def main():
+    args = sys.argv[1:]
+    positional = [a for a in args if not a.startswith('--')]
+    flags = set(a for a in args if a.startswith('--'))
+    if not positional:
+        print("Usage: python3 autofix_schema.py <schema.json> [--check] [--no-data]")
+        sys.exit(1)
+    path = positional[0]
+    check = '--check' in flags
+    no_data = '--no-data' in flags
+    if not os.path.isfile(path):
+        print(f"[error] File not found: {path}")
+        sys.exit(1)
+
+    res = autofix(path, check=check, no_data=no_data)
+    print(f"\n[autofix] {'--check 模式（未写回）' if check else '已尝试修复'}")
+    if res['fixed']:
+        for fx in res['fixed']:
+            print(f"  [FIX] {fx}")
+    else:
+        print("  [FIX] 无机械错误可修复")
+    print(f"\n[result] ok={res['ok']} errors={len(res['errors'])} warnings={len(res['warnings'])} ({res['durationMs']}ms)")
+    for e in res['errors'][:20]:
+        print(f"  [ERROR] {e}")
+    sys.exit(0 if res['ok'] else 1)
+
+
+if __name__ == '__main__':
+    main()