@topmindspace/tms-skills 0.1.4 → 0.1.6

package/top-ppt-html/scripts/smoke_pptx.sh

@@ -2,6 +2,7 @@
 # TopPPT HTML · PPTX 轻量冒烟（Batch 2）
 # extract_model → build_pptx → validate_pptx --strict --model=
 # 用法: bash scripts/smoke_pptx.sh [example.html]
+# 失败时打印短摘要（错误码/页码/消息），完整 JSON 落盘到 TMPDIR。
 set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 cd "$ROOT"
@@ -15,6 +16,7 @@ OUT_DIR="${TMPDIR:-/tmp}/top-ppt-html-smoke"
 mkdir -p "$OUT_DIR"
 MODEL="$OUT_DIR/${STEM}.model.json"
 PPTX="$OUT_DIR/${STEM}.pptx"
+REPORT="$OUT_DIR/${STEM}.validate.json"
 
 echo "== smoke_pptx =="
 echo "HTML  $HTML"
@@ -26,5 +28,42 @@ export NODE_PATH="${ROOT}/node_modules${NODE_PATH:+:$NODE_PATH}"
 node scripts/build_pptx.js "$PPTX" --model="$MODEL"
 echo "PPTX  $PPTX ($(wc -c < "$PPTX") bytes)"
 
-python3 scripts/validate_pptx.py "$PPTX" --strict --model="$MODEL"
-echo "smoke_pptx: OK"
+set +e
+python3 scripts/validate_pptx.py "$PPTX" --strict --model="$MODEL" \
+  --json-out="$REPORT" >"$OUT_DIR/${STEM}.validate.stdout.json"
+rc=$?
+set -e
+
+if [[ "$rc" -ne 0 ]]; then
+  echo "smoke_pptx: VALIDATE FAIL (exit $rc)" >&2
+  python3 - "$REPORT" "$rc" <<'PY'
+import json, sys
+path, rc = sys.argv[1], sys.argv[2]
+try:
+    d = json.loads(open(path, encoding="utf-8").read())
+except Exception as e:
+    print(f"  (could not read report {path}: {e})", file=sys.stderr)
+    sys.exit(int(rc))
+errs = d.get("errors") or []
+warns = d.get("warnings") or []
+print(f"  summary: errors={len(errs)} warnings={len(warns)} slides={d.get('summary',{}).get('slide_count')}", file=sys.stderr)
+seen = set()
+for e in errs + warns:
+    key = (e.get("code"), e.get("slide"), e.get("message"))
+    if key in seen:
+        continue
+    seen.add(key)
+    slide = e.get("slide")
+    slide_s = f"slide={slide} " if slide is not None else ""
+    msg = (e.get("message") or "")[:160]
+    print(f"  [{e.get('code')}] {slide_s}{msg}", file=sys.stderr)
+    if len(seen) >= 40:
+        print(f"  … truncated ({len(errs)+len(warns)} total findings)", file=sys.stderr)
+        break
+print(f"  full JSON: {path}", file=sys.stderr)
+sys.exit(int(rc))
+PY
+fi
+
+echo "smoke_pptx: OK (0 errors / 0 warnings)"
+exit 0

package/top-ppt-html/scripts/sync_runtime.py

@@ -59,6 +59,7 @@ UI = TPL_DIR / 'ui.js'
 TEMPLATES = [TPL_DIR / 'presentation.html',
              TPL_DIR / 'research.html',
              TPL_DIR / 'architecture.html']
+EXAMPLES = sorted((ROOT / 'assets' / 'examples').glob('*.html')) if (ROOT / 'assets' / 'examples').is_dir() else []
 BJ = ROOT / 'scripts' / 'build_pptx.js'
 EM = ROOT / 'scripts' / 'extract_model.py'
 
@@ -336,14 +337,19 @@ def main() -> int:
     ui_repl = ('/* __TOPPPT_UI_START__ */\n'
                '/* ══ TopPPT HTML 公共 UI 脚本（assets/templates/ui.js 的内联副本 · 由 scripts/sync_runtime.py 注入，禁止手改） ══ */\n'
                + ui_js + '\n/* __TOPPPT_UI_END__ */')
+    # 运行时同版本戳：对注入源 assets/pptx-export.js（rstrip 后）取 sha256[:16]，
+    # 写入模板内联块，供 validate_report 比对防「模板未 sync」漂移。
+    runtime_sha = hashlib.sha256(runtime.encode('utf-8')).hexdigest()[:16]
     runtime_repl = ('/* __TOPPPT_RUNTIME_START__ */\n'
                     '/* ══ PPTX 导出运行时（assets/pptx-export.js 的内联副本 · 由 scripts/sync_runtime.py 注入，禁止手改） ══ */\n'
+                    f'/* __TOPPPT_RUNTIME_SHA__:{runtime_sha} */\n'
                     + runtime + '\n/* __TOPPPT_RUNTIME_END__ */')
 
-    # ③ 注入三份模式模板
-    for tpl in TEMPLATES:
+    # ③ 注入三份模式模板 + 黄金样张（样张也内联运行时，须同戳）
+    inject_targets = list(TEMPLATES) + list(EXAMPLES)
+    for tpl in inject_targets:
         if not tpl.exists():
-            print(f'警告: 模板不存在 {tpl}')
+            print(f'警告: 模板/样张不存在 {tpl}')
             ok = False
             continue
         ok = inject(tpl, ENGINE_PAT, engine_repl, '__TOPPPT_ENGINE__') and ok
@@ -649,7 +655,7 @@ process.exit(bad ? 1 : 0);
     print(f'  model-schema.json      sha256[:16] = {ms_digest}  · 页型 {n_schema_pt} 种')
     print(f'  风格 token {n_styles} 套 · 三模式独立比例尺 {len([k for k in lc["modeTypeScale"] if not k.startswith("$")])} 套 · 页型几何 {n_pt} 组')
     print(f'  图表登记 {n_charts} 种（原生 {n_native} / 形状 {n_shape}） · 语义字阶 {n_typo} 级 · 12 列网格 {lc["grid"]["columns"]} 列 · 布局 IR {n_slots} 页型')
-    print('  已刷新: assets/pptx-export.js（常量块 + schema 块） · assets/style-gallery.html（常量块） · templates/{presentation,research,architecture}.html（引擎/UI/运行时内联副本）')
+    print('  已刷新: assets/pptx-export.js（常量块 + schema 块） · assets/style-gallery.html（常量块） · templates/{presentation,research,architecture}.html + assets/examples/*.html（引擎/UI/运行时内联副本，含 __TOPPPT_RUNTIME_SHA__）')
     print(f'  双端单源引用校验: {"PASS" if ok else "WARN（build_pptx 应 require layout-constants.json；extract_model 应读 model-schema.json；页型四件套与图表登记须完整）"}')
     print(f'  说明: 页型几何 {n_pt} 组（多页型共享几何组） · schema 页型 {n_schema_pt} 种')
     return 0

package/top-ppt-html/scripts/test_feedback_gates.py

@@ -102,6 +102,95 @@ def test_annotation_band_overlap() -> None:
     )
 
 
+def test_annotation_band_ignores_full_bleed_bg() -> None:
+    """Full-slide background must not false-positive as band crush."""
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:sp xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:spPr><a:xfrm>"
+        f'<a:off x="0" y="0"/>'
+        f'<a:ext cx="{int(13.333 * EMU)}" cy="{int(7.5 * EMU)}"/>'
+        "</a:xfrm></p:spPr></p:sp>"
+    )
+    el = ET.fromstring(xml)
+    issues = V.annotation_band_overlap_check(
+        [el], 1, int(7.5 * EMU), int(13.333 * EMU),
+    )
+    codes = [i["code"] for i in issues]
+    ok(
+        "3b full-bleed background does not fire ANNOTATION_BAND_OVERLAP",
+        "ANNOTATION_BAND_OVERLAP" not in codes,
+        f"codes={codes}",
+    )
+
+
+def test_annotation_band_allows_content_without_note() -> None:
+    """Without so-what/source, content may use up to contentBottom (~6.9)."""
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:sp xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:spPr><a:xfrm>"
+        f'<a:off x="{int(0.6 * EMU)}" y="{int(5.5 * EMU)}"/>'
+        f'<a:ext cx="{int(4 * EMU)}" cy="{int(1.0 * EMU)}"/>'
+        "</a:xfrm></p:spPr>"
+        "<p:txBody><a:p><a:r><a:t>AgendaCard</a:t></a:r></a:p></p:txBody>"
+        "</p:sp>"
+    )
+    el = ET.fromstring(xml)
+    issues = V.annotation_band_overlap_check([el], 1, int(7.5 * EMU))
+    codes = [i["code"] for i in issues]
+    ok(
+        "3c content to 6.50 without annotation does not fire",
+        "ANNOTATION_BAND_OVERLAP" not in codes,
+        f"codes={codes}",
+    )
+
+
+def test_annotation_band_fires_when_note_present() -> None:
+    """With so-what bar present, body overlapping the withNote band must fire."""
+    def sp(y, h, w, text):
+        return ET.fromstring(
+            '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+            f'<p:sp xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+            "<p:spPr><a:xfrm>"
+            f'<a:off x="{int(0.6 * EMU)}" y="{int(y * EMU)}"/>'
+            f'<a:ext cx="{int(w * EMU)}" cy="{int(h * EMU)}"/>'
+            "</a:xfrm></p:spPr>"
+            f"<p:txBody><a:p><a:r><a:t>{text}</a:t></a:r></a:p></p:txBody>"
+            "</p:sp>"
+        )
+    els = [
+        sp(5.5, 1.0, 4.0, "LegendSeries"),
+        sp(6.05, 0.55, 12.0, "结论 平台化是唯一路径"),
+    ]
+    issues = V.annotation_band_overlap_check(els, 1, int(7.5 * EMU), int(13.333 * EMU))
+    codes = [i["code"] for i in issues]
+    ok(
+        "3d body crush with so-what present fires ANNOTATION_BAND_OVERLAP",
+        "ANNOTATION_BAND_OVERLAP" in codes,
+        f"codes={codes}",
+    )
+
+
+def test_font_size_h2_17_allowed() -> None:
+    """modeTypeScale h2=17 must be on the allowed set (cover/display whitelist)."""
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:sld xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:cSld><p:spTree><p:sp><p:txBody>"
+        '<a:p><a:r><a:rPr sz="1700"/><a:t>AgendaSectionTitle</a:t></a:r></a:p>'
+        "</p:txBody></p:sp></p:spTree></p:cSld></p:sld>"
+    )
+    root = ET.fromstring(xml)
+    issues = V.font_size_snap_check(root, 1)
+    codes = [i["code"] for i in issues]
+    ok(
+        "4b FONT_SIZE_NOT_SNAPPED allows intentional 17pt h2",
+        "FONT_SIZE_NOT_SNAPPED" not in codes,
+        f"codes={codes}",
+    )
+
+
 def test_font_size_not_snapped() -> None:
     xml = (
         '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
@@ -170,6 +259,10 @@ def main() -> int:
     test_shape_bounds_still_reads_a_xfrm()
     test_text_overflow_vertical()
     test_annotation_band_overlap()
+    test_annotation_band_ignores_full_bleed_bg()
+    test_annotation_band_allows_content_without_note()
+    test_annotation_band_fires_when_note_present()
+    test_font_size_h2_17_allowed()
     test_font_size_not_snapped()
     test_engine_static()
     print(f"\n{len(fails)} failed" if fails else "\nAll feedback gates PASS")

package/top-ppt-html/scripts/validate_pptx.py

@@ -354,27 +354,111 @@ def annotation_band_overlap_check(
     elements: list[ET.Element],
     slide_no: int,
     slide_height_emu: int,
+    slide_width_emu: int | None = None,
 ) -> list[dict[str, Any]]:
     """Detect primary content crushing into the annotation band.
 
-    Annotation band ≈ [contentBottomWithNote, contentBottom] (default 6.4–6.9in).
-    Shapes that start in the body and extend into the band (e.g. streamgraph
-    legends stacked below the plot) fire ANNOTATION_BAND_OVERLAP.
+    Geometry (layout-constants pageTypes.layout / exhibit / note):
+      soWhatY ≈ 6.05 · contentBottomWithNote ≈ 6.4 · footnote/note ≈ 6.55 ·
+      contentBottom ≈ 6.9 · pager ≈ 7.0
+
+    Semantics:
+      - Full-bleed backgrounds, full-height accent strips, and pager/footer
+        chrome are never "content crushing the band".
+      - so-what / 口径 / 来源 bars that live in the annotation zone are the
+        band itself — not invaders.
+      - When the slide actually uses an annotation (so-what/source), body
+        content that starts above the band and overlaps
+        [contentBottomWithNote, contentBottom] fires ANNOTATION_BAND_OVERLAP
+        (streamgraph legend / plot crush cases).
+      - When no annotation is present, main content may use up to
+        contentBottom; only a severe invasion (≥0.35in into the nominal
+        withNote band) still fires as a safety net.
     """
     out: list[dict[str, Any]] = []
     try:
         lc_path = Path(__file__).resolve().parent / "layout-constants.json"
         lc = json.loads(lc_path.read_text(encoding="utf-8"))
         lay = ((lc.get("pageTypes") or {}).get("layout") or {})
+        exhibit = ((lc.get("pageTypes") or {}).get("exhibit") or {})
+        note = ((lc.get("pageTypes") or {}).get("note") or {})
         band_top_in = float(lay.get("contentBottomWithNote") or 6.4)
         band_bot_in = float(lay.get("contentBottom") or 6.9)
+        so_what_y_in = float(exhibit.get("soWhatY") or 6.05)
+        note_y_in = float(note.get("y") or exhibit.get("footnoteY") or 6.55)
     except (OSError, json.JSONDecodeError, TypeError, ValueError):
-        band_top_in, band_bot_in = 6.4, 6.9
+        band_top_in, band_bot_in, so_what_y_in, note_y_in = 6.4, 6.9, 6.05, 6.55
+
     band_top = int(band_top_in * 914400)
     band_bot = int(band_bot_in * 914400)
-    # Ignore footer/page-number chrome near the very bottom
-    pager_floor = int(min(band_bot_in + 0.05, slide_height_emu / 914400.0 - 0.05) * 914400)
-    min_overlap = int(0.08 * 914400)  # 0.08in
+    so_what_y = int(so_what_y_in * 914400)
+    note_y = int(note_y_in * 914400)
+    slide_w = int(slide_width_emu) if slide_width_emu else int(13.333333 * 914400)
+    slide_h = int(slide_height_emu)
+    slide_area = max(slide_w * slide_h, 1)
+    pager_floor = int(min(band_bot_in + 0.05, slide_h / 914400.0 - 0.05) * 914400)
+    min_overlap = int(0.10 * 914400)       # 0.10in — ignore sub-tenth rounding kiss
+    severe_overlap = int(0.35 * 914400)    # safety net when no annotation detected
+    full_bleed_area = 0.85
+    full_height_frac = 0.90
+    ann_pat = re.compile(
+        r"(结论|SO\s*WHAT|口径|来源|数据来源|Source\b|Note\b|footnote)",
+        re.IGNORECASE,
+    )
+
+    def _text(el: ET.Element) -> str:
+        return (text_content(el) or "").strip()
+
+    def _is_chrome_or_bg(y: int, cy: int, cx: int) -> bool:
+        if (cx * cy) / slide_area >= full_bleed_area and y <= int(0.05 * 914400):
+            return True
+        if cy >= int(full_height_frac * slide_h) and y <= int(0.05 * 914400):
+            return True
+        if y >= band_bot - int(0.02 * 914400):
+            return True
+        if y >= pager_floor:
+            return True
+        return False
+
+    def _is_annotation_self(y: int, cy: int, cx: int, text: str) -> bool:
+        """so-what / footnote / source row living in the annotation zone."""
+        if y >= so_what_y - int(0.08 * 914400) and (y + cy) <= band_bot + int(0.2 * 914400):
+            if ann_pat.search(text):
+                return True
+            # Wide short bar in so-what band (bar fill behind 结论 text)
+            if cy <= int(0.75 * 914400) and cx >= int(0.45 * slide_w):
+                return True
+        if y >= note_y - int(0.05 * 914400) and cy <= int(0.55 * 914400):
+            return True
+        # Entirely inside the nominal withNote band
+        if y >= band_top - int(0.02 * 914400):
+            return True
+        return False
+
+    # Pass 1: does this slide reserve an annotation?
+    has_annotation = False
+    for el in elements:
+        box = shape_bounds(el)
+        if box is None:
+            continue
+        _x, y, cx, cy = box
+        if cx <= 0 or cy <= 0:
+            continue
+        if _is_chrome_or_bg(y, cy, cx):
+            continue
+        if _is_annotation_self(y, cy, cx, _text(el)):
+            # Only count as "has annotation" when it looks like so-what/source,
+            # not merely any shape whose top is inside the band.
+            txt = _text(el)
+            if (
+                ann_pat.search(txt)
+                or (y >= so_what_y - int(0.08 * 914400) and cy <= int(0.75 * 914400) and cx >= int(0.45 * slide_w))
+                or (y >= note_y - int(0.05 * 914400) and cy <= int(0.55 * 914400) and txt)
+            ):
+                has_annotation = True
+                break
+
+    # Pass 2: body invaders
     for el in elements:
         box = shape_bounds(el)
         if box is None:
@@ -383,14 +467,15 @@ def annotation_band_overlap_check(
         if cx <= 0 or cy <= 0:
             continue
         bottom = y + cy
-        # Legitimate annotation/note content sits entirely inside the band
-        if y >= band_top - int(0.02 * 914400):
+        if _is_chrome_or_bg(y, cy, cx):
             continue
-        # Page chrome (pager) — tiny shapes near bottom edge
-        if y >= pager_floor:
+        if _is_annotation_self(y, cy, cx, _text(el)):
             continue
         overlap = min(bottom, band_bot) - max(y, band_top)
-        if overlap >= min_overlap and bottom > band_top:
+        if overlap < min_overlap or bottom <= band_top:
+            continue
+        # Enforce when annotation present, or when invasion is severe anyway
+        if has_annotation or overlap >= severe_overlap:
             out.append(issue(
                 "ANNOTATION_BAND_OVERLAP",
                 f"主内容侵入注释带（元素底边 {bottom/914400:.2f}in 越过注释带顶 "
@@ -398,17 +483,21 @@ def annotation_band_overlap_check(
                 "图例/系列请收入主图区或压缩系列数，禁止压进 so-what/来源行。",
                 slide=slide_no,
             ))
-            # One finding per slide is enough to gate
             break
     return out
 
 
+
 def font_size_snap_check(root: ET.Element, slide_no: int) -> list[dict[str, Any]]:
-    """Font sizes must sit on the fontShrink ladder (0.5pt snap grid).
+    """Font sizes must sit on the declared type scale / fontShrink ladder.
 
     fitFont already selects from the ladder; this gate catches callers that
     arithmetic-shift sizes (e.g. fz-1) or hardcode off-ladder values without
     re-snapping through the ladder / modeSize path.
+
+    Allowed set = containers.fontShrink.ladder ∪ typeScale ∪ all modeTypeScale
+    roles ∪ a small cover/hero display whitelist. Intentional h2 (17pt) and
+    other mode roles must pass; off-ladder 11.3pt etc. must still fail.
     """
     out: list[dict[str, Any]] = []
     try:
@@ -416,10 +505,25 @@ def font_size_snap_check(root: ET.Element, slide_no: int) -> list[dict[str, Any]
         lc = json.loads(lc_path.read_text(encoding="utf-8"))
         ladder = ((lc.get("containers") or {}).get("fontShrink") or {}).get("ladder") or []
         allowed = {round(float(v), 2) for v in ladder}
+        scale_sources: list[Any] = [lc.get("typeScale") or {}]
+        mts = lc.get("modeTypeScale") or {}
+        if isinstance(mts, dict):
+            scale_sources.extend(v for v in mts.values() if isinstance(v, dict))
+        for src in scale_sources:
+            if not isinstance(src, dict):
+                continue
+            for key, val in src.items():
+                if str(key).startswith("$"):
+                    continue
+                try:
+                    allowed.add(round(float(val), 2))
+                except (TypeError, ValueError):
+                    continue
     except (OSError, json.JSONDecodeError, TypeError, ValueError):
         allowed = {15, 14, 13.5, 13, 12.5, 12, 11.5, 11, 10.5, 10, 9.5, 9, 8.5}
-    # Also allow common display sizes used by cover/hero (not on shrink ladder)
-    allowed |= {44, 36, 30, 28, 24, 22, 20, 18, 16, 8.0, 7.5}
+        allowed |= {44, 36, 30, 22, 19, 18, 17, 14, 13, 11, 10, 8.5}
+    # Cover/hero intermediate display sizes (not every mode lists every step)
+    allowed |= {28, 24, 22, 20, 16, 8.0, 7.5}
     alien: list[float] = []
     for run in root.findall(".//a:r", NS):
         text = "".join(t.text or "" for t in run.findall("a:t", NS))
@@ -784,7 +888,7 @@ def inspect_slide(
         warnings.extend(container_overflow_check(shape, slide_number))
 
     warnings.extend(annotation_band_overlap_check(
-        [*shapes, *pictures, *graphic_frames], slide_number, height))
+        [*shapes, *pictures, *graphic_frames], slide_number, height, width))
     warnings.extend(font_size_snap_check(root, slide_number))
 
     for table in tables:

package/top-ppt-html/scripts/validate_report.py

@@ -28,6 +28,8 @@ research / architecture 仍须显式传 --layout-qa（不强制）。
 import sys
 import re
 import json
+import hashlib
+from typing import Optional
 from html.parser import HTMLParser
 from pathlib import Path
 
@@ -433,8 +435,22 @@ def _check_type_features(txt, chk, model):
         f"{len(missing)} 处: {missing[:4]}" if missing else "", level="WARN")
 
 
+RUNTIME_SHA_RE = re.compile(r'/\* __TOPPPT_RUNTIME_SHA__:([0-9a-f]{16}) \*/')
+
+
+def _pptx_export_source_sha() -> Optional[str]:
+    """当前技能包 assets/pptx-export.js 的 sha256[:16]（与 sync_runtime 注入口径一致）。"""
+    pe = Path(__file__).resolve().parent.parent / 'assets' / 'pptx-export.js'
+    try:
+        body = pe.read_text(encoding='utf-8').rstrip('\n')
+    except OSError:
+        return None
+    return hashlib.sha256(body.encode('utf-8')).hexdigest()[:16]
+
+
 def _check_pptx_export(txt, chk):
-    """PPTX 预览配套：有预览按钮就必须有内容模型 + 预览运行时；页面不得残留导出按钮。"""
+    """PPTX 预览配套：有预览按钮就必须有内容模型 + 预览运行时；页面不得残留导出按钮。
+    另：内联运行时必须带 __TOPPPT_RUNTIME_SHA__ 且与当前 pptx-export.js 同源。"""
     has_btn = 'id="pptPreviewBtn"' in txt
     has_model = 'REPORT_MODEL' in txt
     has_runtime = ('g.TopPptHtml = api' in txt) and ('function slidesXml' in txt)
@@ -445,6 +461,20 @@ def _check_pptx_export(txt, chk):
     else:
         chk("含 PPTX 预览按钮与内容模型（建议保留）",
             has_model and has_runtime, "未集成预览按钮/模型", level="WARN")
+    # 同版本戳：有运行时块时强制核对（缺戳或漂移 = FAIL）
+    if has_runtime or '/* __TOPPPT_RUNTIME_START__ */' in txt:
+        m = RUNTIME_SHA_RE.search(txt)
+        expected = _pptx_export_source_sha()
+        if not m:
+            chk("运行时同版本戳（__TOPPPT_RUNTIME_SHA__）", False,
+                "内联运行时缺戳；请跑 scripts/sync_runtime.py")
+        elif expected is None:
+            chk("运行时同版本戳（__TOPPPT_RUNTIME_SHA__）", False,
+                "无法读取 assets/pptx-export.js 计算源哈希")
+        else:
+            got = m.group(1)
+            chk("运行时同版本戳（__TOPPPT_RUNTIME_SHA__）", got == expected,
+                f"stamp={got} ≠ source={expected}（模板未 sync 或源已改）")
     chk("页面无 PPTX 导出按钮（仅预览 + 提示词）",
         'id="pptxBtn"' not in txt and 'id="pptDownload"' not in txt,
         "残留导出按钮 pptxBtn/pptDownload", level="WARN")