@topmindspace/tms-skills 0.1.3 → 0.1.5

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

@@ -16,7 +16,7 @@
     ② 无 LLM 的 rubric 启发式（content/layout/chart/infographic/tone 五维）
     ③ --deliver：按 SKILL.md「交付说明」七要素（路径/字节数/模式/风格/篇幅/格式/校验+引用）
        生成结构化交付说明——七要素缺一即 gate FAIL，杜绝手拼遗漏
-    交付时一键跑完，避免「只过了结构、内容质量靠自觉」。
+    交付时一键跑完；互不依赖的子进程门禁（HTML / PPTX / evals）并行执行以缩短墙钟。
 """
 from __future__ import annotations
 
@@ -26,6 +26,7 @@ import re
 import subprocess
 import sys
 import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
 from pathlib import Path
 
 try:
@@ -242,33 +243,43 @@ def main() -> int:
     print(f'交付质量门禁 · {html.name}')
     print('-' * 60)
 
-    # ① HTML strict（Mode A / presentation 自动附带 --layout-qa）
+    # ①–③ 互不依赖子进程并行（HTML strict / PPTX strict / evals）
     head_snip = html.read_text(encoding='utf-8')[:2500]
     mode_m = re.search(r'data-mode="([^"]+)"', head_snip)
     mode = mode_m.group(1) if mode_m else 'presentation'
+    jobs: list[tuple[str, list[str], str | None]] = []
+    # (name, cmd, fixed_note) — fixed_note 非空则覆盖尾部摘要
     vcmd = [sys.executable, str(ROOT / 'scripts' / 'validate_report.py'), str(html), '--strict']
     if mode == 'presentation':
         vcmd.append('--layout-qa')
-    rc, out, el = run(vcmd)
-    gate_name = 'validate_report --strict' + (' --layout-qa' if mode == 'presentation' else '')
-    tail = [ln for ln in out.splitlines() if ln.startswith('PASS ') or ln.startswith('结论')]
-    gate(gate_name, rc == 0, tail[-1] if tail else f'exit {rc}', el)
-
-    # ② PPTX strict（可选）
+    gate_html = 'validate_report --strict' + (' --layout-qa' if mode == 'presentation' else '')
+    jobs.append((gate_html, vcmd, None))
     if args.pptx:
-        cmd = [sys.executable, str(ROOT / 'scripts' / 'validate_pptx.py'), args.pptx, '--strict']
+        pcmd = [sys.executable, str(ROOT / 'scripts' / 'validate_pptx.py'), args.pptx, '--strict']
         if args.model:
-            cmd += ['--model=' + args.model]
-        rc, out, el = run(cmd)
-        tail = [ln for ln in out.splitlines() if ln.startswith('PASS ') or ln.startswith('结论')]
-        gate('validate_pptx --strict', rc == 0, tail[-1] if tail else f'exit {rc}', el)
-
-    # ③ evals 确定性
-    cmd = [sys.executable, str(ROOT / 'evals' / 'run_evals.py'), '--score', str(html)]
+            pcmd += ['--model=' + args.model]
+        jobs.append(('validate_pptx --strict', pcmd, None))
+    ecmd = [sys.executable, str(ROOT / 'evals' / 'run_evals.py'), '--score', str(html)]
     if args.trace:
-        cmd += ['--trace', args.trace]
-    rc, out, el = run(cmd)
-    gate('evals --score', rc == 0, '确定性 + 效率检查', el)
+        ecmd += ['--trace', args.trace]
+    jobs.append(('evals --score', ecmd, '确定性 + 效率检查'))
+
+    results: dict[str, tuple[int, str, float, str | None]] = {}
+    with ThreadPoolExecutor(max_workers=max(1, len(jobs))) as pool:
+        futs = {pool.submit(run, cmd): (name, note) for name, cmd, note in jobs}
+        for fut in as_completed(futs):
+            name, note = futs[fut]
+            rc, out, el = fut.result()
+            results[name] = (rc, out, el, note)
+
+    # 按 jobs 声明顺序输出（稳定可读；墙钟已并行）
+    for name, _cmd, _note in jobs:
+        rc, out, el, note = results[name]
+        if note is not None:
+            gate(name, rc == 0, note, el)
+        else:
+            tail = [ln for ln in out.splitlines() if ln.startswith('PASS ') or ln.startswith('结论')]
+            gate(name, rc == 0, tail[-1] if tail else f'exit {rc}', el)
 
     # ④ rubric 启发式
     rubric = heuristic_rubric(html)

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

@@ -220,7 +220,7 @@ def r_donut(i, sec):
         '    <div class="grid g-side rv a-start">\n'
         f'      <div class="fig" style="text-align:center"><div class="fig__cap">构成占比</div>\n'
         f'{chart_svg(ch, i, "donut")}      </div>\n'
-        '      <div class="stack gap-4"><h3 class="t-h3">数值图例（禁止叠在弧上）</h3>\n'
+        '      <div class="stack gap-4"><h3 class="t-h3">构成明细</h3>\n'
         '        <ul class="ul">' + ''.join(legend) + '</ul>\n'
         '      </div>\n    </div>\n')
     return wrap(i, 'donut', body, sec)

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

@@ -0,0 +1,180 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Regression gates for usage-feedback defects (validator + static engine checks)."""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+from xml.etree import ElementTree as ET
+
+ROOT = Path(__file__).resolve().parent
+sys.path.insert(0, str(ROOT))
+import validate_pptx as V  # noqa: E402
+
+EMU = 914400
+NS = V.NS
+fails: list[str] = []
+
+
+def ok(name: str, cond: bool, detail: str = "") -> None:
+    status = "PASS" if cond else "FAIL"
+    print(f"  [{status}] {name}" + (f" — {detail}" if detail and not cond else ""))
+    if not cond:
+        fails.append(name)
+
+
+def test_shape_bounds_reads_p_xfrm() -> None:
+    xml = (
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        f'<p:graphicFrame xmlns:a="{NS["a"]}" xmlns:p="{NS["p"]}">'
+        "<p:xfrm>"
+        f'<a:off x="{int(0.6 * EMU)}" y="{int(2.5 * EMU)}"/>'
+        f'<a:ext cx="{int(8.5 * EMU)}" cy="{int(3.5 * EMU)}"/>'
+        "</p:xfrm>"
+        "</p:graphicFrame>"
+    )
+    el = ET.fromstring(xml)
+    box = V.shape_bounds(el)
+    ok("1 shape_bounds reads p:xfrm", box is not None and box[2] > 0, f"got {box}")
+
+
+def test_shape_bounds_still_reads_a_xfrm() -> None:
+    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="{EMU}" y="{EMU}"/>'
+        f'<a:ext cx="{2 * EMU}" cy="{EMU}"/>'
+        "</a:xfrm></p:spPr></p:sp>"
+    )
+    el = ET.fromstring(xml)
+    box = V.shape_bounds(el)
+    ok("1b shape_bounds reads a:xfrm", box is not None and box[0] == EMU)
+
+
+def _text_shape(paras, x=0.6, y=2.5, w=4.0, h=0.6):
+    parts = []
+    for text, pt in paras:
+        parts.append(
+            f'<a:p><a:r><a:rPr sz="{int(pt * 100)}"/><a:t>{text}</a:t></a:r></a:p>'
+        )
+    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(x * EMU)}" y="{int(y * EMU)}"/>'
+        f'<a:ext cx="{int(w * EMU)}" cy="{int(h * EMU)}"/>'
+        "</a:xfrm></p:spPr>"
+        f'<p:txBody>{"".join(parts)}</p:txBody></p:sp>'
+    )
+    return ET.fromstring(xml)
+
+
+def test_text_overflow_vertical() -> None:
+    paras = [(f"这是第{i}段足够长的中文内容用来累计行高", 12.0) for i in range(8)]
+    shape = _text_shape(paras, h=0.55)
+    issues = V.text_overflow_vertical_check(shape, 1)
+    codes = [i["code"] for i in issues]
+    ok(
+        "2 TEXT_OVERFLOW_VERTICAL fires on multi-segment cumulative",
+        "TEXT_OVERFLOW_VERTICAL" in codes,
+        f"codes={codes}",
+    )
+
+
+def test_annotation_band_overlap() -> None:
+    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.4 * EMU)}"/>'
+        "</a:xfrm></p:spPr></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(
+        "3 ANNOTATION_BAND_OVERLAP fires when content crushes band",
+        "ANNOTATION_BAND_OVERLAP" in codes,
+        f"codes={codes}",
+    )
+
+
+def test_font_size_not_snapped() -> None:
+    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="1130"/><a:t>OffLadderSampleTextHere</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(
+        "4 FONT_SIZE_NOT_SNAPPED fires on off-ladder size",
+        "FONT_SIZE_NOT_SNAPPED" in codes,
+        f"codes={codes}",
+    )
+
+
+def test_engine_static() -> None:
+    export = (ROOT.parent / "assets" / "pptx-export.js").read_text(encoding="utf-8")
+    build = (ROOT.parent / "scripts" / "build_pptx.js").read_text(encoding="utf-8")
+
+    m = re.search(r"function vbarShapes\([\s\S]*?\n\}", export)
+    body = m.group(0) if m else ""
+    ok("B vbarShapes handles ec.series", "ec.series" in body and "series.forEach" in body)
+
+    ok(
+        "C A-channel streamgraph reserves legend inside plot",
+        "Reserve legend INSIDE" in export and "plotBottom" in export,
+    )
+    ok(
+        "C B-channel infoStreamgraph reserves legend inside plot",
+        "Reserve legend INSIDE" in build and "plotBottom" in build,
+    )
+
+    ok(
+        "D A-channel caption uses capYImg from imageLayoutShapes",
+        "capYImg" in export
+        and re.search(r"capYImg\s*=\s*imageLayoutShapes", export) is not None,
+    )
+    ok(
+        "D B-channel caption uses capYImg from imageLayoutShapes",
+        "capYImg" in build
+        and re.search(r"capYImg\s*=\s*imageLayoutShapes", build) is not None,
+    )
+
+    cards = re.search(
+        r"else if \(type === 'cards'\) \{[\s\S]*?else if \(type === 'split'\)",
+        export,
+    )
+    cards_body = cards.group(0) if cards else ""
+    ok(
+        "A A-channel cards uses sz: N object props (not bare sz())",
+        "sz: 12" in cards_body
+        and not re.search(r"(?<![\w.])sz\s*\(\s*12\s*\)", cards_body),
+    )
+    ok(
+        "A modeSize applied in txSp serialization",
+        "function modeSize" in export and "modeSize(" in export,
+    )
+
+
+def main() -> int:
+    print("feedback-gates regression")
+    test_shape_bounds_reads_p_xfrm()
+    test_shape_bounds_still_reads_a_xfrm()
+    test_text_overflow_vertical()
+    test_annotation_band_overlap()
+    test_font_size_not_snapped()
+    test_engine_static()
+    print(f"\n{len(fails)} failed" if fails else "\nAll feedback gates PASS")
+    return 1 if fails else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

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

@@ -108,6 +108,9 @@ STRICT_FAILURE_CODES = {
     "UNBALANCED_EMPTY_SPACE",
     "UNJUSTIFIED_LARGE_IMAGE",
     "TEXT_OVERFLOW_ESTIMATE",
+    "TEXT_OVERFLOW_VERTICAL",
+    "ANNOTATION_BAND_OVERLAP",
+    "FONT_SIZE_NOT_SNAPPED",
     "TEXT_INCOMPLETE",
     "CHART_SKEW_INVALID",
     "CHART_OVERSIZE",
@@ -207,9 +210,17 @@ def slide_chart_text(archive: zipfile.ZipFile, slide_name: str) -> str:
 
 
 def shape_bounds(element: ET.Element) -> tuple[int, int, int, int] | None:
+    """Read shape geometry from DrawingML ``a:xfrm`` **or** PresentationML ``p:xfrm``.
+
+    Native charts live in ``p:graphicFrame``, which carries ``p:xfrm`` (not ``a:xfrm``).
+    Skipping ``p:xfrm`` made chart overflow / overlap gates blind.
+    """
     xfrm = element.find(".//a:xfrm", NS)
+    if xfrm is None:
+        xfrm = element.find(".//p:xfrm", NS)
     if xfrm is None:
         return None
+    # p:xfrm and a:xfrm both nest a:off / a:ext
     offset = xfrm.find("a:off", NS)
     extent = xfrm.find("a:ext", NS)
     if offset is None or extent is None:
@@ -298,6 +309,147 @@ def text_overflow_check(shape: ET.Element, slide_no: int) -> list[dict[str, Any]
     return out
 
 
+def text_overflow_vertical_check(shape: ET.Element, slide_no: int) -> list[dict[str, Any]]:
+    """Multi-segment cumulative vertical overflow (TEXT_OVERFLOW_VERTICAL).
+
+    Per-paragraph area checks miss the case where each line fits individually but
+    the *sum* of estimated line heights exceeds the text-frame height.
+    """
+    out: list[dict[str, Any]] = []
+    box = shape_bounds(shape)
+    if box is None:
+        return out
+    _, _, cx, cy = box
+    w_in, h_in = cx / 914400.0, cy / 914400.0
+    if w_in <= 0 or h_in <= 0:
+        return out
+    cfg = _containers_cfg()
+    lf = float(cfg.get("lineFactor") or 1.35)
+    total_h = 0.0
+    segments = 0
+    for para in shape.findall(".//a:p", NS):
+        line = "".join((t.text or "") for t in para.findall(".//a:t", NS))
+        if not line.strip():
+            continue
+        sizes = font_sizes_pt(para)
+        fz = min(sizes) if sizes else 12.0
+        est_w = est_text_width_in(line, fz)
+        lines_needed = max(1, int((est_w / max(w_in, 0.01)) + 0.999))
+        total_h += lines_needed * (fz / 72.0) * lf
+        segments += 1
+    # Single-segment cases already covered by TEXT_OVERFLOW_ESTIMATE; this gate
+    # targets multi-para cumulative overflow (tolerance mirrors horizontal gate).
+    if segments >= 2 and total_h > h_in * TEXT_OVERFLOW_TOLERANCE:
+        out.append(issue(
+            "TEXT_OVERFLOW_VERTICAL",
+            f"多段文本累计高度估算 {total_h:.2f}in > 文本框 {h_in:.2f}in"
+            f"（{segments} 段，容差 {TEXT_OVERFLOW_TOLERANCE:.0%}）——"
+            "请拆段/缩字号阶梯/换页，禁止静默截断。",
+            slide=slide_no,
+        ))
+    return out
+
+
+def annotation_band_overlap_check(
+    elements: list[ET.Element],
+    slide_no: int,
+    slide_height_emu: int,
+) -> 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.
+    """
+    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 {})
+        band_top_in = float(lay.get("contentBottomWithNote") or 6.4)
+        band_bot_in = float(lay.get("contentBottom") or 6.9)
+    except (OSError, json.JSONDecodeError, TypeError, ValueError):
+        band_top_in, band_bot_in = 6.4, 6.9
+    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
+    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
+        bottom = y + cy
+        # Legitimate annotation/note content sits entirely inside the band
+        if y >= band_top - int(0.02 * 914400):
+            continue
+        # Page chrome (pager) — tiny shapes near bottom edge
+        if y >= pager_floor:
+            continue
+        overlap = min(bottom, band_bot) - max(y, band_top)
+        if overlap >= min_overlap and bottom > band_top:
+            out.append(issue(
+                "ANNOTATION_BAND_OVERLAP",
+                f"主内容侵入注释带（元素底边 {bottom/914400:.2f}in 越过注释带顶 "
+                f"{band_top_in:.2f}in，重叠 {overlap/914400:.2f}in）——"
+                "图例/系列请收入主图区或压缩系列数，禁止压进 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).
+
+    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.
+    """
+    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"))
+        ladder = ((lc.get("containers") or {}).get("fontShrink") or {}).get("ladder") or []
+        allowed = {round(float(v), 2) for v in ladder}
+    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}
+    alien: list[float] = []
+    for run in root.findall(".//a:r", NS):
+        text = "".join(t.text or "" for t in run.findall("a:t", NS))
+        if not text.strip():
+            continue
+        pr = run.find("a:rPr", NS)
+        raw = pr.get("sz") if pr is not None else None
+        if raw is None:
+            continue
+        try:
+            pt = int(raw) / 100.0
+        except (TypeError, ValueError):
+            continue
+        if round(pt, 2) not in allowed and abs(pt * 2 - round(pt * 2)) > 0.01:
+            alien.append(pt)
+        elif round(pt, 2) not in allowed:
+            # On 0.5 grid but not on declared ladder / display set — still flag
+            # when far from any allowed value (>0.26pt)
+            if min(abs(pt - a) for a in allowed) > 0.26:
+                alien.append(pt)
+    if alien:
+        out.append(issue(
+            "FONT_SIZE_NOT_SNAPPED",
+            f"页内出现未对齐字号阶梯的字号 {sorted(set(round(v,2) for v in alien))[:8]}——"
+            "fitFont/modeSize 须回落到 containers.fontShrink.ladder（或封面展示档）。",
+            slide=slide_no,
+        ))
+    return out
+
+
 @lru_cache(maxsize=1)
 def _containers_cfg() -> dict[str, Any]:
     """容器内边距与锚点容差（单源 scripts/layout-constants.json 的 containers / anchorTolerance）。"""
@@ -628,8 +780,13 @@ def inspect_slide(
 
     for shape in shapes:
         warnings.extend(text_overflow_check(shape, slide_number))
+        warnings.extend(text_overflow_vertical_check(shape, slide_number))
         warnings.extend(container_overflow_check(shape, slide_number))
 
+    warnings.extend(annotation_band_overlap_check(
+        [*shapes, *pictures, *graphic_frames], slide_number, height))
+    warnings.extend(font_size_snap_check(root, slide_number))
+
     for table in tables:
         warnings.extend(table_checks(table, slide_number))
 

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")