@topmindspace/tms-skills 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -1,3 +1,34 @@
+## 0.1.8 — 2026-09-26
+
+### Showcase · docs · release polish
+
+- **产品 Showcase**：新增 Mode A 样张 `top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html`（+ model）——介绍 TopMind / tms-skills / top-ppt-html（三模式·风格主题·质量门禁·Fast Mode）；`validate_report --strict` 与 `smoke_pptx` **0/0**。
+- **截图**：刷新 `theme-overview*.png`；新增 `docs/showcase/`（showcase 全页 + 三黄金样张关键页）与精简 `top-ppt-html/assets/showcase/`（进技能包，供 README）。
+- **README 吸引力**：根 README + 技能 README 增加 banner、风格/模式画廊、showcase 链接与安装钉版本 **0.1.8**。
+- **Banner**：`docs/assets/tms-skills-banner.png`。
+- **打包**：`package_skill` 纳入 `assets/showcase/*`；examples 最小数量仍 ≥3（黄金样张 + 可选 showcase）。
+- **文档清理**：用户向 README 对齐当前产品面；PUBLISHING 版本线 → 0.1.8；`build_examples` 说明允许 showcase 并存。
+- 版本对齐 **0.1.8**（根 + 技能 package/lock / SKILL metadata / README）。
+
+### 红线未动
+反截断、图表多样性地板、Mode A craft、runtime SHA 同版本门禁、中文「演示文稿」术语、整仓 npm 发版。
+
+## 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 硬化

package/README.md

@@ -1,117 +1,96 @@
 # tms-skills
 
-**TopMindspace 智能体技能 monorepo** — 可安装的智能体技能集合，当前包含 **top-ppt-html**（优雅、大气、正式场合演讲/汇报演示文稿）。
+<p align="center">
+  <img src="docs/assets/tms-skills-banner.png" alt="tms-skills — TopMindspace agent skills" width="960" />
+</p>
 
-让 idea 飞，好想法被看见。
+**TopMindspace 智能体技能 monorepo** — 把好想法做成可上台的交付。
 
-## 技能一览
+当前主技能 **[top-ppt-html](./top-ppt-html/)**：优雅、大气的正式场合**演示文稿**（单文件 HTML + 版式保真可编辑 PPTX）。
 
-| 技能 | 版本 | 做什么 |
-|------|------|--------|
-| [`top-ppt-html`](./top-ppt-html/) | 0.1.6 | 优雅大气的正式场合演讲/汇报演示文稿：单文件 HTML + 版式保真可编辑 16:9 PPTX |
+> 让 idea 飞，好想法被看见。
 
-安装器包 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 亦为 **0.1.6**（整仓发版：安装器与当前技能同 tag；未来多技能仍可各自演进，默认随仓库 release）。
+## 一眼看到工艺
 
-更多技能以仓库根目录下的技能目录加入（每个目录含 `SKILL.md`）。
+| 演示 · business-blue | 研究 · mckinsey | 架构 · graphite-dark |
+|:---:|:---:|:---:|
+| ![bizblue](docs/showcase/presentation-business-blue/bizblue-cover.png) | ![mckinsey](docs/showcase/research-mckinsey/mckinsey-cover.png) | ![graphite](docs/showcase/architecture-graphite-dark/graphite-cover.png) |
 
-## 安装
+产品介绍样张（Mode A · ~10 页）：
 
-两条通道，装出来同一套技能。**npm = 钉版本快照**；**GitHub = 跟仓库 HEAD**。
+| Cover | 三模式 | 质量门禁 |
+|:---:|:---:|:---:|
+| ![cover](docs/showcase/topmind-showcase/showcase-cover.png) | ![modes](docs/showcase/topmind-showcase/showcase-s4.png) | ![gates](docs/showcase/topmind-showcase/showcase-s6.png) |
 
+- 交互画廊：[top-ppt-html/assets/style-gallery.html](./top-ppt-html/assets/style-gallery.html)
+- Showcase HTML：[top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html)
+- 主题总览图：`top-ppt-html/assets/theme-overview*.png`（Gate 0）
+- 更多截图：[docs/showcase/](./docs/showcase/)
 
-> **警告 / Warning**：不要安装 `@topmindspace/tms-skills@^2`。npm 上的 **2.0.0–2.1.1** 已弃用（仓库重置前的过时线）；当前线是 **0.1.x**（`latest` 指向 0.1.x）。请安装 `@topmindspace/tms-skills@0.1.x`。
->
-> Do **not** install `^2`. Versions **2.0.0–2.1.1 are deprecated**; use **0.1.x** (`latest` tracks 0.1.x).
+## 技能一览
 
+| 技能 | 版本 | 做什么 |
+|------|------|--------|
+| [`top-ppt-html`](./top-ppt-html/) | **0.1.8** | 正式场合演讲/汇报演示文稿：HTML 可翻页 + 16:9 可编辑 PPTX；三模式 × 九风格；strict 0/0 门禁 |
 
-### npm（推荐）
+安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 同为 **0.1.8**（整仓同 tag 发版）。
+
+## 安装
+
+**npm = 钉版本快照**；**GitHub = 跟仓库 HEAD**。
+
+> **警告**：不要安装 `@topmindspace/tms-skills@^2`（2.0.0–2.1.1 已弃用）。当前线 **0.1.x**（`latest`）。
 
 ```bash
 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.6 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills@0.1.8 install top-ppt-html   # 钉版本
 ```
 
-### GitHub 直装
-
 ```bash
+# 跟 HEAD
 npx github:topmindspace/tms-skills install top-ppt-html
-
-git clone https://github.com/topmindspace/tms-skills.git
-node tms-skills/bin/tms-skills.js install top-ppt-html
 ```
 
-### 手工
+默认探测：`./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`，再用户级 `~/.claude` 等；也可用 `--to`。不要 `npm install top-ppt-html`（技能 id 不是独立包）。
 
-解压 GitHub Release 的 `top-ppt-html.zip` 到技能目录。
+PPTX 精导需在技能目录 `npm install`（pptxgenjs）。HTML 生成仅 Python 标准库。
 
-安装器把根目录下的技能目录 `<id>/`（含 `SKILL.md`）复制到目标目录；智能体通过 frontmatter（`name` + `description`）发现技能。
+## 黄金样张
 
-默认探测顺序（`resolveDefaultTarget`）：项目级 `./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`；再用户级 `~/.claude` → `~/.agents` → `~/.cursor` → `~/.codex`；都没有则落 `./.agents/skills`。也可用 `--to` 显式指定。
-
-| 宿主 | 项目级 | 用户级 |
-|------|--------|--------|
-| 通用 / Codex | `.agents/skills` | `~/.agents/skills` |
-| Claude Code | `.claude/skills` | `~/.claude/skills` |
-| Cursor | `.cursor/skills`（兼读 `.agents`） | `~/.cursor/skills` |
-| Codex 兼容 | `.codex/skills` | `~/.codex/skills` |
-| 本仓库另含 | `.mimocode/skills` | — |
-
-> **排错**：不要 `npm install <skill-id>`（技能 id 不是独立 npm 包）。「找不到包」→ 换 GitHub 直装，或 `--registry https://registry.npmjs.org/`。
-
-### 可选依赖（仅 PPTX 精导）
-
-HTML 生成零第三方依赖（Python 标准库）。PPTX 导出需要 Node + pptxgenjs：
-
-```bash
-cd <install-dir>/top-ppt-html
-npm install
-```
+| 模式 | 文件 |
+|------|------|
+| A 演示 | [`2026-09-09-presentation-business-blue`](./top-ppt-html/assets/examples/2026-09-09-presentation-business-blue.html) |
+| B 研究 | [`2026-09-09-research-mckinsey`](./top-ppt-html/assets/examples/2026-09-09-research-mckinsey.html) |
+| C 架构 | [`2026-09-09-architecture-graphite-dark`](./top-ppt-html/assets/examples/2026-09-09-architecture-graphite-dark.html) |
+| 产品 Showcase | [`2026-09-26-topmind-tms-skills-showcase`](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html) |
 
 ## 仓库结构
 
 ```
 tms-skills/
-├─ top-ppt-html/             # 技能（SKILL.md + assets + references + scripts + evals）
+├─ top-ppt-html/             # 技能（SKILL.md + assets + references + scripts）
 ├─ bin/tms-skills.js         # CLI：list / install
-├─ docs/                     # 发布规范 · CI/Release 说明（ci.md）
-├─ scripts/                  # 仓库级工具（隐私扫描）
-├─ .github/workflows/        # CI + Release
+├─ docs/                     # 发布规范 · showcase 截图 · banner
+├─ scripts/                  # 仓库级门禁 / 隐私扫描
 ├─ package.json              # @topmindspace/tms-skills
-├─ LICENSE · CHANGELOG.md · README.md
+└─ LICENSE · CHANGELOG.md · README.md
 ```
 
-## 发布与同步
+## 发布与 CI
 
 | 动作 | GitHub | npm |
 |------|:------:|:---:|
-| push 到 main | 立即可见 | **不变** |
+| push main | 立即可见 | **不变** |
 | tag `vX.Y.Z` | Release + zip | **自动 publish** |
 
-- **push 不会更新 npm**；必须 bump 版本并打 tag。
-- **Release 只保留最近 2 个**（CI 只删旧 Release，**git tags 保留**）；npm 可钉任意历史版本。
-- 安装器与技能 **版本各自独立**；默认 patch/minor，major 仅破坏性变更。
-
-详见 [docs/PUBLISHING.md](./docs/PUBLISHING.md)。
-
-## CI
-
-| 工作流 | 触发 | 做什么 |
-|--------|------|--------|
-| `ci.yml` | push / PR | 打包门禁、审计、隐私扫描、CLI 冒烟 |
-| `release.yml` | tag `v*` | 门禁 → zip → Release → npm publish（已存在则跳过）→ prune Release 留 2（tags 保留） |
-
 ```bash
 npm run check && npm run audit && npm run privacy
+# PPTX 冒烟（含 McKinsey）：bash scripts/ci_skill_gates.sh --with-pptx
 ```
 
-## 开发新技能
-
-1. 根目录建 `<skill-id>/`，`SKILL.md` 的 `name` 与目录一致。
-2. 人类说明写 `README.md`；智能体入口保持 `SKILL.md`。
-3. 发布前 `scripts/package_skill.py --check`。
-4. 登记：根 README、`npm run sync:files`、`CHANGELOG.md`（CI 按发现的技能跑门禁，无需再硬编码）。
+详见 [docs/PUBLISHING.md](./docs/PUBLISHING.md) · [docs/ci.md](./docs/ci.md)。
 
 ## 许可证
 

package/package.json

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

package/top-ppt-html/README.md

@@ -1,14 +1,32 @@
 # TopPPT HTML
 
+<p align="center">
+  <img src="assets/showcase/showcase-cover.png" alt="TopMind × tms-skills showcase cover" width="720" />
+</p>
+
 **让 idea 飞，好想法被看见。** 面向**演讲与正式场合**的高品质演示文稿技能：把主张、调研、分析、架构方案，生成为**优雅、美观、大气**的可翻页 HTML + **版式保真可编辑 PPTX**。核心工艺是版式、排版、色彩与内容组织——克制图标/图表配文，而非 gadget 堆砌或咨询 dump 默认。
 
-- 技能标识：`top-ppt-html`（安装/打包目录名与此一致）；品牌名：**TopPPT HTML**
-- 版本：**v0.1.6**（与 `@topmindspace/tms-skills@0.1.6` 同 tag）
+- 技能标识：`top-ppt-html`；品牌名：**TopPPT HTML**
+- 版本：**v0.1.8**（与 `@topmindspace/tms-skills@0.1.8` 同 tag）
 - **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
 - **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
 
-## 一、技能简介（人类速览）
+### 风格 × 模式一览
+
+| business-blue · 演示 | mckinsey · 研究 | graphite-dark · 架构 |
+|:---:|:---:|:---:|
+| ![bb](assets/showcase/style-business-blue-cover.png) | ![mk](assets/showcase/style-mckinsey-cover.png) | ![gr](assets/showcase/style-graphite-cover.png) |
 
+| Showcase · HTML+PPTX | 三模式 | 质量门禁 |
+|:---:|:---:|:---:|
+| ![sp](assets/showcase/showcase-split.png) | ![md](assets/showcase/showcase-modes.png) | ![gt](assets/showcase/showcase-gates.png) |
+
+- 交互画廊：[`assets/style-gallery.html`](./assets/style-gallery.html)
+- 产品 Showcase：[`assets/examples/2026-09-26-topmind-tms-skills-showcase.html`](./assets/examples/2026-09-26-topmind-tms-skills-showcase.html)（Mode A · business-blue · ~10 页）
+- 主题参考图（Gate 0）：`assets/theme-overview*.png`
+- 仓库级大图集：[`docs/showcase/`](../docs/showcase/)（不进技能 zip）
+
+## 一、技能简介（人类速览）
 | 维度 | 能力 |
 |------|------|
 | 产出 | 单文件 HTML（可翻页、亮暗双主题、header 工具栏）+ 16:9 可编辑 PPTX（精导通道） |
@@ -94,10 +112,11 @@ top-ppt-html/
 ├─ assets/                      #                                           │ 且
 │  ├─ templates/                #   三份模式模板（presentation/research/architecture）  │ 入库
 │  │                            #   + engine.css / ui.js（公共引擎/UI，sync_runtime 注入源）
-│  ├─ examples/                 #   3 份黄金样张 + model（每模式 1；风格见 style-gallery）      │
+│  ├─ examples/                 #   3 黄金样张 + showcase（HTML+model）                          │
 │  ├─ pptx-export.js            #   PPTX 预览运行时（含常量/schema 注入块）   │
 │  ├─ style-gallery.html        #   风格 × 模式 × 亮暗主题交互画廊            │
-│  └─ theme-overview*.png       #   3 张主题参考图（整体=演示 / 研究 / 架构）  │
+│  ├─ theme-overview*.png       #   3 张主题参考图（整体=演示 / 研究 / 架构）  │
+│  └─ showcase/                 #   README 用精简截图（完整集见 docs/showcase） │
 ├─ references/                  # 规范（L1 常读 1 篇 + L2 按需；components/charts 已按族拆分）│  ├─ playbook.md               #   ★ L1 唯一常读入口：模式/页型/组合/图表/配色/校验 │
 │  ├─ components.md             #   逻辑索引（§ 路由到下列物理文件）              │
 │  ├─ components-atoms.md       #   §1–§15c 结构组件                              │
@@ -167,7 +186,7 @@ python scripts/check_triggers.py
 | `references/chart-decision-tree.md` | L2 图表决策树 + 七种误用 |
 | `references/default-surface.md` | Mode A L1.5：12 页型 + 核图 8 + V1–V4 |
 | `references/presentation-craft.md` | Mode A L1.5 工艺（反截断 / 大气正式） |
-| `assets/examples/` | 3 份黄金样张（每模式 1） |
+| `assets/examples/` | 3 份黄金样张（每模式 1）+ TopMind showcase |
 | `evals/trigger-queries.json` | description 触发正/负例；`check_triggers.py` |
 | `docs/archive/` | 历史规范 / 旧示例 |
 

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.6"
+  version: "0.1.8"
   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.6）≠ 布局 schema 线（layout-constants / model-schema 的 version，现 `0.1`）；patch 不抬 schema。
+包 semver（现 0.1.8）≠ 布局 schema 线（layout-constants / model-schema 的 version，现 `0.1`）；patch 不抬 schema。
 
 ## 环境依赖
 

package/top-ppt-html/agents/openai.yaml

@@ -1,5 +1,5 @@
 # Codex / ChatGPT Skills UI metadata (optional)
 display_name: "TopPPT HTML"
-short_description: "Elegant, atmospheric formal decks for speeches — HTML + editable 16:9 PPTX."
+short_description: "Elegant, atmospheric formal presentations for speeches — HTML + editable 16:9 PPTX."
 default_prompt: "Generate an elegant formal presentation or report as HTML (PPTX on request via B-channel)."
 allow_implicit_invocation: true

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));
     }