@topmindspace/tms-skills 0.3.6 → 0.4.1

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

@@ -13,6 +13,46 @@ from pathlib import Path
 
 from render_from_model import extract_model_span
 
+_ICON_DIR = Path(__file__).resolve().parent.parent / 'assets' / 'icons'
+_ICON_CACHE: dict[str, str] = {}
+
+
+def _icon_svg(name: str) -> str | None:
+    """取图标包 SVG（内联用）；缺图标返回 None（调用方保留原标记，由 validate WARN）。"""
+    if name in _ICON_CACHE:
+        return _ICON_CACHE[name]
+    p = _ICON_DIR / f'{name}.svg'
+    try:
+        svg = p.read_text(encoding='utf-8').strip()
+    except OSError:
+        return None
+    _ICON_CACHE[name] = svg
+    return svg
+
+
+# 手写 HTML 模板里的图标占位：<i data-icon="增长"></i> → 内联 SVG（currentColor 随主题变色）
+# 未知图标名保留原标记（validate_report 报 WARN，不静默吞掉）
+ICON_MARK_RE = re.compile(r'<i\s+data-icon="([^"]+)"\s*(?:/>|>\s*</i\s*>)')
+
+
+def hydrate_icons(html: str) -> tuple[str, int, list[str]]:
+    """内联 icon 标记。返回 (new_html, 成功替换数, 未知图标名列表)。"""
+    unknown: list[str] = []
+    replaced = [0]
+
+    def repl(m):
+        name = m.group(1)
+        svg = _icon_svg(name)
+        if svg is None:
+            if name not in unknown:
+                unknown.append(name)
+            return m.group(0)
+        replaced[0] += 1  # 只计真正替换的；未知名保留原标记，不计入
+        return svg
+
+    new_html, _ = ICON_MARK_RE.subn(repl, html)
+    return new_html, replaced[0], unknown
+
 PLACEHOLDER_SVG_RE = re.compile(
     r'<svg class="chart" data-chart="([^"]+)" viewBox="0 0 560 220">\s*'
     r'<!--[\s\S]*?-->\s*'
@@ -336,20 +376,26 @@ def iter_chart_payloads(model: dict):
 
 
 def hydrate(html: str, model: dict) -> str:
+    """占位 SVG → 真实图表 SVG。
+    弹性（0.2.0）：单图数据非法只留占位并记入 errors，不中断整份报告其余图的水合。"""
     payloads = list(iter_chart_payloads(model))
     idx = 0
+    errors: list = []
 
     def repl(m):
         nonlocal idx
         if idx >= len(payloads):
             return m.group(0)
         ch, ctx = payloads[idx]
-        svg = build_svg(ch, ctx)
         idx += 1
-        return svg
+        try:
+            return build_svg(ch, ctx)
+        except ChartDataError as e:
+            errors.append(str(e))
+            return m.group(0)
 
     new_html, n = PLACEHOLDER_SVG_RE.subn(repl, html)
-    return new_html, n, idx, len(payloads)
+    return new_html, n, idx, len(payloads), errors
 
 
 def main() -> int:
@@ -382,13 +428,22 @@ def main() -> int:
         print(f'FAIL: REPORT_MODEL 根节点必须是对象（得到 {type(model).__name__}）')
         return 1
     try:
-        new_html, n_ph, used, total = hydrate(html, model)
+        new_html, n_ph, used, total, chart_errors = hydrate(html, model)
     except ChartDataError as e:
+        # 防御：hydrate 内部已按图捕获，此处仅兜底批量抽取阶段的非法数据
         print(f'FAIL: 图表数据非法——{e}')
         return 1
+    for e in chart_errors:
+        print(f'FAIL: 图表数据非法——{e}（该图保留占位，其余图已水合）')
+    rc = 1 if chart_errors else 0
+    new_html, n_icon, unknown_icons = hydrate_icons(new_html)
+    if unknown_icons:
+        print(f'WARN: 未知图标名（已保留原标记）: {", ".join(unknown_icons)}')
     path.write_text(new_html, encoding='utf-8')
     left = new_html.count('见模型数据')
-    print(f'hydrated placeholders={n_ph} used_payloads={used}/{total} remaining_placeholder={left}')
+    print(f'hydrated placeholders={n_ph} icons={n_icon} used_payloads={used}/{total} remaining_placeholder={left}')
+    if rc:
+        return rc  # 有图表数据非法：文件已落盘（坏图留占位），但以非零码报告
     return 0 if left == 0 else 1
 
 

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

@@ -1,53 +1,82 @@
 /**
- * TopPPT HTML · 语义图标库（SVG 内容 · 24×24 · stroke 1.8）
- * 单源：与 references/icons.md / render_from_model.py ICONS 同语义。
- * build_pptx.js 用 sharp 栅格化为 PNG 后嵌入（真导出，不再用 accent 方块替代）。
- * sync_runtime.py 校验三处图标键一致。
+ * TopPPT HTML · 语义图标库（48 · 24×24 · stroke 1.8 圆角线帽 · currentColor）
+ * 单源：assets/icons/<name>.svg + assets/icons/index.json（关键词映射 + 默认表）。
+ * 由 scripts/make_icon_pack.py 生成。HTML 内联 / build_pptx.js PNG 真导出共用。
+ * 图标图 objectName 统一 `icon:` 前缀，validate_pptx 单独计数，不进 pictures 内容图门禁。
  */
 'use strict';
 
+const fs = require('fs');
+const path = require('path');
+
+const ICON_DIR = path.join(__dirname, '..', 'assets', 'icons');
 const SVG_OPEN = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">';
 
-/** name → SVG 完整标记（currentColor 由调用方替换为目标色） */
-const ICONS = {
-  '增长': 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>',
-};
-
-const ORDER = Object.keys(ICONS);
-
-/** 按标题语义挑图标名；未命中按序轮换（与 render_from_model.pick_icon 同策略） */
+let ICONS = {};
+let ORDER = [];
+let INDEX = { defaults: [], icons: {} };
+
+function _load() {
+  try {
+    INDEX = JSON.parse(fs.readFileSync(path.join(ICON_DIR, 'index.json'), 'utf-8'));
+  } catch (e) {
+    INDEX = { defaults: [], icons: {} };
+  }
+  const names = Object.keys(INDEX.icons || {});
+  for (const name of names) {
+    try {
+      ICONS[name] = fs.readFileSync(path.join(ICON_DIR, `${name}.svg`), 'utf-8').trim();
+    } catch (e) { /* 缺文件则跳过，validate 会 WARN */ }
+  }
+  ORDER = Object.keys(ICONS);
+  if (!ORDER.length) {
+    // 极端回落：包不可读时给一个空壳，避免调用方崩溃
+    ICONS = { '信息': SVG_OPEN + '<circle cx="12" cy="12" r="9"/><path d="M12 11v5"/><path d="M12 7.5h.01"/></svg>' };
+    ORDER = ['信息'];
+  }
+}
+_load();
+
+/** 默认图标表（index.json defaults；选不出语义图标时轮换） */
+function defaultNames() {
+  const ds = (INDEX.defaults || []).filter((n) => ICONS[n]);
+  return ds.length ? ds : ORDER;
+}
+
+/**
+ * 按标题语义挑图标名：关键词命中 → 默认表轮换（不盲目轮换全量 48）。
+ * 与 render_from_model.pick_icon_name 同策略（同读 index.json）。
+ */
 function pickIconName(title, idx) {
   const t = String(title || '');
-  for (const key of ORDER) {
-    if (t.includes(key)) return key;
+  const meta = INDEX.icons || {};
+  for (const name of ORDER) {
+    const kws = (meta[name] && meta[name].keywords) || [name];
+    for (const kw of kws) {
+      if (kw && t.includes(kw)) return name;
+    }
   }
-  return ORDER[(idx || 0) % ORDER.length];
+  const ds = defaultNames();
+  return ds[(idx || 0) % ds.length];
 }
 
-/** 渲染为带指定描边色的 SVG 字符串 */
+/** 渲染为带指定描边色的 SVG 字符串（currentColor → 目标色） */
 function iconSvg(name, color) {
-  const raw = ICONS[name] || ICONS[ORDER[0]];
+  const raw = ICONS[name] || ICONS[defaultNames()[0]] || ICONS[ORDER[0]];
   const c = color || '#1a56a8';
   return raw.replace('stroke="currentColor"', `stroke="${c}"`);
 }
 
-module.exports = { ICONS, ORDER, pickIconName, iconSvg, SVG_OPEN };
+/** 预渲染 PNG（512px）文件路径；无 sharp 环境下 PPTX 通道的可靠回落 */
+function iconPngPath(name) {
+  const n = ICONS[name] ? name : pickIconName(name, 0);
+  const p = path.join(ICON_DIR, `${n}.png`);
+  try {
+    fs.accessSync(p, fs.constants.R_OK);
+    return p;
+  } catch (e) {
+    return null;
+  }
+}
+
+module.exports = { ICONS, ORDER, INDEX, pickIconName, iconSvg, iconPngPath, SVG_OPEN, defaultNames };

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

@@ -383,7 +383,7 @@
       "legendRowH": 0.55,
       "legendLabelW": 3.4,
       "legendValW": 1.3,
-      "legendPctX": 5.3,
+      "legendPctX": 10.8,
       "legendPctW": 1.3
     },
     "steps": {
@@ -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/regression.py

@@ -64,10 +64,10 @@ def main() -> int:
     node = find_node()
     node_path = find_node_modules()
     if not node:
-        print('错误: ' + NODE_HINT)
+        print('错误： ' + NODE_HINT)
         return 2
     if not node_path:
-        print('错误: ' + NODE_MODULES_HINT)
+        print('错误： ' + NODE_MODULES_HINT)
         return 2
     env = node_env(node_path)
     print(f'Node: {node}')
@@ -82,7 +82,7 @@ def main() -> int:
     if args.only:
         examples = [h for h in examples if args.only in h.stem]
     if not examples:
-        print('错误: assets/examples/ 下没有可回归的示例。')
+        print('错误： assets/examples/ 下没有可回归的示例。')
         return 2
 
     for html in examples:

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

@@ -211,7 +211,7 @@ def main(argv: list[str] | None = None) -> int:
 
     pptx = Path(args.pptx).resolve()
     if not pptx.exists():
-        print(f'错误: 找不到 {pptx}')
+        print(f'错误： 找不到 {pptx}')
         return 2
     out = Path(args.out).resolve() if args.out else pptx.parent / 'render-compare'
     out.mkdir(parents=True, exist_ok=True)