minimal-agent 0.9.0 → 0.10.0

package/skills/ui-design/scripts/chart_sanity_check.py

@@ -0,0 +1,261 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+chart_sanity_check.py —— SVG 图表「数据一致性 + 标签容纳性」确定性闸门（ppt 视觉门专用）。
+
+为什么需要这个脚本（2026-07-02 逐页体检根因 ⑧）
+====================
+弱模型手写 SVG 图表会犯两类**几何可判**的错，此前无人检查、直接出货：
+  - 数据映射颠倒：标注 ~20% 的柱画得比 ~80% 的柱还大（真机 slide11 事故）；
+  - 标签装不下：图内 <text> 估算宽度超出所属 <rect>（「蓝光 / 磁带」150px 塞进 120px 柱，
+    视觉上与相邻标签互撞——真机 slide11/19 事故）。
+
+检查口径（fail-open：解析不了/配不上对/图元过多，一律跳过不误伤）
+====================
+逐 <section class="slide"> 找内联 <svg>：
+  A. 百分比柱一致性：`NN%` 文本按横向中心就近配对 <rect> 柱；≥2 对时，数值排序必须与
+     柱尺寸排序一致（纵柱比高、横柱比宽，5% 容差）→ 不一致 ERROR。
+  A2. 绝对数值柱一致性（2026-07-07 真机复盘：page10 成本结构图，柱内标签是 22,800 /
+     4,000–9,000 / 45,000 这类绝对数值而非百分比，check A 的 PERCENT_RE 完全配不上，
+     0 pairs 静默跳过——45,000 那根柱实际画得比 22,800 那根还窄，数据颠倒未被拦截）：
+     锚点落在某 <rect> 内的纯数字/数字区间文本（同 B 的容纳关系，区间取均值），
+     ≥2 个时同样按数值排序 vs 柱尺寸排序（5% 容差）校验，口径与 A 一致，只是配对方式
+     用「锚点在柱内」而非「横向就近」（这类绝对数值标签通常画在柱内部，比就近配对更准）。
+  B. 标签容纳性：锚点落在某 <rect> 内的 <text>，按字宽估算（CJK≈1.0×fontSize、其余≈0.6×）
+     超出该 rect 宽度 8% 以上 → ERROR（修法：加宽图形/缩短标签，不是缩字）。
+
+仅标准库（re/json/argparse）；生成的 SVG 是扁平结构（无 transform 嵌套），正则解析足够；
+出现 transform 或 rect>12 的复杂图直接跳过（宁漏勿误）。
+
+用法：python chart_sanity_check.py <deck.html> [-v]
+"""
+
+import argparse
+import re
+import sys
+
+MAX_RECTS = 12          # rect 数超过此 = 复杂图（架构图/网络图），跳过不猜
+PAIR_MAX_DX_FRAC = 0.6  # 百分比文本与柱中心的横向距离 ≤ 柱宽×此值 才算配上对
+SIZE_TOLERANCE = 0.05   # 柱尺寸比较容差（5%）：近似等高不算颠倒
+LABEL_OVER_FRAC = 1.08  # 标签估宽 > rect 宽 ×此值 → 装不下
+PERCENT_RE = re.compile(r"^[~≈约]?\s*(\d+(?:\.\d+)?)\s*%$")
+# 纯绝对数值/数值区间（含千分位逗号、可选¥/$、可选区间）：22,800 / 4,000–9,000 / 45000
+NUMBER_RANGE_RE = re.compile(
+    r"^[¥$]?\s*(\d[\d,]*(?:\.\d+)?)\s*(?:[–—-]\s*[¥$]?\s*(\d[\d,]*(?:\.\d+)?))?\s*$"
+)
+
+SECTION_RE = re.compile(r'<section class="slide[\s\S]*?(?=<section class="slide|</body>|$)')
+LABEL_RE = re.compile(r'data-screen-label="([^"]*)"')
+SVG_RE = re.compile(r"<svg\b[\s\S]*?</svg>")
+RECT_RE = re.compile(r"<rect\b([^>]*?)/?>")
+TEXT_RE = re.compile(r"<text\b([^>]*)>([\s\S]*?)</text>")
+ATTR_RE = re.compile(r'([a-zA-Z_:][-a-zA-Z0-9_:.]*)\s*=\s*"([^"]*)"')
+
+
+def _attrs(s):
+    return dict(ATTR_RE.findall(s or ""))
+
+
+def _num(v, default=None):
+    try:
+        return float(v)
+    except (TypeError, ValueError):
+        return default
+
+
+def _est_text_width(text, font_size):
+    """按字宽估算文本渲染宽度：CJK/全角 ≈ 1.0×fontSize，其余 ≈ 0.6×。宁窄勿宽（少误报）。"""
+    w = 0.0
+    for ch in text:
+        w += font_size * (1.0 if ord(ch) > 0x2E7F else 0.6)
+    return w
+
+
+def _strip_tags(s):
+    return re.sub(r"<[^>]+>", "", s or "").strip()
+
+
+def _parse_bar_number(text):
+    """纯绝对数值（含千分位/区间）转可比较值；不是纯数字（如含%/中文）则返回 None。区间取均值。"""
+    m = NUMBER_RANGE_RE.match((text or "").strip())
+    if not m:
+        return None
+    a = float(m.group(1).replace(",", ""))
+    if m.group(2):
+        b = float(m.group(2).replace(",", ""))
+        return (a + b) / 2
+    return a
+
+
+def _containing_rect(text_item, rects):
+    """取锚点落在其内的最小 rect（柱优先于底板），落不进任何 rect 则 None。"""
+    holder = None
+    for r in rects:
+        if r["x"] <= text_item["x"] <= r["x"] + r["w"] and r["y"] <= text_item["y"] <= r["y"] + r["h"]:
+            if holder is None or r["w"] * r["h"] < holder["w"] * holder["h"]:
+                holder = r
+    return holder
+
+
+def check_charts(html, verbose=False):
+    """返回 (problems, notes)。problems 非空 = 有 ERROR 级图表缺陷。"""
+    problems = []
+    notes = []
+
+    for section in SECTION_RE.findall(html):
+        m = LABEL_RE.search(section)
+        label = m.group(1) if m else "未知页"
+        for svg_i, svg in enumerate(SVG_RE.findall(section), start=1):
+            if "transform=" in svg:
+                notes.append(f"{label} svg#{svg_i}：含 transform，跳过（复杂图不猜）。")
+                continue
+            rects = []
+            for rm in RECT_RE.finditer(svg):
+                a = _attrs(rm.group(1))
+                x, y = _num(a.get("x"), 0.0), _num(a.get("y"), 0.0)
+                w, h = _num(a.get("width")), _num(a.get("height"))
+                if w is None or h is None or w <= 0 or h <= 0:
+                    continue
+                rects.append({"x": x, "y": y, "w": w, "h": h})
+            if not rects:
+                continue
+            if len(rects) > MAX_RECTS:
+                notes.append(f"{label} svg#{svg_i}：{len(rects)} 个 rect（复杂图），跳过。")
+                continue
+            texts = []
+            for tm in TEXT_RE.finditer(svg):
+                a = _attrs(tm.group(1))
+                content = _strip_tags(tm.group(2))
+                if not content:
+                    continue
+                texts.append({
+                    "x": _num(a.get("x"), 0.0),
+                    "y": _num(a.get("y"), 0.0),
+                    "font": _num(a.get("font-size"), 16.0),
+                    "anchor": a.get("text-anchor", "start"),
+                    "text": content,
+                })
+
+            # ── A. 百分比柱一致性：数值排序 vs 柱尺寸排序 ──
+            pairs = []
+            for t in texts:
+                pm = PERCENT_RE.match(t["text"])
+                if not pm:
+                    continue
+                value = float(pm.group(1))
+                best = None
+                best_dx = None
+                for r in rects:
+                    dx = abs(t["x"] - (r["x"] + r["w"] / 2))
+                    if dx <= r["w"] * PAIR_MAX_DX_FRAC and (best_dx is None or dx < best_dx):
+                        best, best_dx = r, dx
+                if best is not None:
+                    pairs.append((value, best, t["text"]))
+            if len(pairs) >= 2:
+                heights = [p[1]["h"] for p in pairs]
+                widths = [p[1]["w"] for p in pairs]
+                # 纵柱（宽相近、高不同）比高；横柱比宽
+                spread = lambda vals: (max(vals) - min(vals)) / max(max(vals), 1e-9)
+                dim = "h" if spread(heights) >= spread(widths) else "w"
+                ordered = sorted(pairs, key=lambda p: p[0])
+                for (v1, r1, t1), (v2, r2, t2) in zip(ordered, ordered[1:]):
+                    if v2 - v1 < 5:
+                        continue  # 数值太接近不判（近似档位）
+                    if r1[dim] > r2[dim] * (1 + SIZE_TOLERANCE):
+                        problems.append(
+                            f"【图表数据颠倒】{label} · svg#{svg_i} · "
+                            f"标注 {t1} 的柱（{'高' if dim == 'h' else '宽'} {r1[dim]:.0f}）"
+                            f"画得比标注 {t2} 的柱（{r2[dim]:.0f}）还大——数值与图形不一致"
+                            f"  ｜可参考修法（非强制）：按数值重算柱{'高' if dim == 'h' else '宽'}"
+                            f"（尺寸 ∝ 数值），别让示意图撒谎"
+                        )
+            if verbose and pairs:
+                notes.append(f"{label} svg#{svg_i}：配对 {len(pairs)} 组百分比柱。")
+
+            # ── A2. 绝对数值柱一致性：锚点落在柱内的纯数字/数字区间标签，同样按数值排序
+            #        vs 柱尺寸排序校验（percent 已在上面用掉，这里跳过避免重复配对）──
+            value_pairs = []
+            for t in texts:
+                if PERCENT_RE.match(t["text"]):
+                    continue
+                val = _parse_bar_number(t["text"])
+                if val is None:
+                    continue
+                holder = _containing_rect(t, rects)
+                if holder is not None:
+                    value_pairs.append((val, holder, t["text"]))
+            if len(value_pairs) >= 2:
+                heights = [p[1]["h"] for p in value_pairs]
+                widths = [p[1]["w"] for p in value_pairs]
+                spread = lambda vals: (max(vals) - min(vals)) / max(max(vals), 1e-9)
+                dim = "h" if spread(heights) >= spread(widths) else "w"
+                ordered = sorted(value_pairs, key=lambda p: p[0])
+                for (v1, r1, t1), (v2, r2, t2) in zip(ordered, ordered[1:]):
+                    if v1 > 0 and (v2 - v1) / v1 < 0.05:
+                        continue  # 数值太接近不判（近似档位）
+                    if r1[dim] > r2[dim] * (1 + SIZE_TOLERANCE):
+                        problems.append(
+                            f"【图表数据颠倒】{label} · svg#{svg_i} · "
+                            f"标注 {t1} 的柱（{'高' if dim == 'h' else '宽'} {r1[dim]:.0f}）"
+                            f"画得比标注 {t2} 的柱（{r2[dim]:.0f}）还大——数值 {t1} < {t2} 但图形更大"
+                            f"  ｜可参考修法（非强制）：按数值重算柱{'高' if dim == 'h' else '宽'}"
+                            f"（尺寸 ∝ 数值），别让示意图撒谎"
+                        )
+            if verbose and value_pairs:
+                notes.append(f"{label} svg#{svg_i}：配对 {len(value_pairs)} 组绝对数值柱。")
+
+            # ── B. 标签容纳性：锚点在 rect 内的文本估宽必须装得下 ──
+            for t in texts:
+                holder = _containing_rect(t, rects)
+                if holder is None:
+                    continue
+                est = _est_text_width(t["text"], t["font"])
+                if t["anchor"] == "middle":
+                    left, right = t["x"] - est / 2, t["x"] + est / 2
+                elif t["anchor"] == "end":
+                    left, right = t["x"] - est, t["x"]
+                else:
+                    left, right = t["x"], t["x"] + est
+                overflow = max(holder["x"] - left, right - (holder["x"] + holder["w"]), 0.0)
+                if est > holder["w"] * LABEL_OVER_FRAC and overflow > 0:
+                    problems.append(
+                        f"【图表标签装不下】{label} · svg#{svg_i} · "
+                        f"「{t['text'][:16]}」估宽 {est:.0f} 超出所属图形宽 {holder['w']:.0f}"
+                        f"（溢出 {overflow:.0f}）"
+                        f"  ｜可参考修法（非强制）：把图形画大装下标签 / 缩短标签文案 / 标签移到图形外侧"
+                        f"——**不是缩字**（图内文字须 ≥24px）"
+                    )
+
+    return problems, notes
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="SVG 图表数据一致性 + 标签容纳性闸门（仅标准库；复杂图 fail-open 跳过）"
+    )
+    parser.add_argument("html", help="deck.html 路径")
+    parser.add_argument("-v", "--verbose", action="store_true")
+    args = parser.parse_args()
+
+    try:
+        with open(args.html, "r", encoding="utf-8") as f:
+            html = f.read()
+    except OSError as exc:
+        print(f"SKIP: 读取 {args.html} 失败：{exc}")
+        return 0  # fail-open：文件问题由上游门管
+
+    problems, notes = check_charts(html, verbose=args.verbose)
+    if args.verbose:
+        for n in notes:
+            print("NOTE: " + n)
+    if problems:
+        print(f"SVG 图表一致性检查 FAILED —— {len(problems)} 处缺陷：")
+        for p in problems:
+            print("  - " + p)
+        return 1
+    print("SVG 图表一致性检查 PASSED（复杂图/无图表页自动跳过）")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/skills/ui-design/scripts/chart_sanity_check_test.py

@@ -0,0 +1,165 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+chart_sanity_check_test.py —— SVG 图表一致性门的回归锚（stdlib unittest）。
+
+夹具仿真机 slide11 事故（标注 ~20% 的柱比 ~80% 还大）与派生场景，锁定：
+  - 数据颠倒 ERROR / 数值正序通过；
+  - 标签估宽超出所属 rect → ERROR；装得下 → 通过；
+  - 复杂图（rect>12 / 带 transform）与无图表页 fail-open 跳过。
+
+运行：python skills/ui-design/scripts/chart_sanity_check_test.py
+"""
+
+import os
+import sys
+import unittest
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from chart_sanity_check import check_charts  # noqa: E402
+
+
+def deck(svg_body, label="11 测试页"):
+    return (
+        f'<body><section class="slide" data-screen-label="{label}">'
+        f'<svg viewBox="0 0 600 280">{svg_body}</svg></section></body>'
+    )
+
+
+# 真机 slide11 事故复刻：20% 柱高 160 > 80% 柱高 140
+INVERTED = """
+  <rect x="60" y="80" width="120" height="160" fill="blue"/>
+  <text x="120" y="60" text-anchor="middle" font-size="28">~20%</text>
+  <rect x="240" y="100" width="120" height="140" fill="navy"/>
+  <text x="300" y="80" text-anchor="middle" font-size="28">~80%</text>
+"""
+
+CORRECT = """
+  <rect x="60" y="200" width="120" height="40" fill="blue"/>
+  <text x="120" y="190" text-anchor="middle" font-size="28">~20%</text>
+  <rect x="240" y="80" width="120" height="160" fill="navy"/>
+  <text x="300" y="60" text-anchor="middle" font-size="28">~80%</text>
+"""
+
+# 标签装不下：8 个 CJK ×22 ≈ 176 > 柱宽 120
+LABEL_OVERFLOW = """
+  <rect x="240" y="100" width="120" height="140" fill="navy"/>
+  <text x="300" y="128" text-anchor="middle" font-size="22">蓝光磁带历史归档库</text>
+"""
+
+LABEL_FITS = """
+  <rect x="240" y="100" width="120" height="140" fill="navy"/>
+  <text x="300" y="128" text-anchor="middle" font-size="22">SSD</text>
+"""
+
+# 真机 2026-07-07 page10 成本结构图事故复刻：柱内标签是绝对数值（非百分比），
+# 45,000 那根柱（宽 220/高 28）画得比 22,800 那根（宽 380/高 70）还小——check A 的
+# PERCENT_RE 配不上这类标签，0 pairs 静默跳过，数据颠倒未被拦截。
+ABSOLUTE_VALUE_INVERTED = """
+  <rect x="180" y="100" width="380" height="70" fill="#2477a6"/>
+  <text x="370" y="146" text-anchor="middle" font-size="30">22,800</text>
+  <rect x="600" y="142" width="180" height="28" fill="#5a90b5"/>
+  <text x="690" y="166" text-anchor="middle" font-size="24">4,000–9,000</text>
+  <rect x="820" y="142" width="220" height="28" fill="#9bb9d0"/>
+  <text x="930" y="166" text-anchor="middle" font-size="24">45,000</text>
+"""
+
+ABSOLUTE_VALUE_CORRECT = """
+  <rect x="180" y="100" width="200" height="20" fill="#5a90b5"/>
+  <text x="280" y="115" text-anchor="middle" font-size="24">4,000–9,000</text>
+  <rect x="420" y="80" width="380" height="60" fill="#2477a6"/>
+  <text x="610" y="115" text-anchor="middle" font-size="30">22,800</text>
+  <rect x="840" y="40" width="560" height="100" fill="#9bb9d0"/>
+  <text x="1120" y="95" text-anchor="middle" font-size="24">45,000</text>
+"""
+
+
+class ChartSanityTest(unittest.TestCase):
+    def test_inverted_bars_error(self):
+        problems, _n = check_charts(deck(INVERTED))
+        self.assertTrue(any("数据颠倒" in p for p in problems), problems)
+        self.assertTrue(any("~20%" in p and "~80%" in p for p in problems), problems)
+
+    def test_correct_bars_pass(self):
+        problems, _n = check_charts(deck(CORRECT))
+        self.assertEqual(problems, [], problems)
+
+    def test_label_overflow_error(self):
+        problems, _n = check_charts(deck(LABEL_OVERFLOW))
+        self.assertTrue(any("标签装不下" in p for p in problems), problems)
+
+    def test_label_fits_pass(self):
+        problems, _n = check_charts(deck(LABEL_FITS))
+        self.assertEqual(problems, [], problems)
+
+    def test_absolute_value_inverted_bars_error(self):
+        # 真机 page10 事故：柱内标签是绝对数值（非百分比），PERCENT_RE 配不上，
+        # 此前 0 pairs 静默跳过；45,000 的柱画得比 22,800 的柱还小必须被拦截。
+        problems, _n = check_charts(deck(ABSOLUTE_VALUE_INVERTED))
+        self.assertTrue(any("数据颠倒" in p for p in problems), problems)
+        self.assertTrue(any("22,800" in p and "45,000" in p for p in problems), problems)
+
+    def test_absolute_value_correct_bars_pass(self):
+        problems, _n = check_charts(deck(ABSOLUTE_VALUE_CORRECT))
+        self.assertEqual(problems, [], problems)
+
+    def test_absolute_value_close_not_judged(self):
+        # 数值相对差 <5% 不判（近似档位画同尺寸属正常示意）。
+        svg = """
+          <rect x="60" y="80" width="120" height="150" fill="blue"/>
+          <text x="120" y="115" text-anchor="middle" font-size="28">9,800</text>
+          <rect x="240" y="90" width="120" height="140" fill="navy"/>
+          <text x="300" y="123" text-anchor="middle" font-size="28">10,200</text>
+        """
+        problems, _n = check_charts(deck(svg))
+        self.assertEqual(problems, [], problems)
+
+    def test_percent_text_not_double_counted_as_absolute_value(self):
+        # 百分比文本（如 "~20%"）不该被 A2 的绝对数值正则二次配对——NUMBER_RANGE_RE
+        # 不该匹配带 % 的字符串，否则会和 check A 重复判定甚至互相打架。
+        problems, _n = check_charts(deck(INVERTED))
+        # INVERTED 本身应仍只报一次数据颠倒（来自 check A，不应被 A2 重复计入/干扰）。
+        inverted_msgs = [p for p in problems if "数据颠倒" in p]
+        self.assertEqual(len(inverted_msgs), 1, problems)
+
+    def test_close_values_not_judged(self):
+        # 数值差 <5 个百分点不判（近似档位画同高属正常示意）。
+        svg = """
+          <rect x="60" y="80" width="120" height="150" fill="blue"/>
+          <text x="120" y="60" text-anchor="middle" font-size="28">48%</text>
+          <rect x="240" y="90" width="120" height="140" fill="navy"/>
+          <text x="300" y="70" text-anchor="middle" font-size="28">52%</text>
+        """
+        problems, _n = check_charts(deck(svg))
+        self.assertEqual(problems, [], problems)
+
+    def test_complex_svg_skipped(self):
+        # rect > 12（架构图/网络图）：fail-open 跳过，绝不误判。
+        rects = "".join(
+            f'<rect x="{i*40}" y="80" width="30" height="{100+i}" fill="b"/>' for i in range(14)
+        )
+        svg = rects + '<text x="20" y="60" font-size="28">20%</text>'
+        problems, notes = check_charts(deck(svg))
+        self.assertEqual(problems, [], problems)
+        self.assertTrue(any("复杂图" in n for n in notes), notes)
+
+    def test_transform_svg_skipped(self):
+        svg = ('<g transform="translate(10,10)">'
+               '<rect x="60" y="80" width="120" height="160"/></g>'
+               '<text x="120" y="60" font-size="28">20%</text>')
+        problems, notes = check_charts(deck(svg))
+        self.assertEqual(problems, [], problems)
+        self.assertTrue(any("transform" in n for n in notes), notes)
+
+    def test_no_svg_page_passes(self):
+        problems, _n = check_charts('<body><section class="slide" data-screen-label="01 无图">'
+                                    "<h1>标题</h1></section></body>")
+        self.assertEqual(problems, [], problems)
+
+    def test_error_message_carries_page_label(self):
+        problems, _n = check_charts(deck(INVERTED, label="11 存储与平台层"))
+        self.assertTrue(any("11 存储与平台层" in p for p in problems), problems)
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)