cardbuddy 0.14.3 → 0.16.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))
@@ -251,11 +302,6 @@ def crop_png_masked(path, box, out_path, scale=1.0, shapes=None):
     write_png(out_path, cw, ch, 4, out_rows)
 
 
-def _paeth(a, b, c):
-    pa, pb, pc = abs(b - c), abs(a - c), abs(a + b - 2 * c)
-    return a if (pa <= pb and pa <= pc) else (b if pb <= pc else c)
-
-
 def write_png(path, width, height, channels, rows):
     """写 8-bit 非交织 PNG（filter 全 0，简单可靠）。"""
     stride = width * channels

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

@@ -0,0 +1,217 @@
+#!/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. 底部抽屉（喜豆 04/05/06 型）：alertCard 子卡形态 → 保留（subcard），
+     且**产 1 张卡**（矩形由 `vision._bottom_sheet_rect` 几何直取，非候选检测）；
+  5. 全屏遮罩弹框 → 保留（overlay_dialog）；
+  6. 0 候选的普通文字页：保守保留，交给下游裁决（维持既有行为）。
+
+断言分两层：`kind/skip`（画板类型判定，6 例）+ `cards` 数（产出，注意卡片型用例
+允许 0 —— kind 与 cards 数解耦是上游有意设计）+ 抽屉元素归属（边界气泡不得渗入）。
+"""
+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 子卡）──
+# 形态照真实稿（喜豆 04/05/06 型）：抽屉贴底通栏、顶圆角底直角，覆盖下半屏；
+# 被盖住的区域**不再有**底部导航/输入坞图层（不是 chrome 叠加）。抽屉上沿 500
+# 紧邻上一条气泡（其中心 503 恰好越过上沿）—— 用来验证元素归属的覆盖率门槛。
+BOTTOM_SHEET = ab("08个人购汇_有人民币子账户_个人购汇申请书", [
+    L("98.全局/系统控件/状态栏", "symbol", 0, 0, 375, 44),
+    L("5.导航/标题栏/黑-标题+三icon", "symbol", 0, 0, 375, 88),
+] + bubble(238, 482, 118, 42, text("修改家庭地址", 252, 492, 90, 22)) + [
+    L("5.反馈/弹窗/底部弹窗/选择付款卡", "group", 0, 499, 375, 313, layers=[
+        L("矩形", "shape", 0, 500, 375, 312, radius=[20, 20, 0, 0], hexv="#FFFFFFFF"),
+        text("请选择所在地区", 128, 517, 119, 24),
+        text("确定", 325, 517, 30, 24),
+        text("取消", 20, 517, 30, 24),
+    ]),
+])
+
+# ── 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, 0, "纯文本对话页（只有问答气泡）"),
+    (CHAT_WITH_VECTOR_CARD, "card", False, 0, "对话 + 内嵌矢量卡（3 宫格选项）"),
+    (CHAT_WITH_SLICED_CARD, "card", False, 0, "对话 + 卡片切图"),
+    (BOTTOM_SHEET, "subcard", False, 1, "底部抽屉（alertCard 子卡）→ 几何直取 1 张卡"),
+    (OVERLAY_DIALOG, "overlay_dialog", False, 0, "全屏遮罩弹框（alertDialog）"),
+    (PLAIN_NO_CANDIDATE, "card", False, 0, "0 候选的普通文字页（保守保留）"),
+]
+
+
+def main():
+    failed = 0
+    for board, kind, skip, exp_cards, why in CASES:
+        found = pm.detect_artboard_cards(board)
+        verdict = pm.board_verdict(board["name"], board)
+        got_cards = len(found["cards"])
+        ok = (verdict["kind"] == kind and verdict["skip"] == skip
+              and got_cards == exp_cards)
+        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}） "
+              f"cards={got_cards}（期望 {exp_cards}） "
+              f"conv={bool(found['conversationFlow'])} rejected={reasons}")
+
+    # 抽屉卡的元素归属（真实稿 04/05/06 形态）：上沿外的气泡不得渗入，跨沿标题必须保留
+    found = pm.detect_artboard_cards(BOTTOM_SHEET)
+    assert found["cards"], "底部抽屉应产 1 张卡"
+    sx, sy, sw, sh, dock_els, dock_shapes, _m = found["cards"][0]
+    assert (sx, sy, sw, sh) == (0, 500, 375, 312), f"抽屉卡矩形应取面板几何，实际 {(sx, sy, sw, sh)}"
+    assert dock_shapes == [((0, 500, 375, 312), [20, 20, 0, 0])], f"外壳几何（含顶圆角）应原样带入，实际 {dock_shapes}"
+    dock_names = {e.name for e in dock_els}
+    assert "修改家庭地址" not in dock_names, "抽屉上沿外的气泡渗入了（覆盖率门槛 0.6 失效）"
+    assert {"请选择所在地区", "确定", "取消"} <= dock_names, f"跨沿的抽屉标题必须保留，实际 {sorted(dock_names)}"
+    print("[PASS] 抽屉卡元素归属：上沿外气泡滤掉、跨沿标题保留")
+
+    # 端到端：focus_artboard 必须真产出 card-1.png + mask 圆角（几何直取的卡）
+    import shutil
+    import tempfile
+    import png_utils  # noqa: E402
+    tmp = Path(tempfile.mkdtemp(prefix="cb-subcard-"))
+    try:
+        prev = tmp / "artboard.png"
+        pw, ph = 750, 1624
+        png_utils.write_png(str(prev), pw, ph, 4, [b"\xff" * (pw * 4)] * ph)
+        cdir = tmp / "out"
+        cdir.mkdir()
+        spec = pm.focus_artboard(BOTTOM_SHEET, prev, cdir)
+        assert len(spec["cards"]) == 1, f"focus_artboard 应为抽屉产 1 张卡，实际 {len(spec['cards'])}"
+        card = spec["cards"][0]
+        assert card.get("image") == "card-1.png" and (cdir / "card-1.png").exists(), "card-1.png 必须实产"
+        assert (card.get("mask") or {}).get("radius") == [20, 20, 0, 0], \
+            f"mask 圆角应取自面板几何，实际 {card.get('mask')}"
+        assert spec["focusSkipReason"] == "bottom_sheet_geometry", \
+            "focusSkipReason 不得改变（classify_artboard / trainer 依赖它）"
+        print("[PASS] focus_artboard 端到端：card-1.png + mask.radius 实产，focusSkipReason 不变")
+    finally:
+        shutil.rmtree(tmp, ignore_errors=True)
+
+    # 卡片级切图判定（房贷 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：中段大盘切图算卡，小图标不算")
+
+    # 同名画板消歧（2026-09-24）：Sketch 允许两个画板**完全同名**——实测「地址管理」稿
+    # 25 板里两个「11…_失败_再次修改」（375×1232/129 层 vs 375×1252/130 层，两个不同设计）。
+    # 目录名直接用 name 时后跑的会整板覆盖先跑的（产物静默丢失），且 manifest 两条 entry
+    # 指向同一目录、下游按 name 定位（generate_cards.mjs）两行同名无法区分。
+    uniq = pm.unique_canvas_names(["A_首页", "A_首页", "B_备用", "A_首页"])
+    assert uniq == ["A_首页", "A_首页-2", "B_备用", "A_首页-3"], f"同名消歧结果不符，实际 {uniq}"
+    assert len(set(uniq)) == len(uniq), "消歧后必须两两不同（否则仍会互相覆盖）"
+    assert pm.unique_canvas_names(["唯一板"]) == ["唯一板"], "无重名时不得改动画板名（下游零感知）"
+    print("[PASS] 同名画板消歧：第 2 个起追加 -2/-3，无重名时原名不动")
+
+    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

@@ -17,7 +17,6 @@ TOP_SYSTEM_RATIO = 0.12       # 顶部状态栏+导航占画板高度比例（
 BOTTOM_SYSTEM_RATIO = 0.13    # 底部导航+AI输入框+Home Indicator 高度比例（约 100px @812）
 FULLSCREEN_BG_RATIO = 0.85    # 面积 >= 画板 85% 视为全屏背景（蒙版/背景）
 CARD_MIN_AREA_RATIO = 0.045   # 卡片最小面积 = 画板面积的 4.5%（375*812≈305k → ~13.7k px²）
-CARD_MAX_AREA_RATIO = 0.75    # 卡片最大面积 < 画板 75%（排除整屏）
 EDGE_DECOR_RATIO = 0.45       # 与画板顶/底边粘连且高度 < 45%H 的块视为装饰（椭圆/弥散背景）
 MERGE_GAP_RATIO = 0.02        # 两块之间间隙小于画板宽 2% 且高度相似时合并
 OVERLAY_MIN_WIDTH_RATIO = 0.55     # 居中对话框通常明显窄于画板
@@ -32,7 +31,11 @@ OVERLAY_CENTER_TOLERANCE = 0.10    # 对话框水平中心容差
 # 全 24 稿回归：新增 8 处检出均为真弹框（总资产提示/网点报错提示×4/交易
 # 密码框×2/转账计划时间修正提示），0 丢失。
 OVERLAY_MIN_INSET_X_RATIO = 0.008
-OVERLAY_MIN_INSET_Y_RATIO = 0.035
+# 内壳纵向允许略微溢出外壳的下界（负值 = 允许向上溢出画板高度的比例）。
+# 与 X 侧的 0.008 是两个不同的界：X 侧要求正留白，Y 侧只排除「内外壳纵向完全对齐」的
+# 普通内容列。历史值 0.035 从未被引用（死常量），实际生效判据是 _detect_overlay_metrics
+# 里内联的 -0.012；此处提为具名常量，**值不变**（零行为变更）。
+OVERLAY_MIN_INSET_Y_RATIO = -0.012
 
 
 class VisualElement:
@@ -118,22 +121,6 @@ class VisualElement:
         return out
 
 
-def _hex_of(color_obj):
-    if not isinstance(color_obj, dict):
-        return None
-    for key in ("color-hex", "argb-hex", "rgba-hex"):
-        v = color_obj.get(key)
-        if isinstance(v, str) and v.startswith("#"):
-            return v.split()[0][:7] if " " not in v else v[:7]
-    return None
-
-
-def _fill_hex(f):
-    if isinstance(f, dict) and f.get("color"):
-        return _hex_of(f["color"])
-    return None
-
-
 def _flatten_raw(raw_layers):
     out = []
     def walk(ls, parent_count=0):
@@ -203,11 +190,6 @@ def _is_edge_decor(ve, W, H):
     return False
 
 
-def _touch_screen_edges(ve, W):
-    x, y, w, h = ve.rect
-    return (x <= 0 and w >= 0.5 * W) or (x + w >= W and w >= 0.5 * W)
-
-
 def _overlap(a, b):
     ax, ay, aw, ah = a
     bx, by, bw, bh = b
@@ -431,7 +413,7 @@ def detect_overlay_dialog(elements, width, height):
             inset_y = min(iy - oy, (oy + oh) - (iy + ih))
             if (not _rect_inside(inner.rect, outer.rect, tol=0.015 * H) or
                     inset_x < OVERLAY_MIN_INSET_X_RATIO * W or
-                    inset_y < -0.012 * H or oh < 1.5 * ih):
+                    inset_y < OVERLAY_MIN_INSET_Y_RATIO * H or oh < 1.5 * ih):
                 continue
             metrics["outerRect"] = outer.rect
             metrics["inset"] = {"x": inset_x, "y": inset_y}
@@ -650,12 +632,14 @@ def detect_conversation_flow(elements, width, height):
         if 0 <= gap <= 0.16 * H:
             stacked_bubbles += 1
 
-    if keyboard and input_dock:
-        pass
-    elif not bubbles or (len(bubbles) < 2 and not keyboard):
-        return None
-    elif not keyboard and stacked_bubbles == 0:
-        return None
+    # 键盘与输入坞同时存在即为对话输入态（直接认定），否则按气泡/堆叠条件否决。
+    # 原写法是 `if keyboard and input_dock: pass` + `elif` 链，空分支不可读；此处等价改写成
+    # 「非输入态才进否决链」——判定结果逐条相同（零行为变更）。
+    if not (keyboard and input_dock):
+        if not bubbles or (len(bubbles) < 2 and not keyboard):
+            return None
+        if not keyboard and stacked_bubbles == 0:
+            return None
 
     return {
         "inputDock": input_dock,
@@ -665,6 +649,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
@@ -1014,10 +1022,7 @@ def detect_cards(raw_layers, width, height, interaction_flow=None):
                     break
             if rejected:
                 continue
-        elements_in = []
-        for ve in elements:
-            if _point_in_rect(ve_center(ve), c) or _overlap(ve.rect, c) > 0.3 * ve.area:
-                elements_in.append(ve)
+        elements_in = elements_in_rect(elements, c)
         # 同 rect 的外壳层去重：优先保留有圆角的卡面，剔除同 rect 的
         # 无圆角背景层。否则无圆角矩形会把圆角外背景重新遮成不透明。
         by_rect = {}
@@ -1046,6 +1051,31 @@ def _point_in_rect(pt, r):
     return x <= px <= x + w and y <= py <= y + h
 
 
+def elements_in_rect(elements, rect, min_cover=None):
+    """卡片内元素归属的**唯一口径**：`detect_cards`（自动候选检测）与
+    `parse_meaxure.detect_artboard_cards`（底部抽屉转卡）都调这里，两处不会各自
+    实现一遍而漂移。
+
+    min_cover=None（默认 = detect_cards 既有口径）：
+        元素中心落在 rect 内，**或**与 rect 的重叠 > 30% 自身面积。
+    min_cover=0.7（贴底抽屉专用）：
+        只认「与 rect 的重叠 ≥ 70% 自身面积」的元素，不看中心。抽屉面板贴底，
+        其上沿会切过相邻元素（相邻气泡、气泡内文字层的大头刚过沿就会被默认口径
+        收进来），覆盖率门槛正好滤掉 —— 否则抽屉里会凭空多出「被盖住的气泡」。
+        真实稿实测（喜豆 04/05/06 三张 subcard）：阈值在 0.65~0.90 区间元素集合
+        完全一致（不敏感），跨沿的抽屉标题覆盖 ≈98% 始终保留。
+    """
+    out = []
+    for ve in elements:
+        if min_cover is not None:
+            if _intersect_ratio(ve.rect, rect) >= min_cover:
+                out.append(ve)
+            continue
+        if _point_in_rect(ve_center(ve), rect) or _overlap(ve.rect, rect) > 0.3 * ve.area:
+            out.append(ve)
+    return out
+
+
 # ---------- Flex 布局推断（纯几何，对齐平台节点 flex 属性） ----------
 def infer_flex_layout(container_rect, child_rects):
     """从容器与其子元素几何推断 flex 布局参数（纯视觉，无文本依赖）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cardbuddy",
-  "version": "0.14.3",
+  "version": "0.16.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": {