@topmindspace/tms-skills 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## 0.1.7 — 2026-09-26
+
+### top-ppt-html · defect opt (D8/D9/D11/D13)
+
+- **P0 D8**：`chartBottom(hasSoWhat, hasFootnote)` 不再 footnote 短路；`Math.min(soWhatY, footnoteY, contentBottomWithNote)` 与 flagY 让位同口径。双通道（`build_pptx.js` / `pptx-export.js`）对齐；flagBar 在 withNote 时底边不越过 `contentBottomWithNote`；Agenda 预留 0.25in 避免 severe 误伤。
+- **P0 D9**：`annotation_band_overlap_check` 报告页内**全部**侵入者（去掉首条即 `break`）。
+- **P1 D11**：有 so-what 时 `band_top = soWhatY`（6.05），捕获 (6.05, 6.40] 侵入；crush = 自带顶之上压下；注释自形状/窄 accent 条豁免保留。
+- **P1 D13**：`ci_skill_gates.sh --with-pptx` 必跑 `smoke_pptx` × business-blue **与** research-mckinsey（覆盖 soWhat+footnote）；graphite-dark 可选。
+- **CHROME_DRIFT**：页码只认 `N / M`，不再把年份/Exhibit 编号当页脚（research-mckinsey 假阳性清除）。
+- **Fast Mode / 效率**：演讲/汇报线索→Mode A；明确跳过 vs 仍须（质检红线不降）；L0+L1 / `extract_snippet` 纪律不变。
+- **门禁**：`test_feedback_gates` 锁定 D8/D9/D11/CHROME；research-mckinsey `--strict` **0/0**。
+- 版本对齐 **0.1.7**（根 + 技能 package / SKILL metadata / README / PUBLISHING）。
+
+### 红线未动
+反截断、图表多样性地板、Mode A craft、runtime SHA 同版本门禁、中文「演示文稿」术语保持。
+
+## 0.1.6 — 2026-09-25
+
+### CI / Release 硬化
+- **根因 A**：`validate_pptx` 的 `ANNOTATION_BAND_OVERLAP` 把全幅背景（底边 7.50in）误判为侵入注释带；改为排除 full-bleed 背景 / 全高装饰条 / chrome 区，同时保留对图例/主图压进 so-what 带的真阳性。
+- **根因 A′**：`FONT_SIZE_NOT_SNAPPED` 未收录 `modeTypeScale` 的 **h2=17pt**；改为从 typeScale ∪ 全模式 modeTypeScale ∪ ladder 动态取允许集。
+- **冒烟可读性**：`smoke_pptx.sh` 可靠传播 validate 退出码；失败时 stderr 先打错误码/页码短摘要。
+- **根因 B**：Release `npm publish` 遇已发布/已 staged 的 **E409** 时改为 exit 0（幂等）；GitHub Release + 资产仍成功。
+- **DRY**：`scripts/ci_skill_gates.sh` 为 CI/Release 共用门禁；Release 对齐 CI 的 fixture + `smoke_pptx`；CI concurrency cancel-in-progress；npm cache；python-pptx 仅 PPTX 步骤安装。
+- 文档：新增 `docs/ci.md`；版本对齐 **0.1.6**。
+
+### 红线未动
+反截断、图表多样性地板、Mode A craft、runtime SHA 同版本门禁保持。
+
 ## 0.1.5 — 2026-09-25
 
 ### top-ppt-html · defect close-out

package/README.md

@@ -8,9 +8,9 @@
 
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
-| [`top-ppt-html`](./top-ppt-html/) | 0.1.5 | 优雅大气的正式场合演讲/汇报演示文稿：单文件 HTML + 版式保真可编辑 16:9 PPTX |
+| [`top-ppt-html`](./top-ppt-html/) | 0.1.7 | 优雅大气的正式场合演讲/汇报演示文稿：单文件 HTML + 版式保真可编辑 16:9 PPTX |
 
-安装器包 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 亦为 **0.1.5**（整仓发版：安装器与当前技能同 tag；未来多技能仍可各自演进，默认随仓库 release）。
+安装器包 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 亦为 **0.1.7**（整仓发版：安装器与当前技能同 tag；未来多技能仍可各自演进，默认随仓库 release）。
 
 更多技能以仓库根目录下的技能目录加入（每个目录含 `SKILL.md`）。
 
@@ -30,7 +30,7 @@
 npx @topmindspace/tms-skills list
 npx @topmindspace/tms-skills install top-ppt-html
 npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
-npx @topmindspace/tms-skills@0.1.5 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills@0.1.7 install top-ppt-html   # 钉版本
 ```
 
 ### GitHub 直装
@@ -75,7 +75,7 @@ npm install
 tms-skills/
 ├─ top-ppt-html/             # 技能（SKILL.md + assets + references + scripts + evals）
 ├─ bin/tms-skills.js         # CLI：list / install
-├─ docs/                     # 发布规范
+├─ docs/                     # 发布规范 · CI/Release 说明（ci.md）
 ├─ scripts/                  # 仓库级工具（隐私扫描）
 ├─ .github/workflows/        # CI + Release
 ├─ package.json              # @topmindspace/tms-skills

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/tms-skills",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "TopMindspace 智能体技能 monorepo — 通过 npm / GitHub npx 安装技能（top-ppt-html：优雅大气正式场合演讲/汇报演示文稿等）。",
   "license": "MIT",
   "author": "TopMindspace",

package/top-ppt-html/README.md

@@ -3,7 +3,7 @@
 **让 idea 飞，好想法被看见。** 面向**演讲与正式场合**的高品质演示文稿技能：把主张、调研、分析、架构方案，生成为**优雅、美观、大气**的可翻页 HTML + **版式保真可编辑 PPTX**。核心工艺是版式、排版、色彩与内容组织——克制图标/图表配文，而非 gadget 堆砌或咨询 dump 默认。
 
 - 技能标识：`top-ppt-html`（安装/打包目录名与此一致）；品牌名：**TopPPT HTML**
-- 版本：**v0.1.5**（与 `@topmindspace/tms-skills@0.1.5` 同 tag）
+- 版本：**v0.1.7**（与 `@topmindspace/tms-skills@0.1.7` 同 tag）
 - **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
 - **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
 

package/top-ppt-html/SKILL.md

@@ -4,7 +4,7 @@ description: "Use when 用户要做报告、演示、汇报、PPT、slides、dec
 license: MIT
 compatibility: "Python 3 stdlib for HTML generation; Node >=18 + pptxgenjs for PPTX; optional playwright for browser regression / theme captures."
 metadata:
-  version: "0.1.5"
+  version: "0.1.7"
   author: TopMindspace
 ---
 # TopPPT HTML
@@ -25,17 +25,17 @@ metadata:
 
 ## Fast Mode · 快速模式（用户显式 opt-in）
 
-触发词任一即进入（**跳过 Gate 0 与六项问询**）：`快速模式` / `fast` / `直接生成` / `一键出稿` / `fast mode` / `少问一句`。
+触发词即进入（**跳过 Gate 0 与六项**）：`快速模式` / `fast` / `直接生成` / `一键出稿` / `fast mode` / `少问一句`。
 
 | 参数 | 默认 | 推断 |
 |------|------|------|
-| mode | **B** | **路演/汇报/发布/演讲/demo/融资→A**；架构/拓扑→C；未点明→B |
+| mode | **B** | **路演/汇报/发布/演讲/demo/融资/宣讲→A**；架构/拓扑→C；未点明→B |
 | style | B→mckinsey · A→business-blue · C→graphite-dark | |
 | theme | light（graphite→dark） | |
 | 篇幅 | A=10 / B=12 / C=6 | |
-| format | **html only**（默认；**仅当用户要 PPT / 交付含 PPTX 才开** B 通道） | |
+| format | **html only**（**仅当用户要 PPT/PPTX 才开** B 通道） | |
 
-流程：一行宣布「Fast 选用：…」→ **最小大纲**（`outline-design.md`「轻量最小集」）→ playbook §二轻量链（骨架→模型单写→回填→strict→`quality_gate --deliver`；**PPTX 显式 opt-in**）。路径轻量；末可附 `assets/style-gallery.html`。开场声明「已跳过参考图」。**标准模式**仍强制 Gate 0 + 六项。
+**跳过** Gate 0/六项/完整大纲。**仍须** 最小大纲→模型单写→strict 0/0→`quality_gate --deliver`（反截断、图表多样性、Mode A craft 不降）。读面 L0+L1（A/Fast 可加 L1.5）；代码一律 `extract_snippet`。一行宣布「Fast 选用：…」→ playbook §二轻量链；声明已跳过参考图。**标准模式**仍强制 Gate 0 + 六项。
 
 ## 唯一入口流程
 
@@ -121,7 +121,7 @@ metadata:
 
 ## 版本口径
 
-包 semver（现 0.1.5）≠ 布局 schema 线（layout-constants / model-schema 的 version，现 `0.1`）；patch 不抬 schema。
+包 semver（现 0.1.7）≠ 布局 schema 线（layout-constants / model-schema 的 version，现 `0.1`）；patch 不抬 schema。
 
 ## 环境依赖
 

package/top-ppt-html/assets/examples/2026-09-09-architecture-graphite-dark.html

@@ -1976,7 +1976,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 序列化器（仅供预览，页面不导出文件）。
@@ -2231,6 +2231,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) {
@@ -2305,9 +2306,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 工具 ── */
@@ -3195,7 +3199,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) {
@@ -3232,6 +3236,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/examples/2026-09-09-presentation-business-blue.html

@@ -2375,7 +2375,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 序列化器（仅供预览，页面不导出文件）。
@@ -2630,6 +2630,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) {
@@ -2704,9 +2705,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 工具 ── */
@@ -3594,7 +3598,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) {
@@ -3631,6 +3635,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/examples/2026-09-09-research-mckinsey.html

@@ -3577,7 +3577,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 序列化器（仅供预览，页面不导出文件）。
@@ -3832,6 +3832,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) {
@@ -3906,9 +3907,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 工具 ── */
@@ -4796,7 +4800,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) {
@@ -4833,6 +4837,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/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.5",
+  "version": "0.1.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "top-ppt-html",
-      "version": "0.1.5",
+      "version": "0.1.7",
       "license": "MIT",
       "dependencies": {
         "pptxgenjs": "^4.0.0"

package/top-ppt-html/package.json

@@ -1,6 +1,6 @@
 {
   "name": "top-ppt-html",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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_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/smoke_pptx.sh

@@ -2,6 +2,8 @@
 # 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)"
 cd "$ROOT"
@@ -15,6 +17,7 @@ OUT_DIR="${TMPDIR:-/tmp}/top-ppt-html-smoke"
 mkdir -p "$OUT_DIR"
 MODEL="$OUT_DIR/${STEM}.model.json"
 PPTX="$OUT_DIR/${STEM}.pptx"
+REPORT="$OUT_DIR/${STEM}.validate.json"
 
 echo "== smoke_pptx =="
 echo "HTML  $HTML"
@@ -26,5 +29,42 @@ 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"
+set +e
+python3 scripts/validate_pptx.py "$PPTX" --strict --model="$MODEL" \
+  --json-out="$REPORT" >"$OUT_DIR/${STEM}.validate.stdout.json"
+rc=$?
+set -e
+
+if [[ "$rc" -ne 0 ]]; then
+  echo "smoke_pptx: VALIDATE FAIL (exit $rc)" >&2
+  python3 - "$REPORT" "$rc" <<'PY'
+import json, sys
+path, rc = sys.argv[1], sys.argv[2]
+try:
+    d = json.loads(open(path, encoding="utf-8").read())
+except Exception as e:
+    print(f"  (could not read report {path}: {e})", file=sys.stderr)
+    sys.exit(int(rc))
+errs = d.get("errors") or []
+warns = d.get("warnings") or []
+print(f"  summary: errors={len(errs)} warnings={len(warns)} slides={d.get('summary',{}).get('slide_count')}", file=sys.stderr)
+seen = set()
+for e in errs + warns:
+    key = (e.get("code"), e.get("slide"), e.get("message"))
+    if key in seen:
+        continue
+    seen.add(key)
+    slide = e.get("slide")
+    slide_s = f"slide={slide} " if slide is not None else ""
+    msg = (e.get("message") or "")[:160]
+    print(f"  [{e.get('code')}] {slide_s}{msg}", file=sys.stderr)
+    if len(seen) >= 40:
+        print(f"  … truncated ({len(errs)+len(warns)} total findings)", file=sys.stderr)
+        break
+print(f"  full JSON: {path}", file=sys.stderr)
+sys.exit(int(rc))
+PY
+fi
+
+echo "smoke_pptx: OK (0 errors / 0 warnings)"
+exit 0

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

@@ -102,6 +102,95 @@ def test_annotation_band_overlap() -> None:
     )
 
 
+def test_annotation_band_ignores_full_bleed_bg() -> None:
+    """Full-slide background must not false-positive as band crush."""
+    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="0" y="0"/>'
+        f'<a:ext cx="{int(13.333 * EMU)}" cy="{int(7.5 * EMU)}"/>'
+        "</a:xfrm></p:spPr></p:sp>"
+    )
+    el = ET.fromstring(xml)
+    issues = V.annotation_band_overlap_check(
+        [el], 1, int(7.5 * EMU), int(13.333 * EMU),
+    )
+    codes = [i["code"] for i in issues]
+    ok(
+        "3b full-bleed background does not fire ANNOTATION_BAND_OVERLAP",
+        "ANNOTATION_BAND_OVERLAP" not in codes,
+        f"codes={codes}",
+    )
+
+
+def test_annotation_band_allows_content_without_note() -> None:
+    """Without so-what/source, content may use up to contentBottom (~6.9)."""
+    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.0 * EMU)}"/>'
+        "</a:xfrm></p:spPr>"
+        "<p:txBody><a:p><a:r><a:t>AgendaCard</a:t></a:r></a:p></p:txBody>"
+        "</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(
+        "3c content to 6.50 without annotation does not fire",
+        "ANNOTATION_BAND_OVERLAP" not in codes,
+        f"codes={codes}",
+    )
+
+
+def test_annotation_band_fires_when_note_present() -> None:
+    """With so-what bar present, body overlapping the withNote band must fire."""
+    def sp(y, h, w, text):
+        return ET.fromstring(
+            '<?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(y * EMU)}"/>'
+            f'<a:ext cx="{int(w * EMU)}" cy="{int(h * EMU)}"/>'
+            "</a:xfrm></p:spPr>"
+            f"<p:txBody><a:p><a:r><a:t>{text}</a:t></a:r></a:p></p:txBody>"
+            "</p:sp>"
+        )
+    els = [
+        sp(5.5, 1.0, 4.0, "LegendSeries"),
+        sp(6.05, 0.55, 12.0, "结论 平台化是唯一路径"),
+    ]
+    issues = V.annotation_band_overlap_check(els, 1, int(7.5 * EMU), int(13.333 * EMU))
+    codes = [i["code"] for i in issues]
+    ok(
+        "3d body crush with so-what present fires ANNOTATION_BAND_OVERLAP",
+        "ANNOTATION_BAND_OVERLAP" in codes,
+        f"codes={codes}",
+    )
+
+
+def test_font_size_h2_17_allowed() -> None:
+    """modeTypeScale h2=17 must be on the allowed set (cover/display whitelist)."""
+    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="1700"/><a:t>AgendaSectionTitle</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(
+        "4b FONT_SIZE_NOT_SNAPPED allows intentional 17pt h2",
+        "FONT_SIZE_NOT_SNAPPED" not in codes,
+        f"codes={codes}",
+    )
+
+
 def test_font_size_not_snapped() -> None:
     xml = (
         '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
@@ -120,6 +209,98 @@ def test_font_size_not_snapped() -> None:
     )
 
 
+def test_annotation_band_reports_all_invaders() -> None:
+    """D9: do not break after the first ANNOTATION_BAND_OVERLAP on a slide."""
+    def sp(y, h, w, text):
+        return ET.fromstring(
+            '<?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(y * EMU)}"/>'
+            f'<a:ext cx="{int(w * EMU)}" cy="{int(h * EMU)}"/>'
+            "</a:xfrm></p:spPr>"
+            f"<p:txBody><a:p><a:r><a:t>{text}</a:t></a:r></a:p></p:txBody>"
+            "</p:sp>"
+        )
+    els = [
+        sp(5.0, 1.2, 4.0, "PlotSeriesA"),
+        sp(5.2, 1.1, 4.0, "PlotSeriesB"),
+        sp(6.05, 0.55, 12.0, "SO WHAT locked path"),
+    ]
+    issues = V.annotation_band_overlap_check(els, 1, int(7.5 * EMU), int(13.333 * EMU))
+    codes = [i["code"] for i in issues]
+    ok(
+        "3e D9 reports all invaders (not just first)",
+        codes.count("ANNOTATION_BAND_OVERLAP") >= 2,
+        f"codes={codes}",
+    )
+
+
+def test_annotation_band_so_what_band_top() -> None:
+    """D11: with so-what present, invasions in (6.05, 6.40] must fire."""
+    def sp(y, h, w, text):
+        return ET.fromstring(
+            '<?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(y * EMU)}"/>'
+            f'<a:ext cx="{int(w * EMU)}" cy="{int(h * EMU)}"/>'
+            "</a:xfrm></p:spPr>"
+            f"<p:txBody><a:p><a:r><a:t>{text}</a:t></a:r></a:p></p:txBody>"
+            "</p:sp>"
+        )
+    els = [
+        # Body ends at 6.30 — inside (soWhatY=6.05, contentBottomWithNote=6.40]
+        sp(5.0, 1.3, 4.0, "LegendCrushMid"),
+        sp(6.05, 0.55, 12.0, "SO WHAT platform first"),
+    ]
+    issues = V.annotation_band_overlap_check(els, 1, int(7.5 * EMU), int(13.333 * EMU))
+    codes = [i["code"] for i in issues]
+    msgs = " ".join(i.get("message") or "" for i in issues)
+    ok(
+        "3f D11 band_top=soWhatY catches invasion in (6.05, 6.40]",
+        "ANNOTATION_BAND_OVERLAP" in codes and "6.05" in msgs,
+        f"codes={codes} msgs={msgs[:120]}",
+    )
+
+
+def test_chrome_footer_ignores_bare_integers() -> None:
+    """CHROME_DRIFT FP: bare year/exhibit numbers must not count as pager."""
+    def sp(y, text):
+        return ET.fromstring(
+            '<?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(y * EMU)}"/>'
+            f'<a:ext cx="{int(1.0 * EMU)}" cy="{int(0.3 * EMU)}"/>'
+            "</a:xfrm></p:spPr>"
+            f'<p:txBody><a:p><a:r><a:rPr sz="1100"/><a:t>{text}</a:t></a:r></a:p></p:txBody>'
+            "</p:sp>"
+        )
+    shapes = [sp(6.14, "2024"), sp(6.14, "06"), sp(7.0, "3 / 14")]
+    y = V.chrome_footer_y_in(shapes, int(7.5 * EMU))
+    ok(
+        "5 chrome_footer_y_in uses N / M only (ignores bare ints)",
+        y is not None and abs(y - 7.0) < 0.05,
+        f"got {y}",
+    )
+
+
+def test_chart_bottom_no_short_circuit() -> None:
+    """D8: chartBottom must Math.min soWhat/footnote — no footnote-first return."""
+    build = (ROOT.parent / "scripts" / "build_pptx.js").read_text(encoding="utf-8")
+    m = re.search(r"function chartBottom\([\s\S]*?\n\}", build)
+    body = m.group(0) if m else ""
+    ok(
+        "D8 chartBottom uses Math.min (no footnote short-circuit)",
+        "Math.min" in body
+        and "hasFootnote) return" not in body
+        and "CONTENT_BOTTOM_NOTE" in body,
+        f"body={body[:200]!r}",
+    )
+
+
+
 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")
@@ -170,6 +351,14 @@ def main() -> int:
     test_shape_bounds_still_reads_a_xfrm()
     test_text_overflow_vertical()
     test_annotation_band_overlap()
+    test_annotation_band_ignores_full_bleed_bg()
+    test_annotation_band_allows_content_without_note()
+    test_annotation_band_fires_when_note_present()
+    test_annotation_band_reports_all_invaders()
+    test_annotation_band_so_what_band_top()
+    test_chrome_footer_ignores_bare_integers()
+    test_chart_bottom_no_short_circuit()
+    test_font_size_h2_17_allowed()
     test_font_size_not_snapped()
     test_engine_static()
     print(f"\n{len(fails)} failed" if fails else "\nAll feedback gates PASS")

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

@@ -354,27 +354,130 @@ def annotation_band_overlap_check(
     elements: list[ET.Element],
     slide_no: int,
     slide_height_emu: int,
+    slide_width_emu: int | None = None,
 ) -> 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.
+    Geometry (layout-constants pageTypes.layout / exhibit / note):
+      soWhatY ≈ 6.05 · contentBottomWithNote ≈ 6.4 · footnote/note ≈ 6.55 ·
+      contentBottom ≈ 6.9 · pager ≈ 7.0
+
+    Semantics (0.1.7 · D9/D11):
+      - Full-bleed backgrounds, full-height accent strips, and pager/footer
+        chrome are never "content crushing the band".
+      - so-what / 口径 / 来源 bars that live in the annotation zone are the
+        band itself — not invaders.
+      - Crush = starts ABOVE band_top and overlaps down into the band.
+        Shapes whose top is already at/below band_top are in-band chrome.
+      - When so-what is present, band_top = soWhatY so invasions in
+        (soWhatY, contentBottomWithNote] are reported (D11). Footnote/source
+        only keeps band_top = contentBottomWithNote.
+      - When no annotation is present, main content may use up to
+        contentBottom; only a severe invasion (≥0.35in into the nominal
+        withNote band) still fires as a safety net.
+      - Report ALL invaders per slide (D9) — do not break after the first.
     """
     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)
+        exhibit = ((lc.get("pageTypes") or {}).get("exhibit") or {})
+        note = ((lc.get("pageTypes") or {}).get("note") or {})
+        nominal_band_top_in = float(lay.get("contentBottomWithNote") or 6.4)
         band_bot_in = float(lay.get("contentBottom") or 6.9)
+        so_what_y_in = float(exhibit.get("soWhatY") or 6.05)
+        note_y_in = float(note.get("y") or exhibit.get("footnoteY") or 6.55)
     except (OSError, json.JSONDecodeError, TypeError, ValueError):
-        band_top_in, band_bot_in = 6.4, 6.9
+        nominal_band_top_in, band_bot_in, so_what_y_in, note_y_in = 6.4, 6.9, 6.05, 6.55
+
+    band_top_in = nominal_band_top_in
     band_top = int(band_top_in * 914400)
+    nominal_band_top = int(nominal_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
+    so_what_y = int(so_what_y_in * 914400)
+    note_y = int(note_y_in * 914400)
+    slide_w = int(slide_width_emu) if slide_width_emu else int(13.333333 * 914400)
+    slide_h = int(slide_height_emu)
+    slide_area = max(slide_w * slide_h, 1)
+    pager_floor = int(min(band_bot_in + 0.05, slide_h / 914400.0 - 0.05) * 914400)
+    min_overlap = int(0.10 * 914400)
+    severe_overlap = int(0.35 * 914400)
+    full_bleed_area = 0.85
+    full_height_frac = 0.90
+    # Label-like prefixes only — body text containing「来源」must not count (agenda FP)
+    ann_pat = re.compile(
+        r"(?:^|\n)\s*(结论|SO\s*WHAT|口径\s*[:：]?|来源\s*[:：]|数据来源\s*[:：]|"
+        r"Source\s*[:：]|Note\s*[:：]|footnote|注\s*[:：])",
+        re.IGNORECASE,
+    )
+
+    def _text(el: ET.Element) -> str:
+        return (text_content(el) or "").strip()
+
+    def _is_chrome_or_bg(y: int, cy: int, cx: int) -> bool:
+        if (cx * cy) / slide_area >= full_bleed_area and y <= int(0.05 * 914400):
+            return True
+        if cy >= int(full_height_frac * slide_h) and y <= int(0.05 * 914400):
+            return True
+        if y >= band_bot - int(0.02 * 914400):
+            return True
+        if y >= pager_floor:
+            return True
+        return False
+
+    def _is_bar_like(cy: int, cx: int) -> bool:
+        return cy <= int(0.75 * 914400) and cx >= int(0.45 * slide_w)
+
+    def _is_note_like(y: int, cy: int, text: str) -> bool:
+        return y >= note_y - int(0.05 * 914400) and cy <= int(0.55 * 914400) and bool(text)
+
+    def _at_so_what_slot(y: int) -> bool:
+        # Engine locks so-what to soWhatY; agenda trailing rows sit lower (~+0.12)
+        return abs(y - so_what_y) <= int(0.08 * 914400)
+
+    def _is_annotation_self(y: int, cy: int, cx: int, text: str) -> bool:
+        """so-what / footnote / source row living in the annotation zone."""
+        if _at_so_what_slot(y) and cy <= int(0.85 * 914400):
+            # Fill rect, accent strip, or SO WHAT text — all live in the slot
+            if ann_pat.search(text) or _is_bar_like(cy, cx) or cx <= int(0.15 * 914400):
+                return True
+        if _is_note_like(y, cy, text):
+            return True
+        # Entirely inside the nominal withNote band (6.40 口径)
+        if y >= nominal_band_top - int(0.02 * 914400):
+            return True
+        return False
+
+    has_annotation = False
+    has_so_what = False
+    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
+        if _is_chrome_or_bg(y, cy, cx):
+            continue
+        txt = _text(el)
+        note_like = _is_note_like(y, cy, txt)
+        labeled = bool(ann_pat.search(txt))
+        bar = _is_bar_like(cy, cx)
+        # Fill rect sits on soWhatY (±0.02); labeled SO WHAT text may sit slightly below
+        on_fill = abs(y - so_what_y) <= int(0.02 * 914400) and bar
+        labeled_slot = labeled and _at_so_what_slot(y) and cy <= int(0.85 * 914400)
+        if note_like:
+            has_annotation = True
+        elif labeled_slot or on_fill:
+            has_annotation = True
+            has_so_what = True
+
+    if has_so_what:
+        band_top_in = min(nominal_band_top_in, so_what_y_in)
+        band_top = int(band_top_in * 914400)
+
+    # Pass 2: body invaders that START ABOVE the band and crush down (D9: all of them)
     for el in elements:
         box = shape_bounds(el)
         if box is None:
@@ -383,14 +486,19 @@ def annotation_band_overlap_check(
         if cx <= 0 or cy <= 0:
             continue
         bottom = y + cy
-        # Legitimate annotation/note content sits entirely inside the band
+        if _is_chrome_or_bg(y, cy, cx):
+            continue
+        if _is_annotation_self(y, cy, cx, _text(el)):
+            continue
+        # Crush-from-above only: top must sit above band_top
         if y >= band_top - int(0.02 * 914400):
             continue
-        # Page chrome (pager) — tiny shapes near bottom edge
-        if y >= pager_floor:
+        if bottom <= band_top:
             continue
-        overlap = min(bottom, band_bot) - max(y, band_top)
-        if overlap >= min_overlap and bottom > band_top:
+        overlap = min(bottom, band_bot) - band_top
+        if overlap < min_overlap:
+            continue
+        if has_annotation or overlap >= severe_overlap:
             out.append(issue(
                 "ANNOTATION_BAND_OVERLAP",
                 f"主内容侵入注释带（元素底边 {bottom/914400:.2f}in 越过注释带顶 "
@@ -398,17 +506,20 @@ def annotation_band_overlap_check(
                 "图例/系列请收入主图区或压缩系列数，禁止压进 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).
+    """Font sizes must sit on the declared type scale / fontShrink ladder.
 
     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.
+
+    Allowed set = containers.fontShrink.ladder ∪ typeScale ∪ all modeTypeScale
+    roles ∪ a small cover/hero display whitelist. Intentional h2 (17pt) and
+    other mode roles must pass; off-ladder 11.3pt etc. must still fail.
     """
     out: list[dict[str, Any]] = []
     try:
@@ -416,10 +527,25 @@ def font_size_snap_check(root: ET.Element, slide_no: int) -> list[dict[str, Any]
         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}
+        scale_sources: list[Any] = [lc.get("typeScale") or {}]
+        mts = lc.get("modeTypeScale") or {}
+        if isinstance(mts, dict):
+            scale_sources.extend(v for v in mts.values() if isinstance(v, dict))
+        for src in scale_sources:
+            if not isinstance(src, dict):
+                continue
+            for key, val in src.items():
+                if str(key).startswith("$"):
+                    continue
+                try:
+                    allowed.add(round(float(val), 2))
+                except (TypeError, ValueError):
+                    continue
     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}
+        allowed |= {44, 36, 30, 22, 19, 18, 17, 14, 13, 11, 10, 8.5}
+    # Cover/hero intermediate display sizes (not every mode lists every step)
+    allowed |= {28, 24, 22, 20, 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))
@@ -691,7 +817,8 @@ def chrome_footer_y_in(shapes: list[ET.Element], height: int) -> float | None:
     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*$")
+    # Engine footer is always "N / M"; bare integers are chart/exhibit labels (CHROME_DRIFT FP)
+    pager = re.compile(r"^\s*\d+\s*/\s*\d+\s*$")
     for shape in shapes:
         text = (text_content(shape) or "").strip()
         box = shape_bounds(shape)
@@ -784,7 +911,7 @@ def inspect_slide(
         warnings.extend(container_overflow_check(shape, slide_number))
 
     warnings.extend(annotation_band_overlap_check(
-        [*shapes, *pictures, *graphic_frames], slide_number, height))
+        [*shapes, *pictures, *graphic_frames], slide_number, height, width))
     warnings.extend(font_size_snap_check(root, slide_number))
 
     for table in tables: