@topmindspace/tms-skills 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,4 +1,49 @@
-## Unreleased
+## 0.1.4 — 2026-09-25
+
+### top-ppt-html · craft + quality + docs + perf close-out
+
+- **P0 效率 / agent 工作流**（usage-feedback）：
+  - 默认交付 **仅 B 通道 PPTX**（`build_pptx.js`）；A 通道（`pptx-export.js` / `gen_channel_a.js`）限预览与 `cross_verify` / 回归。
+  - `extract_snippet` 强制 + **整读大 L2 = FAIL / 不合格**（SKILL + playbook）；`audit_skill` 新增对应门禁。
+  - `quality_gate` 对互不依赖子进程（HTML strict / PPTX strict / evals）**并行**执行。
+  - Fast / 轻量路径强化 **HTML-first**；PPTX 显式 opt-in（用户要 PPT 或交付含 PPTX）。
+  - **未削弱**红线：反截断、图表多样性（`minTypes.presentation=4` / registry）、Mode A 大气正式工艺、Gate 0 语义。
+- **质量 / 规范**：对齐 SKILL frontmatter、双 `package.json`、README 钉版本、PUBLISHING、安装说明；跑通 check / audit / feedback gates。
+- **docs 工艺改写**：定位强调优雅·美观·大气·演讲/正式场合；版式/排版/色彩/内容组织 + 质检与高保真导出；L0 仍瘦、L2 按需。
+- **此前 #7（validator / engine）**：`shape_bounds` 读 `p:xfrm`、`TEXT_OVERFLOW_VERTICAL`、`ANNOTATION_BAND_OVERLAP`、`FONT_SIZE_NOT_SNAPPED`、多系列 vbar、streamgraph 图例内收、image caption `capYImg`——随本版一并发布。
+
+### Installer
+
+- `@topmindspace/tms-skills` → **0.1.4**（整仓同 tag）。
+
+### Intentional leftovers
+
+- 不引入 Claude-only `when_to_use` / 跨端风险 `allowed-tools`（同 0.1.3）。
+- `skills-ref validate` 仍为可选，非发布硬依赖。
+- layout-constants / model-schema 事实源版本线仍为 `0.1`（patch 记在 package / metadata）。
+
+## 0.1.3 — 2026-09-24
+
+### top-ppt-html · QA close-out + docs
+
+- **P2-4 playbook 拆表**：意图→页型穷举 → `references/page-type-matrix.md`；图表决策表+七种误用 → `references/chart-decision-tree.md`。playbook 保留 Mode 契约 / V1–V4 / 组合 / **图表多样性摘要** / **反截断** / 路径·命令·L2 路由（体积 22KB→~17KB）。
+- **版本对齐**：根 README / 技能 README / PUBLISHING / `metadata.version` / 双 `package.json` → **0.1.3**（消除残留 0.1.0 横幅）。
+- **IMAGE_CAPTION**：配图页亦认 so-what/lead/figcaption；新增 WARN `IMAGE_NEAR_EMPTY`（近图过空）。
+- **P2-2/P2-3**：不引入 Claude-only `when_to_use`、不写跨端风险 `allowed-tools`（`skills-ref validate` 已通过开放标准字段；扩展字段留给宿主实验）。
+- **P2-5**：可选 `npx skills-ref@0.1.5 validate ./top-ppt-html`（不作为发布硬依赖；主门禁仍 `audit_skill`）。
+- **docs**：根 README 安装表/钉版本/`@0.1.3`；技能 README 改为人类维护指南并指向 SKILL；package REQUIRED + MIN refs ≥25。
+
+### Installer
+
+- `@topmindspace/tms-skills` → **0.1.3**（整仓同 tag）。
+
+### 此前 Unreleased（agent-compat，随 0.1.3 一并发布）
+
+- **P0-1 Trigger eval**：`evals/trigger-queries.json` + `scripts/check_triggers.py`；`package_skill.py --check` 门禁。
+- **P0-2 Mode A 读预算诚实**：L0+L1=2；Mode A/Fast 可加 L1.5（`default-surface` + `presentation-craft`）。
+- **P0-3 反过读**：禁止整读清单 + 强制 `extract_snippet.py`。
+- **P1 Frontmatter / 安装路径 / Fast 最小大纲 / 插画 brief**：license·compatibility·metadata；Cursor/Codex 路径；`illustration-layout.md`；`agents/openai.yaml`。
+
 
 ## 0.1.2 — 2026-09-24
 

package/README.md

@@ -1,6 +1,6 @@
 # tms-skills
 
-**TopMindspace 智能体技能 monorepo** — 可安装的智能体技能集合，当前包含 **top-ppt-html**。
+**TopMindspace 智能体技能 monorepo** — 可安装的智能体技能集合，当前包含 **top-ppt-html**（优雅、大气、正式场合演讲/汇报甲板）。
 
 让 idea 飞，好想法被看见。
 
@@ -8,9 +8,9 @@
 
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
-| [`top-ppt-html`](./top-ppt-html/) | 0.1.0 | 报告 / 演示 / 信息架构图：单文件 HTML + 版式保真的可编辑 16:9 PPTX |
+| [`top-ppt-html`](./top-ppt-html/) | 0.1.4 | 优雅大气的正式场合演讲/汇报甲板：单文件 HTML + 版式保真可编辑 16:9 PPTX |
 
-安装器包 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 亦为 **0.1.0**（与技能版本各自独立演进）。
+安装器包 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 亦为 **0.1.4**（整仓发版：安装器与当前技能同 tag；未来多技能仍可各自演进，默认随仓库 release）。
 
 更多技能以仓库根目录下的技能目录加入（每个目录含 `SKILL.md`）。
 
@@ -30,7 +30,7 @@
 npx @topmindspace/tms-skills list
 npx @topmindspace/tms-skills install top-ppt-html
 npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
-npx @topmindspace/tms-skills@0.1.0 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills@0.1.4 install top-ppt-html   # 钉版本
 ```
 
 ### GitHub 直装
@@ -48,6 +48,16 @@ node tms-skills/bin/tms-skills.js install top-ppt-html
 
 安装器把根目录下的技能目录 `<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 精导）

package/bin/tms-skills.js

@@ -70,12 +70,17 @@ function readSkillMeta(skillId) {
 }
 
 function resolveDefaultTarget() {
+  const home = process.env.HOME || process.env.USERPROFILE || '';
   const candidates = [
     path.join(process.cwd(), '.agents', 'skills'),
     path.join(process.cwd(), '.claude', 'skills'),
+    path.join(process.cwd(), '.cursor', 'skills'),
+    path.join(process.cwd(), '.codex', 'skills'),
     path.join(process.cwd(), '.mimocode', 'skills'),
-    path.join(process.env.HOME || process.env.USERPROFILE || '', '.claude', 'skills'),
-    path.join(process.env.HOME || process.env.USERPROFILE || '', '.agents', 'skills'),
+    path.join(home, '.claude', 'skills'),
+    path.join(home, '.agents', 'skills'),
+    path.join(home, '.cursor', 'skills'),
+    path.join(home, '.codex', 'skills'),
   ];
   for (const dir of candidates) {
     if (dir && fs.existsSync(path.dirname(dir))) {

package/package.json

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

package/top-ppt-html/README.md

@@ -1,28 +1,23 @@
 # TopPPT HTML
 
-**让 idea 飞，好想法被看见。** 一套面向 AI 智能体的商务报告生成技能：把想法、调研、分析、架构方案，变成**专业级的 HTML 报告 + 版式保真的可编辑 PPTX**。
+**让 idea 飞，好想法被看见。** 面向**演讲与正式场合**的高品质甲板技能：把主张、调研、分析、架构方案，生成为**优雅、美观、大气**的可翻页 HTML + **版式保真可编辑 PPTX**。核心工艺是版式、排版、色彩与内容组织——克制图标/图表配文，而非 gadget 堆砌或咨询 dump 默认。
 
 - 技能标识：`top-ppt-html`（安装/打包目录名与此一致）；品牌名：**TopPPT HTML**
-- 版本：**v0.1.0** · 完整规范见 `SKILL.md`（智能体入口）+ `references/playbook.md`（唯一常读入口）+ `references/layout-grammar.md`（排版）+ 其余按需 L2
+- 版本：**v0.1.4**（与 `@topmindspace/tms-skills@0.1.4` 同 tag）
+- **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
+- **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
 
-## 一、技能简介
+## 一、技能简介（人类速览）
 
 | 维度 | 能力 |
 |------|------|
-| 产出物 ① | **单文件 HTML 报告**：零外链、可翻页（方向键整屏翻页）、**每页一屏的稳定页高**、亮暗双主题（记忆按文件隔离）、header 自带工具栏（主题/9 风格实时切换/PPTX WYSIWYG 预览/可复制 AI 提示词/全屏 F/收起工具栏 B） |
-| 产出物 ② | **16:9 可编辑 PPTX**：全原生形状/文本框/表格（默认 `pictures=0`；模型显式声明 `section.image` 时按声明数导出素材图片，六版式 full/half/bleed/grid/compare/wall 与 HTML 同比例；无素材时出**原生配图占位框**——可编辑、`pictures` 不增），三模式独立排版比例尺 + **29 种页型**，带数据的图表为**原生数据图表**（双击"编辑数据"），非原生图表**附数据表**（备注/页内表格），口径自动写入演讲者备注，按所选主题导出亮色版或深色版 |
-| 三种模式 | A 演示汇报（大字每屏一主张，8–15 页）/ B 研究报告（咨询密排：行动标题 + Exhibit 编号 + 双三栏 + 密表 + 矩阵，12–25 页）/ C 信息架构图（图为王：全幅分层带/泳道/管线，1–3 张图成篇） |
-| 9 套风格 | 商务蓝（默认）/ 优雅黑白 / 麦肯锡 / 品牌红 / 暖沙金 / 墨绿 / 石墨深灰（深色优先）/ 靛紫 / 光谱彩色——与模式、主题正交组合；**每套风格各有自己的编码色板 c1–c5**（`styleDataColors` 单源，双引擎消费），多系列图表在任何风格下都可辨。**刻意不再扩张**：新增门槛（新色族 + 新语汇 + 场景缺口）见 `references/styles.md` §10 |
-| 复杂信息图 | 桑基 / 树图 / 箱线 / 关系网络 / 马赛克 / 流带 六类专属页型：曲线采样点 ≥16（流带 ≥24）、双边界分别追踪、禁预设形状替代；每页一图，数据表可追溯 |
-| 强调带 | 收尾/CTA 用 `band--accent`（软强调）、金句用 `band--accent--solid`（实底）——**浅色模式不再出现深色收尾页**；`band--deep` 仅显式反相页（≤1 处、不作末页） |
-| 待核实标注 | `.tbd` 内联标色 + `.tbd-legend`/`.flagbar` 说明——无法核实的数字/判断用**强调色**标出，提示用户二次修改（PPTX 同源 + 演讲者备注） |
-| 素材图片 | **六版式**：full 版心全宽 3:1 / half 左图右注 4:3 / bleed 通栏出血 21:9 / grid 多图网格 4:3（2·3·4·6 张）/ compare 双图 A/B / wall Logo 墙；比例由 `imageSpec` 单源锁定（HTML 用 `.media--r*` 类、PPTX 用同一比例算高度并居中）——**两通道比例一致**；`src` 仅 data: 内联或相对路径；PPTX 声明式放行 |
-| 配图占位 | 无素材时不省略图也不塞无关图：`.media--ph`（虚线框 + 斜纹 + 图标 + 尺寸提示）+ 模型 `image.placeholder` → PPTX 出**原生圆角矩形占位框**（可编辑、`pictures` 不增），交付前替换 `src` 即可；预览模态会把图位替换成真实图片 |
-| 用户图片准备 | `scripts/prepare_images.py <图片\|目录> --layout full\|half\|grid…`：读尺寸/格式/体积 → 按版式建议尺寸缩放压缩（有 Pillow 时）→ 自动选 data: 内联或相对路径 → 产出可粘贴的 `.media` HTML 片段与 `image` 模型对象 |
-| 36 种图表 | 环形 / 多段环形 / 饼图 / 柱状 / 堆叠 / 100% 堆叠条 / 折线 / 双折线 / 面积 / 横向条形 / 双向条形 / 雷达 / 仪表盘 / 玫瑰 / 瀑布 / 漏斗 / 甘特 / 散点 / 气泡 / 矩形树图 / 马赛克 / 进度条组 / 迷你趋势线 / 桑基 / 斜率 / 哑铃 / 棒棒糖 / 点图 / 子弹图 / 华夫 / 箱线 / 帕累托 / 径向条 / 流图 / K 线 / 关系网络（全内联 SVG，随主题与风格变色；**16 类走 PPTX 原生图表，其余形状还原 + 数据表**） |
-| 按需深度模式 | 命中「高保真/1:1/精确还原/正式交付」或含复杂信息图时自动升级：`--deep` 把连续文本流与空间锚点纳入 strict，`--emit-manifest` 产出锚点/容器/数据表/图表通道/图片资产登记，`render_compare.py` 准备渲染对照材料（缺依赖自动跳过） |
-| 质量闭环 | `validate_report.py`（HTML strict 全 PASS，含强调带约束/待核实标注/素材图片与配图占位/图表数据表策略）+ `validate_pptx.py --strict`（0 错误 0 警告，含容器级溢出/表格语义字号与密度/未声明图片硬拦/图片版式·裁切·多图数量·相对路径文件存在性）+ WCAG 对比度与单源完整性审计 + 双通道回归双裁判 + 素材图片导出探针 |
-| 设计标准 | Material Design 3 对齐（克制执行）；研究模式对齐咨询机构实践 |
+| 产出 | 单文件 HTML（可翻页、亮暗双主题、header 工具栏）+ 16:9 可编辑 PPTX（精导通道） |
+| 三模式 | A 演示 · B 研究 · C 架构（页型/字号/密度契约见 `playbook.md` §一） |
+| 风格 | 9 套（`styles.md`）；编码色板 c1–c5 随风格 |
+| 图表 | 核图 8 默认 + registry 全量；多样性 / 反截断 / Mode A 工艺见 playbook + `presentation-craft.md` |
+| 质量 | `validate_report --strict`（A 隐含 layout-qa）· `validate_pptx --strict` · `quality_gate --deliver` |
+
+生成规范、页型/图表穷举、铁律 **不在本文件**——智能体读 `SKILL.md` / playbook；选型大表见 `page-type-matrix.md` / `chart-decision-tree.md`。
 
 **核心架构**：HTML 与 PPTX 出自同一内容模型 `window.REPORT_MODEL`（唯一事实源）；页面只预览不导出，PPTX 由智能体走「精导通道」生成（extract → build → strict 校验）。阈值与几何全部单源化：`scripts/layout-constants.json`（常量）+ `scripts/model-schema.json`（页型 DSL）。
 
@@ -48,6 +43,16 @@ node tms-skills/bin/tms-skills.js install top-ppt-html
 
 > **GitHub 更新不会自动进 npm。** 日常可钉 npm 版本；要最新技能用 GitHub 直装，或等 maintainer 打 tag 发版。
 >
+
+### 触发词回归（维护者）
+
+```bash
+python3 scripts/check_triggers.py          # keyword/heuristic vs SKILL description
+# 扩展：编辑 evals/trigger-queries.json（how_to_extend）
+```
+
+`package_skill.py --check` 会自动跑 trigger coverage。
+
 > 「找不到这个包」→ 换 GitHub 直装，或 `--registry https://registry.npmjs.org/`（镜像索引可能滞后）。不要 `npm install top-ppt-html`（技能 id 不是独立 npm 包）。
 
 也可将本目录（或 GitHub Release 附件 `top-ppt-html.zip` 解压结果）复制到智能体技能目录，目录名保持 `top-ppt-html`。技能识别面为 `SKILL.md`（frontmatter 的 `name` / `description` 即触发描述）。
@@ -73,11 +78,11 @@ npm install                  # 依 package.json 安装 pptxgenjs（^4）
 ```
 听意图 → Gate 0 参考图 → 六项问询 → 路径判定（轻量默认 / 完整走 outline-design.md 七步法）
 → scaffold_report.py 起骨架（勿整读/复制模板）→ **只填 window.REPORT_MODEL** → `render_from_model.py --inplace`
-→ validate_report.py --strict 全 PASS → 交付
-→（含 PPTX 时）extract_model.py → build_pptx.js --model → validate_pptx.py --strict 0/0
+→ validate_report.py --strict 全 PASS → 交付（默认 HTML）
+→（用户要 PPTX 时 · **仅 B 通道**）extract_model.py → build_pptx.js --model → validate_pptx.py --strict 0/0
 ```
 
-**渐进式披露三档**（详见 `SKILL.md` 阶段路由表）：`L0` = `SKILL.md`（路由 + 门禁 + 铁律，加载即用）；`L1` = `references/playbook.md`（**唯一常读入口**：模式契约 / 页型选型 / 组合版式矩阵 / 图表选型决策树 / 内容规则 / 配色 / 校验命令）；`L2` = 深度规范，**只在命中条件时读、读完即停**；**取码优先 `extract_snippet.py`**（`components.md`/`charts.md` 为逻辑索引，自动路由到 `components-atoms` / `layouts-*` / `charts-basic` / `charts-extended` / `charts-discipline` 等物理文件）。
+**渐进式披露三档**（详见 `SKILL.md` 阶段路由表）：`L0` = `SKILL.md`（路由 + 门禁 + 铁律，加载即用）；`L1` = `references/playbook.md`（**唯一常读入口**：模式契约 / 页型选型 / 组合版式矩阵 / 图表选型决策树 / 内容规则 / 配色 / 校验命令）；`L2` = 深度规范，**只在命中条件时读、读完即停**；**取码必须 `extract_snippet.py`**（整读大 L2 = FAIL）；`components.md`/`charts.md` 为逻辑索引，自动路由到物理拆分文件。
 
 ## 三、目录结构
 
@@ -106,9 +111,12 @@ top-ppt-html/
 │  ├─ infographics.md           #   铁律与边界（逻辑入口）；代码已拆分见下两行          │
 │  ├─ infographics-stats.md     #   统计图形族 §1–§6 / §71–§77                        │
 │  ├─ infographics-structure.md #   结构图形族 §78–§82                                │
+│  ├─ page-type-matrix.md     #   L2 意图→页型穷举（playbook §三 速记）                 │
+│  ├─ chart-decision-tree.md  #   L2 图表决策表+误用（playbook §五 摘要）               │
+│  ├─ illustration-layout.md  #   L2 插画/配图 brief                                   │
 │  └─ …（modes / styles / design-system / content-rules / icons / default-surface /     │
-│        outline-design / pptx-export / high-fidelity /                               │
-│        failure-modes / tech-design；归档见 docs/archive/refs/）                         │
+│        outline-design / pptx-export / high-fidelity / failure-modes / tech-design；  │
+│        归档见 docs/archive/refs/）                                                   │
 ├─ evals/                       # Eval 框架（结果/过程/风格/效率四类目标）    │
 │  ├─ prompts.csv               #   14 条 prompt（显式/隐式/上下文/负对照）   │
 │  ├─ rubric.schema.json        #   风格目标结构化评分契约                    │
@@ -145,18 +153,23 @@ python scripts/package_skill.py --check
 python scripts/audit_skill.py && python scripts/audit_docs.py
 python scripts/audit_styles.py && python scripts/audit_css.py
 python scripts/negative_tests.py
+python scripts/check_triggers.py
+# 可选第三方：npx --yes skills-ref@0.1.5 validate .
 ```
 
 ## 目录要点
 
 | 路径 | 用途 |
 |------|------|
-| `SKILL.md` | L0 路由（≤13KB） |
-| `references/playbook.md` | L1 决策层 |
-| `references/default-surface.md` | Mode A 主读：12 页型 + 核图 8 + V1–V4；主力骨架 P1–P4+P6/P10 |
+| `SKILL.md` | L0 路由（≤13KB）；智能体唯一入口 |
+| `references/playbook.md` | L1 决策层（Mode / 路径 / V1–V4 / 组合 / 多样性摘要 / 命令 / 路由） |
+| `references/page-type-matrix.md` | L2 页型穷举表 |
+| `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/style-gallery.html` | 9 风格 × 模式 × 亮暗 |
-| `docs/archive/` | 历史规范 / 旧示例 / 全量 build_examples |
+| `evals/trigger-queries.json` | description 触发正/负例；`check_triggers.py` |
+| `docs/archive/` | 历史规范 / 旧示例 |
 
 风格画廊与主题参考图：`assets/theme-overview*.png`（Gate 0）。完整规范索引见 playbook §十。
 

package/top-ppt-html/SKILL.md

@@ -1,11 +1,15 @@
 ---
 name: top-ppt-html
-description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文件零外链 HTML（可翻页、亮暗双主题）+ 版式保真的原生可编辑 16:9 PPTX。三模式（A 演示·每屏一主张 / B 研究·咨询密排 / C 架构·图为王）× 9 风格；布局骨架 P1–P12；内容只填 REPORT_MODEL，render_from_model 回填正文；strict 0/0 才交付。Use when 用户要做报告、演示、汇报、PPT、slides、deck、路演，或写研究报告、分析报告、咨询报告、白皮书、调研、评测、对标、经营分析、复盘、项目汇报、商务/HTML/网页报告，或做架构图、拓扑图、流程图、泳道图、方案图，或把材料/数据做成可视化报告，或导出 HTML/PPT/PPTX（保真、可编辑、高保真、1:1），或优化排版、版式、配色、密度、图文布局，或要快速模式/fast/直接生成/一键出稿/少问一句。Do NOT use for 纯代码工程、非报告类网页或应用开发、视频/图片生成、直接改写已有 Word/PPT 源文件本身。"
+description: "Use when 用户要做报告、演示、汇报、PPT、slides、deck、路演，或写研究报告、分析报告、咨询报告、白皮书、调研、评测、对标、经营分析、复盘、项目汇报、商务/HTML/网页报告，或做架构图、拓扑图、流程图、泳道图、方案图，或把材料做成可视化报告并导出 HTML/PPT/PPTX，或优化排版/版式/配色/图文布局，或要快速模式/fast/直接生成/一键出稿/少问一句。TopPPT HTML：优雅大气的正式场合演讲/汇报甲板——零外链可翻页 HTML（亮暗双主题）+ 版式保真可编辑 16:9 PPTX；核心=版式·排版·色彩·内容组织；三模式（A 演示·每屏一主张 / B 研究·咨询密排 / C 架构·图为王）× 9 风格。Do NOT use for 纯代码工程、非报告类网页或应用开发、视频/图片生成、直接改写已有 Word/PPT 源文件本身。"
+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.4"
+  author: TopMindspace
 ---
-
 # TopPPT HTML
 
-**让 idea 飞，好想法被看见。** 一套技能、三种模式、两种交付：**单文件 HTML 报告**（可翻页、可演示、header 自带工具栏）+ **版式保真的原生可编辑 PPTX**（智能体精导唯一交付通道）。两者同源于一个内容模型 `REPORT_MODEL`。设计对齐 Material Design 3，执行克制（Google/Apple 风）；研究模式对齐咨询机构（McKinsey/BCG）的密度与论证结构，但**克制优先**——不加多余的页头标签、页脚信息与装饰。
+**让 idea 飞，好想法被看见。** 面向**演讲与正式场合**的优雅、大气甲板——非 gadget 堆砌、非咨询 dump 默认。三种模式、两种交付：**单文件 HTML**（可翻页演示）+ **版式保真可编辑 PPTX**（**B 通道** `build_pptx.js` 为唯一交付；**A 通道**仅预览/`cross_verify`）。同源 `REPORT_MODEL`。设计对齐 MD3，执行克制；研究模式可对齐咨询密度，但**克制优先**——少装饰、一屏一重心。
 
 ## Gate 0 · 先给参考图（**标准模式**硬门禁）
 
@@ -30,9 +34,9 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
 | style | B→mckinsey · A→business-blue · C→graphite-dark | |
 | theme | light（graphite→dark） | |
 | 篇幅 | A=10 / B=12 / C=6 | |
-| format | html only（用户要 PPT→html+pptx） | |
+| format | **html only**（默认；**仅当用户要 PPT / 交付含 PPTX 才开** B 通道） | |
 
-流程：一行宣布「Fast 选用：…」→ 走 playbook §二轻量命令链（骨架→模型单写→回填→strict→`quality_gate --deliver`；可选 pptx）。路径永远轻量；回复末可附 `assets/style-gallery.html`。开场须声明「已跳过参考图」。**标准模式**仍强制 Gate 0 + 六项。
+流程：一行宣布「Fast 选用：…」→ **最小大纲**（`outline-design.md`「轻量最小集」）→ playbook §二轻量链（骨架→模型单写→回填→strict→`quality_gate --deliver`；**PPTX 显式 opt-in**）。路径轻量；末可附 `assets/style-gallery.html`。开场声明「已跳过参考图」。**标准模式**仍强制 Gate 0 + 六项。
 
 ## 唯一入口流程
 
@@ -42,7 +46,7 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
       （命令链见 playbook §二/§九；PPTX 见 pptx-export）
 ```
 
-**预算（硬）**：交互轮次 **≤3**；默认必读仅 2 份——本文件 + L1 决策层 `references/playbook.md`；L2 深度文件命中才读、读一份用一份、不预读。
+**预算（硬）**：交互轮次 **≤3**；**L0+L1 共 2 份**（本文件 + `playbook.md`）。**Mode A/Fast**可加 L1.5：`default-surface.md`+`presentation-craft.md`（非违约）。其余 L2 命中才读、不预读。
 
 ## 六项问询（标准模式 · 一次问完 · 唯一一次形式参数确认）
 
@@ -52,7 +56,7 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
 2. **篇幅**——A 8–15 页（图文 V1–V4，简单图禁全幅）/ B 12–25 页 / C 1–3 张图共 6–8 页；有材料按材料量推荐。
 3. **风格（始终选择）**——默认商务蓝；B 推荐麦肯锡/墨绿/暖沙金；C 推荐石墨深灰/商务蓝/彩色；拿不准给 Gate 0 参考图。
 4. **亮暗主题（始终确认）**——浅色默认（打印/外发）/ 深色（沉浸/发布会/大屏）；石墨深灰出厂深色；双主题经 `REPORT_MODEL.theme` 贯穿 HTML 与导出。
-5. **交付格式**——仅 HTML（默认）/ HTML+PPTX（正式汇报、需协作修改时推荐）。
+5. **交付格式**——仅 HTML（默认）/ HTML+PPTX（用户要可编辑甲板时；PPTX 走 **B 通道**）。
 6. **参考图确认**——复述 Gate 0 路径，确认用户已看到。
 
 **载体**：优先结构化选项卡一次收集，否则对话文本一次列全。此后形式层面不再反复确认（内容层面按需一次大纲确认，见下）。
@@ -61,7 +65,7 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
 
 | 路径 | 何时 | 多做什么 |
 |------|------|---------|
-| **轻量**（默认） | 页数不多、材料单一完整、关键判断已敲定 | 仅 1 张规划卡，直接生成 |
+| **轻量**（默认） | 页数不多、材料单一完整、关键判断已敲定 | 最小大纲→1 张规划卡（`outline-design.md`「轻量最小集」） |
 | **完整** | 长篇、材料量大且杂、含未敲定关键判断、用户要看框架 | 证据盘点 → 故事线 → 主张树 → 逐页规划卡 → 大纲确认（1 轮） |
 
 两条路径的**精确判定条件与完整步骤以 `references/playbook.md` §二为准**。完整路径确认只做一次，用户说"调整"只改指定处；确认后不再有内容层面的反复确认。
@@ -80,21 +84,21 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
 
 > 披露分层（机器可读）：`L0=SKILL.md` · `L1=references/playbook.md` · `L2=按需`
 >
-> **纪律**：L0+L1 是默认全部所需；**只在命中"何时读"时才打开 L2，读完即执行、不预读下一份**。需要代码时**一律先走节级取码** `extract_snippet.py`（`--list` 查全量路由；`--task 任务名 / --chart 图表类型 / --page-type 页型 / --file 文件 --section 节号`），逻辑名 `components.md` / `charts.md` 自动路由到物理拆分文件。
+> **纪律**：L0+L1 是默认全部所需；**只在命中"何时读"时才打开 L2，读完即执行、不预读下一份**。需要代码时**一律** `extract_snippet.py`（`--list` / `--task` / `--chart` / `--page-type` / `--file --section`）。**整读大 L2 文件 = FAIL / 不合格**（禁令清单见下与 playbook §十）。
 
 **L2 一览**（命中条件与逐任务只读清单的**详表以 playbook §十为准**，此处仅索引）：
 
 - 模式契约与锁定版式 → `references/modes.md` · 完整路径七步 → `references/outline-design.md`
-- **A/Fast 主读 → `references/default-surface.md`** + **`presentation-craft.md`** · 骨架分层见 `layout-grammar.md` §七
-- 组件/版式**代码** → `components.md` · 图表门面 `charts.md`（纪律+核图；extended 按需取节）· 信息图 → `infographics.md`
+- **A/Fast L1.5 → `default-surface.md` + `presentation-craft.md`** · 骨架 `layout-grammar.md` §七 · 插画 `illustration-layout.md`
+- 组件/版式**代码** → `components.md` · 页型表 `page-type-matrix.md` · 图表门面 `charts.md` + 决策树 `chart-decision-tree.md`（extended 按需）· 信息图 → `infographics.md`
 - 配色/主题/字阶 → `styles.md` + `design-system.md` · 写作 → `content-rules.md` · 图标语义 → `icons.md`
 - PPTX 精导 → `references/pptx-export.md` · 深度高保真 → `references/high-fidelity.md` · 修复顺序 → `references/failure-modes.md` · 技能维护 → `references/tech-design.md`
 
-**操作方式**：定模式/页型/组合/图 → 只读 `playbook.md`；取代码 → `extract_snippet.py`；**禁止整读** `layouts-combo.md` / `charts-basic.md` 等大文件；**同一阶段不重复读同一文件**。
+**操作方式**：定模式/页型/组合/图 → 只读 `playbook.md`；取代码 → **必须** `extract_snippet.py`。**整读下列文件 = FAIL**：`layouts-combo` / `components-atoms` / `charts-basic` / `charts-extended` / `content-rules` 全文 / `pptx-export` / 模式模板 HTML（走 scaffold）。详表 playbook §十。同阶段不重读。
 
 ## 铁律（12 条 · 交付硬门禁）
 
-> 门禁语义；阈值见 playbook / layout 常量 JSON。排版读 `layout-grammar.md`。**motion=none**（无炫技转场；见 `presentation-craft.md`）。
+> 门禁语义；阈值见 playbook / layout 常量 JSON。排版读 `layout-grammar.md`。**motion=none**（无炫技转场；`presentation-craft.md`）。
 
 1. **单文件零外链**——无 CDN/外部字体/外部图片，图形一律内联 SVG；`<img src>` 仅 `data:` 或相对路径且必带 `alt`（单图 ≤1.5MB、全篇 ≤8MB）；无素材图不留空不省略，用配图占位（`components.md` §11c-3）。
 2. **模式先定后写**——从对应模式模板起步；`data-mode` = `REPORT_MODEL.mode`，页面无模式切换；MD3 映射；PPTX 字号走三模式独立比例尺。
@@ -112,9 +116,9 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
 ## 交付物与验收
 
 - **HTML**：单文件零外链、可翻页可演示、每页一屏高；header 工具栏（T 亮暗 / 9 风格即切 / P 预览 / H 指引 / F 全屏 / B 折叠）。
-- **PPTX**：16:9 全原生形状/文本框/表格（`pictures=0` 可编辑）；带数据图表为原生数据图表，非原生附数据表；lead/soWhat/口径/来源写入演讲者备注；按 `REPORT_MODEL.theme` 导出亮/暗版。
-- **验收**：HTML strict 0 FAIL / 0 WARN；带 PPTX 加验 PPTX 严格模式 0/0；未通过时末尾给**定向修复指引**。
-- **交付说明**：`quality_gate.py` 加 `--deliver`（含 PPTX 时带 `--pptx/--model`）自动生成七要素（路径/字节数/模式/风格/篇幅/格式/校验+引用），缺一即 gate FAIL——不要手拼。
+- **PPTX（B 通道交付）**：`extract_model` → `build_pptx.js` → `validate_pptx --strict`；16:9 全原生可编辑。**A 通道不交付**（仅预览 / `cross_verify`；细则 playbook §九）。
+- **验收**：HTML strict 0/0；含 PPTX 再加 PPTX 0/0；失败给**定向修复指引**。
+- **交付说明**：`quality_gate.py --deliver`（含 PPTX 带 `--pptx/--model`；子门禁并行）出七要素，缺一 FAIL——勿手拼。
 
 ## 环境依赖
 

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

@@ -0,0 +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."
+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/pptx-export.js

@@ -79,7 +79,7 @@ var STYLE_DATA_COLORS = {"business-blue":["1a73e8","3526bb","21a199","b77148","9
 var STYLE_DATA_COLORS_DARK = {"business-blue":["8ab4f8","7966e0","88e7e5","d4ad91","cbce83"],"apple-mono":["f5f5f7","2997ff","2dd4bf","ff9f0a","bf5af2"],"mckinsey":["7fb2e5","6f6bdb","8ce3d8","d1a694","cbc586"],"brand-red":["ff5a66","e09e66","e788cb","91d4c2","83b4ce"],"warm-sand":["d9b36a","c2d571","df9391","97b5ce","8e89c7"],"deep-teal":["4fc3b0","7aaecd","97d8a4","c99cac","c29c8f"],"graphite-dark":["4da3ff","6c66e0","88e7dc","d4a691","cec983"],"indigo-violet":["a5a4f0","a967e0","89c3e7","d3c792","aece83"],"spectrum":["8ba0f8","9066e0","88d6e7","d4ba91","bdce83"]};
 var GRID = {"columns":12,"gutter":0.16,"colW":0.8644,"x":[0.6,1.6244,2.6488,3.6732,4.6976,5.722,6.7464,7.7708,8.7952,9.8196,10.844,11.8684,12.733],"y":[2.35,3.27,4.19,5.11,6.03,6.9],"safe":{"top":0.4,"bottom":0.4,"left":0.6,"right":0.6}};
 var TYPO = {"levels":[{"id":"C0","name":"封面/章节幕标题","role":"coverTitle","usage":"封面主标题、章节幕标题"},{"id":"T1","name":"页码/章节徽章","role":"caption","usage":"页码徽章、章节编号"},{"id":"T2","name":"页面主标题/结论标题","role":"h1","usage":"每页顶部结论句（research 行动标题）"},{"id":"T3","name":"副标题/语境说明","role":"lead","usage":"主标题下方导语"},{"id":"T4","name":"模块标题/图表标题","role":"h2","usage":"卡片标题、图表标题、面板标题"},{"id":"T5","name":"证据编号/轻量标签","role":"micro","usage":"Exhibit 编号、状态标签"},{"id":"T6","name":"证据块标题/小节标题","role":"h2","usage":"分栏小标题、证据块标题"},{"id":"T7","name":"正文解释段落","role":"body","usage":"证据解释、管理解读正文、表格正文"},{"id":"T8","name":"结论条文字","role":"body","usage":"so-what 结论条、核心结论框"},{"id":"T9","name":"SO WHAT 标签","role":"caption","usage":"so-what 标签行"},{"id":"T10","name":"SO WHAT 正文/业务含义","role":"body","usage":"so-what 正文、行动含义、表格行动项"},{"id":"T11","name":"图表轴/图例/刻度/微标签","role":"micro","usage":"坐标轴、图例、刻度、单位（禁用于表格正文与完整短句）"},{"id":"T12","name":"图表数据标签","role":"caption","usage":"折线点值、柱形标签、百分比标注"},{"id":"T13","name":"关键 KPI 大数字","role":"h1","usage":"KPI 大数字、hero 数值"},{"id":"T14","name":"注释/口径/来源/页脚","role":"micro","usage":"footnote、来源行、页脚、小页码"}],"tableSemanticRule":{"body":["T7","T10"],"microAllowed":["T11"],"microForbiddenFor":["表格正文","行动项","风险项","解释句","建议句","长项目符号","完整短句"]}};
-var CONT = {"pad":{"card":0.18,"panel":0.2,"cell":0.08,"band":0.16,"soWhat":0.16,"kpi":0.18,"chart":0.1,"head":0.05,"footer":0.05,"node":0.06},"minPad":0.06,"textMetrics":{"lineFactor":1.45,"emAsciiRatio":0.52},"overflowRule":"溢出处置优先级：① 优化内容（列表化/精炼/合并/拆页/换组合版式）→ ② 调整容器尺寸与行宽 → ③ 有限度缩小字号（见 fontShrink）→ ④ 仍装不下则拆页。禁止无限缩字号硬塞，也禁止把「精简」当第一手段砍掉决策必需信息。","fontShrink":{"ladder":[15,14,13.5,13,12.5,12,11.5,11,10.5,10,9.5,9,8.5],"maxShrinkSteps":4,"floorPt":{"presentation":10,"research":9,"architecture":10},"preferContentFirst":true,"warnBelow":9.5},"continuousTextRule":"语义连续的一句话 / so-what 主句 / 结论句 / 表格单元格正文不得拆成多个独立文本框（避免异常空格、断句、基线漂移）；局部加粗高亮必须用同一文本框内富文本。"};
+var CONT = {"pad":{"card":0.18,"panel":0.2,"cell":0.08,"band":0.16,"soWhat":0.16,"kpi":0.18,"chart":0.1,"head":0.05,"footer":0.05,"node":0.06},"minPad":0.06,"textMetrics":{"lineFactor":1.45,"emAsciiRatio":0.52},"overflowRule":"溢出处置优先级（禁静默截断）：① 重构承载（列表/卡片/表/图/组合版式）→ ② 拆页/分章（议程→主张→证据卡→明细；01a/01b；信息须完整）→ ③ 换布局形态（V1–V4/多列/卡栅格）→ ④ 有限 fontShrink（阶梯内、模式 floor 以上、最多 4 档）→ ⑤ 禁止：静默截断、砍 so-what/证据/口径、为审美稀疏删决策必需信息。单页字数预算是预警不是删字许可证。","fontShrink":{"ladder":[15,14,13.5,13,12.5,12,11.5,11,10.5,10,9.5,9,8.5],"maxShrinkSteps":4,"floorPt":{"presentation":10,"research":9,"architecture":10},"preferContentFirst":true,"warnBelow":9.5},"continuousTextRule":"语义连续的一句话 / so-what 主句 / 结论句 / 表格单元格正文不得拆成多个独立文本框（避免异常空格、断句、基线漂移）；局部加粗高亮必须用同一文本框内富文本。"};
 var REG = {"bar":{"html":"svg-bars","pptx":"native","nativeType":"bar","dataTable":"notes","min":{"vbHeightMin":160}},"hbar":{"html":"svg-hbars","pptx":"native","nativeType":"bar","dataTable":"notes","min":{"vbHeightMin":100}},"stack":{"html":"svg-stack","pptx":"native","nativeType":"bar","dataTable":"notes","min":{"vbHeightMin":160},"nativeOpt":{"barGrouping":"stacked"}},"stackline":{"html":"svg-stackline","pptx":"native","nativeType":"bar","dataTable":"notes","min":{"vbHeightMin":40},"nativeOpt":{"barGrouping":"percentStacked"}},"line":{"html":"svg-line","pptx":"native","nativeType":"line","dataTable":"notes","min":{"vbHeightMin":160}},"dualline":{"html":"svg-dualline","pptx":"native","nativeType":"line","dataTable":"notes","min":{"vbHeightMin":160}},"area":{"html":"svg-area","pptx":"native","nativeType":"area","dataTable":"notes","min":{"vbHeightMin":160}},"donut":{"html":"svg-donut","pptx":"native","nativeType":"doughnut","dataTable":"notes","min":{"pxWidthMin":140}},"multidonut":{"html":"svg-mdonut","pptx":"native","nativeType":"doughnut","dataTable":"notes","min":{"pxWidthMin":140}},"pie":{"html":"svg-pie","pptx":"native","nativeType":"pie","dataTable":"notes","min":{"pxWidthMin":140}},"radar":{"html":"svg-radar","pptx":"native","nativeType":"radar","dataTable":"notes","min":{"pxWidthMin":220}},"scatter":{"html":"svg-scatter","pptx":"native","nativeType":"scatter","dataTable":"notes","min":{"vbHeightMin":180}},"bubble":{"html":"svg-bubble","pptx":"native","nativeType":"bubble","dataTable":"notes","min":{"vbHeightMin":180}},"waterfall":{"html":"svg-wf","pptx":"native","nativeType":"bar","dataTable":"notes","min":{"vbHeightMin":170},"nativeTrick":"stacked+hiddenBase+connector"},"gauge":{"html":"svg-gauge","pptx":"native","nativeType":"doughnut","dataTable":"notes","min":{"pxWidthMin":180},"nativeTrick":"doughnut+firstSliceAng+hiddenRemainder"},"pareto":{"html":"svg-pareto","pptx":"native","nativeType":"bar","dataTable":"notes","min":{"vbHeightMin":180},"nativeTrick":"multiType+bar+line"},"gantt":{"html":"svg-gantt","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":130},"path":{"forbidPresetShapes":true}},"vsbar":{"html":"svg-vsbar","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":100},"path":{"forbidPresetShapes":true}},"progress":{"html":"svg-progress","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":100},"path":{"forbidPresetShapes":true}},"sparkline":{"html":"svg-spark","pptx":"shape","dataTable":"off","min":{"vbHeightMin":20},"path":{"forbidPresetShapes":true}},"funnel":{"html":"svg-funnel","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":160},"path":{"minSamplePoints":8,"forbidPresetShapes":true}},"treemap":{"html":"svg-treemap","pptx":"shape","dataTable":"appendix","min":{"vbHeightMin":170},"path":{"forbidPresetShapes":true}},"marimekko":{"html":"svg-marimekko","pptx":"shape","dataTable":"appendix","min":{"vbHeightMin":160},"path":{"forbidPresetShapes":true}},"boxplot":{"html":"svg-boxplot","pptx":"shape","dataTable":"appendix","min":{"vbHeightMin":180},"path":{"forbidPresetShapes":true}},"network":{"html":"svg-network","pptx":"shape","dataTable":"appendix","min":{"vbHeightMin":200},"path":{"forbidPresetShapes":true}},"sankey":{"html":"svg-sankey","pptx":"shape","dataTable":"appendix","min":{"vbHeightMin":200},"path":{"minSamplePoints":16,"trackBothEdges":true,"forbidPresetShapes":true}},"streamgraph":{"html":"svg-stream","pptx":"shape","dataTable":"appendix","min":{"vbHeightMin":160},"path":{"minSamplePoints":24,"trackBothEdges":true,"forbidPresetShapes":true}},"slope":{"html":"svg-slope","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":180},"path":{"forbidPresetShapes":true}},"dumbbell":{"html":"svg-dumbbell","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":160},"path":{"forbidPresetShapes":true}},"lollipop":{"html":"svg-lollipop","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":140},"path":{"forbidPresetShapes":true}},"dotplot":{"html":"svg-dotplot","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":120},"path":{"forbidPresetShapes":true}},"bulletchart":{"html":"svg-bullet","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":140},"path":{"forbidPresetShapes":true}},"waffle":{"html":"svg-waffle","pptx":"shape","dataTable":"notes","min":{"vbHeightMin":160},"path":{"forbidPresetShapes":true}},"radialbar":{"html":"svg-radialbar","pptx":"shape","dataTable":"notes","min":{"pxWidthMin":200},"path":{"minSamplePoints":16,"forbidPresetShapes":true}},"rose":{"html":"svg-rose","pptx":"shape","dataTable":"notes","min":{"pxWidthMin":180},"path":{"minSamplePoints":16,"forbidPresetShapes":true}},"candlestick":{"html":"svg-candle","pptx":"shape","dataTable":"appendix","min":{"vbHeightMin":180},"path":{"forbidPresetShapes":true}}};
 var DEEP = {"triggers":["高保真","1:1","一比一","精确还原","按图还原","正式交付","不能偏移","像素级","严格对照","逐页验收"],"complexCharts":["sankey","streamgraph","treemap","marimekko","boxplot","network","rose","radialbar","candlestick","funnel"],"checks":{"anchors":true,"containerOverflow":true,"renderCompare":true,"manifest":true},"renderCompare":{"engine":"soffice","fallback":"powerpoint-com","skipIfMissing":true,"dpi":96}};
 var IMG = {"layouts":["full","half","bleed","grid","compare","wall"],"multiLayouts":["grid","compare","wall"],"fitEnum":["cover","contain"],"fitDefault":"cover","formats":["png","jpeg","jpg","webp","svg"],"ratioDefault":{"full":"3:1","half":"4:3","bleed":"21:9","grid":"4:3","compare":"4:3","wall":"1:1"},"ratioCssClass":{"full":"media--r3-1","half":"media--r4-3","bleed":"media--r21-9","grid":"media--r4-3","compare":"media--r4-3","wall":"media--r1-1"},"recommendedSizePx":{"full":"2400×800","half":"1400×1050","bleed":"2560×1100","grid":"900×675","compare":"1400×1050","wall":"480×480"},"maxInlineBytes":1572864,"maxTotalInlineBytes":8388608,"maxPerPage":6,"placeholderLabel":"配图占位","placeholderHintPrefix":"建议 ","placeholderHintSuffix":"px","zeroExternal":true,"qualityRule":"位图优先提供 ≥2× 显示尺寸；截图用 16:9 或 4:3 锁定比例；数据图不要用截图（应用内联 SVG 图表，可随主题变色）。"};
@@ -276,6 +276,16 @@ function modeFloorPtA(mode) {
   var m = String(mode || 'presentation');
   return (floors[m] != null) ? floors[m] : 10;
 }
+function snapFont(pt, ladder, floor) {
+  var lad = (ladder || FONT_LADDER).filter(function (v) { return v >= (floor == null ? 0 : floor); });
+  if (!lad.length) return floor == null ? pt : Math.max(floor, pt);
+  var best = lad[0], bd = Math.abs(lad[0] - pt);
+  for (var i = 1; i < lad.length; i++) {
+    var d = Math.abs(lad[i] - pt);
+    if (d < bd) { bd = d; best = lad[i]; }
+  }
+  return best;
+}
 function fitFont(items, widthIn, availIn, opts) {
   opts = opts || {};
   var max = (opts.max == null) ? 99 : opts.max, lf = opts.lineFactor || 1.45;
@@ -620,7 +630,7 @@ function imageLayoutShapes(sh, S, layout, img, items, points, isPh, fit, y0, y1)
       sh.push(shape('rect', rxI, lyI + rowHI / 2 - 0.06, 0.12, 0.12, S.accent));
       sh.push(txSp(rxI + 0.26, lyI, rwI - 0.3, rowHI - 0.04,
         [[{ t: (pt[0] || '') + '　', sz: fzI, b: 1, col: S.ink, font: S.font },
-          { t: pt[1] || '', sz: fzI - 1, col: S.body, font: S.font }]], { anchor: 't' }));
+          { t: pt[1] || '', sz: snapFont(fzI - 1), col: S.body, font: S.font }]], { anchor: 't' }));
     });
     capY = iy + Math.max(ihh, ih * 0.5);
   } else if (layout === 'bleed') {
@@ -669,24 +679,55 @@ function hbarRows(sh, ec, S, y0, y1, dcols, x0, w) {
 }
 /* 竖柱 / 堆叠柱 */
 function vbarShapes(sh, ec, S, x, y, w, h, dcols) {
-  var labels = ec.labels || [], values = ec.values || [];
+  /* Multi-series aware (mirrors lineShapes): ec.series[{name,values}] or single ec.values. */
+  var labels = ec.labels || [];
+  var series = (ec.series && ec.series.length)
+    ? ec.series
+    : [{ name: '数值', values: ec.values || [] }];
   var nb = Math.max(1, labels.length);
+  var ns = Math.max(1, series.length);
   var baseY = y + h, plotW = w, step = plotW / nb;
-  var bw = Math.min(1.1, step * 0.55);
-  var vmax = ec.max || Math.max.apply(null, values.concat([1]));
-  var top = values.length ? Math.max.apply(null, values) : 0;
+  var cluster = Math.min(1.1, step * (ns > 1 ? 0.78 : 0.55));
+  var bw = cluster / ns;
+  var all = [];
+  series.forEach(function (se) {
+    (se.values || []).forEach(function (v) { all.push(Number(v) || 0); });
+  });
+  var vmax = ec.max || Math.max.apply(null, all.concat([1]));
+  var top = all.length ? Math.max.apply(null, all) : 0;
   sh.push(shape('rect', x, baseY, plotW, 0.02, S.line));
-  values.forEach(function (v, i) {
-    var hh = Math.max(0.05, v / vmax * (h - 0.5));
-    var bx = x + i * step + (step - bw) / 2;
-    var hot = v === top;
-    var dc = dcols ? dcols[i % 5] : null;
-    sh.push(shape('roundRect', bx, baseY - hh, bw, hh, dc || (hot ? S.accent : S.faint), { adj: 6000 }));
-    sh.push(txSp(bx - 0.3, baseY - hh - 0.4, bw + 0.6, 0.32,
-      [[{ t: valText(v, ec.unit), sz: 12.5, b: 1, col: hot ? S.accent : S.body, font: S.font }]], { align: 'ctr' }));
-    sh.push(txSp(bx - 0.3, baseY + 0.08, bw + 0.6, 0.32,
-      [[{ t: labels[i], sz: 10.5, col: S.faint, font: S.font }]], { align: 'ctr' }));
+  series.forEach(function (se, si) {
+    var vals = se.values || [];
+    var col = dcols ? dcols[si % 5] : (si === 0 ? S.accent : S.faint);
+    vals.forEach(function (v, i) {
+      var num = Number(v) || 0;
+      var hh = Math.max(0.05, num / vmax * (h - 0.5));
+      var bx = x + i * step + (step - cluster) / 2 + si * bw;
+      var hot = ns === 1 && num === top;
+      sh.push(shape('roundRect', bx, baseY - hh, Math.max(0.04, bw * 0.92), hh,
+        hot ? (dcols ? dcols[i % 5] : S.accent) : col, { adj: 6000 }));
+      if (ns === 1) {
+        sh.push(txSp(bx - 0.3, baseY - hh - 0.4, bw + 0.6, 0.32,
+          [[{ t: valText(num, ec.unit), sz: 12.5, b: 1, col: hot ? S.accent : S.body, font: S.font }]], { align: 'ctr' }));
+      }
+    });
   });
+  labels.forEach(function (lb, i) {
+    var lx = x + i * step;
+    sh.push(txSp(lx, baseY + 0.08, step, 0.32,
+      [[{ t: lb, sz: 10.5, col: S.faint, font: S.font }]], { align: 'ctr' }));
+  });
+  /* Multi-series legend along top of plot (keeps category labels; avoids blank chart). */
+  if (ns > 1) {
+    var lx2 = x;
+    series.forEach(function (se, si) {
+      var col2 = dcols ? dcols[si % 5] : (si === 0 ? S.accent : S.faint);
+      sh.push(shape('rect', lx2, y, 0.12, 0.12, col2));
+      sh.push(txSp(lx2 + 0.16, y - 0.02, 1.4, 0.24,
+        [[{ t: String(se.name || ('系列' + (si + 1))), sz: 10, col: S.body, font: S.font }]]));
+      lx2 += 1.6;
+    });
+  }
 }
 /* 折线 / 双折线 / 面积 */
 function lineShapes(sh, ec, S, x, y, w, h, dcols) {
@@ -1093,8 +1134,11 @@ function infoApprox(sh, sec, S, y0, y1) {
         totals.push(tt);
       }
       var maxTot = Math.max.apply(null, totals.concat([1]));
-      var plotH3 = P.y1 - P.y0;
-      var cyMid = (P.y0 + P.y1) / 2;
+      /* Reserve legend INSIDE the plot box so 6-series pages do not crush the annotation band. */
+      var legH = Math.min(1.2, Math.max(0.28, series.length * 0.22 + 0.08));
+      var plotBottom = P.y1 - legH;
+      var plotH3 = Math.max(0.6, plotBottom - P.y0);
+      var cyMid = P.y0 + plotH3 / 2;
       var base = totals.map(function (tv) { return cyMid - tv / maxTot * plotH3 / 2; });
       series.forEach(function (se, si) {
         var upper = base.map(function (bv, i3) { return bv + (values[si][i3] || 0) / maxTot * plotH3 / 2; });
@@ -1104,12 +1148,12 @@ function infoApprox(sh, sec, S, y0, y1) {
           sh.push(shape('rect', MX + i4 * stepX, (base[i4] + base[i4 + 1]) / 2, stepX, hgt, palette[si % palette.length]));
         }
         base = upper;
-        sh.push(shape('rect', MX, P.y1 + 0.06 + si * 0.26, 0.12, 0.12, palette[si % palette.length]));
-        sh.push(txSp(MX + 0.16, P.y1 + si * 0.26, 1.5, 0.26,
+        sh.push(shape('rect', MX, plotBottom + 0.04 + si * 0.2, 0.12, 0.12, palette[si % palette.length]));
+        sh.push(txSp(MX + 0.16, plotBottom + 0.02 + si * 0.2, 1.5, 0.2,
           [[{ t: String(se.name || ('系列' + (si + 1))), sz: 10, col: S.body, font: S.font }]], { anchor: 'ctr' }));
       });
       labels.forEach(function (lb, i5) {
-        sh.push(txSp(MX + (nPts > 1 ? i5 / (nPts - 1) : 0.5) * CW - 0.4, P.y1 - 0.02, 0.8, 0.24,
+        sh.push(txSp(MX + (nPts > 1 ? i5 / (nPts - 1) : 0.5) * CW - 0.4, plotBottom - 0.22, 0.8, 0.2,
           [[{ t: String(lb), sz: 9.5, col: S.faint, font: S.font }]], { align: 'ctr' }));
       });
     }
@@ -1301,8 +1345,8 @@ function slidesOf(model, S) {
       var iy = iR.y;
       var capH2 = img.caption ? 0.32 : 0;
       var ih = Math.max(1.2, iR.h);
-      imageLayoutShapes(sh, S, layout, img, items, sec.points || [], isPh, fit, iy, iy + ih);
-      if (img.caption) sh.push(txSp(MX, iy + ih + 0.04, CW, capH2, [[{ t: img.caption, sz: 10.5, col: S.faint, font: S.font }]]));
+      var capYImg = imageLayoutShapes(sh, S, layout, img, items, sec.points || [], isPh, fit, iy, iy + ih);
+      if (img.caption) sh.push(txSp(MX, capYImg + 0.04, CW, capH2, [[{ t: img.caption, sz: 10.5, col: S.faint, font: S.font }]]));
     } else if (type === 'donut') {
       var dcn = sec.chart || {};
       if (dcn.labels && dcn.values) donutChart(sh, dcn, S, dcn.colors || donutColors(model.style, S, model.theme));
@@ -1619,7 +1663,7 @@ function slidesOf(model, S) {
           sh.push(shape('rect', x, ly2 + rowHP / 2 - 0.06, 0.12, 0.12, S.accent));
           sh.push(txSp(x + 0.28, ly2, w - 0.4, rowHP - 0.04,
             [[{ t: pt[0] + '　', sz: fzP, b: 1, col: S.ink, font: S.font },
-              { t: pt[1], sz: fzP - 1, col: S.body, font: S.font }]]));
+              { t: pt[1], sz: snapFont(fzP - 1), col: S.body, font: S.font }]]));
         });
       };
       if (lt2 === 'table') {
@@ -1740,7 +1784,7 @@ function slidesOf(model, S) {
         sh.push(shape('rect', ptsR.x, y11 + rowHPt / 2 - P2.markSize / 2, P2.markSize, P2.markSize, S.accent));
         sh.push(txSp(ptsR.x + 0.32, y11, textW, rowHPt - 0.04,
           [[{ t: p[0] + '　', sz: fzP, b: 1, col: S.ink, font: S.font },
-            { t: p[1], sz: fzP - 1, col: S.body, font: S.font }]]));
+            { t: p[1], sz: snapFont(fzP - 1), col: S.body, font: S.font }]]));
       });
       if (hasM) {
         var gx2 = PW - MX - nm2 * mw2;