cardbuddy 0.14.2 → 0.15.0

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

@@ -6,17 +6,68 @@
 （preview/*.png，8-bit RGB、无交织）裁切聚焦卡片区域。
 """
 import math
+import os
 import struct
 import zlib
 
 _SIG = b"\x89PNG\r\n\x1a\n"
 
+# 解码结果缓存：同一张图在一次运行里会被反复读（取色 / 掩码 / 逐切图裁切都各读一遍全图），
+# 实测单画板构建 52 次 read_png 里 40 次是同一张 preview，占掉 31s / 35s。键带上
+# mtime 与 size，文件被改写即自动失效；行是 bytes、调用方只读，故可直接共享同一份 rows。
+# 上限按「张」计：一张 750×2204 RGB 解出来约 5MB，8 张封顶约 40MB。
+_READ_CACHE = {}
+_READ_CACHE_MAX = 8
+
+
+def read_png_size(path):
+    """只解析 IHDR 拿 (width, height, channels)，不解 IDAT。
+
+    给「只要尺寸」的调用方用（例如按设计宽度推缩放比例）：33 字节 vs 整图重建，
+    大图上差三个数量级。
+    """
+    with open(path, "rb") as fh:
+        head = fh.read(33)
+    if not head.startswith(_SIG):
+        raise ValueError("不是 PNG 文件: " + str(path))
+    (width, height, bit_depth, color_type,
+     _comp, _filt, interlace) = struct.unpack(">IIBBBBB", head[16:29])
+    if bit_depth != 8:
+        raise ValueError(f"仅支持 8-bit PNG（实际 {bit_depth}）")
+    if interlace != 0:
+        raise ValueError("不支持交织 PNG")
+    if color_type == 0:
+        channels = 1
+    elif color_type == 2:
+        channels = 3
+    elif color_type == 6:
+        channels = 4
+    else:
+        raise ValueError(f"不支持的 colorType={color_type}")
+    return width, height, channels
+
 
 def read_png(path):
     """解码 PNG -> (width, height, channels, rows)。
     rows: list[bytes]，每行 width*channels 字节（已去 filter）。
     channels: 1=灰度 3=RGB 4=RGBA
+
+    带进程内缓存：键是 (路径, mtime_ns, 大小)，同一次运行里重复读同一张图只解码一次。
     """
+    st = os.stat(path)
+    key = (str(path), st.st_mtime_ns, st.st_size)
+    hit = _READ_CACHE.get(key)
+    if hit is not None:
+        return hit
+    result = _read_png_uncached(path)
+    if len(_READ_CACHE) >= _READ_CACHE_MAX:
+        _READ_CACHE.clear()
+    _READ_CACHE[key] = result
+    return result
+
+
+def _read_png_uncached(path):
+    """真正的解码实现；外部一律走 read_png（带缓存）。"""
     data = open(path, "rb").read()
     if not data.startswith(_SIG):
         raise ValueError("不是 PNG 文件: " + str(path))

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

@@ -0,0 +1,157 @@
+#!/usr/bin/env python3
+"""纯文本画板过滤的回归自检（直跑：python skills/sketch-spec-to-card/scripts/test_text_only_artboard.py）
+
+覆盖用户 2026-09-20 规则：整屏纯文本的对话 / 问答 / 提示画板不产卡，且不能误伤
+「对话里嵌着一张真卡」的状态。用例按真实稿（喜豆AI银行 24 稿）的特征构造：
+
+  1. 纯文本对话页（信用卡返现 01/03 型）：气泡里只有文字 → text_only，被过滤；
+  2. 对话 + 内嵌矢量卡（理财 06 型）：卡壳里是 3 宫格选项，检测器会读成「控件条」→ 保留；
+  3. 对话 + 卡片切图（房贷 32 型）：卡片被整体导成一张切图 → 保留；
+  4. 底部抽屉（个人购汇 08 型）：alertCard 子卡形态 → 保留（subcard）；
+  5. 全屏遮罩弹框 → 保留（overlay_dialog）；
+  6. 0 候选的普通文字页：保守保留，交给下游裁决（维持既有行为）。
+"""
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import parse_meaxure as pm  # noqa: E402
+import vision  # noqa: E402
+
+
+def _fill(hexv):
+    return [{"fillType": "Color", "color": {"color-hex": hexv}}]
+
+
+def L(name, type_, x, y, w, h, radius=None, hexv=None, layers=None, opacity=None):
+    d = {"name": name, "type": type_, "rect": {"x": x, "y": y, "width": w, "height": h}}
+    if hexv:
+        d["fills"] = _fill(hexv)
+    if radius:
+        d["radius"] = radius
+    if layers:
+        d["layers"] = layers
+    if opacity is not None:
+        d["opacity"] = opacity
+    return d
+
+
+def ab(name, layers, w=375, h=812):
+    return {"name": name, "width": w, "height": h, "layers": layers}
+
+
+def chrome():
+    """状态栏 / 标题栏 / 弥散装饰 / 输入坞 / 底部导航——四类画板共用的界面壳。"""
+    return [
+        L("98.全局/系统控件/状态栏", "symbol", 0, 0, 375, 44),
+        L("5.导航/标题栏/黑-标题+三icon", "symbol", 0, 0, 375, 88),
+        L("椭圆形", "shape", 0, 0, 229, 260, hexv="#FFF3E0FF"),
+        L("全局_底部导航", "symbol", 0, 733, 375, 91),
+        L("输入框", "shape", 15, 733, 290, 44, radius=[22], hexv="#FFFFFFFF"),
+        L("发送", "slice", 315, 741, 30, 30),
+    ]
+
+
+def bubble(x, y, w, h, text_layer, radius=None):
+    return [L("用户问-单行备份", "group", x, y, w, h, layers=[
+        L("矩形", "shape", x, y, w, h, radius=radius or [21], hexv="#FFD24AFF"),
+        text_layer,
+    ])]
+
+
+def text(name, x, y, w, h):
+    return L(name, "text", x, y, w, h)
+
+
+# ── 1. 纯文本对话页：只有气泡（用户问 + AI 长文应答），板上没有任何卡片结构 ──
+CHAT_TEXT_ONLY = ab("01信用卡返现_登录用户角色类型为D", chrome() + bubble(
+    196, 100, 163, 42, text("查询信用卡返现", 208, 110, 140, 22)) + [
+    L("应答气泡", "shape", 16, 156, 343, 108, radius=[0, 12, 12, 12], hexv="#FFFFFFFF"),
+    text("当前登录账户无权限操作此交易，建议您使用信用卡或证件号码登录。", 30, 166, 315, 88),
+])
+
+# ── 2. 对话 + 内嵌矢量卡：卡壳里 3 个选项块（检测器读成「控件条」，但它就是卡）──
+CARD_TILES = [
+    L("卡壳", "shape", 16, 238, 343, 184, radius=[12], hexv="#FFFFFFFF"),
+    text("您对这笔钱的规划是：", 28, 252, 240, 24),
+    L("选项1", "shape", 28, 288, 99, 118, radius=[8], hexv="#FFF7E6FF"),
+    L("选项2", "shape", 138, 288, 99, 118, radius=[8], hexv="#FFF7E6FF"),
+    L("选项3", "shape", 248, 288, 99, 118, radius=[8], hexv="#FFF7E6FF"),
+    text("随时要用", 36, 300, 80, 20), text("2.23%", 36, 330, 80, 30),
+    text("放1-6个月", 146, 300, 80, 20), text("3.21%", 146, 330, 80, 30),
+    text("放6个月以上", 256, 300, 80, 20), text("3.65%", 256, 330, 80, 30),
+]
+CHAT_WITH_VECTOR_CARD = ab("06理财_理财推荐", chrome() + bubble(
+    196, 100, 163, 42, text("理财产品推荐", 208, 110, 140, 22)) + [
+    L("应答气泡", "shape", 16, 156, 343, 68, radius=[0, 12, 12, 12], hexv="#FFFFFFFF"),
+    text("理财产品这么多，怎么找到适合自己的呢？", 30, 166, 315, 48),
+] + CARD_TILES)
+
+# ── 3. 对话 + 卡片切图：卡片被设计稿整体导成一张 slice（检测器看不到结构）──
+CHAT_WITH_SLICED_CARD = ab("32房贷利率调整_有房贷_可以调整", chrome() + bubble(
+    196, 100, 163, 42, text("调整下我的房贷利率", 208, 110, 140, 22)) + [
+    L("应答气泡", "shape", 16, 156, 343, 108, radius=[0, 12, 12, 12], hexv="#FFFFFFFF"),
+    text("您的贷款为深圳地区二套住房贷款……", 30, 166, 315, 88),
+    L("编组 4", "slice", 16, 276, 343, 280),
+])
+
+# ── 4. 底部抽屉（alertCard 子卡）──
+BOTTOM_SHEET = ab("08个人购汇_有人民币子账户_个人购汇申请书", chrome() + [
+    L("底部面板", "shape", 0, 600, 375, 212, radius=[16, 16, 0, 0], hexv="#FFFFFFFF"),
+    text("个人购汇申请书", 20, 620, 200, 24),
+    text("本人已知晓……", 20, 660, 320, 60),
+])
+
+# ── 5. 全屏遮罩弹框（alertDialog）──
+OVERLAY_DIALOG = ab("05综合推荐_总资产提示", chrome() + [
+    L("遮罩", "shape", 0, 0, 375, 812, hexv="#00000066", opacity=0.4),
+    L("对话框", "shape", 48, 320, 279, 172, radius=[12], hexv="#FFFFFFFF"),
+    text("总资产提示", 72, 344, 200, 24),
+    text("您的总资产已更新", 72, 380, 220, 20),
+])
+
+# ── 6. 0 候选的普通文字页（无气泡、无卡壳）：保守保留 ──
+PLAIN_NO_CANDIDATE = ab("03信用卡返现_有信用卡_无返现记录", chrome() + [
+    text("当前没有可展示的内容", 30, 166, 315, 40),
+])
+
+CASES = [
+    (CHAT_TEXT_ONLY, "text_only", True, "纯文本对话页（只有问答气泡）"),
+    (CHAT_WITH_VECTOR_CARD, "card", False, "对话 + 内嵌矢量卡（3 宫格选项）"),
+    (CHAT_WITH_SLICED_CARD, "card", False, "对话 + 卡片切图"),
+    (BOTTOM_SHEET, "subcard", False, "底部抽屉（alertCard 子卡）"),
+    (OVERLAY_DIALOG, "overlay_dialog", False, "全屏遮罩弹框（alertDialog）"),
+    (PLAIN_NO_CANDIDATE, "card", False, "0 候选的普通文字页（保守保留）"),
+]
+
+
+def main():
+    failed = 0
+    for board, kind, skip, why in CASES:
+        found = pm.detect_artboard_cards(board)
+        verdict = pm.board_verdict(board["name"], board)
+        ok = verdict["kind"] == kind and verdict["skip"] == skip
+        reasons = sorted({r["reason"] for r in found["rejected"]})
+        mark = "PASS" if ok else "FAIL"
+        if not ok:
+            failed += 1
+        print(f"[{mark}] {why}: kind={verdict['kind']}（期望 {kind}） "
+              f"skip={verdict['skip']}（期望 {skip}） cards={len(found['cards'])} "
+              f"conv={bool(found['conversationFlow'])} rejected={reasons}")
+
+    # 卡片级切图判定（房贷 32 型）单测：中段大盘切图算「板上有卡」，图标切图不算
+    flat = vision._flatten_with_tree(CHAT_WITH_SLICED_CARD["layers"])
+    assert vision.has_card_like_visual(flat, 375, 812) is True, "343x280 的中段切图应判为卡片级"
+    flat_text_only = vision._flatten_with_tree(CHAT_TEXT_ONLY["layers"])
+    assert vision.has_card_like_visual(flat_text_only, 375, 812) is False, "30x30 图标切图不该判为卡片"
+    print("[PASS] has_card_like_visual：中段大盘切图算卡，小图标不算")
+
+    if failed:
+        print(f"\n{failed} 个用例失败")
+        return 1
+    print(f"\n全部 {len(CASES)} 个用例通过")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

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

@@ -665,6 +665,30 @@ def detect_conversation_flow(elements, width, height):
     }
 
 
+def has_card_like_visual(elements, width, height):
+    """画板里有没有「卡片级整块视觉」——设计稿把卡片整体导出成一张切图时（如「编组 4」），
+    图层里就只剩这张大图：检测器看不到它的结构（0 卡），但它显然不是纯文本。
+
+    只认贴在中段的大切图，避免把界面 chrome 当卡：
+      · 宽度 ≥ 55% 画板宽、高度 ≥ 12% 画板高；
+      · 纵向落在 10%..95% 之间（标题栏之下、输入坞 / Home Indicator 之上）。
+    20-40px 的图标切图、顶部导航栏、底部输入坞都命中不了。
+    """
+    W, H = float(width), float(height)
+    if W <= 0 or H <= 0:
+        return False
+    for ve in elements:
+        if not ve.is_slice:
+            continue
+        x, y, w, h = ve.rect
+        if w < 0.55 * W or h < 0.12 * H:
+            continue
+        if y < 0.10 * H or (y + h) > 0.95 * H:
+            continue
+        return True
+    return False
+
+
 def _is_repeated_control_bar(elements, rect):
     """识别横向重复图标/选项控件条，例如评分、开关组或快捷操作条。"""
     x, y, w, h = rect

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cardbuddy",
-  "version": "0.14.2",
+  "version": "0.15.0",
   "description": "Local dev service for the CardBuddy card editor — decouples card CRUD (sync/save/validate/render-status/screenshot) from the static public editor, so the editor can be deployed to any static host while each developer runs a local service against their own card source.",
   "type": "module",
   "bin": {