@topmindspace/tms-skills 0.1.0

package/top-ppt-html/references/layouts-research.md

@@ -0,0 +1,160 @@
+# 结构组件与锁定版式 · layouts-research.md
+
+> 由 `components.md` 拆出（§编号保持不变，跨文件稳定引用）。
+> 取码：`python scripts/extract_snippet.py --file components.md --section <编号>`
+> 或直接 `--file layouts-research.md --section <编号>`。整读大文件视为违规。
+
+## 36. research 模式 · 双栏正文 + 脚注（模式 B 专属）
+
+```html
+<section class="band" id="s2">
+  <div class="wrap">
+    <div class="shead rv">
+      <div class="t-eyebrow">02 · 现状诊断</div>
+      <!-- 行动标题：标题即结论 -->
+      <h2 class="t-h1 shead__title">入湖表 68% 从未被查询，资产沉睡是第一问题</h2>
+    </div>
+    <div class="cols-2 rv">
+      <p class="t-body">发现段：一段直接陈述数据与事实，≤ 200 字。</p>
+      <p class="t-body">证据段：引用口径与对照数据，外部数据带 [n]。</p>
+      <p class="t-body">含义段：这一发现意味着什么，下一步动作。</p>
+    </div>
+    <div class="footnote">
+      注：入湖表共 4,662 张，查询日志取 2026H1；「从未查询」= 半年零访问。
+      来源见 <a class="cite" href="#ref-3">[3]</a>。
+    </div>
+  </div>
+</section>
+```
+
+> research 模式密度规则（卡片 4–5 条、表格 ≤16 行、单页 ≤3200 字）见 `modes.md` 模式 B。
+
+---
+
+## 36b. research 模式 · Exhibit 编号图表框 + so-what 结论条（锁定版式 R2 主件）
+
+```html
+<div class="exhibit rv">
+  <div class="exhibit__hd">
+    <span class="exhibit__no">Exhibit 3</span>
+    <span class="exhibit__t">各域入湖表使用率：供应链领跑，研发垫底</span>
+  </div>
+  <!-- 图表：svg.chart data-chart="…"（做法见第二部分；尺寸取下限即可） -->
+  <svg class="chart" data-chart="hbar" viewBox="0 0 520 150"><!-- …条形图… --></svg>
+  <div class="exhibit__src">来源：数据平台运行月报，2026-08；使用率 = 半年内有查询的表 / 入湖表总数</div>
+</div>
+<div class="sowhat rv">
+  <span class="sowhat__k">So what</span>
+  <span class="sowhat__v">研发域是激活沉睡资产的第一目标：清僵尸表 + 语义化改造，预计抬升整体使用率 8–10 个百分点。</span>
+</div>
+```
+
+> **Exhibit 编号纪律**：全篇连续（1..N 不跳号不重复，校验器检查）；文内引用写"如 Exhibit 3 所示"；`.exhibit__src` 必写来源+口径。so-what ≤ 60 字，一行说清含义或建议。**克制条款**：so-what/来源行只在关键论证页（Exhibit 页/结论页）——REPORT_MODEL 的 `soWhat`/`footnote` 字段同步此原则，逐页都加反而增加复杂度。
+
+---
+
+## 36c. research 模式 · 左侧章节导航轨（可选组件 · 默认不启用）
+
+```html
+<nav class="rail" id="rail" aria-label="章节导航">
+  <a class="rail__a" href="#s1"><span class="rail__n">01</span><span class="rail__t">周期意义</span></a>
+  <a class="rail__a" href="#s2"><span class="rail__n">02</span><span class="rail__t">现状诊断</span></a>
+  <a class="rail__a" href="#s3"><span class="rail__n">03</span><span class="rail__t">治理架构</span></a>
+  <!-- …与章节一一对应；当前章 .on 由脚本自动维护… -->
+</nav>
+```
+
+> 样式与高亮脚本已内置公共引擎（宽屏常显、窄屏自动隐藏、滚动跟随高亮）；模板中默认注释不启用——**仅 ≥10 章深度白皮书且用户明确要目录常驻时解开**，普通报告加了反而增加版面复杂度。
+
+---
+
+## 36d. research 模式 · 锁定版式速查（R1–R8）
+
+| 版式 | 骨架（自上而下） | 组合要点 |
+|------|----------------|---------|
+| **R1 论证页** | 行动标题 → `.cols-2`（2–4 段：发现/证据/含义）→ `.sowhat` → `.footnote` | 段落 ≤200 字/段；主题词式标题禁止；**PPTX 映射：`twocol` 页型** |
+| **R2 Exhibit 页** | 行动标题 → `.exhibit`（编号+图+来源）→ 2–3 条解读（`.ul`）或右栏 → `.sowhat` | 默认主力版式；图取尺寸下限；**PPTX 映射：`exhibit` 页型（chart 支持 bar/hbar）** |
+| **R3 密表页** | 行动标题 → ≤16 行表（含结论列）→ `.sowhat` | 结论列用 `td strong`；行高走 research 密度层；**PPTX 映射：`table` 页型** |
+| **R4 指标带页** | 行动标题 → 4–6 个 `.metric` → 小表/迷你图（可选） | 兼作节奏休止页；每 3–4 页一个；**PPTX 映射：`metrics` 页型** |
+| **R5 分栏证据页** | 行动标题 → `.g-side`（左宽论述 / 右窄证据，或反向） | **左宽右窄**（`.g-side` = 1.35fr : 1fr ↔ PPTX `split` 左 55% / 右 41.5%，同源）；顶边对齐 `a-start`；**PPTX 映射：`split` 页型** |
+| **R6 三栏证据页** | 行动标题 → `.cols-3`（3–6 段并列短论点，每栏 ≤150 字） | 三个并列论点 / 三方观点；**PPTX 映射：`threecol` 页型** |
+| **R7 半表半图页** | 行动标题 → `.grid.g-half`（左密表 + 右 `.exhibit` hbar/line） | 表图互证、对照阅读；**PPTX 映射：`halftable` 页型** |
+| **R8 矩阵图页** | 行动标题 → `.matrix`（rowHeads × colHeads 网格 + 强调单元） | 定位/优先级/象限判断；**PPTX 映射：`matrix` 页型** |
+
+> 不允许临场发明 R8 之外的结构；需要新结构时先扩本表并同步 PPTX 页型与 `layout-constants.json` 页型几何，再使用（锁定版式纪律）。
+
+---
+
+## 36e. research 模式 · 三栏证据页（R6）
+
+```html
+<section class="band" id="s6">
+  <div class="wrap">
+    <div class="shead rv">
+      <div class="t-eyebrow">06 · 风险与治理</div>
+      <h2 class="t-h1 shead__title">规模化三重门槛：技术可控、组织就绪、经济可行</h2>
+    </div>
+    <div class="cols-3 rv">
+      <p class="t-body"><strong>论点一。</strong>第一栏论述，每栏 ≤150 字，保持三栏均衡。</p>
+      <p class="t-body"><strong>论点二。</strong>第二栏论述，与第一栏并列推进。</p>
+      <p class="t-body"><strong>论点三。</strong>第三栏论述，收束到本页结论。</p>
+    </div>
+    <div class="footnote">注：三方口径与样本说明一行。</div>
+  </div>
+</section>
+```
+
+> `.cols-3` 是 CSS 多栏（column-count:3，窄屏自动降栏），与 `.cols-2` 同族；**REPORT_MODEL 对应 `{"type":"threecol","paragraphs":[[小标题,正文]…]}`**，序列化器三栏均分。
+
+---
+
+## 36f. research 模式 · 半表半图页（R7）与矩阵图页（R8）
+
+```html
+<!-- R7 半表半图：左密表 + 右 Exhibit，对照阅读 -->
+<div class="grid g-half rv">
+  <div class="tbl-wrap">
+    <table>
+      <thead><tr><th style="width:30%">业务域</th><th>试点率</th><th>同比增幅</th></tr></thead>
+      <tbody>
+        <tr><td class="k">客服</td><td class="num">72%</td><td><strong>+9pt</strong></td></tr>
+        <tr><td class="k">研发</td><td class="num">38%</td><td><strong>+15pt</strong></td></tr>
+      </tbody>
+    </table>
+  </div>
+  <div class="exhibit">
+    <div class="exhibit__hd">
+      <span class="exhibit__no">Exhibit 2</span>
+      <span class="exhibit__t">右栏图表标题（结论式）</span>
+    </div>
+    <svg class="chart" data-chart="hbar" viewBox="0 0 480 190"><!-- …条形图… --></svg>
+    <div class="exhibit__src">来源：来源名称，YYYY-MM；口径说明</div>
+  </div>
+</div>
+
+<!-- R8 矩阵图：rowHeads × colHeads + 强调单元 -->
+<div class="matrix rv">
+  <div class="matrix__grid" style="--mx-cols:3">
+    <div></div>
+    <div class="matrix__h">实施难度 · 低</div>
+    <div class="matrix__h">实施难度 · 中</div>
+    <div class="matrix__h">实施难度 · 高</div>
+    <div class="matrix__rh">业务价值 · 高</div>
+    <div class="matrix__c matrix__c--a"><b>客服问数</b>首批放量</div>
+    <div class="matrix__c"><b>研发副驾</b>二批放量</div>
+    <div class="matrix__c"><b>端到端交付</b>暂缓</div>
+    <div class="matrix__rh">业务价值 · 中</div>
+    <div class="matrix__c"><b>知识检索</b>常规推进</div>
+    <div class="matrix__c"><b>经营预警</b>常规推进</div>
+    <div class="matrix__c matrix__c--a"><b>自主决策</b>护栏试点</div>
+  </div>
+  <div class="matrix__note">图例：强调单元 = 优先投入项；其余按季度节奏推进。</div>
+</div>
+```
+
+> **R7 REPORT_MODEL**：`{"type":"halftable","table":{head,rows},"chart":{type:'hbar',labels,values,max,unit}}`——左表右图同屏互证。
+> **R8 REPORT_MODEL**：`{"type":"matrix","rowHeads":[…],"colHeads":[…],"cells":[[str 或 {t,accent}]…]}`——强调单元 `{t,accent:true}` 对应 HTML `matrix__c--a`。
+> 矩阵行列数建议 ≤3×3（信息密度上限），超出先精简维度。
+
+---
+

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

@@ -0,0 +1,254 @@
+# 三种报告模式 = 三种独立输出体系
+
+> **何时读**：需要模式密度契约细节、research R1–R8 / architecture A1–A3 锁定版式时；或 playbook 与校验器阈值冲突需要仲裁时。**何时不读**：常规生成（playbook §一 契约表已够用）。
+> **取节**：`python scripts/extract_snippet.py --file modes.md --section A`（B/C 同理，单字母即模式；亦可用标题关键词）。
+
+**模式不是切换关系，而是内容呈现形式、信息密度、面向受众与场景、整体逻辑结构、布局样式的完全不同。** 一份报告 = 一种模式 + 一种风格 + 一种亮暗主题 + 一套内容；模式在生成前的「六项问询」（单次交互，见 SKILL.md）中确定，从对应模式模板起步，`data-mode` 写死在 `<html>` 上（与 `REPORT_MODEL.mode` 一致，校验器双重锁定）——**生成后页面无模式切换**。
+
+```html
+<!-- 三份独立模板，各自锁定 -->
+<html data-mode="presentation"  data-style="business-blue" data-theme="light">  <!-- assets/templates/presentation.html -->
+<html data-mode="research"      data-style="mckinsey"      data-theme="light">  <!-- assets/templates/research.html -->
+<html data-mode="architecture"  data-style="graphite-dark" data-theme="dark">   <!-- assets/templates/architecture.html（石墨深灰深色优先，出厂 dark） -->
+```
+
+- **风格与模式正交**：9 套风格是纯视觉皮肤（色彩/字体/圆角/阴影），header 下拉可生成后实时切换查看（交付前切回选定值，`data-style` 与 `REPORT_MODEL.style` 一致）。
+- **模式决定**：独立模板骨架、密度 token、组件体系、页面预算、图表尺寸策略、PPTX 页型与排版比例尺。
+
+## 模式速选
+
+| 模式 | data-mode | 形态定位 | 受众与场景 | 信息密度 | 典型篇幅 |
+|------|-----------|---------|-----------|---------|---------|
+| A 演示汇报 | `presentation`（默认） | 大字号、每屏一主张、图表大而克制 | 台上宣讲，投影远看 | 低（每屏 1 主张） | 8–15 页 |
+| B 研究报告 | `research` | 咨询密排：行动标题 + 论证链 + Exhibit + 密表 + 矩阵 | 坐下来深读的决策者 | 高（空间利用最大化） | 12–25 页 |
+| C 信息架构图 | `architecture` | 图为王：全幅分层带/泳道/管线 | 评审会，看结构不看句子 | 极低文字 | 1–3 张图（6–8 页，可省 Agenda） |
+
+**意图 → 模式默认推荐**：演示/汇报/宣讲/路演 → A；研究/分析/调研/评测/对标/白皮书 → B；架构/方案拓扑/流程/数据流 → C。混合需求（研究+架构）→ 主模式 B、架构章节用 C 的图示组件。
+
+---
+
+## 三模式信息密度与内容丰富度全维对照（生成前据此设计每页）
+
+> 三种模式不是同一份内容的"疏密调节"，而是**三种阅读契约**：A 是"3 秒一屏"的投影契约（远看、听讲），B 是"30 秒一页"的坐读契约（近看、深读、可反复查证），C 是"一眼看全结构"的评审契约（看图不看句子）。信息密度、内容丰富度、版式节奏全部由此推导。
+
+| 维度 | A 演示汇报 | B 研究报告 | C 信息架构图 |
+|------|-----------|-----------|-------------|
+| 版心宽度 | 1400px | **1240px**（行宽 34–40 字，阅读友好） | **1600px**（图占满） |
+| 正文字号 | 17–18px（投影够大） | **14–15px**（密排） | 默认字号（文字退到图注级） |
+| h1 字号（clamp 上限） | 48px | **34px** | 48px（图才是主角） |
+| 每屏主张数 | 1 个主张 | 1 个结论 + 3–6 组论据 | 1 张主图 |
+| 单页文字预算 | ≤1500 字 | **≤3200 字** | ≤400 字（图注级） |
+| 并列单元上限 | 8 | **12** | 节点 ≤24 / 泳道行 ≤6 步 |
+| 表格行数上限 | 8 | **16**（密表） | —（表转图） |
+| 每页图表数 | **按复杂度定面积**（V1–V4；简单图禁全幅） | 1–2 个（取尺寸下限） | 1 张全幅主图（宽 ≥85% 版心） |
+| 页面高度 | 每页一屏（`--band-min`，垂直居中） | 每页一屏（紧凑 `--band-pad`） | 每页一屏（图为王，`--band-pad` 最紧） |
+| 图表尺寸策略 | **随复杂度**（简单图 18–28% 高，复杂图才 55%+；极偏禁 donut） | 下限即可、不缩水 | 高度预算 500–700px |
+| 论证结构 | 主张 → 证据 → 节奏休止 | **发现→证据→含义 + so-what**（每页都是论证） | 标题 → 图 → 图注 |
+| 组件体系 | 通用组件 + 混排版式 A–F | **R1–R8 锁定版式** | **A1–A3 图示版式** |
+| 节奏休止 | 金句页（全文 1–2 处 · 强调带） | R4 指标带（每 3–4 页一处） | 收尾极简页（强调带） |
+| Agenda | 必备第二页 | 必备（9–16 条双列） | 内容页 ≤4 可省 |
+| 页头页脚 | eyebrow+标题+导语 | + so-what/来源行（仅关键页） | 极简（图例即页脚语义） |
+| Exhibit 编号 | 不用 | **全篇连续编号 + 来源行** | 不用 |
+| 引用密度 | 关键数字带 [n] | 关键数据 [n] + 文末参考资料 | 依据类 [1]–[3] |
+| PPTX 正文字号 | 13pt | **10.5pt**（咨询密排比例尺） | 13pt（diagram 走全幅几何） |
+| PPTX 页型组 | 通用 17 种（含 steps/heatmap/bullet/pyramid） | +5 密排专属（twocol/exhibit/threecol/halftable/matrix） | +lane（全幅 diagram/lane） |
+| 典型篇幅 | 8–15 页 | 12–25 页 | 1–3 张图（6–8 页） |
+
+**密度设计三原理**（为什么这样分）：
+
+1. **A 低密度**：投影距离 + 演讲节奏决定"一屏一主张"。观众同时只能处理一个视觉重心；任何第二重心（双图、满屏小字）都会稀释主张。留白不是浪费，是投影可读性的刚需。
+2. **B 高密度**：读者坐下来深读，视线按"F/Z 形"扫描页面，**单位版面的信息承载力就是生产力**——咨询机构的横向 A4 每页承载 600–900 字 + 一图/一表仍有呼吸感，靠的是行宽控制（34–40 字）、密排组件（Exhibit/密表/矩阵）与论证结构（每页标题即结论），而不是无差别缩小字号。
+3. **C 图形密度**：评审场景读者要的是"结构在不在、链路通不通"，句子是噪音。文字退到图注级（≤400 字/页），图形密度拉满（节点 ≤24、图宽 ≥85% 版心），**1–3 张图即可成篇**——页数越少，评审越高效。
+
+> **选错密度的典型症状**：A 出现双栏小字（投影看不清）→ 拆页或转 B；B 出现大面积留白 + 一句话页（坐读材料信息量不足）→ 合页或转 A；C 出现成段正文（图被文字挤压）→ 文字转图注或拆到 B 模式报告。
+
+---
+
+> **六项问询**（一次问完、全部带意图推荐、不选即按推荐走）：①意图与模式推荐合并确认（本表）②篇幅（A 8–15 页 / B 12–25 页 / C 1–3 张图）③风格 9 套（始终选择——风格是 HTML 皮肤，与交付格式无关）④**亮暗主题**（浅色默认 / 深色沉浸；石墨深灰默认深色；HTML 与 PPTX 同主题导出——`REPORT_MODEL.theme`）⑤交付格式（仅 HTML / HTML+PPTX）⑥参考图确认（Gate 0 已展示整体图，问用户是否看到、要不要换）。载体优先结构化选项卡，宿主工具不支持则对话文本一次列全；问询顺序与完整措辞以 `SKILL.md` 为准。
+>
+> 六项问询收**形式参数**；模式确定后，内容主线/大纲/逐页规划走 `outline-design.md` 内容架构七步法（含按需大纲确认），再进入生成。
+
+> **新页型适用模式**：`kpi` / `comparison` / `donut` / `quote` 四页型适用于 A 与 B（字段约束见 `scripts/model-schema.json`；HTML 版式见 `components.md` §39–42）。
+
+---
+
+## 模式 A · 演示汇报 `presentation`（assets/templates/presentation.html）
+
+台上讲给人听，3 秒抓住主张。要点回顾：
+
+- 字号大（正文 17–18px）、版心 1400px、band--fit 居中节奏、大留白
+- 高度预算 1080p ≈ 830px；单页文字 ≤1500、并列单元 ≤8、表格 ≤8 行
+- 图表大（环形≥140px、柱/折线≥200px 高）；动效克制
+- 节奏休止：连续数据页之间可插 1–2 处「大引言/金句页」（`components.md` §39，**主题一致强调带** `band--accent`/`band--accent--solid`，一句话主张）；**全文 1–2 处即可，多了廉价**
+- **收尾页统一用 `band--accent`**（accent-soft 底）——不再用 `band--deep`：后者在浅色主题下会渲染成深色页（"浅色模式末尾出现深色页"的根因）。`band--deep` 仅作显式反相页，全文 ≤1 处且不得作末页（校验器检查）。
+- 版式从 `components.md` 混排版式 A–C（左图右文 / 表图并排 / 2×2 四象限）挑
+
+---
+
+## 模式 B · 研究报告 `research`（assets/templates/research.html）
+
+> 对齐 McKinsey/BCG 咨询材料的密度与结构：**每一页标题就是结论（行动标题），正文是论证（发现→证据→含义），图表带编号（Exhibit），关键页有 so-what**。读者是坐下来深读的人，不是远看投影的观众——**更多文字、更高信息密度、更紧凑的空间布局**。
+
+### 密度层（模板已内置，非运行时切换）
+
+| Token | presentation | research |
+|-------|-------------|----------|
+| `--fs-body` | 17px | **14–15px** |
+| `--fs-h1` | 48px | **34px** |
+| `--fs-lead` | 21px | **17px** |
+| `--wrap` | 1400px | **1240px**（阅读友好） |
+| `--gap` | 16–28px | **12–20px** |
+| band padding | 56–116px | **40–80px** |
+| 表格行高 | 17px 20px | **13px 16px**（密度↑） |
+| 表格行数上限 | 8 | **16**（密表） |
+| 单页文字预算 | 1500 | **3200** |
+
+### 页面解剖（research：三必备 + 两按需）
+
+```
+[eyebrow]        02 · 现状诊断（章节编号+章节名）——必备
+[行动标题]        结论句 ≥12 字（"六成企业试点卡在治理与集成——规模化分水岭已经出现"）——必备
+[论证区]         锁定版式 R1–R8 之一——必备
+[so-what 条]     .sowhat 一行含义——仅关键论证页（Exhibit 页/结论页）加
+[来源行]         .exhibit__src 随 Exhibit 组件自带；独立 .footnote 仅当页内有关键外部数据且无 Exhibit 时才加
+```
+
+> **克制条款**：不加多余的页头角标、chips 堆叠、逐页页脚信息行——咨询材料的信息密度来自论证结构与图表，不来自装饰性文字元素。
+
+### 锁定版式 R1–R8（research 专属，不允许临场发明结构）
+
+| 版式 | 结构 | 适用 | PPTX 页型 |
+|------|------|------|-----------|
+| **R1 论证页** | 行动标题 + `.cols-2` 双栏正文（发现→证据→含义 段落式）+ so-what + 脚注 | 需要完整论述的判断/逻辑推演 | `twocol` |
+| **R2 Exhibit 页** | 行动标题 + `.exhibit` 图表框（编号+图+来源行）+ 右侧/下方 2–3 条解读 + so-what | 数据证据页（最常用） | `exhibit`（chart 支持 bar/hbar） |
+| **R3 密表页** | 行动标题 + ≤16 行对比表（含结论列）+ so-what | 多维对标/清单 | `table` |
+| **R4 指标带页** | 行动标题 + 4–6 指标卡一排 + 下方小表或迷你图 | 现状基线（兼作「半屏休止」节奏页） | `metrics` |
+| **R5 分栏证据页** | `.g-side`：左宽（55%）论述，右窄（41.5%）Exhibit/表；也可反向（左图右文） | 证据+论证并置 | `split` |
+| **R6 三栏证据页** | `.cols-3` 三栏短论证：三个并列论点 / 三方观点，每栏 ≤150 字 | 并列论点、三重门槛类结构 | `threecol` |
+| **R7 半表半图页** | `.grid.g-half`：左密表 + 右 Exhibit（hbar/line），对照阅读 | 表图互证 | `halftable` |
+| **R8 矩阵图页** | `.matrix`：rowHeads × colHeads 网格，强调单元 accent | 定位/优先级/象限判断 | `matrix` |
+
+组件代码：`components.md` §36–36f。**切换组合规则**：每 3–4 页安排一个 R4 指标带页（防高密度疲劳）；R2 为默认主力版式；R6–R8 用于结构化对比类内容，让"更多内容、更紧凑布局"落在版式上而非字号上。
+
+### 版式与内容规则（research 专属）
+
+1. **行动标题**：`shead__title` 必须是结论句，不是主题词。eyebrow 改为章节编号+章节名。
+2. **三段论证结构**：每页 = 发现（finding）→ 证据（evidence：表/图/数据）→ 含义（so-what：`.sowhat` 一行）。
+3. **Exhibit 编号体系**：全篇连续编号（Exhibit 1、2、3…），放 `.exhibit__no`；`.exhibit__t` 写图表标题（结论式更好）；`.exhibit__src` 写来源行（组件自带）。**编号必须连续且唯一**（校验器检查）。文内引用写法："如 Exhibit 3 所示"。
+4. **so-what 结论条**：`.sowhat`（accent 左边线 + soft 底），一行含义/建议，≤ 60 字；**只加在关键论证页**。
+5. **双栏正文** `.cols-2`：长论述两栏排版，每栏行宽 ≈ 34–40 字；**三栏** `.cols-3`：并列短论点，每栏 ≤150 字。
+6. **脚注式引用**：页内关键数据 `[n]` 上标；Exhibit 来源行走组件自带；**独立 `.footnote` 只在页内有关键外部数据且无 Exhibit 时才加**；文末仍有完整参考资料。
+7. **更密的表格**：行数上限 8→16；允许 `--fs-xs` 的表格说明行。
+8. **卡片可带 4–5 条列表**；并列单元上限 8→12；单页文字预算 1500→3200。
+9. **左侧章节导航轨**：**默认不启用**；仅 ≥10 章深度白皮书且用户明确要目录常驻时才加 `.rail`（组件见 `components.md` §36c）。
+10. 图表取尺寸下限即可（不必放大），但**不允许低于下限**；多系列图表常见（用 `f-c1~c5`）。
+
+### research 模式的质量校验（validate_report.py 自动感知 data-mode）
+
+- 单页文字预算 3200 / 单元 12 / fit 超载阈值 2200 / 表格行数 ≤16
+- 行动标题检查：h1 级标题 ≥ 12 字（主题词式短标题 WARN）
+- **Exhibit 编号连续性检查**（全篇 1..N 无跳号无重复；缺失 WARN）
+- **so-what 连续性**：连续 >3 页无 `.sowhat`/`.note` → WARN
+- **Exhibit 来源行**：每个 `.exhibit` 框内有 `.exhibit__src` → 否则 WARN
+- **模式版式特征**：cols-2/cols-3/exhibit/matrix 至少一处
+- 允许 `.cols-2`/`.cols-3`；分栏页的段落上限放宽（200 字/段）
+- **图表多样性（v8 新增）**：全篇不同 `data-chart` 类型 ≥ `min(6, ⌈图表页数 × 0.6⌉)`；**相邻图表页不得同型**（阈值单源 `charts.variety`）
+- **组合版式（v8 新增）**：含 ≥2 种承载类型（图表/表格/卡片/指标/图片/结构图）的内容页 ≥ **30%**——**单件页是例外不是默认**（组合矩阵见 `components.md` §46c 与 `references/playbook.md` §四）
+
+---
+
+## 模式 C · 信息架构图 `architecture`（assets/templates/architecture.html）
+
+> 一页一张全幅主图，文字退到图注级别。**全文往往就一两张图或两三张图**——封面 + 1–3 张图 + 收尾即可成篇；内容页 ≤4 时**省略 Agenda**（校验器对 architecture 降为 WARN 提示）。受众：评审会/方案沟通，看结构不看句子。
+
+### 密度层（模板已内置）
+
+- `--wrap: 1600px`（更宽，图占满）
+- band padding 压到 `clamp(32px,5vh,64px)`；正文/图表比例可到 2:8
+- `.band--fit` 常用（图+图例正好一屏）
+
+### 锁定版式 A1–A3（architecture 专属）
+
+| 版式 | 结构 | 适用 | PPTX 页型 |
+|------|------|------|-----------|
+| **A1 分层带页** | 行动标题 + `.arch` 分层带（每层 = 层名条 + 节点卡网格）+ `.arch__conn` 层间连接 + 图例 chips | 系统/平台架构（最常用） | `diagram`（architecture 模式走全幅页型 fullStartY..fullEndY，含层间连接） |
+| **A2 泳道页** | 行动标题 + `.lane` 泳道（角色/阶段为行，步骤横排+箭头）+ 图例 | 流程/职责/数据流 | `lane` |
+| **A3 管线页** | 行动标题 + 全宽 SVG 流程管线（`fig--full` 内圆角横条+流向箭头）+ 图注 | 端到端链路 | `lane`（单泳道五步管线映射） |
+
+组件代码：`components.md` §37–38b。A1 默认；强调跨层流转用 A3。
+
+### 图示组件库（components.md 第 37–38b 节）
+
+- **分层带** `.arch`：横向分层（应用层/编排层/模型层），层内放节点卡——架构图最常用
+- **节点卡** `.arch__node`：圆角小卡（标题+一行注），支持 accent 强调焦点节点
+- **层间连接** `.arch__conn`：层与层之间的垂直短箭头（主链路 accent、次链路中性）
+- **泳道** `.lane`：行 = 角色/阶段，`lane__step` 步骤横排 + `.lane__arr` 箭头
+- **正交连接件**（SVG）：主链路 `.s-acc` 实线 2px、次链路 `.s-bds` 虚线 1.5px；箭头三角 `f-txt3`/`f-acc`
+- **图例 chips**：右下角一行（焦点层 / 已有能力 / 主链路 / 数据流）
+
+### 结构图形族（复杂架构图 / 流程图 · 图为王时的主力）
+
+> `.arch` / `.lane` 只覆盖**分层**与**线性步骤**；一旦内容含**分支、判断、汇合、异常路径、层级、时序、闭环**，就必须用结构图形——否则会退化成"矩阵方块 + 文字箭头"（`failure-modes.md` F13）。
+> 规范与可复制 SVG 见 `infographics.md` §78–§82；PPTX 侧映射 `diagram`（分层/层级）或 `steps`（时序/闭环）页型，分支与例外写入 `note`（进演讲者备注）。
+
+| 结构图形 | 用什么 | 上限 |
+|---------|-------|------|
+| 流程图 `flow` | 动作=圆角矩形、判断=菱形、异常=虚线；分支标条件、正交路由、汇合总线 | 节点 ≤20 / 判断 ≤4 |
+| 层级树 `tree` | 父→子正交连接 + 同层等高；层级靠明度阶梯 | 叶 ≤16 / 深 ≤4 |
+| 时序图 `sequence` | 参与者 + 虚线生命线 + 消息箭头 + **激活条** | 参与者 ≤5 / 消息 ≤8 |
+| 闭环 `loop` | 方向一致的箭头 + 中心结论（箭头是主角） | 环节 ≤6 |
+
+**判据**：内容里出现「A 流向 B」「要走哪个分支」「谁先谁后」「上一层下一层」「转一圈回到起点」→ 用结构图形，不要用文字箭头或并列卡片冒充。
+
+### 内容规则
+
+1. 每页**只放一张主图**；图宽 ≥ 版心 85%；高度预算 500–700px
+2. 文字只允许：eyebrow + 行动标题（≤20 字）+ 图注（1–2 行）+ 图内节点短标签（≤8 字/节点）
+3. 节点数上限：分层图 ≤ 24 个节点、泳道每行 ≤ 6 步、流程 ≤ 10 步；超出拆页
+4. 层次用 surface 明度差 + accent 高亮"当前焦点层"，不引入第二色相
+5. 图内文字最小 11px；连接线 1.5–2px；正交折线优先于斜线
+6. 图例必须与图内语义一一对应
+7. **可省略 Agenda**：内容页 ≤4 时封面后直接进图；页多（≥5 内容页）建议补
+8. 长说明全部转图注或拆到 research 模式报告；图为王，文字退到图注级
+
+---
+
+## 复杂信息图页型族（research / architecture 可用）
+
+> 完整规范见 `references/infographics.md`；HTML 写法见 `components.md` `infographics.md` §71–§77。**判据**：普通图表回答"一个数是多少"，信息图页型回答"一整套结构长什么样"。
+
+| 页型 | 承载什么 | 上限 | 适用模式 |
+|------|---------|------|---------|
+| `sankey` | 多主体之间的**流向与流量**（转化链路、资金流向） | 节点 ≤12 / 流带 ≤24 | research / architecture |
+| `treemap` | 层级构成 + **面积编码**（区域收入、成本结构） | 叶节点 ≤16 | research / architecture |
+| `boxplot` | 分组**分布**（中位/四分位/极值/离散度） | 组数 ≤8 | research / architecture |
+| `network` | 节点-边**拓扑关系**（系统依赖、协同链路） | 节点 ≤18 / 边 ≤30 | research / architecture |
+| `marimekko` | **双重编码**（列宽 = 总量、列高 = 构成） | 列 ≤6 / 段 ≤4 | research / architecture |
+| `streamgraph` | 时间上的**构成演变**（结构此消彼长） | 系列 ≤6 | research / architecture |
+
+**共用纪律**：每页一图；文字退到图注级；曲线/流带采样点 ≥16（流带图 ≥24）且**上下边界分别追踪**；**禁用预设形状与矩形化近似**替代曲线语义；`chart.dataTable` 至少 `notes`（数据表写入演讲者备注），需要页内可见时用 `inline`；节点/组/列数超上限按铁律 11 **拆页**（结构容量问题，缩字号无效）；限内标签偏挤时可按 `containers.fontShrink` 有限下探。
+
+**模式适配**：
+- **research**：信息图页作为"证据页"承担一整个论证环节，必须配行动标题 + `.exhibit__src` 来源行；密集报告里信息图页与密表页交替出现（节奏）。
+- **architecture**：信息图页是"图为主角"的自然延伸，页头更简（可省导语），节点标签允许更短（≤6 字）。
+
+---
+
+## 模式 × 风格 × 导出的关系
+
+- 模式影响：独立模板骨架、密度 token、内容规则、页面预算、图表尺寸策略、PPTX 页型与**独立排版比例尺**（`layout-constants.json` `modeTypeScale`：research 咨询密排正文 10.5pt，非简单 ×0.8 缩放）
+- 风格影响：色彩/字体/圆角/阴影（9 套任选，research 推荐 mckinsey/warm-sand/deep-teal，architecture 推荐 graphite-dark/business-blue/spectrum）
+- 导出：`REPORT_MODEL.mode` 随报告记录；PPTX 按模式分派页型（research：twocol/threecol/exhibit/table/metrics/split/halftable/matrix + 密排比例尺；architecture：diagram 全幅/lane，**无 agenda 时少一页大纲**）
+- 校验：`validate_report.py` 读 `data-mode` 自动切换预算阈值与版式断言；`validate_pptx.py --model` 按"有无 agenda"断言页数结构；模式未声明按 presentation 处理并 WARN
+
+## 模板与样例（生成起点）
+
+| 模式 | 模板 | 样例（AI 智能体发展研究主题） |
+|------|------|------|
+| A 演示汇报 | `assets/templates/presentation.html` | `examples/2026-09-09-presentation-business-blue.html`（+apple-mono 变体） |
+| B 研究报告 | `assets/templates/research.html` | `examples/2026-09-09-research-mckinsey.html`（+deep-teal/warm-sand 变体） |
+| C 信息架构图 | `assets/templates/architecture.html`（出厂 dark） | `examples/2026-09-09-architecture-graphite-dark.html`（出厂 dark · 深色优先）+ `spectrum` 变体（light） |
+
+> **主题一致性**：三模式收尾页与金句页统一走**强调带**（`band--accent` / `band--accent--solid`），浅色/深色同向，不再出现"浅色模式末尾深色页"；`band--deep` 仅限显式反相页（≤1 处、不作末页）。
+
+改模板或公共引擎后：`python scripts/sync_runtime.py`（注入 engine/ui/runtime 三类片段）→ `python scripts/build_examples.py`（刷新样例矩阵）→ 全链路回归（validate_report → extract_model → build_pptx → validate_pptx --strict）。