@topmindspace/tms-skills 0.1.4 → 0.1.5

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