@topmindspace/tms-skills 0.1.6 → 0.1.8

package/top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.model.json

@@ -0,0 +1,315 @@
+{
+  "mode": "presentation",
+  "style": "business-blue",
+  "theme": "light",
+  "title": "TopMind × tms-skills",
+  "subtitle": "让 idea 飞 · 把好想法做成可上台的演示文稿",
+  "meta": "产品介绍 · 2026-09-26",
+  "agenda": [
+    [
+      "01",
+      "TopMind 定位",
+      "知识工作空间"
+    ],
+    [
+      "02",
+      "tms-skills 概览",
+      "可安装技能 monorepo"
+    ],
+    [
+      "03",
+      "top-ppt-html 特色",
+      "HTML + 保真 PPTX"
+    ],
+    [
+      "04",
+      "三模式契约",
+      "演示 · 研究 · 架构"
+    ],
+    [
+      "05",
+      "风格与主题",
+      "九风格 × 亮暗"
+    ],
+    [
+      "06",
+      "质量门禁",
+      "strict 0/0 交付"
+    ],
+    [
+      "07",
+      "Fast Mode",
+      "少问一句 · 工艺不降"
+    ]
+  ],
+  "sections": [
+    {
+      "type": "points",
+      "layoutPreset": "P4",
+      "eyebrow": "01 · TopMind",
+      "title": "TopMind：让 idea 飞的知识工作空间",
+      "points": [
+        [
+          "工作空间，不是工具箱",
+          "把想法、材料与产出收拢在同一语境，减少搬运与失真"
+        ],
+        [
+          "知识工艺，克制表达",
+          "强调结构、证据与可读性——让好想法被认真看见"
+        ],
+        [
+          "面向正式场合",
+          "演讲、汇报、路演：材料要上台，不只是堆在文档里"
+        ]
+      ],
+      "soWhat": "TopMind 把有想法推进到可上台——工艺在结构，不在堆砌。"
+    },
+    {
+      "type": "cards",
+      "layoutPreset": "P5",
+      "eyebrow": "02 · tms-skills",
+      "title": "tms-skills：整仓可安装的智能体技能",
+      "columns": 3,
+      "cards": [
+        {
+          "title": "Monorepo",
+          "points": [
+            [
+              "一仓多技能",
+              "根目录技能包 + 统一安装器"
+            ],
+            [
+              "同 tag 发版",
+              "安装器与技能整仓对齐"
+            ]
+          ]
+        },
+        {
+          "title": "双通道安装",
+          "points": [
+            [
+              "npm 钉版本",
+              "npx @topmindspace/tms-skills"
+            ],
+            [
+              "GitHub 跟 HEAD",
+              "日常可 clone / 直装"
+            ]
+          ]
+        },
+        {
+          "title": "当前主技能",
+          "points": [
+            [
+              "top-ppt-html",
+              "正式场合演示文稿"
+            ],
+            [
+              "HTML + PPTX",
+              "同源模型 · 双交付"
+            ]
+          ]
+        }
+      ],
+      "footnote": "包名 @topmindspace/tms-skills · 当前线 0.1.x（latest）"
+    },
+    {
+      "type": "split",
+      "layoutPreset": "P1",
+      "eyebrow": "03 · top-ppt-html",
+      "title": "一屏一主张：可翻页 HTML，保真可编辑 PPTX",
+      "left": {
+        "points": [
+          [
+            "模型单写",
+            "只填 REPORT_MODEL，禁手改 HTML 正文"
+          ],
+          [
+            "三模式 × 九风格",
+            "演示 / 研究 / 架构各有契约"
+          ],
+          [
+            "门禁闭环",
+            "validate --strict 0/0 才交付"
+          ]
+        ]
+      },
+      "right": {
+        "type": "bar",
+        "cap": "交付关注点（示意权重）",
+        "labels": [
+          "版式",
+          "排版",
+          "色彩",
+          "内容"
+        ],
+        "values": [
+          32,
+          28,
+          18,
+          22
+        ],
+        "unit": "",
+        "max": 40,
+        "dataTable": "notes"
+      },
+      "soWhat": "工艺是版式、排版、色彩与内容组织——图表图标克制配文。"
+    },
+    {
+      "type": "cards",
+      "layoutPreset": "P5",
+      "eyebrow": "04 · 三模式",
+      "title": "模式先定后写：A 演示 · B 研究 · C 架构",
+      "columns": 3,
+      "cards": [
+        {
+          "title": "A · 演示",
+          "points": [
+            [
+              "每屏一主张",
+              "标题即行动句，非话题标签"
+            ],
+            [
+              "大气留白",
+              "证据充分但不堆咨询 dump"
+            ]
+          ]
+        },
+        {
+          "title": "B · 研究",
+          "points": [
+            [
+              "咨询密排",
+              "Exhibit · 来源 · so-what"
+            ],
+            [
+              "结论可核对",
+              "数字与口径双向对齐"
+            ]
+          ]
+        },
+        {
+          "title": "C · 架构",
+          "points": [
+            [
+              "图为王",
+              "拓扑 / 泳道 / 分层"
+            ],
+            [
+              "少字多结构",
+              "一图说清关系"
+            ]
+          ]
+        }
+      ],
+      "footnote": "意图线索：路演/汇报/演讲 → A；调研/对标 → B；拓扑/方案图 → C"
+    },
+    {
+      "type": "metrics",
+      "layoutPreset": "P2",
+      "eyebrow": "05 · 风格主题",
+      "title": "九风格开场即可见，亮暗主题一键贯穿",
+      "metrics": [
+        [
+          "9",
+          "风格套装（商务蓝·麦肯锡·石墨等）"
+        ],
+        [
+          "2",
+          "亮暗主题（浅色外发 / 深色大屏）"
+        ],
+        [
+          "1",
+          "交互画廊 style-gallery"
+        ],
+        [
+          "3",
+          "主题参考图（演示·研究·架构）"
+        ]
+      ],
+      "soWhat": "Gate 0 先给参考图；标准模式跳过即不合格。"
+    },
+    {
+      "type": "comparison",
+      "layoutPreset": "P4",
+      "eyebrow": "06 · 质量门禁",
+      "title": "散装出稿止步，strict 0/0 才算交付",
+      "left": {
+        "title": "散装路径 · 风险",
+        "points": [
+          [
+            "手改 HTML",
+            "模型与正文双写，一改就漂"
+          ],
+          [
+            "无严格校验",
+            "截断、同型图、半空卡易漏"
+          ],
+          [
+            "口头交付",
+            "缺七要素，验收靠感觉"
+          ]
+        ]
+      },
+      "right": {
+        "title": "门禁路径 · 目标",
+        "points": [
+          [
+            "模型单写",
+            "render 回填，禁手改正文"
+          ],
+          [
+            "HTML + PPTX",
+            "validate --strict 双侧 0/0"
+          ],
+          [
+            "七要素说明",
+            "quality_gate --deliver"
+          ]
+        ]
+      },
+      "verdict": "反截断、图表多样性、runtime SHA——门禁是交付的一部分。"
+    },
+    {
+      "type": "timeline",
+      "layoutPreset": "P6",
+      "eyebrow": "07 · Fast Mode",
+      "title": "Fast Mode：跳过问询，不跳过工艺",
+      "phases": [
+        [
+          "触发",
+          "显式 opt-in",
+          "快速模式 / fast / 一键出稿 / 少问一句"
+        ],
+        [
+          "推断",
+          "默认参数",
+          "路演线索→A·business-blue；未点明→B·mckinsey"
+        ],
+        [
+          "仍须",
+          "质量闭环",
+          "最小大纲 → 模型单写 → strict 0/0 → 交付说明"
+        ]
+      ],
+      "soWhat": "Fast 豁免问询，但反截断与 Mode A craft 一律不降。"
+    }
+  ],
+  "closing": {
+    "title": "让好想法被看见",
+    "points": [
+      [
+        "装技能",
+        "npx @topmindspace/tms-skills install top-ppt-html"
+      ],
+      [
+        "看样张",
+        "assets/examples · style-gallery.html"
+      ],
+      [
+        "上台交付",
+        "HTML 可翻页 · PPTX 可编辑 · strict 0/0"
+      ]
+    ]
+  }
+}

package/top-ppt-html/assets/pptx-export.js

@@ -252,6 +252,7 @@ function dataColors(style, theme) {
 var LAY = PT.layout || {};
 var CONTENT_TOP = (LAY.contentTop != null) ? LAY.contentTop : 2.5;
 var CONTENT_BOTTOM = (LAY.contentBottom != null) ? LAY.contentBottom : 6.9;
+var CONTENT_BOTTOM_NOTE = (LAY.contentBottomWithNote != null) ? LAY.contentBottomWithNote : 6.4;
 
 /* ── 自适应排版工具（与 build_pptx.js 同算法，保证两通道字号/换行一致） ── */
 function estLines(text, widthIn, fontPt) {
@@ -326,9 +327,12 @@ function fitRowH(avail, n, pref, floor) {
   return Math.max(lo, Math.min(pref, avail / Math.max(1, n)));
 }
 function chartBottom(hasSoWhat, hasFootnote) {
-  if (hasFootnote) return PT.exhibit.footnoteY - 0.12;
-  if (hasSoWhat) return PT.exhibit.soWhatY - 0.12;
-  return CONTENT_BOTTOM;
+  /* D8: tightest of soWhat/footnote/contentBottomWithNote — no short-circuit */
+  var bot = CONTENT_BOTTOM;
+  if (hasSoWhat) bot = Math.min(bot, PT.exhibit.soWhatY - 0.12);
+  if (hasFootnote) bot = Math.min(bot, PT.exhibit.footnoteY - 0.12);
+  if (hasSoWhat || hasFootnote) bot = Math.min(bot, CONTENT_BOTTOM_NOTE);
+  return bot;
 }
 
 /* ── XML 工具 ── */
@@ -1216,7 +1220,7 @@ function slidesOf(model, S) {
     head(ag, 'AGENDA', '报告大纲');
     var colN = items.length > 8 ? 2 : 1;
     var perCol = Math.ceil(items.length / colN) || 1;
-    var rowH = Math.min(1.05, (CONTENT_BOTTOM - CONTENT_TOP) / perCol);
+    var rowH = Math.min(1.05, (CONTENT_BOTTOM - CONTENT_TOP - 0.25) / Math.max(1, perCol));
     var numSz = rowH >= 0.85 ? 30 : (rowH >= 0.65 ? 22 : 18);
     var tSz = rowH >= 0.85 ? 16 : 14, dSz = rowH >= 0.85 ? 12 : 11;
     items.forEach(function (it, i) {
@@ -1253,6 +1257,7 @@ function slidesOf(model, S) {
       flagY = CONTENT_BOTTOM - flagH;
       if (sec.footnote) flagY = Math.min(flagY, PT.exhibit.footnoteY - flagH - 0.06);
       if (sec.soWhat) flagY = Math.min(flagY, PT.exhibit.soWhatY - flagH - 0.06);
+      if (sec.footnote || sec.soWhat) flagY = Math.min(flagY, CONTENT_BOTTOM_NOTE - flagH);
       bodyBottom = Math.min(bodyBottom, flagY - (_F.gap || 0.12));
     }
 

package/top-ppt-html/assets/templates/architecture.html

@@ -1778,7 +1778,7 @@ window.REPORT_MODEL = {
 
 /* __TOPPPT_RUNTIME_START__ */
 /* ══ PPTX 导出运行时（assets/pptx-export.js 的内联副本 · 由 scripts/sync_runtime.py 注入，禁止手改） ══ */
-/* __TOPPPT_RUNTIME_SHA__:68c55206c33160af */
+/* __TOPPPT_RUNTIME_SHA__:77ca318e7a510e01 */
 /* ═══════════════════════════════════════════════════════════════════════════
  * TopPPT HTML· 浏览器端 PPTX 预览运行时
  * 零依赖、随报告单文件分发；OOXML 序列化器（仅供预览，页面不导出文件）。
@@ -2033,6 +2033,7 @@ function dataColors(style, theme) {
 var LAY = PT.layout || {};
 var CONTENT_TOP = (LAY.contentTop != null) ? LAY.contentTop : 2.5;
 var CONTENT_BOTTOM = (LAY.contentBottom != null) ? LAY.contentBottom : 6.9;
+var CONTENT_BOTTOM_NOTE = (LAY.contentBottomWithNote != null) ? LAY.contentBottomWithNote : 6.4;
 
 /* ── 自适应排版工具（与 build_pptx.js 同算法，保证两通道字号/换行一致） ── */
 function estLines(text, widthIn, fontPt) {
@@ -2107,9 +2108,12 @@ function fitRowH(avail, n, pref, floor) {
   return Math.max(lo, Math.min(pref, avail / Math.max(1, n)));
 }
 function chartBottom(hasSoWhat, hasFootnote) {
-  if (hasFootnote) return PT.exhibit.footnoteY - 0.12;
-  if (hasSoWhat) return PT.exhibit.soWhatY - 0.12;
-  return CONTENT_BOTTOM;
+  /* D8: tightest of soWhat/footnote/contentBottomWithNote — no short-circuit */
+  var bot = CONTENT_BOTTOM;
+  if (hasSoWhat) bot = Math.min(bot, PT.exhibit.soWhatY - 0.12);
+  if (hasFootnote) bot = Math.min(bot, PT.exhibit.footnoteY - 0.12);
+  if (hasSoWhat || hasFootnote) bot = Math.min(bot, CONTENT_BOTTOM_NOTE);
+  return bot;
 }
 
 /* ── XML 工具 ── */
@@ -2997,7 +3001,7 @@ function slidesOf(model, S) {
     head(ag, 'AGENDA', '报告大纲');
     var colN = items.length > 8 ? 2 : 1;
     var perCol = Math.ceil(items.length / colN) || 1;
-    var rowH = Math.min(1.05, (CONTENT_BOTTOM - CONTENT_TOP) / perCol);
+    var rowH = Math.min(1.05, (CONTENT_BOTTOM - CONTENT_TOP - 0.25) / Math.max(1, perCol));
     var numSz = rowH >= 0.85 ? 30 : (rowH >= 0.65 ? 22 : 18);
     var tSz = rowH >= 0.85 ? 16 : 14, dSz = rowH >= 0.85 ? 12 : 11;
     items.forEach(function (it, i) {
@@ -3034,6 +3038,7 @@ function slidesOf(model, S) {
       flagY = CONTENT_BOTTOM - flagH;
       if (sec.footnote) flagY = Math.min(flagY, PT.exhibit.footnoteY - flagH - 0.06);
       if (sec.soWhat) flagY = Math.min(flagY, PT.exhibit.soWhatY - flagH - 0.06);
+      if (sec.footnote || sec.soWhat) flagY = Math.min(flagY, CONTENT_BOTTOM_NOTE - flagH);
       bodyBottom = Math.min(bodyBottom, flagY - (_F.gap || 0.12));
     }
 

package/top-ppt-html/assets/templates/presentation.html

@@ -1788,7 +1788,7 @@ window.REPORT_MODEL = {
 
 /* __TOPPPT_RUNTIME_START__ */
 /* ══ PPTX 导出运行时（assets/pptx-export.js 的内联副本 · 由 scripts/sync_runtime.py 注入，禁止手改） ══ */
-/* __TOPPPT_RUNTIME_SHA__:68c55206c33160af */
+/* __TOPPPT_RUNTIME_SHA__:77ca318e7a510e01 */
 /* ═══════════════════════════════════════════════════════════════════════════
  * TopPPT HTML· 浏览器端 PPTX 预览运行时
  * 零依赖、随报告单文件分发；OOXML 序列化器（仅供预览，页面不导出文件）。
@@ -2043,6 +2043,7 @@ function dataColors(style, theme) {
 var LAY = PT.layout || {};
 var CONTENT_TOP = (LAY.contentTop != null) ? LAY.contentTop : 2.5;
 var CONTENT_BOTTOM = (LAY.contentBottom != null) ? LAY.contentBottom : 6.9;
+var CONTENT_BOTTOM_NOTE = (LAY.contentBottomWithNote != null) ? LAY.contentBottomWithNote : 6.4;
 
 /* ── 自适应排版工具（与 build_pptx.js 同算法，保证两通道字号/换行一致） ── */
 function estLines(text, widthIn, fontPt) {
@@ -2117,9 +2118,12 @@ function fitRowH(avail, n, pref, floor) {
   return Math.max(lo, Math.min(pref, avail / Math.max(1, n)));
 }
 function chartBottom(hasSoWhat, hasFootnote) {
-  if (hasFootnote) return PT.exhibit.footnoteY - 0.12;
-  if (hasSoWhat) return PT.exhibit.soWhatY - 0.12;
-  return CONTENT_BOTTOM;
+  /* D8: tightest of soWhat/footnote/contentBottomWithNote — no short-circuit */
+  var bot = CONTENT_BOTTOM;
+  if (hasSoWhat) bot = Math.min(bot, PT.exhibit.soWhatY - 0.12);
+  if (hasFootnote) bot = Math.min(bot, PT.exhibit.footnoteY - 0.12);
+  if (hasSoWhat || hasFootnote) bot = Math.min(bot, CONTENT_BOTTOM_NOTE);
+  return bot;
 }
 
 /* ── XML 工具 ── */
@@ -3007,7 +3011,7 @@ function slidesOf(model, S) {
     head(ag, 'AGENDA', '报告大纲');
     var colN = items.length > 8 ? 2 : 1;
     var perCol = Math.ceil(items.length / colN) || 1;
-    var rowH = Math.min(1.05, (CONTENT_BOTTOM - CONTENT_TOP) / perCol);
+    var rowH = Math.min(1.05, (CONTENT_BOTTOM - CONTENT_TOP - 0.25) / Math.max(1, perCol));
     var numSz = rowH >= 0.85 ? 30 : (rowH >= 0.65 ? 22 : 18);
     var tSz = rowH >= 0.85 ? 16 : 14, dSz = rowH >= 0.85 ? 12 : 11;
     items.forEach(function (it, i) {
@@ -3044,6 +3048,7 @@ function slidesOf(model, S) {
       flagY = CONTENT_BOTTOM - flagH;
       if (sec.footnote) flagY = Math.min(flagY, PT.exhibit.footnoteY - flagH - 0.06);
       if (sec.soWhat) flagY = Math.min(flagY, PT.exhibit.soWhatY - flagH - 0.06);
+      if (sec.footnote || sec.soWhat) flagY = Math.min(flagY, CONTENT_BOTTOM_NOTE - flagH);
       bodyBottom = Math.min(bodyBottom, flagY - (_F.gap || 0.12));
     }
 

package/top-ppt-html/assets/templates/research.html

@@ -2067,7 +2067,7 @@ window.REPORT_MODEL = {
 
 /* __TOPPPT_RUNTIME_START__ */
 /* ══ PPTX 导出运行时（assets/pptx-export.js 的内联副本 · 由 scripts/sync_runtime.py 注入，禁止手改） ══ */
-/* __TOPPPT_RUNTIME_SHA__:68c55206c33160af */
+/* __TOPPPT_RUNTIME_SHA__:77ca318e7a510e01 */
 /* ═══════════════════════════════════════════════════════════════════════════
  * TopPPT HTML· 浏览器端 PPTX 预览运行时
  * 零依赖、随报告单文件分发；OOXML 序列化器（仅供预览，页面不导出文件）。
@@ -2322,6 +2322,7 @@ function dataColors(style, theme) {
 var LAY = PT.layout || {};
 var CONTENT_TOP = (LAY.contentTop != null) ? LAY.contentTop : 2.5;
 var CONTENT_BOTTOM = (LAY.contentBottom != null) ? LAY.contentBottom : 6.9;
+var CONTENT_BOTTOM_NOTE = (LAY.contentBottomWithNote != null) ? LAY.contentBottomWithNote : 6.4;
 
 /* ── 自适应排版工具（与 build_pptx.js 同算法，保证两通道字号/换行一致） ── */
 function estLines(text, widthIn, fontPt) {
@@ -2396,9 +2397,12 @@ function fitRowH(avail, n, pref, floor) {
   return Math.max(lo, Math.min(pref, avail / Math.max(1, n)));
 }
 function chartBottom(hasSoWhat, hasFootnote) {
-  if (hasFootnote) return PT.exhibit.footnoteY - 0.12;
-  if (hasSoWhat) return PT.exhibit.soWhatY - 0.12;
-  return CONTENT_BOTTOM;
+  /* D8: tightest of soWhat/footnote/contentBottomWithNote — no short-circuit */
+  var bot = CONTENT_BOTTOM;
+  if (hasSoWhat) bot = Math.min(bot, PT.exhibit.soWhatY - 0.12);
+  if (hasFootnote) bot = Math.min(bot, PT.exhibit.footnoteY - 0.12);
+  if (hasSoWhat || hasFootnote) bot = Math.min(bot, CONTENT_BOTTOM_NOTE);
+  return bot;
 }
 
 /* ── XML 工具 ── */
@@ -3286,7 +3290,7 @@ function slidesOf(model, S) {
     head(ag, 'AGENDA', '报告大纲');
     var colN = items.length > 8 ? 2 : 1;
     var perCol = Math.ceil(items.length / colN) || 1;
-    var rowH = Math.min(1.05, (CONTENT_BOTTOM - CONTENT_TOP) / perCol);
+    var rowH = Math.min(1.05, (CONTENT_BOTTOM - CONTENT_TOP - 0.25) / Math.max(1, perCol));
     var numSz = rowH >= 0.85 ? 30 : (rowH >= 0.65 ? 22 : 18);
     var tSz = rowH >= 0.85 ? 16 : 14, dSz = rowH >= 0.85 ? 12 : 11;
     items.forEach(function (it, i) {
@@ -3323,6 +3327,7 @@ function slidesOf(model, S) {
       flagY = CONTENT_BOTTOM - flagH;
       if (sec.footnote) flagY = Math.min(flagY, PT.exhibit.footnoteY - flagH - 0.06);
       if (sec.soWhat) flagY = Math.min(flagY, PT.exhibit.soWhatY - flagH - 0.06);
+      if (sec.footnote || sec.soWhat) flagY = Math.min(flagY, CONTENT_BOTTOM_NOTE - flagH);
       bodyBottom = Math.min(bodyBottom, flagY - (_F.gap || 0.12));
     }
 

package/top-ppt-html/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "top-ppt-html",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "top-ppt-html",
-      "version": "0.1.6",
+      "version": "0.1.8",
       "license": "MIT",
       "dependencies": {
         "pptxgenjs": "^4.0.0"

package/top-ppt-html/package.json

@@ -1,6 +1,6 @@
 {
   "name": "top-ppt-html",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "private": true,
   "description": "TopPPT HTML：优雅大气的正式场合演讲/汇报演示文稿。单文件 HTML + 版式保真可编辑 PPTX；布局骨架 P1–P12；模型单写；strict 0/0 交付。",
   "license": "MIT",

package/top-ppt-html/references/playbook.md

@@ -46,7 +46,7 @@
 Gate 0 参考图 → 六项问询（1 轮）→ 最小大纲（outline-design「轻量最小集」）→ 1 张规划卡 → scaffold_report.py
   → **只填 REPORT_MODEL** → render_from_model.py --inplace → validate_report.py --strict → 交付
 ```
-（Fast Mode 跳过 Gate 0/六项，仍须最小大纲；默认 **HTML-only**，PPTX 显式 opt-in 走 B 通道；**禁止**手改 HTML 正文与模型双写。）
+（Fast Mode 跳过 Gate 0/六项，仍须最小大纲+strict；默认 **HTML-only**，PPTX 显式 opt-in 走 B 通道；路演/汇报/演讲线索→Mode A；**禁止**手改 HTML 正文与模型双写。）
 
 **完整路径**（任一命中）——研究 ≥20 页 / 演示 ≥12 页 / 材料量大且杂 / 含未敲定关键判断 / 用户要看框架。
 ```

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

@@ -1,12 +1,13 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-"""TopPPT HTML · 黄金样张维护（Batch 3 瘦身）
+"""TopPPT HTML · 黄金样张维护
 
-assets/examples/ 仅保留 3 份黄金样张（每模式 1）：
+assets/examples/ 至少保留 3 份黄金样张（每模式 1）：
   presentation-business-blue · research-mckinsey · architecture-graphite-dark
+另可含产品 showcase（如 2026-09-26-topmind-tms-skills-showcase），不替代黄金样张。
 
 完整 9 风格染色矩阵旧实现：docs/archive/build_examples.py.full
-其余示例：docs/archive/examples/
+其余历史示例：docs/archive/examples/
 """
 from __future__ import annotations
 

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

@@ -573,9 +573,13 @@ function imageLayoutShapes(s, layout, img, items, points, isPh, fit, y0, y1) {
 }
 /* 数据图表上下文（供备注与自适应使用） */
 function chartBottom(hasSoWhat, hasFootnote) {
-  if (hasFootnote) return PT.exhibit.footnoteY - 0.12;
-  if (hasSoWhat) return PT.exhibit.soWhatY - 0.12;
-  return CONTENT_BOTTOM;
+  /* 取最紧下界：so-what / footnote / contentBottomWithNote 并存时不得短路（D8）。
+   * 与 ~1630 flagY 的 Math.min 让位同口径；withNote 时对齐 regionOf 的 contentBottomWithNote。 */
+  let bot = CONTENT_BOTTOM;
+  if (hasSoWhat) bot = Math.min(bot, PT.exhibit.soWhatY - 0.12);
+  if (hasFootnote) bot = Math.min(bot, PT.exhibit.footnoteY - 0.12);
+  if (hasSoWhat || hasFootnote) bot = Math.min(bot, CONTENT_BOTTOM_NOTE);
+  return bot;
 }
 
 /* ═══ 原生数据图表（pptxgenjs addChart → 真 chart part + 内嵌 Excel 工作簿）═══
@@ -1581,8 +1585,9 @@ function addTable(s, tbl, x, y, w, availH, opts) {
   const items = CONTENT.agenda;
   const colN = items.length > 8 ? 2 : 1;
   const perCol = Math.ceil(items.length / colN);
-  const availH = CONTENT_BOTTOM - CONTENT_TOP;
-  const rowH = Math.min(1.05, availH / perCol);
+  /* 预留 0.25in，避免末行底边落入 severe-overlap 安全网（无注释页亦勿压进 withNote 带过深） */
+  const availH = CONTENT_BOTTOM - CONTENT_TOP - 0.25;
+  const rowH = Math.min(1.05, availH / Math.max(1, perCol));
   const numSize = rowH >= 0.85 ? sz(30) : (rowH >= 0.65 ? sz(22) : sz(18));
   const tSize = rowH >= 0.85 ? sz(16) : sz(14);
   const dSize = rowH >= 0.85 ? sz(12) : sz(11);
@@ -1630,6 +1635,8 @@ CONTENT.sections.forEach((sec) => {
     flagY = CONTENT_BOTTOM - flagH;
     if (sec.footnote) flagY = Math.min(flagY, PT.exhibit.footnoteY - flagH - 0.06);
     if (sec.soWhat) flagY = Math.min(flagY, PT.exhibit.soWhatY - flagH - 0.06);
+    /* withNote 时 flag 底不得越过 contentBottomWithNote（与 chartBottom / regionOf 同口径） */
+    if (sec.footnote || sec.soWhat) flagY = Math.min(flagY, CONTENT_BOTTOM_NOTE - flagH);
     bodyBottom = Math.min(bodyBottom, flagY - (_F.gap || 0.12));
   }
 

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

@@ -17,7 +17,7 @@
     README.md                      人类视角的简介 / 安装 / 开发 / 打包
     package.json                   Node 依赖声明（pptxgenjs）与常用命令
     assets/templates/              三份模式模板 + engine.css / ui.js（公共片段注入源）
-    assets/examples/               3 份黄金样张 HTML + model（每模式 1；风格见 style-gallery）
+    assets/examples/               ≥3 黄金样张（每模式 1）+ 可选产品 showcase HTML/model
     assets/pptx-export.js          PPTX 预览运行时（注入源）
     assets/style-gallery.html      风格 × 模式 × 亮暗主题交互画廊
     assets/theme-overview*.png     3 张主题参考图（整体 + research + architecture；演示态与整体图相同）
@@ -42,7 +42,7 @@
 ────────────────────────────────────────────────────────────────────────
     · SKILL.md frontmatter 含 name / description；name 与分发包目录名一致；
       description 为单行双引号字符串且 ≤ 1024 字符（平台截断阈值）
-    · references（含 layout-grammar）、3 份模式模板 + engine.css / ui.js、3 组黄金样张、3 张参考图齐全
+    · references（含 layout-grammar）、3 份模式模板 + engine.css / ui.js、≥3 组样张、3 张参考图齐全
     · 关键脚本齐全（单源注入 / 审计 / 示例重建 / 回归 / 双校验器 / 精导 / 打包）
 """
 import fnmatch
@@ -84,6 +84,7 @@ INCLUDE = [
     'assets/theme-overview-architecture.png',
     'assets/templates/*',
     'assets/examples/*',
+    'assets/showcase/*',
     'references/*',
     'scripts/*',
     'evals/*',
@@ -155,7 +156,7 @@ REQUIRED = [
 
 # 必须达到最小数量的集合（名称含日期，故按数量校验）
 MIN_COUNTS = {
-    'assets/examples/*.html': 3,  # Batch3 每模式 1 份黄金样张
+    'assets/examples/*.html': 3,  # ≥3：每模式黄金样张；可另含 showcase
     'assets/examples/*.model.json': 3,
     'references/*.md': 25,  # + page-type-matrix + chart-decision-tree；≥25 防误删
 }

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]
+# CI（ci_skill_gates --with-pptx）必跑 business-blue + research-mckinsey（D13；后者覆盖 soWhat+footnote / D8）
 # 失败时打印短摘要（错误码/页码/消息），完整 JSON 落盘到 TMPDIR。
 set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"