@topmindspace/tms-skills 0.1.1 → 0.1.2

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

@@ -0,0 +1,384 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""TopPPT HTML · 布局选型建议（Batch 2）
+
+用法:
+  python scripts/recommend_layout.py --mode B --intent "经营分析 占比极偏" --pages 10
+  python scripts/recommend_layout.py --mode A --intent "路演" --intent "趋势" --json
+  python scripts/recommend_layout.py --mode C --from-model path/to.model.json
+  echo '{"mode":"research","intents":["架构"]}' | python scripts/recommend_layout.py --stdin
+
+输出 JSON 页序列：{pageType, skel, chart?, rationale, v?}
+启发式：playbook V1–V4 / sizeByComplexity / 极偏禁 donut / 高容量多页序列 / layoutSystem.defaultCharts（核图 8）；advanced 仅意图命中；Mode A 主力骨架 P1–P4+P6/P10，次级 P7–P9/P11–P12 不默认。
+不列入 package REQUIRED（可选工具；Batch 3 再定是否纳入）。
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent
+LC = json.loads((ROOT / 'layout-constants.json').read_text(encoding='utf-8'))
+LS = LC.get('layoutSystem') or {}
+PAGE_TO_PRESET = dict(LS.get('pageToPreset') or {})
+DEFAULT_CHARTS = list(LS.get('defaultCharts') or
+                      ['bar', 'hbar', 'line', 'donut', 'progress', 'area', 'stack', 'dualline'])
+ADVANCED_CHARTS = set(LS.get('advancedCharts') or [])
+_MODE_SKELS = LS.get('modeSkels') or {}
+PRIMARY_SKELS = {
+    'presentation': list((_MODE_SKELS.get('presentation') or {}).get('primary') or
+                         ['P1', 'P2', 'P3', 'P4', 'P6', 'P10']),
+    'research': list((_MODE_SKELS.get('research') or {}).get('primary') or
+                     ['P5', 'P7', 'P8', 'P4', 'P6']),
+    'architecture': list((_MODE_SKELS.get('architecture') or {}).get('primary') or
+                         ['P9', 'P10', 'P11']),
+}
+SECONDARY_SKELS = {
+    'presentation': list((_MODE_SKELS.get('presentation') or {}).get('secondary') or
+                         ['P7', 'P8', 'P9', 'P11', 'P12']),
+    'research': list((_MODE_SKELS.get('research') or {}).get('secondary') or []),
+    'architecture': list((_MODE_SKELS.get('architecture') or {}).get('secondary') or []),
+}
+
+SIZE_BANDS = list(((LC.get('charts') or {}).get('sizeByComplexity') or {}).get('bands') or [])
+V_MAP = dict(LS.get('vMap') or {'V1': 'P1', 'V2': 'P2', 'V3': 'P3', 'V4': 'P4'})
+
+MODE_ALIAS = {
+    'a': 'presentation', 'presentation': 'presentation', '演示': 'presentation',
+    'b': 'research', 'research': 'research', '研究': 'research',
+    'c': 'architecture', 'architecture': 'architecture', '架构': 'architecture',
+}
+
+# 模式默认节奏（页型序列）；cover/closing 由调用方决定是否保留
+DEFAULT_SEQ = {
+    # Mode A：偏 V1–V4 / claim 页（kpi/points/quote）；降低 donut 默认权重（构成意图命中再用）
+    'presentation': [
+        'cover', 'agenda', 'kpi', 'points', 'bar', 'points', 'comparison', 'quote', 'closing',
+    ],
+    'research': [
+        'cover', 'agenda', 'metrics', 'exhibit', 'twocol', 'halftable',
+        'exhibit', 'threecol', 'matrix', 'flags', 'closing',
+    ],
+    'architecture': [
+        'cover', 'diagram', 'lane', 'diagram', 'points', 'closing',
+    ],
+}
+
+INTENT_RULES: list[tuple[tuple[str, ...], dict]] = [
+    (('极偏', '占比失衡', '长尾', '0.5%'), {
+        'pageType': 'kpi', 'chart': None, 'v': 'V3',
+        'rationale': '极偏占比禁 donut/pie → V3 大数+佐证',
+    }),
+    (('占比', '构成', '份额', '结构'), {
+        'pageType': 'points', 'chart': 'stack', 'v': 'V1',
+        'rationale': '构成类优先 stack/hbar+V1；donut 仅非极偏且需环形直觉时用（降默认权重）',
+    }),
+    (('趋势', '爬坡', '时间序列', '同比', '环比'), {
+        'pageType': 'bar', 'chart': 'line', 'v': 'V2',
+        'rationale': '时间趋势 → line；演示用 V2 上图下带',
+    }),
+    (('排名', '对比', '谁高谁低', '对标'), {
+        'pageType': 'bar', 'chart': 'hbar', 'v': 'V1',
+        'rationale': '排名/对比 → hbar',
+    }),
+    (('架构', '拓扑', '分层', '泳道', '流程'), {
+        'pageType': 'diagram', 'chart': 'network', 'v': None,
+        'rationale': '结构图为王；skel P10/P11',
+    }),
+    (('路演', '融资', 'pitch', '发布', '汇报', '演讲', 'demo', '演示'), {
+        'pageType': 'points', 'chart': None, 'v': 'V1',
+        'rationale': '演示节奏偏 V1–V4 + claim；简单图禁全幅；motion=none',
+    }),
+    (('经营', '复盘', '分析', '调研'), {
+        'pageType': 'exhibit', 'chart': 'bar', 'v': None,
+        'rationale': '研究证据页 exhibit + bar',
+    }),
+    (('瀑布', 'waterfall', '增减拆解', '桥图'), {
+        'pageType': 'bar', 'chart': 'waterfall', 'v': 'V1',
+        'rationale': 'advanced:waterfall 意图命中（非默认池）',
+    }),
+    (('漏斗', 'funnel', '转化率'), {
+        'pageType': 'bar', 'chart': 'funnel', 'v': 'V1',
+        'rationale': 'advanced:funnel 意图命中',
+    }),
+    (('甘特', 'gantt', '排期', '里程碑计划'), {
+        'pageType': 'bar', 'chart': 'gantt', 'v': None,
+        'rationale': 'advanced:gantt 意图命中',
+    }),
+    (('桑基', 'sankey', '流向', '分流'), {
+        'pageType': 'diagram', 'chart': 'sankey', 'v': None,
+        'rationale': 'advanced/信息图：流向意图',
+    }),
+    (('长文', '密集', '材料多', '证据多', '详细', 'deep dive', '白皮书', '高容量'), {
+        'pageType': 'points', 'chart': None, 'v': 'V1',
+        'rationale': '高容量→多页序列（勿塞一页）',
+        'sequence': 'high_volume',
+    }),
+]
+
+# 高容量内容：推荐多页分解，而非一页塞爆
+HIGH_VOLUME_SEQ = {
+    'presentation': [
+        'cover', 'agenda',
+        'kpi',          # claim
+        'points',       # evidence cards
+        'cards',        # secondary evidence
+        'bar',          # chart evidence
+        'points',       # detail list
+        'table',        # detail table if needed
+        'quote',        # breath
+        'closing',
+    ],
+    'research': [
+        'cover', 'agenda', 'metrics', 'exhibit', 'twocol',
+        'halftable', 'exhibit', 'threecol', 'table', 'flags', 'closing',
+    ],
+    'architecture': [
+        'cover', 'diagram', 'lane', 'diagram', 'points', 'points', 'closing',
+    ],
+}
+
+
+def _norm_mode(m: str) -> str:
+    return MODE_ALIAS.get((m or 'b').lower().strip(), 'research')
+
+
+def _skel(page_type: str, v: str | None = None, mode: str | None = None,
+          allow_secondary: bool = False) -> str:
+    if page_type in ('cover', 'closing'):
+        return 'P1'
+    if page_type in ('agenda',):
+        return 'P2'
+    if v and v in V_MAP:
+        return V_MAP[v]
+    sk = PAGE_TO_PRESET.get(page_type, 'P4')
+    # Mode A: remap secondary skels to primary unless intent explicitly allows
+    if mode == 'presentation' and not allow_secondary and sk in set(SECONDARY_SKELS.get('presentation') or []):
+        remap = {
+            'P7': 'P4', 'P8': 'P1', 'P9': 'P10', 'P11': 'P6', 'P12': 'P6',
+        }
+        sk = remap.get(sk, 'P4')
+    return sk
+
+
+def _chart_ok(chart: str | None, n_cats: int, n_pts: int) -> str | None:
+    """Apply sizeByComplexity forbid list; return possibly replaced chart."""
+    if not chart:
+        return None
+    for band in SIZE_BANDS:
+        if n_cats <= int(band.get('maxCats') or 99) and n_pts <= int(band.get('maxPts') or 99):
+            forbid = set(band.get('forbid') or [])
+            if chart in forbid:
+                prefer = list(band.get('prefer') or ['kpi'])
+                return None if prefer[0] in ('kpi', 'progress', 'vsbar') else prefer[0]
+            return chart
+    return chart if chart in DEFAULT_CHARTS else DEFAULT_CHARTS[0]
+
+
+def _complexity(sec: dict) -> tuple[int, int]:
+    ch = sec.get('chart') if isinstance(sec.get('chart'), dict) else {}
+    vals = ch.get('values') or ch.get('data') or []
+    labels = ch.get('labels') or []
+    pts = sec.get('points') or sec.get('items') or []
+    n_pts = len(vals) if vals else len(pts)
+    n_cats = len(labels) if labels else (len(vals) if vals else (1 if pts else 0))
+    return max(n_cats, 0), max(n_pts, 0)
+
+
+def _skew(sec: dict) -> bool:
+    ch = sec.get('chart') if isinstance(sec.get('chart'), dict) else {}
+    vals = [float(v) for v in (ch.get('values') or []) if isinstance(v, (int, float))]
+    vals = [v for v in vals if v >= 0]
+    if len(vals) < 2:
+        return False
+    total = sum(vals) or 1.0
+    pcts = [v / total * 100 for v in vals]
+    mn, mx = min(pcts), max(pcts)
+    return mn < 5.0 or (mn > 0 and mx / mn > 20)
+
+
+def _match_intent(text: str) -> dict | None:
+    for keys, hint in INTENT_RULES:
+        if any(k in text for k in keys):
+            return dict(hint)
+    return None
+
+
+def recommend(
+    mode: str,
+    intents: list[str] | None = None,
+    pages: int | None = None,
+    model: dict | None = None,
+) -> list[dict]:
+    mode = _norm_mode(mode)
+    intents = intents or []
+    blob = ' '.join(intents)
+
+    if model and isinstance(model.get('sections'), list) and model['sections']:
+        out = []
+        for i, sec in enumerate(model['sections'], 1):
+            if not isinstance(sec, dict):
+                continue
+            pt = str(sec.get('type') or 'points')
+            n_cats, n_pts = _complexity(sec)
+            ch = None
+            if isinstance(sec.get('chart'), dict):
+                ch = sec['chart'].get('type')
+            elif pt in DEFAULT_CHARTS:
+                ch = pt if pt != 'bar' else 'bar'
+            rationale = 'from-model'
+            v = None
+            if _skew(sec) and (ch in ('donut', 'pie', 'multidonut') or pt == 'donut'):
+                pt, ch, v = 'kpi', None, 'V3'
+                rationale = 'model 极偏占比 → V3 KPI（禁 donut）'
+            else:
+                ch = _chart_ok(ch, n_cats or 3, n_pts or 3)
+                if mode == 'presentation':
+                    if n_cats <= 2 and n_pts <= 3:
+                        v = 'V3'
+                        rationale = '演示·简单数据 → V3 大数，禁全幅简单图'
+                    elif n_pts >= 8:
+                        v = 'V2'
+                        rationale = '演示·复杂序列 → V2 上图下带'
+                    else:
+                        v = 'V1'
+                        rationale = '演示·默认 V1 主视觉+右注解'
+            if blob:
+                hit = _match_intent(blob)
+                if hit and i == min(3, len(model['sections'])):
+                    pt = hit.get('pageType', pt)
+                    ch = hit.get('chart', ch)
+                    v = hit.get('v', v)
+                    rationale = hit.get('rationale', rationale)
+            allow_sec = bool(ch and ch in ADVANCED_CHARTS) or pt in ('diagram', 'lane', 'matrix', 'heatmap')
+            skel = sec.get('layoutPreset') or _skel(pt, v, mode, allow_secondary=allow_sec)
+            row = {'page': i, 'pageType': pt, 'skel': skel, 'chart': ch,
+                   'rationale': rationale}
+            if v:
+                row['v'] = v
+            out.append(row)
+        return out
+
+    intent_hit = _match_intent(blob) if blob else None
+    high_vol = bool(intent_hit and intent_hit.get('sequence') == 'high_volume')
+    # 页数偏多或意图含高容量 → 多页序列（议程→主张→证据卡→明细），禁一页塞爆
+    if high_vol or (pages and pages >= 10) or any(
+            k in blob for k in ('长文', '密集', '材料多', '证据多', '详细', '白皮书')):
+        seq = list(HIGH_VOLUME_SEQ.get(mode, HIGH_VOLUME_SEQ['presentation']))
+        high_vol = True
+    else:
+        seq = list(DEFAULT_SEQ.get(mode, DEFAULT_SEQ['research']))
+    if pages and pages > 0:
+        mid = seq[1:-1] if len(seq) > 2 else seq
+        if pages <= 2:
+            seq = seq[:1] + seq[-1:]
+        else:
+            need = pages - 2
+            body = (mid * ((need // max(len(mid), 1)) + 1))[:need]
+            seq = [seq[0]] + body + [seq[-1]]
+
+    out = []
+    for i, pt in enumerate(seq, 1):
+        # 默认只从核图 8 轮换；advanced 不进默认节奏
+        ch = pt if pt in DEFAULT_CHARTS else (DEFAULT_CHARTS[(i - 1) % len(DEFAULT_CHARTS)]
+                                             if pt in ('bar', 'exhibit', 'donut') else None)
+        if ch in ADVANCED_CHARTS:
+            ch = DEFAULT_CHARTS[(i - 1) % len(DEFAULT_CHARTS)]
+        if pt == 'bar':
+            ch = 'bar'
+        if pt == 'donut':
+            ch = 'donut'
+        if pt == 'exhibit':
+            ch = 'bar'
+        if pt == 'comparison':
+            ch = 'hbar'  # 对比默认 hbar，避免 donut 占默认序列
+        # Mode A：内容页默认 V1；kpi→V3；复杂序列由 intent/from-model 升 V2
+        if mode == 'presentation' and pt not in ('cover', 'agenda', 'closing', 'quote'):
+            v = 'V3' if pt == 'kpi' else 'V1'
+        else:
+            v = None
+        rationale = f'default {mode} rhythm'
+        allow_sec = bool(ch and ch in ADVANCED_CHARTS) or pt in ('diagram', 'lane', 'matrix', 'heatmap')
+        skel = _skel(pt, v, mode, allow_secondary=allow_sec)
+        row = {'page': i, 'pageType': pt, 'skel': skel, 'chart': ch, 'rationale': rationale}
+        if v:
+            row['v'] = v
+        out.append(row)
+
+    if intent_hit and out and intent_hit.get('sequence') != 'high_volume':
+        idx = 2 if len(out) > 2 else 0
+        if out[idx]['pageType'] in ('cover', 'agenda'):
+            idx = min(idx + 1, len(out) - 1)
+        out[idx]['pageType'] = intent_hit.get('pageType', out[idx]['pageType'])
+        out[idx]['chart'] = intent_hit.get('chart')
+        if intent_hit.get('v'):
+            out[idx]['v'] = intent_hit['v']
+        ch_i = out[idx].get('chart')
+        allow_sec = bool(ch_i and ch_i in ADVANCED_CHARTS) or out[idx]['pageType'] in ('diagram', 'lane', 'matrix', 'heatmap')
+        out[idx]['skel'] = _skel(out[idx]['pageType'], out[idx].get('v'), mode, allow_secondary=allow_sec)
+        out[idx]['rationale'] = intent_hit.get('rationale', '')
+    if high_vol:
+        for r in out:
+            if r['pageType'] in ('cover', 'closing', 'agenda'):
+                continue
+            r['rationale'] = (r.get('rationale') or '') + (
+                ' · 高容量多页分解（禁一页塞爆/截断）' if '高容量' not in (r.get('rationale') or '') else '')
+    return out
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description='Recommend pageType/skel/chart sequence')
+    ap.add_argument('--mode', default=None, help='A|B|C or presentation|research|architecture')
+    ap.add_argument('--intent', action='append', default=[], help='repeatable intent phrases')
+    ap.add_argument('--pages', type=int, default=None)
+    ap.add_argument('--from-model', default=None, help='path to REPORT_MODEL JSON')
+    ap.add_argument('--stdin', action='store_true', help='read JSON {mode,intents,pages,model} from stdin')
+    ap.add_argument('--json', action='store_true', help='machine-readable (default when --stdin/--from-model)')
+    args = ap.parse_args()
+
+    model = None
+    intents = list(args.intent or [])
+    mode = args.mode
+    pages = args.pages
+
+    if args.stdin:
+        raw = sys.stdin.read()
+        data = json.loads(raw) if raw.strip() else {}
+        mode = mode or data.get('mode')
+        intents = intents or list(data.get('intents') or [])
+        pages = pages if pages is not None else data.get('pages')
+        model = data.get('model') or data if 'sections' in data else None
+
+    if args.from_model:
+        model = json.loads(Path(args.from_model).read_text(encoding='utf-8'))
+        mode = mode or model.get('mode')
+
+    if not mode:
+        ap.error('--mode is required (or provide via --from-model/--stdin)')
+
+    rows = recommend(mode, intents, pages, model)
+    as_json = args.json or args.stdin or bool(args.from_model)
+    payload = {'mode': _norm_mode(mode), 'pages': rows}
+    if as_json:
+        print(json.dumps(payload, ensure_ascii=False, indent=2))
+    else:
+        print(f"# recommend_layout · mode={payload['mode']}"
+              + (f" · intents={intents!r}" if intents else '')
+              + (f" · pages={pages}" if pages else ''))
+        print(f"{'#':>3}  {'pageType':<14} {'skel':<6} {'chart':<12} {'v':<4} rationale")
+        for r in rows:
+            print(f"{r['page']:>3}  {r['pageType']:<14} {r['skel']:<6} "
+                  f"{str(r.get('chart') or '—'):<12} {str(r.get('v') or '—'):<4} "
+                  f"{r.get('rationale') or ''}")
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

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

@@ -240,7 +240,7 @@ def main() -> int:
         fails.append('dark-theme')
 
     # ⑥ 双通道交叉裁判（python-pptx）：放在探针之后，A/B 产物齐全时才逐页比对
-    r4 = run([PY, str(ROOT / 'scripts' / 'cross_verify.py')])
+    r4 = run([PY, str(ROOT / 'scripts' / 'cross_verify.py')] + (['--full-ab'] if '--full-ab' in sys.argv else []))
     if r4.returncode == 2:
         print('  [cross_verify] SKIP（python-pptx 未安装，可选第三方裁判）')
         skipped.append('cross-verify')

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

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# TopPPT HTML · PPTX 轻量冒烟（Batch 2）
+# extract_model → build_pptx → validate_pptx --strict --model=
+# 用法: bash scripts/smoke_pptx.sh [example.html]
+set -euo pipefail
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+HTML="${1:-assets/examples/2026-09-09-presentation-business-blue.html}"
+if [[ ! -f "$HTML" ]]; then
+  echo "smoke_pptx: missing $HTML" >&2
+  exit 2
+fi
+STEM="$(basename "$HTML" .html)"
+OUT_DIR="${TMPDIR:-/tmp}/top-ppt-html-smoke"
+mkdir -p "$OUT_DIR"
+MODEL="$OUT_DIR/${STEM}.model.json"
+PPTX="$OUT_DIR/${STEM}.pptx"
+
+echo "== smoke_pptx =="
+echo "HTML  $HTML"
+python3 scripts/extract_model.py "$HTML" "$MODEL"
+echo "MODEL $MODEL ($(wc -c < "$MODEL") bytes)"
+
+# Prefer local node_modules pptxgenjs
+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"

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

@@ -115,13 +115,15 @@ def build_const_block(lc: dict) -> str:
     img_js = 'var IMG = ' + json.dumps(_strip_comments(lc.get('imageSpec') or {}), ensure_ascii=False,
                                        separators=(',', ':')) + ';'
     # 页型布局区域 IR（与 scripts/lib_layout_regions.js 同源公式；浏览器端 A 通道消费）
-    slots_path = ROOT / 'scripts' / 'layout_slots.json'
-    slots = {}
-    if slots_path.exists():
-        try:
-            slots = json.loads(slots_path.read_text(encoding='utf-8'))
-        except json.JSONDecodeError:
-            slots = {}
+    # Batch 3: layoutSlots 单源 = layout-constants.json（不再读独立 layout_slots.json）
+    slots = lc.get('layoutSlots') or {}
+    if not slots:
+        slots_path = ROOT / 'scripts' / 'layout_slots.json'  # 兼容过渡
+        if slots_path.exists():
+            try:
+                slots = json.loads(slots_path.read_text(encoding='utf-8'))
+            except json.JSONDecodeError:
+                slots = {}
     slots_js = 'var LAYOUT_SLOTS = ' + json.dumps(_strip_comments(slots), ensure_ascii=False,
                                                   separators=(',', ':')) + ';'
     region_fn = r'''
@@ -528,28 +530,27 @@ def main() -> int:
             print(f'警告: {eng_name} 未见图片版式 {eng_missing_lay}（imageSpec 已登记但引擎未提及）')
             ok = False
 
-    # ⑩ 页型布局 IR（layout_slots.json）：高频页型槽位完整性
-    slots_path = ROOT / 'scripts' / 'layout_slots.json'
+    # ⑩ 页型布局 IR（LC.layoutSlots）：高频页型槽位完整性
     n_slots = 0
-    if not slots_path.exists():
-        print('警告: 缺 scripts/layout_slots.json（页型布局 IR 单源）')
+    slots_doc = lc.get('layoutSlots') or {}
+    if not slots_doc.get('pageTypes'):
+        print('警告: layout-constants.json 缺 layoutSlots.pageTypes（页型布局 IR 单源）')
         ok = False
     else:
         try:
-            slots_doc = json.loads(slots_path.read_text(encoding='utf-8'))
             slots_pages = slots_doc.get('pageTypes') or {}
             for pt_name, pt_def in slots_pages.items():
                 if pt_name not in schema_types:
-                    print(f'警告: layout_slots 页型 {pt_name!r} 不在 schema.pageTypes')
+                    print(f'警告: layoutSlots 页型 {pt_name!r} 不在 schema.pageTypes')
                     ok = False
                 slot_list = pt_def.get('slots') or []
                 if not slot_list:
-                    print(f'警告: layout_slots 页型 {pt_name!r} 无槽位定义')
+                    print(f'警告: layoutSlots 页型 {pt_name!r} 无槽位定义')
                     ok = False
                     continue
                 ids = [s.get('id') for s in slot_list]
                 if 'head' not in ids or not any(s.get('role') == 'primary' for s in slot_list):
-                    print(f'警告: layout_slots 页型 {pt_name!r} 缺 head 或 primary 槽位')
+                    print(f'警告: layoutSlots 页型 {pt_name!r} 缺 head 或 primary 槽位')
                     ok = False
             n_slots = len(slots_pages)
             # 布局 IR 模块存在性（B 通道 require）
@@ -559,7 +560,7 @@ def main() -> int:
                 ok = False
             else:
                 ir_txt = ir_mod.read_text(encoding='utf-8')
-                for key in ('regionOf', 'layout_slots.json', 'layout-constants.json'):
+                for key in ('regionOf', 'layoutSlots', 'layout-constants.json'):
                     if key not in ir_txt:
                         print(f'警告: lib_layout_regions.js 缺少 {key!r} 引用')
                         ok = False
@@ -603,7 +604,7 @@ process.exit(bad ? 1 : 0);
                 except Exception as exc:
                     print(f'警告: 布局 IR 烟测未执行: {exc}')
         except json.JSONDecodeError as exc:
-            print(f'警告: layout_slots.json 解析失败: {exc}')
+            print(f'警告: layoutSlots 解析失败: {exc}')
             ok = False
             n_slots = 0
 
@@ -618,14 +619,10 @@ process.exit(bad ? 1 : 0);
         if ms.get('version') != ver:
             print(f'警告: model-schema.json version={ms.get("version")!r} ≠ layout-constants.json {ver!r}')
             ok = False
-        try:
-            slots_ver = (json.loads((ROOT / 'scripts' / 'layout_slots.json').read_text(encoding='utf-8'))
-                         .get('version'))
-            if slots_ver != ver:
-                print(f'警告: layout_slots.json version={slots_ver!r} ≠ {ver!r}')
-                ok = False
-        except (OSError, json.JSONDecodeError):
-            pass  # ⑩ 已告警
+        slots_ver = (lc.get('layoutSlots') or {}).get('version')
+        if slots_ver and slots_ver != ver:
+            print(f'警告: layoutSlots.version={slots_ver!r} ≠ layout-constants {ver!r}')
+            ok = False
         try:
             pj_ver = json.loads((ROOT / 'package.json').read_text(encoding='utf-8')).get('version')
             if not str(pj_ver or '').startswith(f'{ver}.'):

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

@@ -530,6 +530,35 @@ def title_anchor_info(shapes: list[ET.Element]) -> dict[str, Any] | None:
     }
 
 
+
+def chrome_footer_y_in(shapes: list[ET.Element], height: int) -> float | None:
+    """页码 chrome y（英寸）：只认页码形文本（如 3 / 14），避免把 so-what/图注当页脚。"""
+    zones = ((json.loads(Path(__file__).with_name("layout-constants.json").read_text(encoding="utf-8"))
+              .get("layoutSystem") or {}).get("zones") or {})
+    chrome = zones.get("chromePct") or [18, 24]
+    bottom_frac = float(chrome[1] if isinstance(chrome, list) and len(chrome) > 1 else 24) / 100.0
+    threshold = int(height * (1.0 - bottom_frac))
+    ys: list[float] = []
+    pager = re.compile(r"^\s*\d+\s*/\s*\d+\s*$|^\s*\d+\s*$")
+    for shape in shapes:
+        text = (text_content(shape) or "").strip()
+        box = shape_bounds(shape)
+        if not text or box is None:
+            continue
+        _x, y, _cx, _cy = box
+        if y < threshold:
+            continue
+        if not pager.match(text):
+            continue
+        sizes = font_sizes_pt(shape)
+        if sizes and max(sizes) > 14:
+            continue
+        ys.append(y / 914400.0)
+    if not ys:
+        return None
+    return round(sum(ys) / len(ys), 4)
+
+
 def anchor_check(shapes: list[ET.Element], slide_no: int, width: int) -> list[dict[str, Any]]:
     """空间锚点注册（深度模式）：标题/页头块的左边距必须对齐版心左边界。
 
@@ -728,6 +757,7 @@ def inspect_slide(
         "font_sizes_pt": sorted({round(v, 2) for v in _all_run_sizes(root)}),
         "text_characters": len(combined_text),
         "anchor": title_anchor_info(shapes),
+        "chrome_footer_y_in": chrome_footer_y_in(shapes, height),
     }
     return metrics, warnings
 
@@ -1105,6 +1135,42 @@ def promote_strict_failures(report: dict[str, Any], deep: bool = False) -> None:
         existing.add(key)
 
 
+
+def validate_chrome_drift(slides: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    """跨页 chrome（页脚/页码）y 一致性：相对中位数漂移超过 chromeDriftIn → WARN。
+
+    封面/收尾页版式不同（常无页脚或 y 不同）豁免；仅比内容页。严格交付下任意 WARN 会挡
+    smoke，故容差偏宽、只抓明显漂移。
+    """
+    out: list[dict[str, Any]] = []
+    if len(slides) < 4:
+        return out
+    first_n = slides[0].get("slide")
+    last_n = slides[-1].get("slide")
+    ys = [(s.get("slide"), s.get("chrome_footer_y_in"))
+          for s in slides
+          if s.get("chrome_footer_y_in") is not None
+          and s.get("slide") not in (first_n, last_n)]
+    if len(ys) < 3:
+        return out
+    vals = sorted(y for _, y in ys)
+    mid = vals[len(vals) // 2]
+    try:
+        lc = json.loads(Path(__file__).with_name("layout-constants.json").read_text(encoding="utf-8"))
+        max_delta = float(((lc.get("qualityGates") or {}).get("chromeDriftIn") or {}).get("maxAbsDeltaIn") or 0.2)
+    except (OSError, json.JSONDecodeError, TypeError, ValueError):
+        max_delta = 0.2
+    drifted = [(n, y) for n, y in ys if abs(float(y) - mid) > max_delta]
+    for n, y in drifted[:4]:
+        out.append(issue(
+            "CHROME_DRIFT",
+            f"第{n}页页脚/页码 y={y:.3f}in 相对中位 {mid:.3f}in 漂移 {abs(y-mid):+.3f}in "
+            f"（容差 {max_delta}in）；跨页 chrome 应锁死几何。",
+            slide=n,
+        ))
+    return out
+
+
 def validate_pptx(
     path: str | Path,
     model_path: str | Path | None = None,
@@ -1209,6 +1275,9 @@ def validate_pptx(
             for field in ("native_text_shapes", "native_graphic_shapes", "pictures", "charts", "tables"):
                 report["summary"][field] = sum(slide[field] for slide in report["slides"])
 
+            # P1-6 chrome 一致性：页脚/页码 y 相对中位数漂移
+            report["warnings"].extend(validate_chrome_drift(report["slides"]))
+
             # 图片门禁：默认零图片（pictures=0 全原生可编辑）；
             # 仅当模型显式声明 section.image / split.right.image 时才允许对应数量的图片落地。
             # 配图占位（image.placeholder）走原生形状，不计入图片数；版式/裁切/多图数量另做硬门禁。