@topmindspace/tms-skills 0.1.16 → 0.1.18

package/top-ppt-html/references/page-type-matrix.md

@@ -10,15 +10,15 @@
 | 现状基线 / 指标快照 | `metrics` | `kpi` | 4–6 个；单数压场用 `kpi` |
 | 单个核心数字压场 | `kpi` | `metrics` | hero 一数一结论 |
 | 多维对标清单 | `table` | `halftable` | ≤8 行（research ≤16） |
-| 时间趋势 / 爬坡 | `bar`（chart.type=line/area/dualline） | `exhibit` | 时间点 >8 改折线 |
+| 时间趋势 / 爬坡 | `bar`（chart.type=line/area/dualline） | `exhibit` | 时间点 >8 改折线；**area 还原度 low，PPTX 优先 line** |
 | 构成占比 | `donut`（pie/multidonut/waffle） | `halftable` / **V3 KPI** | 扇区 ≤5，最小扇区 ≥8%；**极偏（min<5% 或 max/min>20）禁 donut→V3** |
 | 排名 / 大小对比 | `bar`（chart.type=hbar/lollipop/pareto） | `table` | 类别 >8 取 Top 7 + 附录 |
-| 现状 vs 目标 | `bullet` / `comparison` | `bar`（vsbar/bulletchart） | 目标线与实际条同量纲 |
+| 现状 vs 目标 | `bullet` / `comparison` | `bar`（vsbar/bulletchart） | 目标线与实际条同量纲；comparison 的 `verdict`/`soWhat` **二选一** |
 | 两期升降（谁升谁降） | `bar`（slope/dumbbell） | `table` | 两端都要标数值 |
 | 双维分布 / 优先级 | `bar`（scatter/bubble） | `matrix` | 气泡半径 ∝ √值 |
-| 分布 / 离散度 | `boxplot` | `bar`（dotplot） | 组数 ≤8；箱线四件齐备 |
+| 分布 / 离散度 | `boxplot` | `bar`（dotplot） | 组数 ≤8；箱线四件齐备；**boxplot 还原度 low，PPTX 改 dotplot** |
 | 增减归因（A→B） | `bar`（waterfall） | `table` | 每段标变化量 + 合计收口 |
-| 转化 / 筛选漏斗 | `bar`（funnel） | `sankey` | 层数 ≤5 |
+| 转化 / 筛选漏斗 | `bar`（funnel） | `sankey` | 层数 ≤5；**sankey 还原度 low，PPTX 改 table** |
 | 计划排期（并行） | `bar`（gantt） | `timeline` | 里程碑叙事用 `timeline`，勿混 |
 | 里程碑 / 路线叙事 | `timeline` | `steps` | 3–5 个，每个 ≤2 行 |
 | 步骤 / 实施节奏 | `steps` | `timeline` | 3–6 步；高亮步 ≤2 处 |
@@ -28,8 +28,12 @@
 | 关键判断 / 金句休止 | `quote` | `points` | 全文 1–2 处，多了廉价 |
 | 完整论述（发现→证据→含义） | `twocol`（research R1） | `threecol` | 段 ≤200 字；标题必须结论句 |
 | 数据证据页（主力） | `exhibit`（R2） | `split` | 全篇 Exhibit 连续编号 |
-| 三栏并列论点 | `threecol`（R6） | `cards` | 每栏 ≤150 字 |
-| 系统分层架构 | `diagram` | `bar`（chart.type=network） | 节点 ≤24；层 ≤4 |
+| 三栏并列论点 | `threecol`（R6） | `cards` | 每栏 ≤150 字；栏宽按版心全宽推导 |
+| 系统分层架构 | `diagram` | `bar`（chart.type=network） | 节点 ≤24；层 ≤4；**network 还原度 low** |
 | 流程 / 职责协作 | `lane` | `diagram` | 每行 ≤6 步；正交折线优先 |
 | 素材图片（实拍/截图） | `image` | `split` | 六版式；无图用 `image.placeholder` |
 | 待核实项收口 | `flags` 字段 | `table` | 标色必须配说明 |
+| 大纲 / 议程 | `agenda`（结构页） | — | ≤8 条单列；>8 双列；>12 自动分页；标题 ≤36 字 |
+
+> **容量契约**（超限请拆页/换形态，禁静默截断）：agenda ≤16 条（`splitMax`）、单条标题 ≤36 字（`titleMaxChars`）；metrics ≤6/行、值 ≤6 字；diagram ≤3 层 × 每层 ≤3 节点、层名 ≤7 字、注解 ≤10 字；timeline ≤5 段、每段说明 ≤22 字；comparison `verdict`/`soWhat` 二选一；threecol/twocol 每栏 ≥120 字、段数 <4 时用三栏；表格单元格 ≤14 字、行 ≤8（research ≤16）。
+> **PPTX 还原度**（`charts.fidelityMap`）：`high` = bar/hbar/line/donut/stack/waterfall/gauge/pareto/progress 等；`low` = area/radar/treemap/sankey/streamgraph/marimekko/boxplot/network——PPTX 会退化，优先改 high 图型或 `dataTable=inline`。完整分级见 `chart-decision-tree.md`。

package/top-ppt-html/references/pptx-export.md

@@ -108,7 +108,7 @@ HTML 侧仍用 MD3 clamp；双端都以「最后一排可读」为准（`present
 
 > 几何常量见 `layout-constants.json` `pageTypes.{sankey,treemap,boxplot,network,marimekko,streamgraph}`（含节点/流带上限、采样点下限、双边界追踪约束）；版式与生成规则详见 `references/infographics.md`。
 
-**通用可选字段（全部页型）**：`soWhat`（结论条，MD3 tonal soft 满铺、**无左轨**；**不绘制「SO WHAT」标签**）、`footnote`（页脚来源行）、`flags`（**待核实标注清单** `["…"]` → accent 强调色清单条，提示用户二次确认，并写入演讲者备注）、`image`（素材图片 / 配图占位，见 `image` 页型）、`exhibitNo`（非 exhibit 页型也可带 Exhibit 徽标）。research 模式 `soWhat/footnote` **只在关键论证页填写**（克制条款；结论条无 So what 字样）；comparison 页型的 `verdict` 为 accent 实底结论条。
+**通用可选字段（全部页型）**：`soWhat`（结论条，MD3 tonal soft 满铺、**无左轨**；**不绘制「SO WHAT」标签**）、`footnote`（页脚来源行）、`note`（口径注，与 `footnote` 共用注释带末行 `footnoteY=6.72`，同页二者自动合并为一行）、`flags`（**待核实标注清单** `["…"]` → accent 强调色清单条，提示用户二次确认，并写入演讲者备注）、`image`（素材图片 / 配图占位，见 `image` 页型）、`exhibitNo`（非 exhibit 页型也可带 Exhibit 徽标）。research 模式 `soWhat/footnote` **只在关键论证页填写**（克制条款；结论条无 So what 字样）。**`verdict` 与 `soWhat` 互斥**（共用 annotation 结论条槽位，同页双填必叠印）——comparison 页填 `verdict`（accent 实底结论条）时不要再填 `soWhat`；渲染器自动二选一（verdict 优先），`extract_model` 对同页双填发 WARN。
 
 > **素材图片（单源 `layout-constants.json` 的 `imageSpec`）**：`image` 三选一必填——`src`（用户图，data: 内联或相对路径）｜`items:[{src,alt?,caption?,placeholder?}]`（多图版式）｜`placeholder:true`（**配图占位**，无素材时锁版式用）。
 > - **六版式**（`layout`）：`full` 版心全宽 3:1｜`half` 左图右注 4:3｜`bleed` 通栏出血 21:9｜`grid` 多图网格 4:3（2/3/4/6 张）｜`compare` 双图 A/B 4:3｜`wall` Logo 墙 1:1。比例写在 `imageSpec.ratioDefault`，**HTML 用同比例锁定类、PPTX 用同一比例算高度并垂直居中**——两通道版式一致。
@@ -118,7 +118,7 @@ HTML 侧仍用 MD3 clamp；双端都以「最后一排可读」为准（`present
 > - **准入门**：`imageAdmission`（`forbidden` 禁图片化区域 / `allowed` 可保留的复杂视觉资产 / `maxPageAreaPct` 40% / `fullSlideRiskPct` 90%）。
 > - **素材准备**：`python scripts/prepare_images.py <图片|目录> --layout full|half|grid…` → 产出可粘贴的 `.media` HTML 片段与 `image` 模型对象（自动缩放/压缩/内联，体积超限自动转相对路径）。
 
-> **图表双通道**：图表类型与通道归属以 `scripts/layout-constants.json` 的 `charts.registry` 为唯一事实源（四元组：`html` 实现 / `pptx` 通道 / `nativeType` 或 `path` 几何约束 / `dataTable` 策略）。
+> **图表双通道**：图表类型与通道归属以 `scripts/layout-constants.json` 的 `charts.registry` 为唯一事实源（四元组：`html` 实现 / `pptx` 通道 / `nativeType` 或 `path` 几何约束 / `dataTable` 策略）。**PPTX 还原度分级**（`charts.fidelityMap`）：`high` 双通道等价｜`medium` 形状可读但视觉降级｜`low` PPTX 显著退化（area/radar/treemap/sankey/streamgraph/marimekko/boxplot/network）。**交付 PPTX 时优先 high 图型**（`bar`/`hbar`/`line`/`donut`），或对 low 图型强制 `dataTable=inline` 补数据表——详见 `chart-decision-tree.md`。
 > - **原生通道（16 类，`pptx:"native"`）**：`bar / hbar / stack / stackline / line / dualline / area / donut / multidonut / pie / radar / scatter / bubble` + 3 类原生技巧 `waterfall`（堆叠柱 + 隐藏基底 + 累计连接线）、`gauge`（doughnut + firstSliceAng 270° 扇形）、`pareto`（多类型组合：柱 + 累计折线）——一律走 `pptxgenjs addChart`，产出真 chart part + 内嵌 Excel 工作簿，PowerPoint/WPS 中双击即可"编辑数据"。`chart.series` 传多系列（`[{name, values}…]`）；`chart.points` 传 XY 点（scatter `[[x,y]…]` / bubble `[[x,y,size]…]`）。
 > - **形状通道（`pptx:"shape"`，20 类）**：全部走 OOXML 原生形状高保真还原（`charts.registry[type].path` 约束采样点下限、双边界追踪、禁预设形状替代）。按**载荷形态**分两组：
 >   - **可作 `chart.type` 的 14 类**（载荷 = `chart:{labels, values, series?, start?, target?, max?, unit?}`）：`funnel / gantt / vsbar / progress / sparkline / slope / dumbbell / lollipop / dotplot / bulletchart / waffle / radialbar / rose / candlestick`——由 `bar` / `exhibit` / `halftable` / `split` 页型承载。
@@ -129,7 +129,7 @@ HTML 侧仍用 MD3 clamp；双端都以「最后一排可读」为准（`present
 > - **A/B 双通道语义一致**：A 通道（浏览器预览 `pptx-export.js`）对所有类型做形状近似（类别标签与数值都落为文本），B 通道交付走原生图表；`cross_verify.py` 对两侧文本做归一化（chart categories 并入 + `NUMERIC_TOKEN` 纯数值过滤 + `sorted(set())` 去重），并额外核对 **B 通道原生图表数值 ↔ 模型数值**（类别标签一致不代表数值一致）。
 > - **通道能力边界（演讲者备注）**：A 预览通道**不产 notesSlide**（浏览器预览也看不到备注），故 `MODEL_CHART_NOTES_MISSING` 与 `MODEL_CHART_COUNT` 同走 `--allow-shape-charts` 豁免；**交付通道（B）不豁免**——`dataTable=notes` 的图表必须在备注里真的有数据表。
 >
-> **自适应排版**：所有文本块按可用高度自适应字号/行距（`fitFont`），表格行高按可用高度计算，列表/泳道/矩阵/卡片行高随容器收敛——保证不越界、不重叠（`validate_pptx.py` 硬拦越界与文本溢出）。
+> **自适应排版**：所有文本块按可用高度自适应字号/行距（`fitFont`），表格行高按可用高度计算，列表/泳道/矩阵/卡片行高随容器收敛——保证不越界、不重叠（`validate_pptx.py` 硬拦越界与文本溢出）。**几何铁律**：① 架构节点标题/注解按实际节点高度钳制（注解不得「浮回」标题上，空间不足降级单框混排）；② 图表类目标签含在图高 `h` 内（禁画到 `y+h` 外压 so-what）；③ 多栏均分用**版心全宽**推导（`(CW-(n-1)×gap)/n`，禁用单栏宽当总宽）；④ 图例落图区底部（`bodyBottom-0.28`），禁用页面底部固定偏移；⑤ KPI 支撑指标列在 `dividerX` 右侧（禁全宽默认返回压住 hero）；⑥ 有图注时图片下界收到 `contentBottomWithNote`。Agenda：>8 条自动双列、>12 条自动分页（Agenda I/II）、长标题截断全称沉 notes（`titleMaxChars=36`）、两通道列优先一致。
 
 > 保真机制：每种子页型对应 HTML 的一种锁定版式（`components.md` §36d/§37–38b/§39–42 ↔ 页型表），坐标/字号按同一套常量映射（`layout-constants.json` 的 `pageTypes` + `modeTypeScale`）。**三模式独立比例尺**：research 密排（正文 10.5pt、h1 22pt）；architecture 与 presentation 同基但 diagram 走全幅几何。图表颜色：**9 套风格各有自己的编码色板 c1–c5**（单源 `styleDataColors` / `styleDataColorsDark`，按 `model.theme` 选择），多系列图表自动取用（`dataColors(style, theme)`）；未登记风格时回落「accent / faint / body / line」四阶单色系。**页型字段与必填约束以 `model-schema.json` 为唯一事实源**（`:array` = 非空数组、`:str` = 非空字符串），浏览器端 `validateModel` 与 `extract_model.py` 校验同一份定义。
 

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

@@ -381,6 +381,15 @@ function footnoteLine(s, text) {
   s.addText(text, { x: R.x, y: R.y, w: R.w, h: R.h,
     fontFace: STYLE.font, fontSize: sz(9.5), color: STYLE.faint, objectName: trName('footnote') });
 }
+/* R2：sec.note 与 sec.footnote 共用注释带末行（footnoteY=6.72）。
+   note.y=6.55 会压进 so-what 带——同页二者合并为一行。 */
+function noteOrFootnote(s, sec) {
+  const parts = [];
+  if (sec && sec.note) parts.push(String(sec.note));
+  if (sec && sec.footnote) parts.push(String(sec.footnote));
+  if (!parts.length) return;
+  footnoteLine(s, parts.join('　·　'));
+}
 /* 待核实清单条（accent 强调色标注 · 与 HTML .flagbar 同源）
  * 底对齐 contentBottom，正文区在调用点按 flagH 让位。 */
 function flagBar(s, items, yTop) {
@@ -1584,30 +1593,55 @@ function addTable(s, tbl, x, y, w, availH, opts) {
   s.addNotes([CONTENT.subtitle, CONTENT.meta].filter(Boolean).join('\n'));
 })();
 
-/* Agenda（architecture 极简形态可省略 agenda → 不产出大纲页；>8 条自动双列；行高自适应防溢出） */
+/* Agenda（architecture 极简形态可省略 agenda → 不产出大纲页；
+   >8 条自动双列；>12 条自动分页 Agenda I/II；长标题截断+全称入 notes；
+   行高自适应防溢出；列填充与 HTML 统一为列优先） */
 (function agenda() {
   if (!Array.isArray(CONTENT.agenda) || !CONTENT.agenda.length) return;
-  const s = base();
-  head(s, 'AGENDA', '报告大纲');
   const items = CONTENT.agenda;
-  const colN = items.length > 8 ? 2 : 1;
-  const perCol = Math.ceil(items.length / colN);
-  /* 预留 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);
-  items.forEach((it, i) => {
-    const col = Math.floor(i / perCol), row = i % perCol;
-    const x = MX + col * (CW / colN), y = CONTENT_TOP + row * rowH;
-    s.addText(it[0], { x, y, w: 0.9, h: rowH - 0.05, fontFace: STYLE.font, fontSize: numSize,
-      bold: true, color: STYLE.accent, valign: 'top' });
-    s.addText([
-      { text: it[1] + '\n', options: { fontSize: tSize, bold: true, color: STYLE.ink } },
-      { text: it[2] || '', options: { fontSize: dSize, color: STYLE.body } },
-    ], { x: x + 1.0, y: y + 0.03, w: CW / colN - 1.15, h: rowH - 0.08, fontFace: STYLE.font,
-      valign: 'top', lineSpacing: tSize + 5 });
+  /* R4：单页容量 = 双列 × 每列最多 6 行（行高 ≥0.55in 可读） */
+  const ROWS_PER_PAGE = 12;
+  const pages = [];
+  for (let i = 0; i < items.length; i += ROWS_PER_PAGE) pages.push(items.slice(i, i + ROWS_PER_PAGE));
+  pages.forEach((pageItems, pi) => {
+    const s = base();
+    const sub = pages.length > 1 ? `（${pi + 1}/${pages.length}）` : '';
+    head(s, 'AGENDA', '报告大纲' + sub);
+    const colN = pageItems.length > 8 ? 2 : 1;
+    const perCol = Math.ceil(pageItems.length / colN);
+    /* 预留 0.25in，避免末行底边落入 severe-overlap 安全网 */
+    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);
+    const notes = [];
+    pageItems.forEach((it, i) => {
+      /* 列优先：先填左列再填右列（与 HTML grid-auto-flow:column 一致） */
+      const col = Math.floor(i / perCol), row = i % perCol;
+      const x = MX + col * (CW / colN), y = CONTENT_TOP + row * rowH;
+      /* R4：标题按盒宽估算折行，超 1 行则截断并把全称沉 notes */
+      const titleBoxW = CW / colN - 1.15;
+      const rawTitle = String(it[1] || '');
+      const titleEstW = estTextH(rawTitle, titleBoxW, tSize, 1.2);
+      const maxTitleH = rowH * 0.55;
+      let title = rawTitle;
+      if (titleEstW > maxTitleH) {
+        const maxChars = Math.max(10, Math.floor(rawTitle.length * (maxTitleH / titleEstW)));
+        if (rawTitle.length > maxChars) {
+          title = rawTitle.slice(0, maxChars - 1) + '…';
+          notes.push(`条目 ${it[0]} 全称：${rawTitle}`);
+        }
+      }
+      s.addText(it[0], { x, y, w: 0.9, h: rowH - 0.05, fontFace: STYLE.font, fontSize: numSize,
+        bold: true, color: STYLE.accent, valign: 'top' });
+      s.addText([
+        { text: title + '\n', options: { fontSize: tSize, bold: true, color: STYLE.ink } },
+        { text: it[2] || '', options: { fontSize: dSize, color: STYLE.body } },
+      ], { x: x + 1.0, y: y + 0.03, w: titleBoxW, h: rowH - 0.08, fontFace: STYLE.font,
+        valign: 'top', lineSpacing: tSize + 5 });
+    });
+    if (notes.length) s.addNotes(notes.join('\n'));
   });
 })();
 
@@ -1729,15 +1763,18 @@ CONTENT.sections.forEach((sec) => {
         ], { x: sd.x + 0.5, y: py, w: cw2 - 0.75, h: rowH - 0.04, fontFace: STYLE.font, valign: 'top' });
       });
     });
+    /* R2：verdict 与 soWhat 共用 annotation 槽位——只画一个（verdict 优先，语义更具体）。
+       两者同页必须互斥，否则结论条整条叠印。 */
     if (sec.verdict) {
       const vreg = REGIONS.regionOf('exhibit', 'annotation') ||
         { x: MX, y: PT.exhibit.soWhatY, w: CW, h: 0.62 };
       s.addShape('rect', { x: vreg.x, y: vreg.y, w: vreg.w, h: vreg.h,
-        fill: { color: STYLE.accent }, line: { type: 'none' } });
+        fill: { color: STYLE.accent }, line: { type: 'none' }, objectName: trName('soWhat') });
       s.addText([
         { text: '结论　', options: { fontSize: sz(11), bold: true, color: STYLE.onAccent, charSpacing: 1.5 } },
         { text: sec.verdict, options: { fontSize: sz(12.5), bold: true, color: STYLE.onAccent } },
-      ], { x: vreg.x + 0.22, y: vreg.y + 0.06, w: vreg.w - 0.44, h: vreg.h - 0.12, fontFace: STYLE.font, valign: 'middle' });
+      ], { x: vreg.x + 0.22, y: vreg.y + 0.06, w: vreg.w - 0.44, h: vreg.h - 0.12, fontFace: STYLE.font,
+        valign: 'middle', objectName: trName('soWhat') });
     }
   } else if (type === 'quote') {
     const Q = PT.quote;
@@ -1808,8 +1845,6 @@ CONTENT.sections.forEach((sec) => {
           align: 'right', valign: 'middle', fontFace: STYLE.font, fontSize: sz(10.5), color: STYLE.faint });
       });
     }
-    if (sec.note) s.addText(sec.note, { x: MX, y: PT.note.y, w: CW, h: PT.note.h,
-      fontFace: STYLE.font, fontSize: sz(11), color: STYLE.faint });
   } else if (type === 'heatmap') {
     /* 热力矩阵：行 × 列 + 4 级色阶（surface-1 → accent-soft → accent-soft-2 → accent） */
     const H = PT.heatmap;
@@ -1993,7 +2028,7 @@ CONTENT.sections.forEach((sec) => {
   } else if (type === 'bar') {
     const c = sec.chart || {};
     const dcols = c.colors || dataColors(styleArg);
-    const bot = chartBottom(!!sec.soWhat, !!sec.footnote) - (sec.note ? 0.42 : 0.05);
+    const bot = chartBottom(!!sec.soWhat, !!(sec.footnote || sec.note)) - 0.05;
     const isH = c.type === 'hbar';
     const reg = REGIONS.regionOf('bar', isH ? 'hbar' : 'primary', { bottom: bot }) ||
       { x: MX, y: isH ? PT.bar.hbarY0 : PT.bar.chartY, w: CW, h: 3 };
@@ -2022,15 +2057,13 @@ CONTENT.sections.forEach((sec) => {
     } else {
       chartBlock(s, c, cx, reg.y, cw, Math.max(1.5, reg.h), dcols);
     }
-    if (sec.note) s.addText(sec.note, { x: MX, y: PT.note.y, w: CW, h: PT.note.h, fontFace: STYLE.font,
-      fontSize: sz(11), color: STYLE.faint });
   } else if (type === 'twocol' || type === 'threecol') {
     const ps = sec.paragraphs || [];
     const nCol = (type === 'threecol') ? 3 : 2;
     const gap = (type === 'threecol') ? PT.research.col3Gap : PT.twocol.colGap;
-    const treg = REGIONS.regionOf('twocol', 'primary', { top: bodyY, bottom: bodyBottom }) ||
-      { x: MX, y: bodyY, w: CW, h: bodyBottom - bodyY };
-    /* threecol 用 3 栏均分（twocol IR 的 colW 仅适用 2 栏） */
+    /* R3：多栏均分必须用版心全宽。regionOf('twocol','primary') 返回的是「单栏宽」，
+       直接当总宽再 cols() 会把三栏压成 1.69in、右侧 55% 全空。 */
+    const treg = { x: MX, y: bodyY, w: CW, h: bodyBottom - bodyY };
     const g = cols(treg.w, nCol, gap);
     const per = Math.ceil(ps.length / nCol);
     const availH = treg.h;
@@ -2258,11 +2291,30 @@ CONTENT.sections.forEach((sec) => {
         const nds = isRec(nd) ? (nd.d || '') : '';
         s.addShape('roundRect', { x, y, w: nw, h: lh, rectRadius: 0.06,
           fill: { color: acc ? STYLE.soft : STYLE.surface }, line: { color: STYLE.line, width: 0.75 } });
-        s.addText(ntt, { x: x + 0.12, y: y + (nds ? 0.12 : lh / 2 - 0.2), w: nw - 0.24, h: 0.38,
-          fontFace: STYLE.font, fontSize: sz(12.5), bold: true, color: acc ? STYLE.accent : STYLE.ink,
-          valign: nds ? 'top' : 'middle' });
-        if (nds) s.addText(nds, { x: x + 0.12, y: y + lh - 0.5, w: nw - 0.24, h: 0.4,
-          fontFace: STYLE.font, fontSize: sz(10), color: STYLE.faint });
+        /* 节点内标题/注解：注解底对齐会「浮回」标题上（R1）。改为标题顶对齐 + 注解钳在标题下边；
+           空间不足时降级为单框混排（标题粗体 + 注解小字），禁止叠印。 */
+        const padX = 0.12, padY = 0.10;
+        const innerW = nw - padX * 2;
+        const titleH = 0.32, noteH = 0.34, gapTN = 0.04;
+        const needH = titleH + gapTN + (nds ? noteH : 0) + padY * 2;
+        if (!nds || lh >= needH) {
+          const tY = y + padY;
+          s.addText(ntt, { x: x + padX, y: nds ? tY : y + lh / 2 - 0.18, w: innerW, h: titleH,
+            fontFace: STYLE.font, fontSize: sz(nds ? 12 : 12.5), bold: true,
+            color: acc ? STYLE.accent : STYLE.ink, valign: 'middle' });
+          if (nds) {
+            const nY = Math.max(tY + titleH + gapTN, y + lh - padY - noteH);
+            s.addText(nds, { x: x + padX, y: nY, w: innerW, h: Math.min(noteH, y + lh - padY - nY),
+              fontFace: STYLE.font, fontSize: sz(10), color: STYLE.faint, valign: 'top' });
+          }
+        } else {
+          /* 空间不足：单框混排（同一文本框内富文本，禁拆两框叠印） */
+          s.addText([
+            { text: ntt, options: { fontSize: sz(11), bold: true, color: acc ? STYLE.accent : STYLE.ink, breakLine: true } },
+            { text: nds, options: { fontSize: sz(9), color: STYLE.faint } },
+          ], { x: x + padX, y: y + padY * 0.5, w: innerW, h: lh - padY,
+            fontFace: STYLE.font, valign: 'top', lineSpacing: sz(11 * 1.25) });
+        }
       });
       if (li < lys.length - 1) {
         const cy = y + lh + D.layerGap / 2;
@@ -2275,10 +2327,15 @@ CONTENT.sections.forEach((sec) => {
       }
     });
     if (sec.legend) {
-      let lx = MX;
-      sec.legend.forEach((lg) => {
-        s.addText('● ' + lg, { x: lx, y: PH - 0.62, w: 3.2, h: 0.3, fontFace: STYLE.font, fontSize: sz(10), color: STYLE.faint });
-        lx += 2.0;
+      /* R2：图例进图区底部（与 HTML .arch__legend 同源），禁用 PH-0.62 固定偏移——
+         那会压到来源行(6.72)与页码(7.0)。图例条自适应行内均分，右对齐。 */
+      const lgH = 0.28;
+      const lgY = Math.max(dStart, bodyBottom - lgH - 0.02);
+      const nLg = Math.max(1, sec.legend.length);
+      const step = Math.min(2.4, CW / nLg);
+      sec.legend.forEach((lg, li) => {
+        s.addText('● ' + lg, { x: MX + CW - nLg * step + li * step, y: lgY, w: step - 0.05, h: lgH,
+          fontFace: STYLE.font, fontSize: sz(10), color: STYLE.faint, align: 'left' });
       });
     }
   } else if (type === 'exhibit') {
@@ -2348,8 +2405,10 @@ CONTENT.sections.forEach((sec) => {
     }
   }
   /* research 通用可选件：so-what 结论条 + 页脚来源行 + 待核实条（所有页型共用同一槽位） */
-  if (sec.soWhat) soWhatBar(s, sec.soWhat);
-  if (sec.footnote) footnoteLine(s, sec.footnote);
+  /* R2：verdict 已占 annotation 槽位时跳过 soWhat，禁止同槽双条叠印 */
+  if (sec.soWhat && !sec.verdict) soWhatBar(s, sec.soWhat);
+  /* R2：note 与 footnote 共用注释带末行（禁 note.y=6.55 压 so-what） */
+  noteOrFootnote(s, sec);
   if (flagH) flagBar(s, flagItems, flagY);
   /* 演讲者备注（口径/含义/来源沉 notes，不堆版面） */
   const _notes = [];

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

@@ -58,6 +58,7 @@ def slide_texts(prs):
         for shape in slide.shapes:
             if shape.has_text_frame:
                 for line in shape.text_frame.text.splitlines():
+
                     t = line.strip()
                     if t and not NUMERIC_TOKEN.match(t):
                         texts.append(t)
@@ -193,6 +194,58 @@ def overflow_estimate(prs, name):
     return issues
 
 
+# ── R6 跨通道一致性（Agenda 阅读顺序 / 元素数量 / 图表数据标签） ──
+
+def agenda_order(prs) -> list[str]:
+    """大纲页条目阅读顺序（第 2 页，按 y 再 x 排序的短文本序列）。"""
+    if len(prs.slides) < 2:
+        return []
+    items = []
+    for shape in prs.slides[1].shapes:
+        if not shape.has_text_frame:
+            continue
+        t = shape.text_frame.text.strip()
+        if not t or len(t) > 60:
+            continue
+        # 序号行（01/02…）或短标题——取前 20 个稳定 token 作顺序指纹
+        items.append((round(shape.top / 914400, 1), round(shape.left / 914400, 1), t[:24]))
+    items.sort()
+    return [t for _, _, t in items[:20]]
+
+
+def element_counts(prs) -> list[tuple[int, int, int]]:
+    """每页 (shapes, pictures, charts) 数量——跨通道应对齐（A 形状近似 vs B 原生图表可有 1 图差）。"""
+    out = []
+    for slide in prs.slides:
+        shapes = sum(1 for s in slide.shapes if s.shape_type is not None)
+        pics = sum(1 for s in slide.shapes if s.shape_type == 13)  # PICTURE
+        charts = sum(1 for s in slide.shapes if getattr(s, 'has_chart', False))
+        out.append((shapes, pics, charts))
+    return out
+
+
+def chart_label_presence(prs) -> list[int]:
+    """含图表的页是否有数据标签/数值文本（防「图表无标签」静默退化）。"""
+    flagged = []
+    for i, slide in enumerate(prs.slides, 1):
+        has_chart = any(getattr(s, 'has_chart', False) for s in slide.shapes)
+        if not has_chart:
+            continue
+        has_numeric = False
+        for s in slide.shapes:
+            if s.has_text_frame:
+                for line in s.text_frame.text.splitlines():
+                    if NUMERIC_TOKEN.match(line.strip()):
+                        has_numeric = True
+                        break
+            if has_numeric:
+                break
+        # 原生 chart part 的数据在 chart XML 里（不进 text_frame）——只对形状通道严格
+        if not has_numeric and not any(getattr(s, 'has_chart', False) for s in slide.shapes):
+            flagged.append(i)
+    return flagged
+
+
 def main() -> int:
     if Presentation is None:
         print('python-pptx 未安装')
@@ -270,7 +323,37 @@ def main() -> int:
             fails.append(f'{name}: B 通道出现 A 没有的字号 {alien}'
                          f'（两通道应同走 modeTypeScale；modeSize() 与 sz() 的钳制/取整须一致）')
         sz_note = ' 字号比例尺=' + ('PASS' if not alien else 'DRIFT')
-        print(f'{name}: A可解析✓ B可解析✓ 页数={len(ta)} 逐页文本={status}{chart_note}{sz_note}')
+        # ⑥ 跨通道一致性：Agenda 阅读顺序 / 元素数量 / 图表数据标签
+        ao_a, ao_b = agenda_order(prs_a), agenda_order(prs_b)
+        ag_note = ''
+        if ao_a and ao_b and ao_a != ao_b:
+            fails.append(f'{name}: Agenda 阅读顺序不一致 A={ao_a[:4]}… B={ao_b[:4]}…')
+            ag_note = ' Agenda序=DRIFT'
+        elif ao_a and ao_b:
+            ag_note = ' Agenda序=PASS'
+        ec_a, ec_b = element_counts(prs_a), element_counts(prs_b)
+        # A/B 图表实现路径不同（形状近似 vs 原生/形状），形状总数不可比。
+        # 只对图片数（应精确一致）做硬比对——图片是同一份素材，数量错=内容丢失。
+        cnt_diff = []
+        for i, ((sa, pa, ca), (sb, pb, cb)) in enumerate(zip(ec_a, ec_b), 1):
+            if pa != pb:
+                cnt_diff.append((i, f'pics A={pa} B={pb}'))
+        cnt_note = ''
+        if cnt_diff:
+            fails.append(f'{name}: 图片数量不一致 {cnt_diff[:3]}（同一模型应同数）')
+            cnt_note = ' 图片数=DRIFT'
+        else:
+            cnt_note = ' 图片数=PASS'
+        lab_a = chart_label_presence(prs_a)
+        lab_b = chart_label_presence(prs_b)
+        lab_note = ''
+        if lab_a or lab_b:
+            fails.append(f'{name}: 图表缺数据标签 A页{lab_a} B页{lab_b}（形状通道须附数值）')
+            lab_note = ' 图表标签=MISS'
+        else:
+            lab_note = ' 图表标签=PASS'
+        print(f'{name}: A可解析✓ B可解析✓ 页数={len(ta)} 逐页文本={status}{chart_note}{sz_note}'
+              f'{ag_note}{cnt_note}{lab_note}')
 
     print('\n── 溢出启发式（check-overflow · 18% 容差）──')
     if all_overflow:

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

@@ -95,6 +95,11 @@ def validate_against_schema(model, schema):
         warnings.append(f"章节页仅 {len(secs)} 页，正式报告建议 ≥3")
     if len(ag) > ms.get('agendaComfortMax', 16):
         warnings.append(f"agenda {len(ag)} 条超出单页舒适上限，建议拆分")
+    # R2：verdict 与 soWhat 共用 annotation 槽位——同页双填必叠印
+    for i, sec in enumerate(secs if isinstance(secs, list) else []):
+        if isinstance(sec, dict) and sec.get('verdict') and sec.get('soWhat'):
+            warnings.append(
+                f"sections[{i}] 同时填写 verdict 与 soWhat（共用结论条槽位，渲染会叠印）——请二选一")
     return missing, warnings
 
 

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

@@ -835,8 +835,47 @@
       "preferCoreFirst": true,
       "corePreferMin": 3
     },
+    "fidelityMap": {
+      "$comment": "PPTX 还原度分级：high=双通道等价（原生图表或简单形状）；medium=形状还原可读但视觉降级；low=复杂信息图在 PPTX 显著退化（面积图变实心楔形、桑基/树图/流带近似），建议改 bar/line/hbar 或强制 dataTable=inline。validate_report 对 low 图型发 WARN。",
+      "bar": "high",
+      "hbar": "high",
+      "stack": "high",
+      "stackline": "high",
+      "line": "high",
+      "dualline": "high",
+      "donut": "high",
+      "multidonut": "high",
+      "pie": "high",
+      "scatter": "high",
+      "bubble": "high",
+      "waterfall": "high",
+      "gauge": "high",
+      "pareto": "high",
+      "progress": "high",
+      "vsbar": "high",
+      "sparkline": "high",
+      "funnel": "medium",
+      "slope": "medium",
+      "dumbbell": "medium",
+      "lollipop": "medium",
+      "dotplot": "medium",
+      "bulletchart": "medium",
+      "waffle": "medium",
+      "radialbar": "medium",
+      "rose": "medium",
+      "gantt": "medium",
+      "candlestick": "medium",
+      "area": "low",
+      "radar": "low",
+      "treemap": "low",
+      "sankey": "low",
+      "streamgraph": "low",
+      "marimekko": "low",
+      "boxplot": "low",
+      "network": "low"
+    },
     "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 按本表断言。",
+      "$comment": "图表登记四元组：pptx=native 走 addChart（真 chart part + 内嵌 Excel，双击可编辑数据）；pptx=shape 走 OOXML 原生形状/SVG path 高保真还原，且**必须**按 dataTable 策略附数据表保证数据可追溯；nativeTrick = 用原生图表技巧实现的类型；path = 形状还原的几何约束（采样点下限 / 双边界追踪 / 禁预设形状）。build_pptx.js 与 pptx-export.js 双引擎按本表分派，validate_pptx.py 按本表断言。PPTX 还原度分级见 charts.fidelityMap。",
       "bar": {
         "html": "svg-bars",
         "pptx": "native",
@@ -1307,9 +1346,10 @@
       "judgmentPattern": "\\d|[二两三四五六七八九十半]|一(?!览|体|致|直|些|般|系列|同|起|方面)|是(?!否)|应(?!用|急|对|届)|需(?!求)|将(?!来|近)|增|降|优先|瓶颈|关键|高于|低于|快于|慢于|第一|唯一|从.{1,12}到|翻倍|过半|不足|领先|落后|卡在|分化|出现|成为|仍|并非|必须|才能|才是|最大|最浅|最深|马当先|明显|尚在|已(?!知)|提升|贡献|占比|领跑|先行|滞后|分野|显著|差异|穿越|兑现|放量|[：:—–]"
     },
     "agenda": {
-      "$comment": "大纲条目数阈值：≤singleMax 单列；>singleMax 须 .agenda--2col（两列/两排）；>splitMax 拆上篇/下篇或只列一级章节。scaffold / validate_report 消费。",
+      "$comment": "大纲条目数阈值：≤singleMax 单列；>singleMax 须 .agenda--2col（两列/两排）；>splitMax 拆上篇/下篇或只列一级章节。titleMaxChars = 单条标题字数上限（超长截断+全称沉 notes）。scaffold / validate_report 消费。",
       "singleMax": 8,
       "splitMax": 16,
+      "titleMaxChars": 36,
       "twoColClass": "agenda--2col"
     },
     "pageHeight": {

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

@@ -312,10 +312,13 @@ function regionOf(pageType, slotId, opts) {
   if (type === 'image') {
     if (slot === 'primary') {
       const y = Math.max(PT.y || 2.3, (opts && opts.top) || 0);
-      const bottom = (opts && opts.bottom != null) ? opts.bottom : L.contentBottom;
-      const capH = (opts && opts.caption) ? 0.32 : 0;
+      /* R2：有图注时图片不得越过 contentBottomWithNote（图注本身落在注释带，属 annotation self）。
+         否则图片底边（如 6.58）会被判「主内容侵入注释带」。 */
+      const hasCap = !!(opts && opts.caption);
+      const bottom = (opts && opts.bottom != null) ? opts.bottom
+        : (hasCap ? L.contentBottomWithNote : L.contentBottom);
       return {
-        x: mx, y, w: cw, h: Math.max(1.2, Math.min(PT.h || 4.2, bottom - y - capH)),
+        x: mx, y, w: cw, h: Math.max(1.2, Math.min(PT.h || 4.2, bottom - y)),
         halfW: PT.halfW, halfGap: PT.halfGap, capY: PT.capY, capH: PT.capH || 0.3,
         radius: PT.radius, gridGap: PT.gridGap, gridCols: PT.gridCols,
       };

package/top-ppt-html/scripts/model-schema.json

@@ -41,6 +41,7 @@
     "exhibitNo",
     "layoutPreset"
   ],
+  "mutualExclusionHint": "verdict 与 soWhat 互斥：二者共用 annotation 结论条槽位，同页双填必叠印。comparison 页填 verdict 时不要再填 soWhat（渲染器已自动二选一，但模型侧应只给一个）。",
   "flagsHint": "flags = 待核实/待二次修改条目字符串数组（如 '2027 增速 xx%（口径未定）'）；渲染为 accent 强调色标注行，提示用户核对。",
   "imageHint": "image = 素材图片/配图占位对象。三选一必填：src（用户图，data: 内联或相对路径，零外链铁律禁 http(s)）｜items（多图版式：grid/compare/wall，元素 {src?, alt?, caption?, placeholder?}）｜placeholder:true（无图时出配图占位，原生形状渲染、pictures 不增）。其余可选：layout（full/half/bleed/grid/compare/wall，见 layout-constants.json imageSpec.layouts）、fit（cover 默认 / contain）、caption、alt、hint、ratio。",
   "imageLayoutHint": "layout 与 HTML 版式对应：full=版心全宽图｜half=左图右注（points 为右栏注解）｜bleed=通栏出血｜grid=多图网格（items 2/3/4/6 张）｜compare=双图 A/B 对比（items 2 张）｜wall=Logo 墙（items 3–12 张小图）。占位符标签文本由双引擎按 imageSpec 拼同一串，保证 A/B 通道逐页文本一致。",