@topmindspace/tms-skills 0.1.1 → 0.1.2

package/top-ppt-html/scripts/build_pptx.js

@@ -1588,6 +1588,11 @@ function addTable(s, tbl, x, y, w, availH, opts) {
 /* 章节页 · 按页型分发 */
 CONTENT.sections.forEach((sec) => {
   const type = sec.type || 'points';
+  // Batch 2: honor layoutPreset (scaffold/recommend_layout → PPTX IR alignment)
+  if (!sec.layoutPreset) {
+    const _p2p = (LC.layoutSystem && LC.layoutSystem.pageToPreset) || {};
+    if (_p2p[type]) sec.layoutPreset = _p2p[type];
+  }
   const s = base();
   if (type !== 'quote') head(s, sec.eyebrow, sec.title, sec.lead);
 
@@ -2319,6 +2324,7 @@ CONTENT.sections.forEach((sec) => {
   if (sec.items) _notes.push('达成对比：' + sec.items.map(it => it[0] + ' ' + it[1] + (it[2] != null ? '/' + it[2] : '')).join('；'));
   if (sec.levels) _notes.push('层级：' + sec.levels.map(l => (isRec(l) ? l.t : l[0]) || '').join(' → '));
   if (sec.soWhat) _notes.push('So what：' + sec.soWhat);
+  if (sec.layoutPreset) _notes.push('布局骨架：' + sec.layoutPreset);
   if (flagItems.length) _notes.push('待核实（需二次确认）：' + flagItems.join('；'));
   if (sec.note) _notes.push('注：' + sec.note);
   if (sec.footnote) _notes.push('来源：' + sec.footnote);

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

@@ -83,6 +83,45 @@ def variety_floor(mode: str, n_chart_pages: int, variety: dict | None = None) ->
     return min(floor, max(1, int(-(-n_chart_pages * ratio // 1))))
 
 
+
+def core_charts(lc: dict | None = None) -> list[str]:
+    lc = lc or load_lc()
+    ls = lc.get('layoutSystem') or {}
+    return list(ls.get('defaultCharts') or
+                ['bar', 'hbar', 'line', 'donut', 'progress', 'area', 'stack', 'dualline'])
+
+
+def advanced_charts(lc: dict | None = None) -> set[str]:
+    lc = lc or load_lc()
+    ls = lc.get('layoutSystem') or {}
+    return set(ls.get('advancedCharts') or [])
+
+
+def variety_core_preference(used: list[str], variety: dict | None = None,
+                            lc: dict | None = None) -> str | None:
+    """preferCoreFirst：advanced 已用但核图多样性不足 → WARN 文案。
+
+    advanced 仍计入 minTypes（不罚）；仅提示勿用冷门图凑下限。
+    """
+    v = variety if variety is not None else chart_variety(lc)
+    if not v.get('preferCoreFirst'):
+        return None
+    core = set(core_charts(lc))
+    adv = advanced_charts(lc)
+    distinct = set(used)
+    core_used = distinct & core
+    adv_used = distinct & adv if adv else (distinct - core)
+    if not adv_used:
+        return None
+    floor_hint = int(v.get('corePreferMin') or 3)
+    if len(core_used) >= min(floor_hint, len(core)):
+        return None
+    return (
+        f"核图仅 {sorted(core_used) or '∅'}（建议先 ≥{floor_hint} 种核图拉开多样性）；"
+        f"已用 advanced {sorted(adv_used)}——允许计入 minTypes，但勿为凑下限而选用；"
+        f"仅内容意图命中时用 advanced"
+    )
+
 def adjacent_same_type(pages: list[list[str]]) -> list[str]:
     """相邻图表页同型告警文案列表。"""
     adj, prev, prev_i = [], None, 0

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

@@ -8,7 +8,7 @@
 ③ 文本溢出启发式：文本估算宽 vs shape 宽 × 可容行数
 ④ B 通道原生图表数值 ↔ 模型数值（类别标签一致不代表数值一致；数值错乱只能这里拓）
 ⑤ 字号比例尺同源：B 的字号必须是 A 字号集的子集（防 modeSize()/sz() 后处理漂移）
-用法：先 node scripts/gen_channel_a.js 生成 A 通道产物，再 python scripts/cross_verify.py
+默认 SKIP；加 --full-ab 才执行。用法：先 node scripts/gen_channel_a.js 生成 A 通道产物，再 python scripts/cross_verify.py
 改 pptx-export.js 序列化骨架后必跑（见 references/pptx-export.md 双裁判教训）。
 """
 import json
@@ -291,4 +291,8 @@ def main() -> int:
 
 
 if __name__ == '__main__':
+    # Batch 2: A/B 全文对等默认关闭；显式 --full-ab 才跑（Fast/标准交付不依赖）
+    if '--full-ab' not in sys.argv:
+        print('cross_verify: SKIP（默认关闭；需要 A/B 全文对等时加 --full-ab）')
+        sys.exit(0)
     sys.exit(main())

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

@@ -118,9 +118,9 @@ TASK_ROUTES = {
         ],
     },
     'icons': {
-        'desc': '图标语义速查与使用准则',
+        'desc': '图标语义选型 / 禁区 / 尺寸 / 高频 SVG（完整枚举见归档，不预读）',
         'reads': [
-            ('icons.md', ['速查', '使用准则']),
+            ('icons.md', ['使用准则', '速查', '高频取码']),
         ],
     },
 }

package/top-ppt-html/scripts/layout-constants.json

@@ -54,7 +54,7 @@
     "micro": 10
   },
   "modeTypeScale": {
-    "$comment": "三模式独立排版比例尺（pt）。research=咨询密排（正文 10.5pt、标题 22pt）；architecture 与 presentation 同基。序列化器按「调用点基准 pt → 最接近 typeScale 角色」映射到当前模式取值。",
+    "$comment": "三模式独立排版比例尺（pt）。默认按中型会议室投影。小会议室可保持原值；礼堂/大报告厅宜更大标题档、更少每页单元（见 pptx-export 会场节）。research=咨询密排（正文 10.5pt、标题 22pt）；architecture 与 presentation 同基。",
     "presentation": {
       "coverTitle": 44,
       "coverSub": 18,
@@ -820,7 +820,7 @@
       }
     },
     "variety": {
-      "$comment": "图表多样性预算（validate_report.py 与 evals/run_evals.py 消费）——治「图表定义 36 种、实际只用 bar/line/donut」。类型数下限 = min(minTypes[模式], max(1, ⌈图表页数 × minTypesRatio⌉))；noRepeatAdjacent = 相邻图表页不得同 data-chart；compositeMinRatio/compositeModes = 组合版式（内容页含 ≥2 种承载类型）比例下限与适用模式（治「单件页当默认」，只对 research 生效：A 演示按契约每屏一主张，C 架构恒为一页一图）。判据与选型见 references/playbook.md §四/§五。",
+      "$comment": "图表多样性预算（validate_report.py 与 evals/run_evals.py 消费）——治「图表定义 36 种、实际只用 bar/line/donut」。类型数下限 = min(minTypes[模式], max(1, ⌈图表页数 × minTypesRatio⌉))；noRepeatAdjacent = 相邻图表页不得同 data-chart；compositeMinRatio/compositeModes 只对 research 生效（A 演示一屏一主张，C 架构一页一图）。preferCoreFirst：多样性宜先拉开 layoutSystem.defaultCharts（核图 8）；advanced 图种在使用时同样计入 minTypes（不因用 advanced 受罚），但仅当内容意图命中时选用，禁为凑下限硬上冷门图。禁反模式：简单图全幅、极偏 donut/pie（见 layout-qa / sizeByComplexity）。判据与选型见 references/playbook.md §五。",
       "minTypes": {
         "presentation": 4,
         "research": 6,
@@ -831,7 +831,9 @@
       "compositeMinRatio": 0.3,
       "compositeModes": [
         "research"
-      ]
+      ],
+      "preferCoreFirst": true,
+      "corePreferMin": 3
     },
     "registry": {
       "$comment": "图表登记四元组：pptx=native 走 addChart（真 chart part + 内嵌 Excel，双击可编辑数据）；pptx=shape 走 OOXML 原生形状/SVG path 高保真还原，且**必须**按 dataTable 策略附数据表保证数据可追溯；nativeTrick = 用原生图表技巧实现的类型；path = 形状还原的几何约束（采样点下限 / 双边界追踪 / 禁预设形状）。build_pptx.js 与 pptx-export.js 双引擎按本表分派，validate_pptx.py 按本表断言。",
@@ -1218,15 +1220,16 @@
     }
   },
   "checkBudgets": {
-    "$comment": "单页预算（validate_report.py 消费）：char 单页纯文字上限 / unit 并列单元上限 / empty 过空页阈值 / fit 满屏页文字上限 / wrap 版心宽度断言 / trow 表格行数上限。bodyPx 供页高溢出静态估算（HTML 正文基准 px，与 modes 契约一致）。",
+    "$comment": "单页预算（validate_report 消费）：char=文字量预警（WARN，非「字多就删」）；unit=并列单元预警；empty=过空页 FAIL；fit=满屏页文字；wrap=版心；trow=表行。Mode A 密卡/列表页允许偏密；超 char 先走 overflowRule，不对字数单独 FAIL。",
     "presentation": {
-      "char": 1500,
+      "char": 1800,
       "unit": 8,
       "empty": 80,
       "fit": 1000,
       "wrap": 1400,
       "trow": 8,
-      "bodyPx": 17
+      "bodyPx": 17,
+      "$comment": "预警阈值；结构合理的密页可接近此值；溢出无拆页→ layout-qa FAIL"
     },
     "research": {
       "char": 3200,
@@ -1323,9 +1326,9 @@
       "lineFactor": 1.45,
       "emAsciiRatio": 0.52
     },
-    "overflowRule": "溢出处置优先级：① 优化内容（列表化/精炼/合并/拆页/换组合版式）→ ② 调整容器尺寸与行宽 → ③ 有限度缩小字号（见 fontShrink）→ ④ 仍装不下则拆页。禁止无限缩字号硬塞，也禁止把「精简」当第一手段砍掉决策必需信息。",
+    "overflowRule": "溢出处置优先级（禁静默截断）：① 重构承载（列表/卡片/表/图/组合版式）→ ② 拆页/分章（议程→主张→证据卡→明细；01a/01b；信息须完整）→ ③ 换布局形态（V1–V4/多列/卡栅格）→ ④ 有限 fontShrink（阶梯内、模式 floor 以上、最多 4 档）→ ⑤ 禁止：静默截断、砍 so-what/证据/口径、为审美稀疏删决策必需信息。单页字数预算是预警不是删字许可证。",
     "fontShrink": {
-      "$comment": "有限缩字号策略（v8.2 放松）。内容确实偏多、优化格式与措辞后仍装不下时，允许在阶梯内下探；绝对下限按模式。优先顺序永远是：列表化/精炼 → 换组合/拆页 → 最后才缩字号。",
+      "$comment": "有限缩字号（最后手段）。优先：重构承载 → 拆页/分章 → 换布局 → 最后才缩字号。最多 4 档；绝对下限按模式 floor。禁止无限缩字号，禁止用缩字号代替拆页。",
       "ladder": [
         15,
         14,
@@ -1732,8 +1735,8 @@
     ],
     "fillTarget": {
       "presentation": [
-        62,
-        78
+        58,
+        75
       ],
       "research": [
         70,
@@ -1774,15 +1777,18 @@
         ]
       },
       "list": {
-        "maxItemLines": 2,
-        "maxItemChars": 45,
+        "maxItemLines": 3,
+        "maxItemChars": 72,
         "itemGap": "sp-3",
-        "maxPerCard": 4
+        "maxPerCard": 5,
+        "$comment": "结构引导（非硬砍刀）：条目宜可读完整；超长→加行/拆项/拆页，禁省略号截断充数。maxItemChars/maxItemLines 为投影可读建议，校验不因「字多」单独 FAIL。",
+        "preferItemChars": 45
       },
       "card": {
         "padToken": "sp-5",
         "equalHeight": true,
-        "maxBullets": 4
+        "maxBullets": 5,
+        "$comment": "maxBullets 为建议；更多→拆卡/跟进页，勿截断条目。"
       },
       "metric": {
         "perRow": [
@@ -1837,11 +1843,73 @@
         "a-end",
         "align-items"
       ],
-      "requireOnMixed": true
+      "requireOnMixed": true,
+      "$comment": "混排须显式对齐类；layout-qa 另检列节奏（多列网格共享顶边/左缘意图）。",
+      "requireColumnRhythm": true
+    },
+    "fillTargetComment": "填充率目标带。Mode A 大气留白：cover/section/quote/closing 等休止页为 intentional whitespace，不按 underfill/FILL_LOW 惩罚（见 qualityGates.underfill.exemptIds + validate LAYOUT_FILL 轻量页豁免）。内容页半空仍属 underfill。硬规则守舞台；自适应留给内容。",
+    "modeSkels": {
+      "$comment": "Mode A 主力骨架 = P1–P4 + P6/P10；P7–P9、P11–P12 为 A 次级（research/architecture 场景下可升主力）。P5 三卡为 A 常用扩展（非默认轮换）。次级仍合法、文档与画廊可引用，禁止删除。",
+      "presentation": {
+        "primary": [
+          "P1",
+          "P2",
+          "P3",
+          "P4",
+          "P6",
+          "P10"
+        ],
+        "secondary": [
+          "P7",
+          "P8",
+          "P9",
+          "P11",
+          "P12"
+        ],
+        "extended": [
+          "P5"
+        ]
+      },
+      "research": {
+        "primary": [
+          "P5",
+          "P7",
+          "P8",
+          "P4",
+          "P6"
+        ],
+        "secondary": [
+          "P1",
+          "P2",
+          "P3",
+          "P9",
+          "P10",
+          "P11",
+          "P12"
+        ]
+      },
+      "architecture": {
+        "primary": [
+          "P9",
+          "P10",
+          "P11"
+        ],
+        "secondary": [
+          "P1",
+          "P2",
+          "P3",
+          "P4",
+          "P5",
+          "P6",
+          "P7",
+          "P8",
+          "P12"
+        ]
+      }
     }
   },
   "qualityGates": {
-    "$comment": "v9 硬门禁阈值（validate_report / validate_pptx / quality_gate 消费）。tagLeakPatterns = 可见文本中禁止出现的 HTML 源码片段；titleOnly = 去页头后正文字符上限（低于即 TITLE_ONLY_PAGE）；underfillCarriers = 承载组件数下限；roundtripMin = 模型代表性文本落页覆盖率下限（原 0.50 过松，放行截断）；chartSkew = 极偏占比禁 donut/pie；chartOversize = 简单图占内容区面积上限。",
+    "$comment": "v9+ 硬门禁。tagLeakPatterns / titleOnly / underfill / roundtripMin / chartSkew / chartOversize 同前。antiTruncation：截断迹象与溢出未拆页；chromeDriftIn：跨页 chrome y 容差（英寸）。",
     "tagLeakPatterns": [
       "<a ",
       "</a>",
@@ -1866,8 +1934,11 @@
         "refs",
         "appendix",
         "next",
-        "closing"
-      ]
+        "closing",
+        "section",
+        "chapter"
+      ],
+      "$comment": "intentional whitespace 豁免：封面/章节幕/金句/收尾/参考资料等休止页不要求承载数下限；其余内容页半空 = underfill FAIL。"
     },
     "roundtripMin": 0.8,
     "chartSkew": {
@@ -1885,6 +1956,28 @@
       "simpleMaxCats": 2,
       "simpleMaxPts": 3,
       "maxContentAreaPct": 55
+    },
+    "antiTruncation": {
+      "$comment": "截断/内容损失启发式。ellipsisInContent=正文/列表中的截断省略号；overflowNoSplit 与 layout-qa 同源。",
+      "ellipsisPatterns": [
+        "…",
+        "...",
+        "……",
+        "…。",
+        "...。"
+      ],
+      "forbidEllipsisTruncate": true,
+      "overflowNoSplitFail": true
+    },
+    "chromeDriftIn": {
+      "$comment": "PPTX 内容页页脚/页码 y 相对中位数漂移超过此值（英寸）→ WARN CHROME_DRIFT。封面/收尾豁免。默认 0.2in，抓明显漂移、不挡正常页型微差。",
+      "maxAbsDeltaIn": 0.2
+    },
+    "halfEmpty": {
+      "$comment": "半空卡：同页多卡时，正文过短的卡占比过高 → layout-qa WARN/FAIL。",
+      "minCards": 3,
+      "shortPlainChars": 12,
+      "maxShortRatio": 0.5
     }
   },
   "imageAdmission": {

package/top-ppt-html/scripts/lib_layout_regions.js

@@ -1,12 +1,11 @@
 /**
  * TopPPT HTML · 页型布局区域 IR（双通道几何收敛起点）
  *
- * 从 layout-constants.json + layout_slots.json 派生「语义槽位 → 英寸矩形」。
- * B 通道（build_pptx.js）直接 require；A 通道消费同一 LC 常量（数字同源），
- * 本模块是把「槽位语义」从散落坐标收拢成可测接口的第一步。
+ * 从 layout-constants.json（含 layoutSlots）派生「语义槽位 → 英寸矩形」。
+ * B 通道（build_pptx.js）直接 require；A 通道消费同一 LC 常量（数字同源）。
  *
- * 纪律：改几何只改 layout-constants.json；改槽位只改 layout_slots.json。
- * 新增页型先扩 layout_slots.json，再在此补 regionOf 分支，最后写双引擎。
+ * 纪律：改几何与槽位只改 layout-constants.json（layoutSlots 已并入）。
+ * 新增页型先扩 LC.layoutSlots，再在此补 regionOf 分支，最后写双引擎。
  */
 'use strict';
 
@@ -15,10 +14,9 @@ const path = require('path');
 
 const ROOT = path.join(__dirname, '..');
 const LC = JSON.parse(fs.readFileSync(path.join(__dirname, 'layout-constants.json'), 'utf8'));
-// 布局 IR：优先 layout-constants.layoutSlots（v9 单源合并）；否则回落 layout_slots.json
-let SLOTS = LC.layoutSlots;
+const SLOTS = LC.layoutSlots;
 if (!SLOTS || !SLOTS.pageTypes) {
-  SLOTS = JSON.parse(fs.readFileSync(path.join(__dirname, 'layout_slots.json'), 'utf8'));
+  throw new Error('layout-constants.json 缺 layoutSlots.pageTypes（Batch 3 单源）');
 }
 
 const INFO_TYPES = {
@@ -387,7 +385,7 @@ function regionOf(pageType, slotId, opts) {
   return null;
 }
 
-/** 槽位是否在 layout_slots.json 中声明为 required */
+/** 槽位是否在 LC.layoutSlots 中声明为 required */
 function slotRequired(pageType, slotId) {
   const def = (SLOTS.pageTypes || {})[pageType];
   if (!def) return false;

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

@@ -20,6 +20,9 @@
   N12 模型 theme 与 data-theme 矛盾
   N13 模型 mode 与 data-mode 矛盾
   N14 内部锚点断裂（链接目标 id 不存在）
+  L4  截断迹象（列表项省略号砍义）
+  L5  溢出未拆页
+  L6  混排缺对齐（ALIGN_RHYTHM）
 
 用法: python scripts/negative_tests.py
 """
@@ -62,6 +65,25 @@ def expect_fail(name: str, path: Path, keyword: str) -> bool:
     return ok
 
 
+
+def expect_layout_qa_fail(name: str, path: Path, keyword: str) -> bool:
+    """Run validate_report --strict --layout-qa and require FAIL containing keyword."""
+    r = subprocess.run(
+        [PY, str(ROOT / 'scripts' / 'validate_report.py'), str(path),
+         '--strict', '--layout-qa'],
+        capture_output=True, text=True, encoding='utf-8', errors='replace')
+    out = (r.stdout or '') + (r.stderr or '')
+    hit = [ln for ln in out.splitlines()
+           if keyword in ln and ('[FAIL]' in ln or 'FAIL' in ln)]
+    ok = r.returncode != 0 and bool(hit)
+    print(f'  [{"OK" if ok else "FAIL"}] {name}')
+    if hit:
+        print(f'        抓到: {hit[0].strip()[:120]}')
+    elif not ok:
+        print(f'        layout-qa 未触发（期望含「{keyword}」）')
+    return ok
+
+
 def main() -> int:
     base = ROOT / 'assets' / 'examples' / '2026-09-09-research-mckinsey.html'
     if not base.exists():
@@ -163,7 +185,111 @@ def main() -> int:
         p.write_text(content, encoding='utf-8')
         ok = expect_fail(name, p, keyword) and ok
 
-    ok = _pptx_notes_case() and ok
+
+    # ── Batch 2 · layout-qa 专用负例 ─────────────────────────────────────
+    # L1 管线产物缺 data-skel：先造带 skel 的页，再撕掉其中一页的标记
+    import tempfile
+    scaf = OUT / 'L1-scaffold.html'
+    subprocess.run(
+        [PY, str(ROOT / 'scripts' / 'scaffold_report.py'),
+         '--mode', 'presentation', '--style', 'business-blue', '--theme', 'light',
+         '--title', 'LayoutQA Neg', '--sections', '5', '--out', str(scaf)],
+        capture_output=True, text=True)
+    if scaf.exists() and 'data-skel="' in scaf.read_text(encoding='utf-8'):
+        t_l1 = scaf.read_text(encoding='utf-8')
+        # 撕掉第一个内容页的 data-skel
+        t_l1b = re.sub(r'(id="s1") data-skel="P\d+"', r'\1', t_l1, count=1)
+        p_l1 = OUT / 'L1-missing-skel.html'
+        p_l1.write_text(t_l1b, encoding='utf-8')
+        ok = expect_layout_qa_fail('L1 缺 data-skel', p_l1, 'LAYOUT_QA_MISSING_SKEL') and ok
+        # L2 连续 3 页同一 skel
+        t_l2 = t_l1
+        # force s1,s2,s3 all P4
+        t_l2 = re.sub(r'(id="s1"[^>]*data-skel=")P\d+"', r'\1P4"', t_l2, count=1)
+        t_l2 = re.sub(r'(id="s2"[^>]*data-skel=")P\d+"', r'\1P4"', t_l2, count=1)
+        t_l2 = re.sub(r'(id="s3"[^>]*data-skel=")P\d+"', r'\1P4"', t_l2, count=1)
+        # also rewrite if attribute order is data-skel before id
+        t_l2 = re.sub(r'(data-skel=")P\d+(" data-page-type="[^"]+" id="s1")', r'\1P4\2', t_l2)
+        t_l2 = re.sub(r'(data-skel=")P\d+("([^>]*) id="s1")', r'\1P4\2', t_l2)
+        # simpler: replace first three data-skel values
+        def _force_p4(src, n=3):
+            out, c = [], 0
+            for part in re.split(r'(data-skel="P\d+")', src):
+                if part.startswith('data-skel="') and c < n:
+                    out.append('data-skel="P4"'); c += 1
+                else:
+                    out.append(part)
+            return ''.join(out)
+        t_l2 = _force_p4(t_l1, 3)
+        p_l2 = OUT / 'L2-skel-streak.html'
+        p_l2.write_text(t_l2, encoding='utf-8')
+        ok = expect_layout_qa_fail('L2 连续同 skel', p_l2, 'LAYOUT_QA_SKEL_STREAK') and ok
+        # L3 极偏 donut in REPORT_MODEL
+        t_l3 = t_l1
+        if 'window.REPORT_MODEL' in t_l3:
+            # inject a skewed donut section into model JSON
+            inj = (
+                '{"type":"donut","title":"极偏环",'
+                '"chart":{"type":"donut","labels":["A","B"],"values":[0.5,99.5]}},'
+            )
+            t_l3 = re.sub(r'("sections"\s*:\s*\[)', r'\1' + inj, t_l3, count=1)
+            p_l3 = OUT / 'L3-skew-donut.html'
+            p_l3.write_text(t_l3, encoding='utf-8')
+            ok = expect_layout_qa_fail('L3 极偏 donut', p_l3, 'LAYOUT_QA_SKEW_DONUT') and ok
+
+        # L4 截断迹象：列表项以省略号砍义
+        t_l4 = t_l1
+        inj4 = '<div class="card"><ul><li class="card__li">这项证据其实很长但被故意截断了…</li></ul></div>'
+        t_l4 = re.sub(r'(id="s1"[^>]*>)', lambda m: m.group(1) + inj4, t_l4, count=1)
+        p_l4 = OUT / 'L4-truncation.html'
+        p_l4.write_text(t_l4, encoding='utf-8')
+        ok = expect_layout_qa_fail('L4 截断迹象', p_l4, 'LAYOUT_QA_TRUNCATION') and ok
+
+        # L5 溢出未拆页：塞入超长正文使页高估算爆掉且无续页信号
+        t_l5 = t_l1
+        wall = '论证要点' + ('详细证据与口径说明，必须完整保留不得删减。' * 40)
+        t_l5 = re.sub(
+            r'(id="s1"[^>]*>)',
+            lambda m: m.group(1) + '<div class="card"><p>' + wall + '</p></div>'
+                 + '<div class="card"><p>' + wall + '</p></div>'
+                 + '<div class="card"><p>' + wall + '</p></div>',
+            t_l5, count=1)
+        p_l5 = OUT / 'L5-overflow-nosplit.html'
+        p_l5.write_text(t_l5, encoding='utf-8')
+        ok = expect_layout_qa_fail('L5 溢出未拆页', p_l5, 'LAYOUT_QA_OVERFLOW_NO_SPLIT') and ok
+
+        # L6 混排缺对齐：图+卡同页但无对齐类
+        t_l6 = t_l1
+        inj6 = (
+            '<div class="grid g-2">'
+            '<div class="fig"><svg class="chart" data-chart="bar" style="height:200px"></svg></div>'
+            '<div class="card"><ul><li>证据甲</li><li>证据乙</li></ul></div>'
+            '</div>'
+        )
+        t_l6 = re.sub(r'(id="s1"[^>]*>)', lambda m: m.group(1) + inj6, t_l6, count=1)
+        # 撕掉 s1 段内对齐类，确保 ALIGN_RHYTHM 能抓住
+        def _strip_align_s1(src: str) -> str:
+            m = re.search(r'(<section[^>]*id="s1"[^>]*>)([\s\S]*?)(</section>)', src)
+            if not m:
+                # attribute order may be data-skel before id
+                m = re.search(r'(<section[^>]*id="s1"[^>]*>)([\s\S]*?)(</section>)', src)
+            if not m:
+                return src
+            body = m.group(2)
+            body = re.sub(r'\ba-start\b', '', body)
+            body = re.sub(r'\ba-c\b', '', body)
+            body = re.sub(r'\ba-end\b', '', body)
+            body = body.replace('align-items:start', '').replace('align-items: center', '')
+            return src[:m.start()] + m.group(1) + body + m.group(3) + src[m.end():]
+        t_l6 = _strip_align_s1(t_l6)
+        p_l6 = OUT / 'L6-align-rhythm.html'
+        p_l6.write_text(t_l6, encoding='utf-8')
+        ok = expect_layout_qa_fail('L6 混排缺对齐', p_l6, 'LAYOUT_QA_ALIGN_RHYTHM') and ok
+
+    else:
+        print('  [SKIP] layout-qa 负例（scaffold 未产出 data-skel）')
+
+        ok = _pptx_notes_case() and ok
     ok = _chart_data_case() and ok
     ok = _title_pattern_case() and ok
     ok = _font_scale_case() and ok

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

@@ -17,14 +17,14 @@
     README.md                      人类视角的简介 / 安装 / 开发 / 打包
     package.json                   Node 依赖声明（pptxgenjs）与常用命令
     assets/templates/              三份模式模板 + engine.css / ui.js（公共片段注入源）
-    assets/examples/               9 份示例 HTML + 9 份 REPORT_MODEL（复制起点 · 覆盖全部 9 风格）
+    assets/examples/               3 份黄金样张 HTML + model（每模式 1；风格见 style-gallery）
     assets/pptx-export.js          PPTX 预览运行时（注入源）
     assets/style-gallery.html      风格 × 模式 × 亮暗主题交互画廊
     assets/theme-overview*.png     3 张主题参考图（整体 + research + architecture；演示态与整体图相同）
-    references/*.md                15 篇规范（playbook.md = 唯一常读入口 L1；其余 L2 按需加载）
+    references/*.md                规范全文（Batch3 起 ≥20 篇；playbook.md = L1；其余 L2 按需）
     scripts/                         生成 / 校验 / 回归 / 维护工具（py + js + json 单源）
     scripts/extract_snippet.py       L2 节级片段抽取（减少整读大规范）
-    scripts/layout_slots.json        页型布局 IR（高频页型语义槽位）
+    # layoutSlots 已并入 layout-constants.json（Batch 3）
 
 ────────────────────────────────────────────────────────────────────────
 不进包（构建产物 / 本地状态 / 缓存，与 .gitignore 口径一致）
@@ -42,7 +42,7 @@
 ────────────────────────────────────────────────────────────────────────
     · SKILL.md frontmatter 含 name / description；name 与分发包目录名一致；
       description 为单行双引号字符串且 ≤ 1024 字符（平台截断阈值）
-    · references（含 layout-grammar）、3 份模式模板 + engine.css / ui.js、9 组示例、3 张参考图齐全
+    · references（含 layout-grammar）、3 份模式模板 + engine.css / ui.js、3 组黄金样张、3 张参考图齐全
     · 关键脚本齐全（单源注入 / 审计 / 示例重建 / 回归 / 双校验器 / 精导 / 打包）
 """
 import fnmatch
@@ -118,27 +118,30 @@ REQUIRED = [
     'assets/templates/ui.js',
     'references/playbook.md',
     'references/layout-grammar.md',
+    'references/default-surface.md',
+    'references/presentation-craft.md',
     'references/modes.md', 'references/outline-design.md', 'references/design-system.md',
     'references/styles.md', 'references/content-rules.md', 'references/components.md',
     'references/charts.md',
     'references/infographics.md', 'references/icons.md', 'references/pptx-export.md',
     'references/high-fidelity.md', 'references/failure-modes.md',
-    'references/tech-design.md', 'references/industry-benchmark.md',
+    'references/tech-design.md',
     'scripts/env_probe.py', 'scripts/audit_docs.py', 'scripts/audit_skill.py',
     'scripts/scaffold_report.py',
+    'scripts/render_from_model.py',
+    'scripts/recommend_layout.py',
     'scripts/sync_runtime.py', 'scripts/audit_styles.py', 'scripts/build_examples.py',
     'scripts/regression.py', 'scripts/validate_report.py', 'scripts/validate_pptx.py',
     'scripts/extract_model.py', 'scripts/build_pptx.js', 'scripts/gen_channel_a.js',
     'scripts/cross_verify.py', 'scripts/prepare_images.py', 'scripts/probe_image_export.py',
     'scripts/render_compare.py', 'scripts/capture_theme_overview.js', 'scripts/package_skill.py',
-    'scripts/layout-constants.json', 'scripts/model-schema.json', 'scripts/layout_slots.json',
+    'scripts/layout-constants.json', 'scripts/model-schema.json',
     'scripts/lib_layout_regions.js', 'scripts/extract_snippet.py', 'scripts/quality_gate.py',
     'scripts/checks_html.py', 'scripts/section-file-map.json',
     'scripts/measure_height.py', 'scripts/audit_css.py', 'scripts/negative_tests.py',
     'references/components-atoms.md', 'references/layouts-research.md',
     'references/layouts-architecture.md', 'references/layouts-combo.md',
     'references/charts-basic.md', 'references/charts-extended.md', 'references/charts-discipline.md',
-    'references/design-system-engine.md',
     'references/infographics-stats.md', 'references/infographics-structure.md',
     'evals/prompts.csv', 'evals/run_evals.py', 'evals/rubric.schema.json',
     'evals/trace.example.json',
@@ -146,9 +149,9 @@ REQUIRED = [
 
 # 必须达到最小数量的集合（名称含日期，故按数量校验）
 MIN_COUNTS = {
-    'assets/examples/*.html': 9,
-    'assets/examples/*.model.json': 9,
-    'references/*.md': 15,
+    'assets/examples/*.html': 3,  # Batch3 每模式 1 份黄金样张
+    'assets/examples/*.model.json': 3,
+    'references/*.md': 22,  # craft 轮后含 default-surface + presentation-craft；≥22 防误删
 }
 
 

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

@@ -4,6 +4,7 @@
 
 用法:
     python scripts/quality_gate.py report.html
+    # Mode A / presentation 自动对 validate_report 附加 --layout-qa
     python scripts/quality_gate.py report.html --pptx report.pptx --model report.model.json
     python scripts/quality_gate.py report.html --trace trace.json --json
     python scripts/quality_gate.py report.html --require-rubric 60
@@ -241,10 +242,17 @@ def main() -> int:
     print(f'交付质量门禁 · {html.name}')
     print('-' * 60)
 
-    # ① HTML strict
-    rc, out, el = run([sys.executable, str(ROOT / 'scripts' / 'validate_report.py'), str(html), '--strict'])
+    # ① HTML strict（Mode A / presentation 自动附带 --layout-qa）
+    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'
+    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('validate_report --strict', rc == 0, tail[-1] if tail else f'exit {rc}', el)
+    gate(gate_name, rc == 0, tail[-1] if tail else f'exit {rc}', el)
 
     # ② PPTX strict（可选）
     if args.pptx: