@topmindspace/tms-skills 0.1.2 → 0.1.4

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

@@ -1,8 +1,8 @@
 # 作战手册 · Playbook（唯一常读入口 · L1）
 
 > **每次生成都读这一份，通常就够了。**
-> 本文件是**决策层**：定模式、选页型、选版式组合、选图表、定配色、跑校验。
-> **代码、几何、穷举表不在本文件**——需要时按 `SKILL.md` 的 L2 路由读深度文件，**读完即停，不预读**。
+> 决策层：定模式、选页型、选版式组合、选图表、定配色、跑校验——服务**优雅、大气、正式场合**的演讲/汇报甲板（Mode A 默认气质；B/C 按契约，勿把咨询 dump 当 A 默认）。
+> **代码、几何、穷举表不在本文件**——按 `SKILL.md` L2 路由命中再读，**读完即停**；整读大 L2 = **FAIL**。
 
 ---
 
@@ -35,6 +35,7 @@
 **密度选错的症状**：A 出现双栏小字墙（投影看不清）→ 拆页/换形态；A 为「疏朗」删证据/so-what → **反模式**，按 content-rules §四-c 恢复；B 大面积留白 → 合页或补证据；C 成段正文 → 转图注。
 **节奏**：禁止连续 3 页同密度档；同一版式不连用超过 2 页；research 每 3–4 页插一个低密度页（指标带/金句/大数）。
 **反截断**：溢出顺序 = 重构承载 → 拆页/分章 → 换布局 → 有限 fontShrink；禁静默截断（见 `presentation-craft.md`）。
+**插画页**：情绪/产品/占位图 ≠ 数据图；安全边距、图文不叠、icon+chart 共存、Mode A full-bleed+主张叠字规则见 `illustration-layout.md`。
 
 ---
 
@@ -42,10 +43,10 @@
 
 **轻量路径**（默认）——同时满足：≤12 页 · 材料单一完整 · 无未敲定关键判断 · 用户没要求看框架。
 ```
-Gate 0 参考图 → 六项问询（1 轮）→ 1 张规划卡 → scaffold_report.py
+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 正文与模型双写。）
+（Fast Mode 跳过 Gate 0/六项，仍须最小大纲；默认 **HTML-only**，PPTX 显式 opt-in 走 B 通道；**禁止**手改 HTML 正文与模型双写。）
 
 **完整路径**（任一命中）——研究 ≥20 页 / 演示 ≥12 页 / 材料量大且杂 / 含未敲定关键判断 / 用户要看框架。
 ```
@@ -53,7 +54,7 @@ Gate 0 参考图 → 六项问询（1 轮）→ 证据表 → 故事线脑暴
   → scaffold_report.py → **只填 REPORT_MODEL** → render_from_model.py --inplace → validate_report.py --strict → 交付
 ```
 
-**预算（硬）**：交互轮次 ≤3；必读文件 = `SKILL.md` + 本文件（≤2 份）；L2 深度文件按需且单份读完即停。
+**预算（硬）**：交互轮次 ≤3；常读面仅入口两份（`SKILL.md` + 本手册）。正式演示 / Fast 演示路径额外允许工艺双件为 L1.5（`default-surface` 与 `presentation-craft`），不记作超读。深度 L2 命中再开、读完即停。
 
 ---
 
@@ -61,37 +62,9 @@ Gate 0 参考图 → 六项问询（1 轮）→ 证据表 → 故事线脑暴
 
 > 自动选型：`python scripts/recommend_layout.py --mode A --intent "路演" --pages 10 --json`（或 `--from-model report.model.json`）→ `{pageType,skel,chart,rationale}`；Mode A 交付 `--strict` 已含 layout-qa。
 
-> 穷举表（内容形态 → 版式 → PPTX 页型）见 `components.md` §46；密度档适配见 `components.md` §46b；组合见下节 §四。
-
-| 我要表达 | 首选页型 | 次选 | 关键约束 |
-|---------|---------|------|---------|
-| 要点式并列主张（默认页） | `points` | `cards` | 每卡宜 3–5 条；更多拆卡/跟进页，勿截断条目 |
-| 现状基线 / 指标快照 | `metrics` | `kpi` | 4–6 个；单数压场用 `kpi` |
-| 单个核心数字压场 | `kpi` | `metrics` | hero 一数一结论 |
-| 多维对标清单 | `table` | `halftable` | ≤8 行（research ≤16） |
-| 时间趋势 / 爬坡 | `bar`（chart.type=line/area/dualline） | `exhibit` | 时间点 >8 改折线 |
-| 构成占比 | `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） | 目标线与实际条同量纲 |
-| 两期升降（谁升谁降） | `bar`（slope/dumbbell） | `table` | 两端都要标数值 |
-| 双维分布 / 优先级 | `bar`（scatter/bubble） | `matrix` | 气泡半径 ∝ √值 |
-| 分布 / 离散度 | `boxplot` | `bar`（dotplot） | 组数 ≤8；箱线四件齐备 |
-| 增减归因（A→B） | `bar`（waterfall） | `table` | 每段标变化量 + 合计收口 |
-| 转化 / 筛选漏斗 | `bar`（funnel） | `sankey` | 层数 ≤5 |
-| 计划排期（并行） | `bar`（gantt） | `timeline` | 里程碑叙事用 `timeline`，勿混 |
-| 里程碑 / 路线叙事 | `timeline` | `steps` | 3–5 个，每个 ≤2 行 |
-| 步骤 / 实施节奏 | `steps` | `timeline` | 3–6 步；高亮步 ≤2 处 |
-| 二维强度对标 | `heatmap` | `matrix` | 行列 ≤5×5；只用强调色明度阶梯 |
-| 定位 / 优先级 / 象限 | `matrix` | `bar`（scatter） | ≤3×3 |
-| 层级递进 / 价值阶梯 | `pyramid` | `diagram` | 3–5 层；强调层 ≤1 |
-| 关键判断 / 金句休止 | `quote` | `points` | 全文 1–2 处，多了廉价 |
-| 完整论述（发现→证据→含义） | `twocol`（research R1） | `threecol` | 段 ≤200 字；标题必须结论句 |
-| 数据证据页（主力） | `exhibit`（R2） | `split` | 全篇 Exhibit 连续编号 |
-| 三栏并列论点 | `threecol`（R6） | `cards` | 每栏 ≤150 字 |
-| 系统分层架构 | `diagram` | `bar`（chart.type=network） | 节点 ≤24；层 ≤4 |
-| 流程 / 职责协作 | `lane` | `diagram` | 每行 ≤6 步；正交折线优先 |
-| 素材图片（实拍/截图） | `image` | `split` | 六版式；无图用 `image.placeholder` |
-| 待核实项收口 | `flags` 字段 | `table` | 标色必须配说明 |
+> **穷举意图→页型表** → L2 `page-type-matrix.md`（命中才读）。`components.md` §46 / §46b；组合见 §四。
+
+**速记（默认面）**：要点→`points`/`cards` · 指标→`metrics`/`kpi` · 证据图→`exhibit`/`split` · 对标表→`table`/`halftable` · 趋势→`bar`+line/area · 占比→`donut`（极偏→**V3**）· 架构→`diagram`/`lane` · 图文演讲→§三-b V1–V4。
 
 ---
 
@@ -154,48 +127,11 @@ Gate 0 参考图 → 六项问询（1 轮）→ 证据表 → 故事线脑暴
 
 > **默认面（8 核心图）**：`bar` · `hbar` · `line` · `donut` · `progress` · `area` · `stack` · `dualline`
 > （= `layoutSystem.defaultCharts`）。完整登记与代码 → `extract_snippet.py --chart <类型>`；误用纪律 → `charts.md`（先 `charts-discipline`，核图 8，extended 按需）。
-> 下表仍保留决策提示；**生成默认只从 8 核心里选**，扩展图仅在意图明确命中时用。
-
-
-> 穷举代码见 `charts.md` §16–§31、§35、§52–§70；误用反例与多样性纪律见 `charts.md` §66（facade：纪律→核图→extended）。
-> **默认生成面（P1 收敛）**：优先 `bar / hbar / line / donut / progress / area / stack / dualline`。
-> **高级图型**（waterfall/gantt/funnel/slope/… 与 6 类信息图）按需选用，不进默认轮换。
-> **纪律**：全篇不同 `data-chart` 类型 ≥ `min(模式上限, ⌈图表页数 × 0.6⌉)`（上限：research 6 / presentation 4 / architecture 3）；**相邻图表页不得同型**。多样性 **preferCoreFirst**：先拉开核图 8；advanced 计入 minTypes（不罚）但只在意图命中时用，**禁止预读** `charts-extended.md`；**禁**为凑下限硬上冷门图、简单图全幅、极偏 donut/pie。
-
-| 分析意图（读者要得出的结论） | 首选 | 次选 | 禁用 / 改判条件 |
-|---------------------------|------|------|----------------|
-| 谁大谁小 | `hbar` | `lollipop` / `bar` | 类别 >8 → Top7 + 附录 |
-| 随时间怎么变 | `line` | `area` / `dualline` | 时间点 >8 不标点值 |
-| 占比是多少 | `donut` | `pie` / `multidonut` | 扇区 >5 → 合并"其他"或 `treemap` |
-| 每 1% 的直觉 | `waffle` | `donut` | 类别 >3 改 `marimekko` |
-| 结构在变形 | `streamgraph` | `stackline` | 系列 >6 合并 |
-| 总量 × 构成双编码 | `marimekko` | `treemap` | 列 >6 / 段 >4 → 拆 |
-| 份额悬殊（头部集中） | `treemap` | `donut` | 叶 >16 → 合并小项 |
-| 从 A 到 B 是谁贡献的 | `waterfall` | `pareto` | 段 >6 → 合并 |
-| 主要矛盾是哪几个 | `pareto` | `waterfall` | 类别 >7 → 合并 |
-| 转化/流失在哪一环 | `funnel` | `sankey` | 层 >5 → 改 `hbar` |
-| 多对多的流向 | `sankey` | `network` | 节点 >12 / 流带 >24 → 拆页 |
-| 谁和谁相连 | `network` | `diagram` | 节点 >18 / 边 >30 → 拆页 |
-| 两期谁升谁降 | `slope` | `dumbbell` | 系列 >6 → 取 Top 6 |
-| 单指标前后对比（多对象） | `dumbbell` | `vsbar` | 行 >6 → 拆页 |
-| 实际 vs 目标（含区间） | `bulletchart` | `bullet` | 行 >6 → 拆页 |
-| 达成率（多指标同心） | `radialbar` | `gauge` | 环 >5 → 改 `bullet` |
-| 一个值够不够 | `gauge` | `radialbar` | 单值叙事，勿与图并存 |
-| 分布不是均值 | `boxplot` | `dotplot` | 组 >8 → 拆页 |
-| 双维定位 + 第三维权重 | `bubble` | `scatter` | 气泡 >8 → 标注关键项 |
-| 六维能力画像 | `radar` | `rose` | 维度 >6 → 拆两组 |
-| 区间波动（开高低收） | `candlestick` | `line` | 蜡烛 >12 → 聚合 |
-| 多项目完成度 | `progress` | `bullet` | 行 >6 → 拆页 |
-| 迷你趋势（卡内） | `sparkline` | — | 只用于指标卡，不与大图并存 |
-
-**七种最常见的误用（出现即改判）**：
-1. 用 `bar` 表达占比 → 改 `donut`/`stackline`/`waffle`。
-2. 用 `donut` 表达 8 个类别 → 合并或改 `treemap`。
-3. 用 `line` 表达类别对比（无时间轴）→ 改 `hbar`。
-4. 用 `table` 表达趋势 → 改 `line`/`area`。
-5. 用均值型图表表达分布 → 改 `boxplot`/`dotplot`。
-6. 同一页放两张同型图 → 改 `split`/`halftable` 并让两图**编码不同维度**。
-7. 多系列图用单色明度阶梯（分不清） → 用 `f-c1~c5` 编码色板（见 §八）。
+> **扩展决策表 + 七种误用** → L2 `chart-decision-tree.md`（命中才读）。**生成默认只从 8 核心里选**，扩展图仅意图明确命中。
+
+**多样性（硬摘要 · 保留）**：全篇不同 `data-chart` ≥ `min(模式上限, ⌈图表页数 × 0.6⌉)`（上限 research 6 / presentation **4** / architecture 3）；**相邻图表页不得同型**。**preferCoreFirst**：先拉开核图 8；advanced 计入 `minTypes`（不罚）但禁预读 `charts-extended.md`；**禁**为凑下限硬上冷门图、简单图全幅、极偏 donut/pie。
+
+**速记**：谁大谁小→`hbar` · 时间→`line`/`area` · 占比→`donut`（扇区>5/极偏改判）· 归因→`waterfall` · 转化→`funnel` · 流向→`sankey`。
 
 ---
 
@@ -252,33 +188,36 @@ python scripts/validate_pptx.py 2026-09-15-主题.pptx --strict --model=….mode
 ```
 
 **交付前必过**：`validate_report.py --strict` 0/0（**Mode A / presentation 隐含 `--layout-qa`**；research/architecture 不强制）；含 PPTX 时 `validate_pptx.py --strict --model=` 0/0。
-**推荐一键门禁**：`python scripts/quality_gate.py 报告.html [--pptx x.pptx --model x.model.json]`（presentation 同口径附带 layout-qa；交付加 `--deliver` 出七要素，不要手拼）。
-**A/B 全文对等**：`cross_verify.py` 默认 SKIP，仅 `python scripts/cross_verify.py --full-ab` 或 `regression.py --full-ab` 时启用。
+**PPTX 通道**：默认交付只跑 **B 通道**（`build_pptx.js`）；**A 通道**（`pptx-export.js` / `gen_channel_a.js`）仅预览与 `cross_verify` / 回归——**勿把 A 产物当交付**。
+**推荐一键门禁**：`python scripts/quality_gate.py 报告.html [--pptx x.pptx --model x.model.json]`（HTML/PPTX/evals **并行**；presentation 附 layout-qa；`--deliver` 出七要素，勿手拼）。
+**A/B 全文对等**：`cross_verify.py` 默认 SKIP，仅 `--full-ab` / `regression.py --full-ab` 启用。
 **PPTX 冒烟**：`bash scripts/smoke_pptx.sh`（extract_model → build_pptx → validate_pptx --strict）。
-**失败自修复**：按输出逐条修 → 重跑，直到 0/0；修复顺序见 `failure-modes.md`。
+**失败自修复**：按输出逐条修 → 重跑至 0/0；顺序见 `failure-modes.md`。
 
 ---
 
 ## 十、L2 节级路由（按任务只读这些，读完即停）
 
-> 默认生成面：`default-surface.md`（12 页型 + 8 图 + V1–V4）。Mode A 工艺清单：`presentation-craft.md`。
-> **不要整读** `components.md` / `charts.md` 背后的物理拆分大文件。需要代码时优先：
-> `python scripts/extract_snippet.py --list` · `--task <名>` · `--chart <类型>` · `--page-type <页型>` · `--file components.md --section 46`（逻辑名自动路由）
+> 常读仍为入口两份；演示路径可加 **L1.5 工艺双件**：`default-surface.md` + `presentation-craft.md`。
+> 默认生成面：`default-surface.md`（12 页型 + 8 图 + V1–V4）。Mode A 工艺：`presentation-craft.md`。插画：`illustration-layout.md`。
+>
+> **整读下列文件 = FAIL / 不合格**（强制 `extract_snippet.py`）：`layouts-combo.md` · `components-atoms.md` · `charts-basic.md` · `charts-extended.md` · `content-rules.md` 全文 · `pptx-export.md` · 模式模板 HTML（走 `scaffold_report.py`）。
+> 取码：`python scripts/extract_snippet.py --list` · `--task <名>` · `--chart <类型>` · `--page-type <页型>` · `--file components.md --section 46`（逻辑名自动路由）
 
 | 任务 | 只读 |
 |------|------|
-| research 证据页 / Exhibit / 密表 | `components.md` §36d/§46/§46c · 本文件 §三/§四 · `extract_snippet.py --task research-evidence` |
-| 正式演示 / Mode A 工艺 | `default-surface.md` · `presentation-craft.md` · 本文件 §三-b/§五 |
+| research 证据页 / Exhibit / 密表 | `components.md` §36d/§46/§46c · 本文件 §三/§四 · `page-type-matrix.md` · `extract_snippet.py --task research-evidence` |
+| 正式演示 / Mode A 工艺 | `default-surface.md` · `presentation-craft.md` · 本文件 §三-b/§五 · `page-type-matrix.md` |
 | 演示组合版式 | `components.md` §39–§42/§46/§46b/§46c · `--task presentation-combo` |
 | 架构 / 泳道 / 分层 | `components.md` §37–§38b · `infographics.md` §78–§80 · `--task architecture-diagram` |
-| 选图 / 取图表代码 | 本文件 §五 · `--chart <类型>` · 误用见 `charts.md` §66 |
+| 选图 / 取图表代码 | 本文件 §五 · `chart-decision-tree.md` · `--chart <类型>` · 误用见 `charts.md` §66 |
 | 密度 / 字数 / 去 AI 味 | `content-rules.md` §一/§四 · 本文件 §六 · `--task content-rules` |
-| 素材图片 / 占位 | `components.md` §11c · `--task image-layout` |
+| 素材图片 / 占位 / 插画页 | `illustration-layout.md` · `components.md` §11c · `--task image-layout` |
 | PPTX 精导字段 | `pptx-export.md` · 本文件 §九 · `--task pptx-export` |
 | 高保真 / 锚点 | `high-fidelity.md` · `--task high-fidelity` |
 | 配色 / 风格 | `styles.md` · `design-system.md` §1a–§1b/§9 · `--task style-theme` |
 | 图标 / 语义速查 | `icons.md` · `--task icons` |
 | 起骨架用节奏包 | `scaffold_report.py --list-types` → `--preset consulting` 等 |
 
-**纪律**：L0+L1 是默认全部所需；上表命中才开 L2；**读完即执行，不预读下一份**。页型语义槽位见 `layout-constants.json` → `layoutSlots`（双通道同源 IR）。
+**纪律**：L0+L1 默认全部所需（Mode A/Fast 可加 L1.5）；命中才开 L2；**读完即执行，不预读**；大文件整读 = **FAIL**，一律 `extract_snippet.py`。页型槽位见 `layout-constants.json` → `layoutSlots`（双通道同源 IR）。
 **维护者**：改常量/schema/引擎后必跑 `sync_runtime.py` → `audit_styles.py` → `audit_docs.py` → `audit_skill.py` → `build_examples.py` → `regression.py`。

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

@@ -21,7 +21,7 @@
 ```
 
 - **页面预览**：收到/打开报告的人点 header「预览 PPTX」（快捷键 P）即可查看页序列，无需任何环境。预览模态与精导通道使用**同一序列化语义**（`slidesOf → slideXml`）——**版式与文本所见即所得**；带数据的原生图表在交付 PPTX 中为真 chart part（双击可编辑数据），预览侧为形状近似，**图表形态以精导产物为准**。**页面不直接导出文件**：浏览器端跑不了 strict 质检硬门禁，达不到交付质量；预览模态常显**可复制 AI 提示词**，用户想获得 PPTX 时复制给 AI，由智能体走精导通道生成（`?` 帮助弹窗 / 快捷键 H 有同样说明）。
-- **智能体精导**：正式 PPTX 的唯一交付路径——从报告抽模型 → 生成 → **过 strict 质检** → 交付。生成时用户选了「HTML+PPTX」交付格式的，交付时一并生成；交付后用户随时可通过页面提示词回来补生成。
+- **智能体精导（B 通道 · 唯一交付）**：`extract_model.py` → `build_pptx.js` → `validate_pptx.py --strict` 0/0。用户选「HTML+PPTX」或事后要 PPT 时才跑；**不要**用 A 通道（`pptx-export.js` / `gen_channel_a.js`）产物交付——A 仅页面预览与回归双裁判。
 - **双单源**：页面几何/三模式独立比例尺（`typeScale` 基准 + `modeTypeScale` 模式取值）/页型几何/9 风格 token 全在 `scripts/layout-constants.json`；**页型 DSL schema（字段/必填/适用模式）在 `scripts/model-schema.json`**。通道 B 直接 `require`；页面运行时由 `sync_runtime.py` 注入（同时注入三模板的引擎/UI/运行时内联副本）。**改常量只改 JSON，改 schema 只改 schema JSON，然后跑 `python scripts/sync_runtime.py`**。
 
 ### 会场与字号（venue · P1-4）

package/top-ppt-html/references/presentation-craft.md

@@ -2,7 +2,7 @@
 
 > **何时读**：Mode A / 正式演示 / 路演 / 演讲 / Fast 演示路径。与 `default-surface.md` 同级常读。  
 > **何时不读**：Mode B 密排、Mode C 架构深读（能力保留，不反向污染 A）。  
-> **定位**：大气、演讲友好；一屏一主张；图标/图表克制配文——非 gadget deck、非咨询 dump。
+> **定位**：优雅 · 美观 · 大气；正式场合演讲友好；版式/排版/色彩/内容组织优先；图标/图表克制配文——非 gadget deck、非咨询 dump。
 
 ## 铁律速查（Hard rules）
 
@@ -32,7 +32,8 @@
 
 ```
 validate_report.py --strict   # presentation 自动隐含 --layout-qa
-quality_gate.py … --deliver   # 同口径
+quality_gate.py … --deliver   # HTML/PPTX/evals 并行；同口径
+# PPTX 交付仅 B 通道 build_pptx.js（A 通道不交付）
 ```
 
 检查：V 契约 · 简单全幅 · 骨架连用 · 截断/溢出未拆页 · 半空卡 · 对齐节奏 · 主张标题 WARN · 核图多样性 · WCAG。
@@ -46,6 +47,14 @@ quality_gate.py … --deliver   # 同口径
 - [ ] `motion = none`；翻页靠内容节奏  
 
 
+## 插画页（非数据配图）
+
+- 情绪/产品/占位图与数据图**勿同页抢主位**；规则见 `illustration-layout.md`。
+- **安全边距** ≥24px；文字不压照片焦点；标签/图例不重叠。
+- **icon + chart**：icon 在注释列，不进绘图区。
+- **full-bleed + 主张叠字**（Mode A）：仅封面/章节幕/金句/收尾；遮罩保对比度；必有 caption/来源；证据另页。
+- 配图页写 **caption + so-what**（氛围休止页可免 so-what）；校验对缺项 WARN。
+
 ## 长文与信息承载（anti-truncation）
 
 > **硬原则**：大量文字**不得**为了「看起来像稀疏 demo 甲板」而被故意压缩或删除。留白是设计；**删掉证据 / so-what / 口径不是设计**。

package/top-ppt-html/references/tech-design.md

@@ -136,3 +136,9 @@
 | `evals/*` | Eval 框架：`prompts.csv`（14 条，含负对照）+ `rubric.schema.json`（风格目标评分契约）+ `run_evals.py`（结果/过程/风格/效率四类目标） |
 | `assets/templates/*` | 三模式模板 + 公共引擎/UI（标记块由 `sync_runtime.py` 注入） |
 | `assets/examples/*` | 示例矩阵（含信息图页型与原生图表技巧） |
+
+## 附：第三方校验与实验 frontmatter
+
+- **主门禁**：`audit_skill.py` / `package_skill.py --check`（体积、披露、Gate0、触发覆盖）。
+- **可选**：`npx --yes skills-ref@0.1.5 validate .`（Agent Skills 开放标准；本技能已通过）。**不**作为 CI 硬依赖。
+- **不启用**：Claude-only `when_to_use`（会破坏严格 allowlist）；跨端 `allowed-tools`（宿主语法分叉）——需要时由宿主侧实验，不进本仓库 frontmatter。

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

@@ -139,7 +139,7 @@ def main() -> int:
     # ⑤ 篇数与必需文件
     n_ref = len(list(REF.glob('*.md')))
     sk = (ROOT / 'SKILL.md').read_text(encoding='utf-8')
-    d = re.search(r'^description:\s*"(.*)"\s*$', sk, re.M | re.S)
+    d = re.search(r'^description:\s*"(.*)"\s*$', sk, re.M)
     dlen = len(d.group(1)) if d else -1
     nm = re.search(r'^name:\s*(\S+)\s*$', sk, re.M)
     missing = [r for r in REQUIRED if not (ROOT / r).exists()]

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

@@ -13,7 +13,7 @@
 
 审计项（任一不过 → 退出码 1）:
   ① 体积预算   —— SKILL.md / 常读入口 playbook.md / 单份 reference / 模式模板 的上限
-  ② 元数据     —— frontmatter name 与技能名一致；description ≤ DESC_HARD，且 ≤ DESC_SOFT（触发精度）
+  ② 元数据     —— frontmatter name 与技能名一致；description ≤ DESC_HARD/SOFT；可选 license/compatibility/metadata（开放标准）
   ③ 披露分层   —— SKILL.md 必须声明 L0/L1/L2 三档，且 L1（常读入口）恰好 1 份
   ④ 交互门禁   —— SKILL.md 必须含「Gate 0 参考图先行」，且其出现位置在「六项问询」之前；若声明 Fast Mode，须同时有豁免句且标准路径仍为硬门禁
   ⑤ 效率预算   —— SKILL.md 必须显式声明交互轮次上限与必读文件数上限
@@ -139,7 +139,7 @@ def main() -> int:
         f'最大 {kb(max((p.stat().st_size for p in TPL.glob("*.html")), default=0))} / 上限 {kb(BUDGET["template"])}')
 
     # ② 元数据
-    d = re.search(r'^description:\s*"(.*)"\s*$', sk, re.M | re.S)
+    d = re.search(r'^description:\s*"(.*)"\s*$', sk, re.M)
     dlen = len(d.group(1)) if d else -1
     nm = re.search(r'^name:\s*(\S+)\s*$', sk, re.M)
     chk('② name 一致', bool(nm) and nm.group(1) == NAME,
@@ -149,9 +149,37 @@ def main() -> int:
     chk('② description 软上限（触发精度）', 0 < dlen <= BUDGET['desc_soft'],
         f'{dlen} / 建议 ≤ {BUDGET["desc_soft"]}')
 
+    # ②b 开放标准可选 frontmatter（允许额外键；校验存在与粗约束）
+    lic = re.search(r'^license:\s*(.+)$', sk, re.M)
+    chk('② license', bool(lic) and 'MIT' in (lic.group(1) if lic else ''),
+        '缺 license: MIT（开放标准可选，本技能应对齐 package.json）',
+        'license=MIT')
+    compat = re.search(r'^compatibility:\s*"(.*)"\s*$', sk, re.M | re.S)
+    clen = len(compat.group(1)) if compat else -1
+    chk('② compatibility', 0 < clen <= 500,
+        f'compatibility 缺失或超 500 字符（{clen}）',
+        f'{clen} 字符')
+    meta_ver = re.search(r'^\s+version:\s*"?([\w.\-]+)"?\s*$', sk, re.M)
+    meta_author = re.search(r'^\s+author:\s*(\S+)\s*$', sk, re.M)
+    pkg_ver = ''
+    try:
+        import json as _json
+        pkg_ver = str(_json.loads((ROOT / 'package.json').read_text(encoding='utf-8')).get('version') or '')
+    except Exception:
+        pass
+    chk('② metadata.version', bool(meta_ver) and (not pkg_ver or meta_ver.group(1) == pkg_ver),
+        f'metadata.version 缺失或与 package.json 不一致（fm={meta_ver.group(1) if meta_ver else None} pkg={pkg_ver})',
+        f'{meta_ver.group(1) if meta_ver else "?"}')
+    chk('② metadata.author', bool(meta_author),
+        '缺 metadata.author',
+        meta_author.group(1) if meta_author else '')
+
     # ③ 渐进式披露分层（机器可读标记：L0=… · L1=… · L2=…）
-    m_l1 = re.search(r'L1\s*=\s*`?([^`\s·|]+)`?', sk)
-    has_l0 = bool(re.search(r'L0\s*=', sk))
+    # Prefer machine-readable disclosure marker `L1=references/...`（忽略正文「L0+L1 共 2」等）
+    m_l1 = re.search(r'L1\s*=\s*`?(references/[a-z0-9\-./]+\.md)`?', sk)
+    if not m_l1:
+        m_l1 = re.search(r'L1\s*=\s*`?([^`\s·|]+)`?', sk)
+    has_l0 = bool(re.search(r'L0\s*=\s*`?SKILL', sk)) or bool(re.search(r'`L0=SKILL', sk))
     has_l2 = bool(re.search(r'L2\s*=', sk))
     l1_files = [f.strip() for f in re.split(r'[,、]', m_l1.group(1)) if f.strip()] if m_l1 else []
     chk('③ 披露分层 L0/L1/L2', has_l0 and has_l2 and len(l1_files) == BUDGET['l1_files'],
@@ -182,6 +210,17 @@ def main() -> int:
         'SKILL.md 未声明交互轮次上限', '已声明（≤3 轮）')
     chk('⑤ 必读文件预算', bool(re.search(r'必读.{0,6}上限|必读文件数|只读当前需要的|不预读', sk)),
         'SKILL.md 未声明必读文件预算/不预读纪律', '已声明（不预读纪律）')
+    # ⑤b 反过读硬门禁文案（整读大 L2 = FAIL）+ B 通道交付口径
+    ok_snip = bool(re.search(r'extract_snippet', sk)) and bool(
+        re.search(r'整读.{0,40}(?:FAIL|不合格)|(?:FAIL|不合格).{0,40}整读', sk))
+    chk('⑤ extract_snippet 整读=FAIL', ok_snip,
+        'SKILL.md 须同时声明 extract_snippet 与「整读…FAIL/不合格」',
+        '已声明 FAIL 口径')
+    ok_b = bool(re.search(r'B\s*通道|build_pptx', sk)) and bool(
+        re.search(r'A\s*通道|pptx-export|cross_verify', sk))
+    chk('⑤ B 通道交付 / A 预览', ok_b,
+        'SKILL.md 须区分 B 通道交付与 A 通道预览/cross_verify',
+        '已区分')
 
     # ⑥ 引用完整性
     missing: list[str] = []

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

@@ -174,6 +174,17 @@ function modeFloorPt() {
   const f = FS_POLICY.floorPt[m];
   return f != null ? f : 10;
 }
+function snapFont(pt, ladder, floor) {
+  /* Snap arbitrary pt to nearest ladder step (≥ floor). fitFont + callers (fz-1) must use this. */
+  const lad = (ladder || FONT_LADDER).filter(v => v >= (floor == null ? 0 : floor));
+  if (!lad.length) return floor == null ? pt : Math.max(floor, pt);
+  let best = lad[0], bd = Math.abs(lad[0] - pt);
+  for (let i = 1; i < lad.length; i++) {
+    const d = Math.abs(lad[i] - pt);
+    if (d < bd) { bd = d; best = lad[i]; }
+  }
+  return best;
+}
 function fitFont(items, widthIn, availIn, opts) {
   opts = opts || {};
   const floor = opts.floor != null ? opts.floor : modeFloorPt();
@@ -536,7 +547,7 @@ function imageLayoutShapes(s, layout, img, items, points, isPh, fit, y0, y1) {
     const ptsI = points || [];
     const rowHI = fitRowH(ih - 0.1, ptsI.length, IM.noteRowH || 0.62, 0.3);
     const fzI = fitFont(ptsI.map(p => (p[0] || '') + (p[1] || '')), rwI - 0.3, ih, { max: 14, gapFactor: 0.6 });
-    const fz = sz(fzI), fzSm = sz(fzI - 1);
+    const fz = sz(fzI), fzSm = sz(snapFont(fzI - 1));
     ptsI.forEach((pt, i) => {
       const lyI = iy + i * rowHI;
       s.addShape('rect', { x: rxI, y: lyI + rowHI / 2 - 0.06, w: 0.12, h: 0.12,
@@ -1490,8 +1501,11 @@ function infoStreamgraph(s, sec, y0, y1) {
     totals.push(t);
   }
   const maxTot = Math.max.apply(null, totals.concat([1]));
-  const plotH = P.y1 - P.y0;
-  const cyMid = (P.y0 + P.y1) / 2;
+  /* Reserve legend INSIDE the plot box — 6 series must not crush the annotation band. */
+  const legH = Math.min(1.2, Math.max(0.28, series.length * 0.22 + 0.08));
+  const plotBottom = P.y1 - legH;
+  const plotH = Math.max(0.6, plotBottom - P.y0);
+  const cyMid = P.y0 + plotH / 2;
   const xAt = (i) => MX + (nPts > 1 ? i / (nPts - 1) : 0.5) * CW;
   const yAt = (i) => cyMid - (totals[i] / maxTot) * plotH / 2;
   const palette = [STYLE.accent, STYLE.faint, STYLE.body, STYLE.line, STYLE.soft, STYLE.surface];
@@ -1512,14 +1526,14 @@ function infoStreamgraph(s, sec, y0, y1) {
     }
     ribbonRects(s, pts, palette[si % palette.length]);
     const lx = MX;
-    s.addShape('rect', { x: lx, y: P.y1 + 0.06 + si * 0.26, w: 0.12, h: 0.12,
+    s.addShape('rect', { x: lx, y: plotBottom + 0.04 + si * 0.2, w: 0.12, h: 0.12,
       fill: { color: palette[si % palette.length] }, line: { type: 'none' } });
-    s.addText(String(se.name || ('系列' + (si + 1))), { x: lx + 0.16, y: P.y1 + si * 0.26, w: 1.5, h: 0.26,
+    s.addText(String(se.name || ('系列' + (si + 1))), { x: lx + 0.16, y: plotBottom + 0.02 + si * 0.2, w: 1.5, h: 0.2,
       fontFace: STYLE.font, fontSize: sz(10), color: STYLE.body, valign: 'middle' });
     base = upper;
   });
   labels.forEach((lb, i) => {
-    s.addText(String(lb), { x: xAt(i) - 0.4, y: P.y1 - 0.02, w: 0.8, h: 0.24, align: 'center',
+    s.addText(String(lb), { x: xAt(i) - 0.4, y: plotBottom - 0.22, w: 0.8, h: 0.2, align: 'center',
       fontFace: STYLE.font, fontSize: sz(9.5), color: STYLE.faint });
   });
 }
@@ -1745,8 +1759,8 @@ CONTENT.sections.forEach((sec) => {
     const iy = ireg.y;
     const capH = img.caption ? 0.32 : 0;
     const ih = Math.max(1.2, ireg.h);
-    imageLayoutShapes(s, layout, img, items, sec.points || [], isPh, fit, iy, iy + ih);
-    if (img.caption) s.addText(img.caption, { x: MX, y: iy + ih + 0.04, w: CW, h: capH,
+    const capYImg = imageLayoutShapes(s, layout, img, items, sec.points || [], isPh, fit, iy, iy + ih);
+    if (img.caption) s.addText(img.caption, { x: MX, y: capYImg + 0.04, w: CW, h: capH,
       fontFace: STYLE.font, fontSize: sz(10.5), color: STYLE.faint });
   } else if (type === 'donut') {
     const dcn = sec.chart || {};
@@ -2133,7 +2147,7 @@ CONTENT.sections.forEach((sec) => {
       const ly0 = bodyY, availP = bodyBottom - ly0;
       const rowH = fitRowH(availP, pts.length, SP.rowH, 0.3);
       const fzB = fitFont(pts.map(p => (p[0] || '') + (p[1] || '')), w - 0.4, availP, { max: 14, gapFactor: 0.6 });
-      const fz = sz(fzB), fzSm = sz(fzB - 1);
+      const fz = sz(fzB), fzSm = sz(snapFont(fzB - 1));
       pts.forEach((pt, i) => {
         const ly = ly0 + i * rowH;
         s.addShape('rect', { x, y: ly + rowH / 2 - 0.06, w: 0.12, h: 0.12, fill: { color: STYLE.accent }, line: { type: 'none' } });
@@ -2277,7 +2291,7 @@ CONTENT.sections.forEach((sec) => {
     const rowH = fitRowH(avail, pts.length, P.rowH, 0.3);
     const fzB = fitFont(pts.map(p => (p[0] || '') + (p[1] || '')), textW - 0.32, avail,
       { max: 15, gapFactor: 0.55 });
-    const fz = sz(fzB), fzSm = sz(fzB - 1);
+    const fz = sz(fzB), fzSm = sz(snapFont(fzB - 1));
     pts.forEach((p, i) => {
       const y = bodyY + i * rowH;
       s.addShape('rect', { x: MX, y: y + rowH / 2 - P.markSize / 2, w: P.markSize, h: P.markSize,

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

@@ -0,0 +1,153 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""TopPPT HTML · description trigger coverage (keyword/heuristic, no LLM).
+
+Gates regressions when SKILL.md description drifts away from eval queries.
+See evals/trigger-queries.json → how_to_extend.
+
+Usage:
+    python3 scripts/check_triggers.py
+    python3 scripts/check_triggers.py --json
+"""
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+SKILL = ROOT / 'SKILL.md'
+QUERIES = ROOT / 'evals' / 'trigger-queries.json'
+
+# Tokens that, if present in a query AND in description (or Do-NOT zone for negatives),
+# count toward a hit. Multi-char CJK / ASCII keywords preferred over single chars.
+POS_KEYWORDS = [
+    '报告', '演示', '汇报', '路演', '调研', '白皮书', '评测', '对标', '经营分析', '复盘',
+    'PPT', 'PPTX', 'pptx', 'slides', 'deck', 'HTML', '网页报告',
+    '架构图', '拓扑', '流程图', '泳道', '方案图',
+    '排版', '版式', '配色', '图文',
+    '快速模式', 'fast', '一键出稿', '直接生成', '少问一句',
+    '可视化', '高保真', '可编辑',
+    '咨询报告', '分析报告', '研究报告', '项目汇报', '商务',
+]
+
+# Negative-zone cues in description (Do NOT …) — if a miss-query matches these
+# boundary phrases more than positive product cues, treat as correctly excluded.
+NEG_BOUNDARY = [
+    '纯代码', '代码工程', '非报告类', '视频', '图片生成',
+    'Word', '源文件', '应用开发', 'coding', 'Do NOT',
+]
+
+# Extra strong negative query cues (if query has these AND lacks report cues → expect miss)
+NEG_QUERY_CUES = [
+    'react', '组件', '单测', 'debug', 'python 报错', '视频', 'mp4', 'midjourney',
+    '海报图', '已有的 pptx', '已有 pptx', 'word 文档', '电商官网', 'sql',
+    'nginx', 'refactor', 'typescript', '剪辑', '录像', '字幕', '迁移脚本',
+]
+
+
+def load_description() -> str:
+    txt = SKILL.read_text(encoding='utf-8')
+    m = re.search(r'^description:\s*"(.*)"\s*$', txt, re.M)
+    if not m:
+        raise SystemExit('SKILL.md missing description frontmatter')
+    return m.group(1)
+
+
+def tokenize_hits(query: str, desc: str) -> list[str]:
+    q_low = query.lower()
+    d_low = desc.lower()
+    hits = []
+    for kw in POS_KEYWORDS:
+        if kw.lower() in q_low and kw.lower() in d_low:
+            hits.append(kw)
+    return hits
+
+
+def looks_negative_query(query: str) -> bool:
+    q = query.lower()
+    return any(c in q for c in NEG_QUERY_CUES)
+
+
+def boundary_covered(desc: str) -> bool:
+    return sum(1 for b in NEG_BOUNDARY if b.lower() in desc.lower()) >= 2
+
+
+def evaluate(desc: str, data: dict) -> tuple[list[dict], int, int]:
+    rows = []
+    fails = 0
+    for bucket, default_expect in (('positive', 'hit'), ('negative', 'miss')):
+        for item in data.get(bucket, []):
+            q = item['query']
+            expect = item.get('expect', default_expect)
+            hits = tokenize_hits(q, desc)
+            if expect == 'hit':
+                ok = len(hits) >= 1
+                detail = f'keywords={hits}' if ok else 'no shared trigger keyword with description'
+            else:
+                # miss: either no positive keyword overlap, OR query is clearly
+                # out-of-scope and description has Do-NOT boundaries.
+                ok = (len(hits) == 0) or (
+                    looks_negative_query(q) and boundary_covered(desc) and len(hits) <= 1
+                )
+                # Stricter: if query is a known out-of-scope cue, require miss even
+                # when a weak overlapping token exists (e.g. "pptx" in "改已有 pptx").
+                if looks_negative_query(q) and boundary_covered(desc):
+                    ok = True
+                detail = (
+                    f'miss-ok boundary; weak_hits={hits}' if ok
+                    else f'unexpected trigger overlap={hits}'
+                )
+            rows.append({
+                'id': item.get('id'),
+                'expect': expect,
+                'ok': ok,
+                'query': q,
+                'detail': detail,
+            })
+            if not ok:
+                fails += 1
+    return rows, fails, len(rows)
+
+
+def main() -> int:
+    as_json = '--json' in sys.argv
+    if not QUERIES.exists():
+        print(f'MISSING {QUERIES}')
+        return 1
+    data = json.loads(QUERIES.read_text(encoding='utf-8'))
+    desc = load_description()
+    rows, fails, total = evaluate(desc, data)
+    n_pos = sum(1 for r in rows if r['expect'] == 'hit')
+    n_neg = sum(1 for r in rows if r['expect'] == 'miss')
+    if as_json:
+        print(json.dumps({
+            'total': total, 'fails': fails,
+            'positive': n_pos, 'negative': n_neg,
+            'description_chars': len(desc),
+            'rows': rows,
+        }, ensure_ascii=False, indent=2))
+    else:
+        print(f'trigger coverage · {total - fails}/{total}  '
+              f'(+{n_pos} / −{n_neg}) · description {len(desc)} chars')
+        for r in rows:
+            mark = 'OK' if r['ok'] else 'FAIL'
+            print(f'  [{mark}] {r["id"]} expect={r["expect"]}  {r["detail"]}')
+            if not r['ok']:
+                print(f'         Q: {r["query"]}')
+        if fails:
+            print(f'\nFAILED {fails} query(ies). Extend keywords in SKILL description '
+                  f'or adjust evals/trigger-queries.json (see how_to_extend).')
+        else:
+            print('\nAll trigger heuristics passed.')
+    return 1 if fails else 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

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

@@ -23,6 +23,7 @@
   L4  截断迹象（列表项省略号砍义）
   L5  溢出未拆页
   L6  混排缺对齐（ALIGN_RHYTHM）
+  N18 配图页缺 caption/图注（IMAGE_CAPTION）
 
 用法: python scripts/negative_tests.py
 """
@@ -176,6 +177,15 @@ def main() -> int:
             '"footnote": "<strong>x</strong> ', 1)
     cases.append(('N17 模型夹带标签', t17, 'HTML_TAG_IN_TEXT'))
 
+    # N18 配图页缺 caption（有 <img>/media 无图注类）
+    t18 = txt.replace(
+        '</body>',
+        '<section class="band" data-page-type="image">'
+        '<div class="media media--full">'
+        '<img src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7" alt="注入无图注">'
+        '</div></section></body>', 1)
+    cases.append(('N18 配图缺 caption', t18, 'IMAGE_CAPTION'))
+
     ok = True
     for name, content, keyword in cases:
         if content == txt: