@topmindspace/tms-skills 0.3.9 → 0.4.1

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

@@ -1408,7 +1408,35 @@
       "preferContentFirst": true,
       "warnBelow": 9.5
     },
-    "continuousTextRule": "语义连续的一句话 / so-what 主句 / 结论句 / 表格单元格正文不得拆成多个独立文本框（避免异常空格、断句、基线漂移）；局部加粗高亮必须用同一文本框内富文本。"
+    "continuousTextRule": "语义连续的一句话 / so-what 主句 / 结论句 / 表格单元格正文不得拆成多个独立文本框（避免异常空格、断句、基线漂移）；局部加粗高亮必须用同一文本框内富文本。",
+    "adaptiveText": {
+      "$comment": "弹性文本单源（0.2.0）：长标题/长列表/长表格单元格的降级规则。build_pptx.js 只读本表（AT），禁止在调用处散落 magic number。tier 语义：字符数按 CJK=1、拉丁/数字≈0.5 折算（与 estLines 同口径）。",
+      "title": {
+        "base": 30,
+        "step1": 24,
+        "longChars": 28,
+        "longMax": 24,
+        "xlongChars": 44,
+        "xlongMax": 20
+      },
+      "list": {
+        "denseItems": 6,
+        "gapFactor": 0.5,
+        "denseGapFactor": 0.25,
+        "lineFactor": 1.45,
+        "denseLineFactor": 1.3,
+        "max": 14,
+        "denseMax": 12
+      },
+      "table": {
+        "cellMax": 12.5,
+        "cellFloor": 9,
+        "headMax": 13,
+        "longCellChars": 24,
+        "rowFloorIn": 0.22,
+        "cellPadIn": 0.07
+      }
+    }
   },
   "anchorTolerance": {
     "$comment": "空间锚点容差（深度模式）。centerPct = 中心点偏差上限（占参考框局部宽高比例）；keyPx = 关键锚点（图标/标签/箭头端点）偏差上限（px，按 1280×720 参考图计）；exactPx = 用户要求 1:1 时的上限。",
@@ -1964,7 +1992,7 @@
     }
   },
   "qualityGates": {
-    "$comment": "v9+ 硬门禁。tagLeakPatterns / titleOnly / underfill / roundtripMin / chartSkew / chartOversize 同前。antiTruncation：截断迹象与溢出未拆页；chromeDriftIn：跨页 chrome y 容差（英寸）。",
+    "$comment": "v9+ 硬门禁。tagLeakPatterns / titleOnly / underfill / roundtripMin / chartSkew / chartOversize 同前。antiTruncation：截断迹象与溢出未拆页；chromeDriftIn：跨页 chrome y 容差（英寸）。 contentCoverage：模型文本→渲染文本覆盖率下限（validate_report 只 WARN）。",
     "tagLeakPatterns": [
       "<a ",
       "</a>",
@@ -2033,7 +2061,8 @@
       "minCards": 3,
       "shortPlainChars": 12,
       "maxShortRatio": 0.5
-    }
+    },
+    "contentCoverage": 0.95
   },
   "imageAdmission": {
     "$comment": "图片资产准入门。forbidden = 禁止图片化的区域（主信息层与简单图表必须原生重建）；allowed = 可保留为图片的复杂视觉资产；maxPageAreaPct = 单页图片覆盖面积上限（超过须逐项说明）；fullSlideRiskPct = 按整页背景风险处理阈值（内容页默认失败）；placeholderIsNative = 配图占位由原生形状渲染（不是图片，不触发 pictures 门禁）。",
@@ -3525,5 +3554,63 @@
         ]
       }
     }
+  },
+  "layoutVariants": {
+    "$comment": "版式变体注册表（0.2.0 新增）：复用既有页型/组件的组合版式，不新增 DSL 页型。variant 写在 section.variant；HTML 侧 render_from_model 按 base 页型渲染 + 变体类名；PPTX 侧 build_pptx 同名映射。新增变体：在此登记 + references/layout-variants.md 写骨架文档；禁止为变体另起渲染器。",
+    "version": "0.1",
+    "variants": {
+      "bento-grid": {
+        "name": "Bento 拼贴卡",
+        "base": "cards",
+        "html": ".grid.g-bento（复用 .card；首卡 .card--lead 跨 2 列）",
+        "components": [
+          "card",
+          "card__ico",
+          "pts_list"
+        ],
+        "sectionAttr": "data-variant=\"bento-grid\"",
+        "when": "4–6 张卡、其中 1 张是主结论/总览时；信息密度高于等权卡片",
+        "budget": {
+          "maxCards": 6,
+          "recommendCards": "4–5",
+          "leadMaxPoints": 4,
+          "otherMaxPoints": 3
+        },
+        "pptx": "cards 分支：首卡跨 2 列，其余顺排（build_pptx.js variant 分支）"
+      },
+      "timeline": {
+        "name": "图标时间线",
+        "base": "timeline",
+        "html": "复用 .tl；phase 字典加 icon 键 → 节点图标 .tl__ico[data-icon]",
+        "components": [
+          "tl",
+          "icon:<name>"
+        ],
+        "sectionAttr": "data-variant=\"timeline\"",
+        "when": "阶段有明确类型语义（里程碑/风险/交付）且图标能加速扫读时；无语义用基础 timeline",
+        "budget": {
+          "maxPhases": 6,
+          "iconPerPhase": 1,
+          "descMaxChars": 60
+        },
+        "pptx": "timeline 分支：节点圆点旁贴 icon: 图标（build_pptx.js phaseKV 第 5 元）"
+      },
+      "2-col-feature": {
+        "name": "双栏特性",
+        "base": "twocol",
+        "html": ".cols-2；左栏 .col--feature（复用 .card 语义：加粗标题 + accent 左线）",
+        "components": [
+          "cols-2",
+          "card"
+        ],
+        "sectionAttr": "data-variant=\"2-col-feature\"",
+        "when": "左栏是核心主张/特性、右栏是支撑细节时；两栏对等论证用基础 twocol",
+        "budget": {
+          "maxParas": 6,
+          "featureMaxParas": 2
+        },
+        "pptx": "twocol 分支：首栏加 accent 左线 + 标题放大（build_pptx.js variant 分支）"
+      }
+    }
   }
-}
+}

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

@@ -0,0 +1,172 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""TopPPT HTML · 内置图标包生成器（单源）
+
+产出 assets/icons/：
+  - <name>.svg   24×24 手绘线性图标（stroke=currentColor, 1.8, 圆角），HTML 内联用
+  - <name>.png   512px 预渲染（cairosvg），PPTX 通道用（python-pptx 不认 SVG，见报告）
+  - index.json   关键词→图标映射 + 默认图标表
+
+用法:
+  python scripts/make_icon_pack.py            # 写 SVG + index.json
+  python scripts/make_icon_pack.py --png      # 另渲染 512px PNG（需 cairosvg）
+
+图标全部手绘原创（24 网格），不复制第三方图标库。
+其中 19 个沿用既有 icon_lib.js 的成熟路径（字节一致，现有渲染不变）；
+流程 采用 references/icons.md 文档版（git-branch 式，与文档对齐）。
+"""
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+OUT = ROOT / 'assets' / 'icons'
+
+SVG_OPEN = ('<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" '
+            'stroke="currentColor" stroke-width="1.8" stroke-linecap="round" '
+            'stroke-linejoin="round">')
+
+# name -> (inner_svg, label, keywords)
+ICONS: dict[str, tuple[str, str, list[str]]] = {
+    # ── 既有 19（与 icon_lib.js 现行字节一致） ──
+    '增长': ('<path d="M22 7l-8.5 8.5-5-5L2 17"/><path d="M16 7h6v6"/>',
+             '增长/上升', ['增长', '上升', '提升', '增加', 'up']),
+    '下降': ('<path d="M22 17l-8.5-8.5-5 5L2 7"/><path d="M16 17h6v-6"/>',
+             '下降/回落', ['下降', '回落', '减少', '降低', 'down']),
+    '数据': ('<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14c0 1.66 4.03 3 9 3s9-1.34 9-3V5"/><path d="M3 12c0 1.66 4.03 3 9 3s9-1.34 9-3"/>',
+             '数据库/底座', ['数据', '底座', 'database']),
+    '图表': ('<path d="M3 3v18h18"/><rect x="7" y="12" width="3" height="6" rx="1"/><rect x="12" y="8" width="3" height="10" rx="1"/><rect x="17" y="4" width="3" height="14" rx="1"/>',
+             '柱状图', ['图表', '柱状', 'bar']),
+    '趋势': ('<path d="M3 3v18h18"/><path d="M7 14l4-4 3 3 5-6"/><path d="M15 7h4v4"/>',
+             '趋势/折线', ['趋势', '折线', 'line']),
+    '占比': ('<path d="M21.2 15.9A10 10 0 1 1 8 2.8"/><path d="M22 12A10 10 0 0 0 12 2v10z"/>',
+             '环形/占比', ['占比', '环形', '份额', 'donut']),
+    '表格': ('<rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M3 15h18M9 3v18M15 3v18"/>',
+             '表格/网格', ['表格', '矩阵', 'table']),
+    '效率': ('<path d="M12 15l3.5-5.5"/><path d="M20.2 15a8.5 8.5 0 1 0-16.4 0"/>',
+             '仪表盘/效率', ['效率', '仪表盘', '性能', 'gauge']),
+    '成果': ('<circle cx="12" cy="8" r="6"/><path d="M15.5 13 17 22l-5-3-5 3 1.5-9"/>',
+             '奖章/成果', ['成果', '奖章', '奖项', 'medal']),
+    '安全': ('<path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/><path d="M9 12l2 2 4-4"/>',
+             '盾牌/安全', ['安全', '盾牌', 'shield']),
+    '权限': ('<rect x="3" y="11" width="18" height="10" rx="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/>',
+             '锁/权限', ['权限', '锁', 'lock']),
+    '检查': ('<circle cx="12" cy="12" r="10"/><path d="M8 12.5l2.5 2.5L16 9.5"/>',
+             '检查/对勾', ['检查', '对勾', '校验', 'check']),
+    '风险': ('<path d="M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z"/><path d="M12 9v4M12 17h.01"/>',
+             '警告/风险', ['风险', '警告', 'warning']),
+    '团队': ('<path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/>',
+             '用户/团队', ['团队', '人力', 'team']),
+    '计划': ('<rect x="3" y="4" width="18" height="18" rx="2"/><path d="M16 2v4M8 2v4M3 10h18"/>',
+             '日历/计划', ['计划', '日历', '日程', 'calendar']),
+    '智能': ('<rect x="4" y="4" width="16" height="16" rx="2"/><path d="M9 9h6v6H9zM9 1v3M15 1v3M9 20v3M15 20v3M1 9h3M1 15h3M20 9h3M20 15h3"/>',
+             '芯片/AI', ['智能', '芯片', 'AI', 'chip']),
+    '洞察': ('<circle cx="11" cy="11" r="8"/><path d="M21 21l-4.35-4.35"/>',
+             '搜索/洞察', ['洞察', '搜索', '分析', 'search']),
+    '工具': ('<path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"/>',
+             '扳手/工具', ['工具', '扳手', 'tool']),
+    '清单': ('<path d="M8 6h13M8 12h13M8 18h13M3 6h.01M3 12h.01M3 18h.01"/>',
+             '清单/条目', ['清单', '条目', 'checklist']),
+    # ── 流程：采用 references/icons.md 文档版（git-branch 式） ──
+    '流程': ('<circle cx="6" cy="6" r="3"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="8" r="3"/><path d="M6 9v6M18 11a9 9 0 0 1-9 4"/>',
+             '分支/流程', ['流程', '分支', 'pipeline']),
+    # ── 新增 28（手绘原创） ──
+    '箭头': ('<path d="M4 12h15"/><path d="M13 6l6 6-6 6"/>',
+             '右箭头', ['箭头', '指向', 'arrow']),
+    '下载': ('<path d="M12 4v11"/><path d="M7 10.5l5 5 5-5"/><path d="M4 16v4h16v-4"/>',
+             '下载', ['下载', 'download']),
+    '上传': ('<path d="M12 20V9"/><path d="M7 13.5l5-5 5 5"/><path d="M4 16v4h16v-4"/>',
+             '上传', ['上传', 'upload']),
+    '分享': ('<circle cx="6" cy="12" r="2.5"/><circle cx="17.5" cy="5.5" r="2.5"/><circle cx="17.5" cy="18.5" r="2.5"/><path d="M8.3 10.9l6.9-4.2M8.3 13.1l6.9 4.2"/>',
+             '分享', ['分享', 'share']),
+    '循环': ('<path d="M20.5 15a8.5 8.5 0 1 1-2-8.9L21 8.5"/><path d="M21 3.5v5h-5"/>',
+             '循环/刷新', ['循环', '刷新', '迭代', '飞轮', 'refresh']),
+    '目标': ('<circle cx="12" cy="12" r="9"/><circle cx="12" cy="12" r="5"/><path d="M12 12h.01"/>',
+             '同心圆靶心', ['目标', 'target']),
+    '闪电': ('<path d="M13 2 3 14h7l-1 8 10-12h-7l1-8z"/>',
+             '闪电/高效', ['闪电', '高效', '快速', '快捷']),
+    '勾选': ('<path d="M4 12.5l5 5L20 6.5"/>',
+             '对勾', ['勾选', '完成', 'done']),
+    '用户': ('<circle cx="12" cy="8" r="4"/><path d="M4 21c0-3.5 3.6-5.5 8-5.5s8 2 8 5.5"/>',
+             '单人/用户', ['用户', '客户', 'user']),
+    '组织': ('<rect x="9" y="2" width="6" height="6" rx="1"/><rect x="2" y="16" width="6" height="6" rx="1"/><rect x="16" y="16" width="6" height="6" rx="1"/><path d="M12 8v4M5 12h14M5 12v4M19 12v4"/>',
+             '组织架构/层级', ['组织', '层级', '架构', 'org']),
+    '灯泡': ('<path d="M12 3a6 6 0 0 0-3.4 11c.7.5 1.4 1.3 1.4 2.5h4c0-1.2.7-2 1.4-2.5A6 6 0 0 0 12 3z"/><path d="M10 19.5h4"/><path d="M10.8 22h2.4"/>',
+             '灯泡/创意', ['灯泡', '创意', '想法', 'idea']),
+    '文档': ('<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8l-6-6z"/><path d="M14 2v6h6"/><path d="M9 13h6M9 17h6"/>',
+             '文档/报告', ['文档', '报告', '文件', 'doc']),
+    '云': ('<path d="M7 18.5a4 4 0 0 1-.4-7.98A5.5 5.5 0 0 1 17.3 11 3.9 3.9 0 0 1 17 18.5H7z"/>',
+           '云/平台', ['云', '平台', 'cloud']),
+    '邮件': ('<rect x="2" y="4" width="20" height="16" rx="2"/><path d="M2.5 7.5 12 13l9.5-5.5"/>',
+             '信封/邮件', ['邮件', '邮箱', 'mail']),
+    '手机': ('<rect x="7" y="2" width="10" height="20" rx="2.5"/><path d="M11 18.5h2"/>',
+             '手机', ['手机', '移动', 'phone']),
+    '对话': ('<rect x="3" y="4" width="18" height="12" rx="2"/><path d="M8 16v4l4.5-4"/>',
+             '对话框', ['对话', '沟通', 'chat']),
+    '位置': ('<path d="M12 21.5s-7-5.3-7-11a7 7 0 0 1 14 0c0 5.7-7 11-7 11z"/><circle cx="12" cy="10.5" r="2.5"/>',
+             '定位/地点', ['位置', '地点', 'pin']),
+    '时间': ('<circle cx="12" cy="12" r="9"/><path d="M12 7v5l3.5 2"/>',
+             '时钟/时间', ['时间', '时钟', 'clock']),
+    '金钱': ('<rect x="2" y="6" width="20" height="12" rx="2"/><circle cx="12" cy="12" r="2.8"/><path d="M5.5 12h.01M18.5 12h.01"/>',
+             '纸币/财务', ['金钱', '成本', '财务', 'money']),
+    '链接': ('<path d="M10 14a4.5 4.5 0 0 0 6.4.4l2.8-2.8a4.5 4.5 0 0 0-6.4-6.4l-1.6 1.6"/><path d="M14 10a4.5 4.5 0 0 0-6.4-.4l-2.8 2.8a4.5 4.5 0 0 0 6.4 6.4l1.6-1.6"/>',
+             '链条/链接', ['链接', 'link']),
+    '设置': ('<circle cx="12" cy="12" r="3.2"/><path d="M12 2.5v2.8M12 18.7v2.8M2.5 12h2.8M18.7 12h2.8M5.2 5.2l2 2M16.8 16.8l2 2M18.8 5.2l-2 2M7.2 16.8l-2 2"/>',
+             '齿轮/设置', ['设置', '齿轮', '配置', 'setting']),
+    '信息': ('<circle cx="12" cy="12" r="9"/><path d="M12 11v5"/><path d="M12 7.5h.01"/>',
+             '信息/提示', ['信息', '提示', 'info']),
+    '星标': ('<path d="m12 2.8 2.8 5.8 6.4.9-4.6 4.5 1.1 6.3-5.7-3-5.7 3 1.1-6.3L2.8 9.5l6.4-.9z"/>',
+             '五角星', ['星标', '收藏', 'star']),
+    '书签': ('<path d="M6.5 3h11V21l-5.5-3.8L6.5 21z"/>',
+             '书签', ['书签', 'bookmark']),
+    '文件夹': ('<path d="M3 7a2 2 0 0 1 2-2h4l2 2.5h8a2 2 0 0 1 2 2V18a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/>',
+               '文件夹/资产', ['文件夹', '资产', 'folder']),
+    '火箭': ('<path d="M12 2.5c2.6 2.2 4 5.6 4 9.2l-4 2.8-4-2.8c0-3.6 1.4-7 4-9.2z"/><circle cx="12" cy="9" r="1.6"/><path d="M8.3 12.5 5 16.5l3.6-.6M15.7 12.5l3.3 4-3.6-.6"/><path d="M10.8 16.8c0 1.6.5 2.6 1.2 3.7.7-1.1 1.2-2.1 1.2-3.7"/>',
+             '火箭/发射', ['火箭', '发射', 'rocket']),
+    '旗帜': ('<path d="M5 21.5V4"/><path d="M5 4.5h12.5l-2.8 3.8 2.8 3.7H5"/>',
+             '旗帜/里程碑', ['旗帜', '里程碑', 'flag']),
+    '罗盘': ('<circle cx="12" cy="12" r="9"/><path d="m15.5 8.5-2.2 4.8-4.8 2.2 2.2-4.8z"/>',
+             '罗盘/方向', ['罗盘', '方向', '导航', 'compass']),
+}
+
+DEFAULTS = ['信息', '检查', '数据', '图表', '目标', '团队', '工具']
+
+
+def main() -> int:
+    OUT.mkdir(parents=True, exist_ok=True)
+    assert len(ICONS) == 48, f'图标数应为 48，实际 {len(ICONS)}'
+    assert all(d in ICONS for d in DEFAULTS), '默认图标必须在包内'
+    index = {'version': '0.2.0', 'count': len(ICONS),
+             'defaults': DEFAULTS, 'icons': {}}
+    for name, (inner, label, keywords) in ICONS.items():
+        svg = SVG_OPEN + inner + '</svg>'
+        (OUT / f'{name}.svg').write_text(svg, encoding='utf-8')
+        index['icons'][name] = {
+            'file': f'{name}.svg',
+            'png': f'{name}.png',
+            'label': label,
+            'keywords': keywords,
+            'default': name in DEFAULTS,
+        }
+    (OUT / 'index.json').write_text(
+        json.dumps(index, ensure_ascii=False, indent=2) + '\n', encoding='utf-8')
+    print(f'[make_icon_pack] OK: {len(ICONS)} svg + index.json → {OUT}')
+    if '--png' in sys.argv:
+        try:
+            import cairosvg
+        except ImportError:
+            print('[make_icon_pack] FAIL: 需 cairosvg（pip install cairosvg）才能渲染 PNG')
+            return 1
+        for name, (inner, _label, _kw) in ICONS.items():
+            svg = SVG_OPEN.replace('currentColor', '#1a56a8') + inner + '</svg>'
+            cairosvg.svg2png(bytestring=svg.encode('utf-8'),
+                             write_to=str(OUT / f'{name}.png'),
+                             output_width=512, output_height=512)
+        print(f'[make_icon_pack] OK: {len(ICONS)} png(512px) → {OUT}')
+    return 0
+
+
+if __name__ == '__main__':
+    raise SystemExit(main())

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

@@ -39,10 +39,13 @@
     "lead",
     "soWhat",
     "footnote",
+    "note",
     "flags",
     "image",
     "exhibitNo",
-    "layoutPreset"
+    "layoutPreset",
+    "variant",
+    "anchor"
   ],
   "mutualExclusionHint": "verdict 与 soWhat 互斥：二者共用 annotation 结论条槽位，同页双填必叠印。comparison 页填 verdict 时不要再填 soWhat（渲染器已自动二选一，但模型侧应只给一个）。",
   "flagsHint": "flags = 待核实/待二次修改条目字符串数组（如 '2027 增速 xx%（口径未定）'）；渲染为 accent 强调色标注行，提示用户核对。",

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

@@ -95,9 +95,18 @@ def kp(k, v) -> str:
     return f'<li><strong>{k}。</strong>{v}</li>' if k else f'<li>{v}</li>'
 
 
-def open_sec(i: int, ptype: str, extra: str = '') -> str:
+def sec_anchor(i: int, sec: dict) -> str:
+    """页锚点 id：模型 anchor 优先，否则 s{i}（agenda 链接与 open_sec 同源，禁各写一份）。"""
+    a = str((sec or {}).get('anchor') or '').strip()
+    if re.fullmatch(r'[A-Za-z][A-Za-z0-9_-]*', a):
+        return a
+    return f's{i}'
+
+
+def open_sec(i: int, ptype: str, extra: str = '', sec: dict = None) -> str:
     skel = PAGE_TO_PRESET.get(ptype, 'P4')
-    return (f'<section class="band" id="s{i}" data-skel="{skel}" '
+    sid = sec_anchor(i, sec)
+    return (f'<section class="band" id="{sid}" data-skel="{skel}" '
             f'data-page-type="{ptype}"{extra}>')
 
 
@@ -118,10 +127,17 @@ def sowhat(sec: dict) -> str:
 
 
 def footnote(sec: dict) -> str:
+    # footnote 与 note 共用来源行（与 build_pptx 注释带同口径：两者都不丢）
     t = sec.get('footnote')
-    if not t:
+    n = sec.get('note')
+    parts = []
+    if t:
+        parts.append(cite(t))
+    if n and n != t:
+        parts.append(f'注：{cite(n)}')
+    if not parts:
         return ''
-    return f'    <div class="footnote">{cite(t)}</div>\n'
+    return f'    <div class="footnote">{" ".join(parts)}</div>\n'
 
 
 def flags_block(sec: dict) -> str:
@@ -134,55 +150,49 @@ def flags_block(sec: dict) -> str:
 
 
 def wrap(i: int, ptype: str, body: str, sec: dict, extra: str = '') -> str:
-    return (f'{open_sec(i, ptype, extra)}\n  <div class="wrap">\n'
+    return (f'{open_sec(i, ptype, extra, sec)}\n  <div class="wrap">\n'
             f'{shead(sec)}\n{body}{sowhat(sec)}{footnote(sec)}{flags_block(sec)}'
             f'  </div>\n</section>')
 
 
-# ── 语义图标库（高频取码 · 与 references/icons.md 同源；PPTX 侧由 accent 方块路标对应）──
-_SVG_OPEN = ('<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" '
-             'stroke-linecap="round" stroke-linejoin="round">')
-ICONS: dict[str, str] = {
-    '增长': _SVG_OPEN + '<path d="M22 7l-8.5 8.5-5-5L2 17"/><path d="M16 7h6v6"/></svg>',
-    '下降': _SVG_OPEN + '<path d="M22 17l-8.5-8.5-5 5L2 7"/><path d="M16 17h6v-6"/></svg>',
-    '数据': _SVG_OPEN + '<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14c0 1.66 4.03 3 9 3s9-1.34 9-3V5"/><path d="M3 12c0 1.66 4.03 3 9 3s9-1.34 9-3"/></svg>',
-    '图表': _SVG_OPEN + '<path d="M3 3v18h18"/><rect x="7" y="12" width="3" height="6" rx="1"/><rect x="12" y="8" width="3" height="10" rx="1"/><rect x="17" y="4" width="3" height="14" rx="1"/></svg>',
-    '趋势': _SVG_OPEN + '<path d="M3 3v18h18"/><path d="M7 14l4-4 3 3 5-6"/><path d="M15 7h4v4"/></svg>',
-    '占比': _SVG_OPEN + '<path d="M21.2 15.9A10 10 0 1 1 8 2.8"/><path d="M22 12A10 10 0 0 0 12 2v10z"/></svg>',
-    '表格': _SVG_OPEN + '<rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M3 15h18M9 3v18M15 3v18"/></svg>',
-    '效率': _SVG_OPEN + '<path d="M12 15l3.5-5.5"/><path d="M20.2 15a8.5 8.5 0 1 0-16.4 0"/></svg>',
-    '成果': _SVG_OPEN + '<circle cx="12" cy="8" r="6"/><path d="M15.5 13 17 22l-5-3-5 3 1.5-9"/></svg>',
-    '安全': _SVG_OPEN + '<path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/><path d="M9 12l2 2 4-4"/></svg>',
-    '权限': _SVG_OPEN + '<rect x="3" y="11" width="18" height="10" rx="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/></svg>',
-    '检查': _SVG_OPEN + '<circle cx="12" cy="12" r="10"/><path d="M8 12.5l2.5 2.5L16 9.5"/></svg>',
-    '风险': _SVG_OPEN + '<path d="M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z"/><path d="M12 9v4M12 17h.01"/></svg>',
-    '团队': _SVG_OPEN + '<path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>',
-    '流程': _SVG_OPEN + '<circle cx="18" cy="18" r="3"/><circle cx="6" cy="6" r="3"/><path d="M6 21V9a9 9 0 0 0 9 9"/></svg>',
-    '计划': _SVG_OPEN + '<rect x="3" y="4" width="18" height="18" rx="2"/><path d="M16 2v4M8 2v4M3 10h18"/></svg>',
-    '智能': _SVG_OPEN + '<rect x="4" y="4" width="16" height="16" rx="2"/><path d="M9 9h6v6H9zM9 1v3M15 1v3M9 20v3M15 20v3M1 9h3M1 15h3M20 9h3M20 15h3"/></svg>',
-    '洞察': _SVG_OPEN + '<circle cx="11" cy="11" r="8"/><path d="M21 21l-4.35-4.35"/></svg>',
-    '工具': _SVG_OPEN + '<path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"/></svg>',
-    '清单': _SVG_OPEN + '<path d="M8 6h13M8 12h13M8 18h13M3 6h.01M3 12h.01M3 18h.01"/></svg>',
-}
+# ── 语义图标库（单源：assets/icons/ + index.json；与 icon_lib.js / PPTX 真导出同源）──
+_ICON_DIR = Path(__file__).resolve().parent.parent / 'assets' / 'icons'
+_ICON_INDEX: dict = {}
+try:
+    _ICON_INDEX = json.loads((_ICON_DIR / 'index.json').read_text(encoding='utf-8'))
+except OSError:
+    _ICON_INDEX = {}
+
+
+def _load_icons() -> 'dict[str, str]':
+    out: dict[str, str] = {}
+    for name in (_ICON_INDEX.get('icons') or {}):
+        try:
+            out[name] = (_ICON_DIR / f'{name}.svg').read_text(encoding='utf-8').strip()
+        except OSError:
+            continue
+    return out
+
+
+ICONS: dict[str, str] = _load_icons()
 _ICONS_ORDER = list(ICONS.keys())
+_ICON_DEFAULTS = [n for n in (_ICON_INDEX.get('defaults') or []) if n in ICONS] or _ICONS_ORDER
 
 
 def pick_icon(title: str = '', idx: int = 0) -> str:
-    """按标题语义挑图标；未命中则按序轮换（保持同屏同家族、不堆砌）。"""
-    t = str(title or '')
-    for key, svg in ICONS.items():
-        if key in t:
-            return svg
-    return ICONS[_ICONS_ORDER[idx % len(_ICONS_ORDER)]]
+    """按标题语义挑图标 SVG；未命中则在默认表内轮换（选不出用默认，不盲目轮换全量）。"""
+    return ICONS[pick_icon_name(title, idx)]
 
 
 def pick_icon_name(title: str = '', idx: int = 0) -> str:
-    """图标名（与 icon_lib.js / PPTX 真导出同名）。"""
+    """图标名（与 icon_lib.js / PPTX 真导出同名；关键词来自 index.json）。"""
     t = str(title or '')
-    for key in ICONS:
-        if key in t:
+    meta = _ICON_INDEX.get('icons') or {}
+    for key in _ICONS_ORDER:
+        kws = (meta.get(key) or {}).get('keywords') or [key]
+        if any(kw and kw in t for kw in kws):
             return key
-    return _ICONS_ORDER[idx % len(_ICONS_ORDER)]
+    return _ICON_DEFAULTS[idx % len(_ICON_DEFAULTS)]
 
 
 def card_head(title: str, idx: int = 0, icon_name: str | None = None) -> str:
@@ -253,16 +263,23 @@ def r_metrics(i, sec):
 
 
 def r_kpi(i, sec):
+    # 大数指标页：hero 大数字 + 支撑指标行（metrics，可选）+ 要点；三者缺一不丢其余
     hero = sec.get('hero') or []
     val = hero[0] if hero else ''
     lab = hero[1] if len(hero) > 1 else ''
     delta = hero[2] if len(hero) > 2 else ''
+    left = ''
+    if val or lab:
+        left = (
+            '      <div class="stack gap-3"><div class="t-metric" style="color:var(--accent)">'
+            f'{esc(val)}</div>'
+            f'<div class="t-h3">{esc(lab)}</div>'
+            + (f'<div class="t-sm" style="color:var(--accent);font-weight:600">{esc(delta)}</div>' if delta else '')
+            + '</div>\n')
+    mets = metrics_row(sec.get('metrics')) if sec.get('metrics') else ''
     body = (
         '    <div class="grid g-hero rv a-c">\n'
-        f'      <div class="stack gap-3"><div class="t-metric" style="color:var(--accent)">{esc(val)}</div>'
-        f'<div class="t-h3">{esc(lab)}</div>'
-        + (f'<div class="t-sm" style="color:var(--accent);font-weight:600">{esc(delta)}</div>' if delta else '')
-        + '</div>\n'
+        + left + mets
         + '      <div class="grid g-2">\n'
         + pts_list(sec.get('points') or [['支撑', '一句话。']])
         + '\n      </div>\n    </div>\n')
@@ -339,14 +356,20 @@ def r_exhibit(i, sec):
 
 def r_twocol(i, sec):
     paras = sec.get('paragraphs') or []
+    variant = sec.get('variant') or ''
     cols = []
-    for p in paras:
+    for pi, p in enumerate(paras):
         if isinstance(p, (list, tuple)) and len(p) >= 2:
             cols.append(f'      <p class="t-body"><strong>{esc(p[0])}。</strong>{cite(p[1])}</p>')
         else:
             cols.append(f'      <p class="t-body">{cite(p)}</p>')
+    # 变体 2-col-feature：首栏为特性栏（复用 .card 语义：加粗标题 + accent 左线）
+    extra = ''
+    if variant == '2-col-feature' and cols:
+        cols[0] = cols[0].replace('class="t-body"', 'class="t-body col--feature"', 1)
+        extra = ' data-variant="2-col-feature"'
     body = '    <div class="cols-2 rv">\n' + '\n'.join(cols) + '\n    </div>\n'
-    return wrap(i, 'twocol', body, sec)
+    return wrap(i, 'twocol', body, sec, extra)
 
 
 def r_threecol(i, sec):
@@ -365,11 +388,16 @@ def r_threecol(i, sec):
 
 def r_cards(i, sec):
     cards = sec.get('cards') or []
+    variant = sec.get('variant') or ''
     n = int(sec.get('columns') or min(3, max(1, len(cards))))
     cls = {1: 'g-2', 2: 'g-2', 3: 'g-3', 4: 'g-4'}.get(n, 'g-3')
     # 纯卡片栅格强制等高（g-2--equal / g-3--equal），与 CSS / layout-grammar「同行卡片 stretch」一致
     if cls in ('g-2', 'g-3', 'g-4'):
         cls = cls + '--equal'
+    extra = ''
+    if variant == 'bento-grid':
+        # 变体 bento-grid：首卡跨 2 列（.card--lead），复用 .card 组件
+        cls, extra = 'g-bento', ' data-variant="bento-grid"'
     blocks = []
     for ci, cd in enumerate(cards):
         if isinstance(cd, dict):
@@ -380,11 +408,12 @@ def r_cards(i, sec):
             title, points, icon_name = cd[0], [['', cd[1]]], None
         else:
             title, points, icon_name = (cd or ''), [], None
+        lead_cls = ' card--lead' if (variant == 'bento-grid' and ci == 0) else ''
         blocks.append(
-            f'      <div class="card">{card_head(str(title), ci, icon_name)}\n'
+            f'      <div class="card{lead_cls}">{card_head(str(title), ci, icon_name)}\n'
             f'        {pts_list(points)}</div>')
     body = f'    <div class="grid {cls} rv">\n' + '\n'.join(blocks) + '\n    </div>\n'
-    return wrap(i, 'cards', body, sec)
+    return wrap(i, 'cards', body, sec, extra)
 
 
 def r_split(i, sec):
@@ -519,6 +548,9 @@ def r_image(i, sec):
         else:
             grid_cls = f'media-grid media-grid--{min(4, max(2, n))}'
         media = f'    <div class="{grid_cls} rv">\n' + '\n'.join(cells) + '\n    </div>\n'
+        # 组 caption（图编号）：多图版式同样渲染，与 PPTX img.caption 同口径（此前仅单图分支渲染）
+        if cap:
+            media += f'    <p class="media__src">{cite(cap)}</p>\n'
     else:
         src = im.get('src') or ''
         ph = bool(im.get('placeholder')) or not src
@@ -589,23 +621,32 @@ def r_lane(i, sec):
 
 def r_timeline(i, sec):
     items = []
+    variant = sec.get('variant') or ''
     for ph in (sec.get('phases') or []):
         if isinstance(ph, (list, tuple)):
             lab, name, desc = (list(ph) + ['', '', ''])[:3]
             state = ph[3] if len(ph) > 3 else ''
+            icon_name = ph[4] if len(ph) > 4 else ''
         else:
             lab, name, desc, state = ph.get('label', ''), ph.get('name', ''), ph.get('d', ''), ph.get('s', '')
+            icon_name = ph.get('icon', '')
         cls = 'tl__i'
         if state == 'done':
             cls += ' tl__i--done'
         elif state == 'now':
             cls += ' tl__i--now'
+        # 变体 timeline：节点图标（icon:<name>，无图标回落圆点）
+        dot = '<div class="tl__d"></div>'
+        if variant == 'timeline' and icon_name and icon_name in ICONS:
+            dot = (f'<div class="tl__ico" data-icon="{esc(icon_name)}">'
+                   f'{ICONS[icon_name]}</div>')
         items.append(
-            f'        <div class="{cls}"><div class="tl__d"></div>'
+            f'        <div class="{cls}">{dot}'
             f'<div class="tl__l">{esc(lab)}</div><div class="tl__t">{esc(name)}</div>'
             f'<p class="t-body">{cite(desc)}</p></div>')
     body = '    <div class="fig rv"><div class="tl">\n' + '\n'.join(items) + '\n    </div></div>\n'
-    return wrap(i, 'timeline', body, sec)
+    extra = ' data-variant="timeline"' if variant == 'timeline' else ''
+    return wrap(i, 'timeline', body, sec, extra)
 
 
 def r_steps(i, sec):
@@ -675,18 +716,34 @@ def r_pyramid(i, sec):
 
 
 def r_halftable(i, sec):
-    """半表半图：g-half 左表右图（校验 TYPE_FEATURE.halftable）。"""
+    """半表半图：g-half 左表右图（校验 TYPE_FEATURE.halftable）。
+    research 模式带 exhibitNo 时：右图按 Exhibit 规范加编号徽标与来源行，表侧不丢
+    （此前 research 统一走 r_exhibit 会静默丢弃 table——内容覆盖率门禁捕获）。"""
     tbl = sec.get('table') or {}
     ch = sec.get('chart') or {}
     head = tbl.get('head') or []
     rows = tbl.get('rows') or []
     th = ''.join(f'<th>{esc(h)}</th>' for h in head)
     trs = ''.join('<tr>' + ''.join(f'<td>{cite(c)}</td>' for c in row) + '</tr>' for row in rows)
+    no = sec.get('exhibitNo')
+    if no:
+        fig = (
+            '      <div class="fig"><div class="exhibit rv">\n'
+            f'        <div class="exhibit__hd"><span class="exhibit__no">Exhibit {esc(no)}</span>'
+            f'<span class="exhibit__t">{esc(sec.get("title") or "")}</span></div>\n'
+            f'{chart_svg(ch, i)}'
+            f'        <div class="exhibit__src">{cite(sec.get("footnote") or "来源：待补")}</div>\n'
+            '      </div></div>\n')
+        sec = dict(sec)
+        sec.pop('footnote', None)  # 已进来源行，避免 wrap 再渲染一次
+    else:
+        fig = (
+            f'      <div class="fig"><div class="fig__cap">{esc(ch.get("cap") or "互证图")}</div>\n'
+            f'{chart_svg(ch, i)}      </div>\n')
     body = (
         '    <div class="grid g-half g-2 rv a-start">\n'
         f'      <div class="tbl-wrap"><table><thead><tr>{th}</tr></thead><tbody>{trs}</tbody></table></div>\n'
-        f'      <div class="fig"><div class="fig__cap">{esc(ch.get("cap") or "互证图")}</div>\n'
-        f'{chart_svg(ch, i)}      </div>\n'
+        f'{fig}'
         '    </div>\n')
     return wrap(i, 'halftable', body, sec)
 
@@ -800,8 +857,10 @@ def render_body(model: dict) -> str:
             title = ag[1] if isinstance(ag, (list, tuple)) and len(ag) > 1 else ''
             desc = ag[2] if isinstance(ag, (list, tuple)) and len(ag) > 2 else ''
             href_i = chapter_first.get(str(num).zfill(2)) or chapter_first.get(str(num)) or gi
+            # 锚点与 open_sec 同源：该页有 anchor 则链到命名锚点
+            href_id = sec_anchor(href_i, secs[href_i - 1] if 0 < href_i <= len(secs) else {})
             lis.append(
-                f'      <li class="agenda__i"><a class="agenda__a" href="#s{href_i}">'
+                f'      <li class="agenda__i"><a class="agenda__a" href="#{href_id}">'
                 f'<span class="agenda__n">{esc(num)}</span>'
                 f'<span><span class="agenda__t">{esc(title)}</span>'
                 f'<div class="agenda__d">{esc(desc)}</div></span></a></li>')
@@ -822,7 +881,9 @@ def render_body(model: dict) -> str:
             sec = dict(sec)
             sec['exhibitNo'] = ex_n
         fn = RENDERERS.get(t, r_points)
-        if is_research_exhibit:
+        if is_research_exhibit and t != 'halftable':
+            # halftable 在 research 下仍走 r_halftable（表+图），仅借 exhibitNo 加 Exhibit 徽标；
+            # 统一走 r_exhibit 会静默丢弃 table（内容覆盖率门禁捕获，0.2.0 修）。
             fn = r_exhibit
         try:
             parts.append(fn(i, sec))