@topmindspace/tms-skills 0.3.9 → 0.5.0

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

@@ -159,15 +159,22 @@ function _normColor(c) {
   if (/^[0-9a-f]{3}$/.test(v)) v = '#' + v;
   return v;
 }
-/** 取图标 PNG data URI；无缓存时按名挑色兜底（accent → 首色 → null） */
+/** 取图标 PNG data URI；无缓存时按名挑色兜底（accent → 首色 → 包内 512px PNG → null） */
 function iconPng(name, colorHex) {
   const n = name && ICON_ASSETS.icons[name] ? name : ICON_LIB.pickIconName(name, 0);
   const bag = ICON_ASSETS.icons[n];
-  if (!bag) return null;
-  const want = _normColor(colorHex);
-  if (bag[want]) return bag[want];
-  const keys = Object.keys(bag);
-  return bag[keys[0]] || null;
+  if (bag) {
+    const want = _normColor(colorHex);
+    if (bag[want]) return bag[want];
+    const keys = Object.keys(bag);
+    if (keys.length) return bag[keys[0]];
+  }
+  // 无 sharp / 无预生成资产时的可靠回落：包内 512px 预渲染 PNG（python-pptx/pptxgenjs 均可直接嵌入）
+  try {
+    const p = ICON_LIB.iconPngPath(n);
+    if (p) return 'data:image/png;base64,' + fs.readFileSync(p).toString('base64');
+  } catch (e) { /* 继续回落 accent 方块 */ }
+  return null;
 }
 /** 在指定盒内嵌图标（真导出）；无图标资产时回落 accent 小方块（可扫读路标） */
 function addIcon(s, name, x, y, size, colorHex) {
@@ -275,6 +282,30 @@ const FS_POLICY = (function () {
   }
 })();
 const FONT_LADDER = FS_POLICY.ladder;
+/* 弹性文本单源（containers.adaptiveText · 0.2.0）：长标题/长列表/长表格单元格的降级规则。
+   调用处只读 AT_* 与下列 helper，禁止手写字号/行距/阈值 magic number。 */
+const AT = (LC.containers && LC.containers.adaptiveText) || {};
+const AT_TITLE = AT.title || {}, AT_LIST = AT.list || {}, AT_TABLE = AT.table || {};
+/* 标题字号上限：按字符数（CJK=1，拉丁/数字≈0.5，与 estLines 同口径）分档 */
+function titleMaxFor(text) {
+  const s = String(text == null ? '' : text);
+  let units = 0;
+  for (const ch of s) units += /[\x00-\xff]/.test(ch) ? 0.5 : 1;
+  if (units >= (AT_TITLE.xlongChars != null ? AT_TITLE.xlongChars : 44)) return AT_TITLE.xlongMax || 20;
+  if (units >= (AT_TITLE.longChars != null ? AT_TITLE.longChars : 28)) return AT_TITLE.longMax || 24;
+  return AT_TITLE.base || 30;
+}
+/* 列表密集度：条目数达标 → 收紧字号上限/段间距/行距 */
+function listFitOpts(n) {
+  const dense = n >= (AT_LIST.denseItems != null ? AT_LIST.denseItems : 6);
+  return {
+    dense,
+    max: dense ? (AT_LIST.denseMax || 12) : (AT_LIST.max || 14),
+    gapFactor: dense ? (AT_LIST.denseGapFactor != null ? AT_LIST.denseGapFactor : 0.25)
+                     : (AT_LIST.gapFactor != null ? AT_LIST.gapFactor : 0.5),
+    lineFactor: dense ? (AT_LIST.denseLineFactor || 1.3) : (AT_LIST.lineFactor || 1.45),
+  };
+}
 /* 缩字号触底记录：触底 = 内容量超出该版式承载力，是「该拆页/换组合」的信号，不得无声无息 */
 const SHRINK_FLOOR_HITS = [];
 function modeFloorPt() {
@@ -470,9 +501,10 @@ function head(s, eyebrow, title, lead) {
   };
   if (eyebrow) s.addText(eyebrow, { x: H.x, y: H.y, w: H.w, h: 0.4, fontFace: STYLE.font,
     fontSize: sz(13), bold: true, color: STYLE.accent, charSpacing: 2 });
-  /* 主标题自适应：过长时缩一档，避免压到分隔线 */
+  /* 主标题自适应（adaptiveText.title 单源）：先按字符数分档定上限，再按高度验算降一档，避免压到分隔线 */
   const titleH = eyebrow ? (H.ruleY - H.titleY - 0.06) : 1.6 - 0.6;
-  const tSize = estTextH(title, CW, sz(30), 1.25) > titleH ? sz(24) : sz(30);
+  const tMax = titleMaxFor(title);
+  const tSize = sz(estTextH(title, CW, sz(tMax), 1.25) > titleH ? Math.min(tMax, AT_TITLE.step1 || 24) : tMax);
   s.addText(title, { x: H.x, y: eyebrow ? H.titleY : 0.6, w: H.w, h: Math.max(0.6, titleH),
     fontFace: STYLE.fontDisplay, fontSize: tSize, bold: true, color: STYLE.ink, fit: 'shrink' });
   s.addShape('rect', { x: H.x, y: eyebrow ? H.ruleY : 1.6, w: 0.9, h: 0.045, fill: { color: STYLE.accent }, line: { type: 'none' } });
@@ -515,7 +547,7 @@ function isRec(v) { return !!v && typeof v === 'object' && !Array.isArray(v); }
    pointKV: [k,v] | {k|t, v|d} | str（对齐 pts_list）
    metricKV: [v,k] | {v|value, k}（对齐 metrics_row）
    bulletKV: [k,a,t] | {k,a,t}（对齐 r_bullet；缺省保持 undefined 以便调用方判空）
-   phaseKV: [label,name,desc,state] | {label,name,d,s}（对齐 r_timeline）
+   phaseKV: [label,name,desc,state,icon?] | {label,name,d,s,icon?}（对齐 r_timeline；icon 为变体 timeline 节点图标）
    paraKV: [title,text] | str（对齐 r_twocol；str 为无加粗标题的正文段） */
 function pointKV(p) {
   if (Array.isArray(p)) return [String(p[0] == null ? '' : p[0]), String(p[1] == null ? '' : p[1])];
@@ -533,9 +565,10 @@ function bulletKV(it) {
   return [String(it == null ? '' : it), undefined, undefined];
 }
 function phaseKV(ph) {
-  if (Array.isArray(ph)) return [ph[0] || '', ph[1] || '', ph[2] || '', ph[3] || ''];
-  if (isRec(ph)) return [ph.label || '', ph.name || '', ph.d || '', ph.s || ''];
-  return [String(ph == null ? '' : ph), '', '', ''];
+  // 第 5 元 = icon（变体 timeline 的节点图标；缺省 ''，渲染回落圆点）
+  if (Array.isArray(ph)) return [ph[0] || '', ph[1] || '', ph[2] || '', ph[3] || '', ph[4] || ''];
+  if (isRec(ph)) return [ph.label || '', ph.name || '', ph.d || '', ph.s || '', ph.icon || ''];
+  return [String(ph == null ? '' : ph), '', '', '', ''];
 }
 function paraKV(p) {
   if (Array.isArray(p)) return [p[0] || '', p[1] || ''];
@@ -1836,7 +1869,7 @@ function addTable(s, tbl, x, y, w, availH, opts) {
   const minRowH = opts.minRowH != null ? opts.minRowH : PT.table.rowHMin;
   const headRowH = opts.headRowH != null ? opts.headRowH : (PT.table.headRowH || minRowH);
   /* 行数超过容量时优先压行高到 hardFloor，仍放不下则整体缩放到 availH（禁溢出） */
-  const hardFloor = Math.min(minRowH, 0.22);
+  const hardFloor = Math.min(minRowH, AT_TABLE.rowFloorIn != null ? AT_TABLE.rowFloorIn : 0.22);
   const ideal = availH / Math.max(1, n);
   let rowH = Math.min(maxRowH, Math.max(hardFloor, ideal));
   if (n * rowH > availH + 0.01) {
@@ -1847,7 +1880,8 @@ function addTable(s, tbl, x, y, w, availH, opts) {
   }
   /* 行多则同步收字号（research 密排允许更小；句子单元格仍走语义字号门禁） */
   const dense = rowH < 0.42;
-  const headSz = sz(dense ? 11 : 13), bodySz = sz(dense ? 10 : 12.5);
+  const headSz = sz(dense ? 11 : Math.min(13, AT_TABLE.headMax || 12));
+  const bodySz = sz(dense ? 10 : Math.min(12.5, AT_TABLE.cellMax || 13));
   const hRowH = Math.min(headRowH, Math.max(hardFloor, rowH * 1.15));
   /* 内容高度预估：逐格用 estTextH 估算，超出行高则全表收字号 ——
      禁依赖 fit:'shrink' 或渲染引擎自动撑高（PowerPoint/LibreOffice 会按内容增高行，压住脚注） */
@@ -1855,9 +1889,11 @@ function addTable(s, tbl, x, y, w, availH, opts) {
   const effColW = (Array.isArray(tbl.colW) && tbl.colW.length >= ncolsT) ? tbl.colW.slice(0, ncolsT)
     : Array.from({ length: ncolsT }, () => w / ncolsT);
   const cellPadIn = (dense ? 2 : 5) / 72;
+  /* 长表格单元格适配（adaptiveText.table 单源）：逐格估算，超出行高则全表收字号；
+     floor 取模式下限与表格下限之大者——表格不得突破模式可读性底线 */
   const fitCellSz = (text, cw, availHh, maxSz) => fitFont([String(text == null ? '' : text)],
     Math.max(0.5, cw - cellPadIn * 2), Math.max(0.2, availHh - cellPadIn * 2),
-    { max: maxSz, maxShrinkSteps: 6 });
+    { max: maxSz, maxShrinkSteps: 6, floor: Math.max(modeFloorPt(), AT_TABLE.cellFloor || 0) });
   let bodySzF = bodySz, headSzF = headSz;
   rowsIn.forEach(r => r.forEach((c, j) => {
     const f = fitCellSz(c, effColW[j] != null ? effColW[j] : effColW[0], rowH, bodySz);
@@ -2408,8 +2444,14 @@ CONTENT.sections.forEach((sec) => {
     ps.forEach((p, i) => {
       const x = treg.x + 0.2 + i * stepW;
       const on = p[3] === 'done' || p[3] === 'now';
-      s.addShape('ellipse', { x: x - T.dotR / 2, y: T.dotY, w: T.dotR, h: T.dotR,
-        fill: { color: on ? STYLE.accent : STYLE.line }, line: { type: 'none' } });
+      // 变体 timeline：节点图标（icon:<name>）；无图标回落圆点
+      const wantIcon = (sec.variant === 'timeline') && p[4];
+      if (wantIcon) {
+        addIcon(s, p[4], x - 0.13, T.dotY - 0.06, 0.26, on ? STYLE.accent : STYLE.body);
+      } else {
+        s.addShape('ellipse', { x: x - T.dotR / 2, y: T.dotY, w: T.dotR, h: T.dotR,
+          fill: { color: on ? STYLE.accent : STYLE.line }, line: { type: 'none' } });
+      }
       s.addText(p[0], { x: x - 0.1, y: T.labelY, w: stepW - 0.2, h: 0.4, fontFace: STYLE.font,
         fontSize: sz(12), bold: true, color: STYLE.accent, charSpacing: 1 });
       s.addText(p[1], { x: x - 0.1, y: T.nameY, w: stepW - 0.2, h: 0.5, fontFace: STYLE.fontDisplay,
@@ -2465,11 +2507,25 @@ CONTENT.sections.forEach((sec) => {
     const fz = fitFont(items.length ? items : ['x'.repeat(longest)], g.w, availH, { max: 13.5, gapFactor: 1.2 });
     groups.forEach((col, ci) => {
       if (!col.length) return;
+      const colX = treg.x + ci * g.step;
+      // 变体 2-col-feature：首栏特性栏（accent 左线 + 标题放大一档）
+      const isFeature = (sec.variant === '2-col-feature') && ci === 0 && nCol === 2;
+      const fx = isFeature ? colX + 0.14 : colX;
+      const fw = isFeature ? g.w - 0.14 : g.w;
+      if (isFeature) {
+        // 特性栏 accent 左线：高度按首段实际文本估算（不用整栏 availH，避免无墨水区压进注释带触发 severe 门禁）
+        const p0 = col[0] || ['', ''];
+        const barH = Math.min(availH,
+          estTextH(p0[0] + '　', fw, sz(fz + 1), 1.5) +
+          estTextH(p0[1] || '', fw, sz(fz - 1), 1.5) + sz(7) / 72 + 0.06);
+        s.addShape('rect', { x: colX, y: treg.y, w: 0.045, h: Math.max(0.2, barH),
+          fill: { color: STYLE.accent }, line: { type: 'none' }, objectName: 'feature:bar' });
+      }
       const runs = col.map(p => ([
-        { text: p[0] + '　', options: { fontSize: sz(fz), bold: true, color: STYLE.ink } },
+        { text: p[0] + '　', options: { fontSize: sz(isFeature ? fz + 1 : fz), bold: true, color: STYLE.ink } },
         { text: p[1] + '\n', options: { fontSize: sz(fz - 1), color: STYLE.body, breakLine: true } },
       ])).flat();
-      s.addText(runs, { x: treg.x + ci * g.step, y: treg.y, w: g.w, h: availH, fontFace: STYLE.font,
+      s.addText(runs, { x: fx, y: treg.y, w: fw, h: availH, fontFace: STYLE.font,
         valign: 'top', lineSpacing: sz(fz * 1.5), paraSpaceBefore: sz(7) });
     });
   } else if (type === 'halftable') {
@@ -2563,8 +2619,10 @@ CONTENT.sections.forEach((sec) => {
         : (Array.isArray(cd)
           ? { title: cd[0] || '', points: cd.length > 1 ? [['', cd[1]]] : [] }
           : { title: String(cd == null ? '' : cd), points: [] }));
-    const c = Math.min(sec.columns || 3, cds.length || 1);
-    const r = Math.ceil((cds.length || 1) / c);
+    const isBento = (sec.variant === 'bento-grid') && cds.length >= 3;
+    const c = isBento ? 3 : Math.min(sec.columns || 3, cds.length || 1);
+    // bento-grid：首卡占 2 个槽位（跨 2 列），其余顺排；槽位数 = 卡数 + 1
+    const r = isBento ? Math.ceil((cds.length + 1) / c) : Math.ceil((cds.length || 1) / c);
     const gw = (creg.w - (c - 1) * cdC.gap) / c;
     const gh = fitRowH(creg.h - (r - 1) * cdC.gap, r, cdC.maxH, 0.6);
     /* points 文本归一化（scaffold v9 契约 {title, points:[[k,v]]} 兼容三种形态） */
@@ -2589,21 +2647,28 @@ CONTENT.sections.forEach((sec) => {
         { max: 12, lineFactor: 1.5, gapFactor: 0 }))) : 12;
     const ptsFz = sz(ptsFzB);
     cds.forEach((cd, i) => {
-      const col = i % c, row = Math.floor(i / c);
+      let col = i % c, row = Math.floor(i / c), span = 1;
+      if (isBento) {
+        // 首卡跨 2 列：槽位 = i===0 ? [0,1] : i+1
+        const slot = i === 0 ? 0 : i + 1;
+        if (i === 0) span = 2;
+        col = slot % c; row = Math.floor(slot / c);
+      }
+      const cw = span * gw + (span - 1) * cdC.gap;
       const x = creg.x + col * (gw + cdC.gap), y = creg.y + row * (gh + cdC.gap);
-      s.addShape('roundRect', { x, y, w: gw, h: gh, rectRadius: 0.08,
+      s.addShape('roundRect', { x, y, w: cw, h: gh, rectRadius: 0.08,
         fill: { color: STYLE.surface }, line: { color: STYLE.line, width: 0.75 } });
       /* 卡片头路标：真导出语义图标（SVG→PNG），与 HTML .card__ico 同源；无资产时回落 accent 方块 */
       const ico = 0.18;
       const icoName = cd.icon || ICON_LIB.pickIconName(cd.title || '', i);
       addIcon(s, icoName, x + 0.18, y + 0.2, ico, STYLE.accent);
-      s.addText(cd.title || '', { x: x + 0.18 + ico + 0.1, y: y + 0.14, w: gw - 0.36 - ico - 0.1, h: cdC.titleH, fontFace: STYLE.font,
+      s.addText(cd.title || '', { x: x + 0.18 + ico + 0.1, y: y + 0.14, w: cw - 0.36 - ico - 0.1, h: cdC.titleH, fontFace: STYLE.font,
         fontSize: sz(15), bold: true, color: STYLE.ink, fit: 'shrink' });
       /* points 兼容：[[k,v]…] | [str…] | [{t,d}…]（scaffold v9 契约 {title, points:[[k,v]]}） */
       const ptLines = (cd.points || []).map(cardPtText);
       s.addText(ptLines.map(t => ({ text: t + '\n',
           options: { fontSize: ptsFz, color: STYLE.body, fontFace: STYLE.font, breakLine: true } })),
-        { x: x + 0.18, y: y + 0.14 + cdC.titleH + 0.06, w: gw - 0.36, h: ptsBoxH,
+        { x: x + 0.18, y: y + 0.14 + cdC.titleH + 0.06, w: cw - 0.36, h: ptsBoxH,
           fontFace: STYLE.font, valign: 'top', lineSpacing: ptsFz * 1.5 });
     });
   } else if (type === 'split') {
@@ -2792,8 +2857,10 @@ CONTENT.sections.forEach((sec) => {
       : CW - 0.4;
     const avail = bodyBottom - bodyY;
     const rowH = fitRowH(avail, pts.length, P.rowH, 0.3);
+    /* 长列表收紧（adaptiveText.list 单源）：条目多时降字号上限/段间距/行距，仍装不下由 fitFont 阶梯下探 */
+    const _lo = listFitOpts(pts.length);
     const fzB = fitFont(pts.map(p => (p[0] || '') + (p[1] || '')), textW - 0.32, avail,
-      { max: 15, gapFactor: 0.55 });
+      { max: Math.min(15, _lo.max), gapFactor: _lo.gapFactor, lineFactor: _lo.lineFactor });
     const fz = sz(fzB), fzSm = sz(snapFont(fzB - 1));
     pts.forEach((p, i) => {
       const y = bodyY + i * rowH;

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

@@ -0,0 +1,119 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""TopPPT HTML · 图标包校验（assets/icons/）
+
+检查：
+  1. 每个 *.svg 合法 XML；根为 svg；viewBox 恰为 "0 0 24 24"
+  2. 描边风格统一：fill="none"、stroke="currentColor"、stroke-width="1.8"、
+     stroke-linecap/linejoin="round"（同家族铁律）
+  3. 只含允许元素（path/circle/rect/ellipse/line/polyline/polygon），无 <text>/<image>，
+     无 fill="#..." 彩色填充（禁三方彩色标），无外链
+  4. index.json 一致性：icons 键 ↔ <name>.svg 文件一一对应；defaults 5~8 个且都在包内；
+     keywords 非空且含自身名
+  5. 每个图标有同名 512px PNG（PPTX 通道预渲染）
+
+用法: python scripts/check_icons.py [--strict]
+退出码：0=通过；1=有 FAIL；2=仅 WARN（--strict 下也按 1 处理）
+"""
+from __future__ import annotations
+
+import json
+import sys
+import xml.etree.ElementTree as ET
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+ICON_DIR = ROOT / 'assets' / 'icons'
+ALLOWED = {'path', 'circle', 'rect', 'ellipse', 'line', 'polyline', 'polygon'}
+
+
+def main() -> int:
+    strict = '--strict' in sys.argv
+    fails: list[str] = []
+    warns: list[str] = []
+
+    idx_path = ICON_DIR / 'index.json'
+    if not idx_path.exists():
+        print('FAIL: assets/icons/index.json 缺失')
+        return 1
+    index = json.loads(idx_path.read_text(encoding='utf-8'))
+    icons_meta = index.get('icons') or {}
+    if index.get('count') != len(icons_meta):
+        fails.append(f"index.json count={index.get('count')} 与实际条目 {len(icons_meta)} 不一致")
+
+    svg_names = {p.stem for p in ICON_DIR.glob('*.svg')}
+    meta_names = set(icons_meta)
+    for n in sorted(meta_names - svg_names):
+        fails.append(f'index.json 有条目但缺文件: {n}.svg')
+    for n in sorted(svg_names - meta_names):
+        warns.append(f'有 SVG 文件但 index.json 未登记: {n}.svg')
+
+    defaults = index.get('defaults') or []
+    if not 5 <= len(defaults) <= 8:
+        fails.append(f'defaults 应 5~8 个，实际 {len(defaults)} 个')
+    for d in defaults:
+        if d not in icons_meta:
+            fails.append(f'default 图标不在包内: {d}')
+
+    for name, meta in icons_meta.items():
+        kws = meta.get('keywords') or []
+        if not kws:
+            warns.append(f'{name}: keywords 为空')
+        elif name not in kws:
+            warns.append(f'{name}: keywords 未含自身名')
+        png = ICON_DIR / f'{name}.png'
+        if not png.exists():
+            fails.append(f'缺预渲染 PNG: {name}.png')
+        elif png.stat().st_size < 1024:
+            warns.append(f'{name}.png 疑似过小（{png.stat().st_size}B）')
+
+    for name in sorted(svg_names):
+        p = ICON_DIR / f'{name}.svg'
+        try:
+            root = ET.fromstring(p.read_text(encoding='utf-8'))
+        except ET.ParseError as e:
+            fails.append(f'{name}.svg XML 非法: {e}')
+            continue
+        tag = root.tag.split('}')[-1]
+        if tag != 'svg':
+            fails.append(f'{name}.svg 根元素不是 svg: {tag}')
+            continue
+        if root.get('viewBox') != '0 0 24 24':
+            fails.append(f"{name}.svg viewBox={root.get('viewBox')!r}（必须 '0 0 24 24'）")
+        style = {
+            'fill': root.get('fill'), 'stroke': root.get('stroke'),
+            'stroke-width': root.get('stroke-width'),
+            'stroke-linecap': root.get('stroke-linecap'),
+            'stroke-linejoin': root.get('stroke-linejoin'),
+        }
+        want = {'fill': 'none', 'stroke': 'currentColor', 'stroke-width': '1.8',
+                'stroke-linecap': 'round', 'stroke-linejoin': 'round'}
+        if style != want:
+            fails.append(f'{name}.svg 风格属性偏离家族规范: {style}')
+        for el in root.iter():
+            t = el.tag.split('}')[-1]
+            if t == 'svg':
+                continue
+            if t not in ALLOWED:
+                fails.append(f'{name}.svg 含非法元素 <{t}>（禁 text/image/彩色填充）')
+            for k, v in el.attrib.items():
+                if k == 'fill' and v not in ('none',):
+                    fails.append(f'{name}.svg <{t}> 有彩色填充 fill={v}')
+                if isinstance(v, str) and v.startswith('http'):
+                    fails.append(f'{name}.svg 含外链: {v[:60]}')
+
+    for w in warns:
+        print(f'WARN: {w}')
+    for f in fails:
+        print(f'FAIL: {f}')
+    print(f'[check_icons] {len(svg_names)} svg / {len(icons_meta)} index / '
+          f'{len(defaults)} defaults: {"OK" if not fails else "FAIL"}')
+    if fails:
+        return 1
+    if warns and strict:
+        return 1
+    return 0
+
+
+if __name__ == '__main__':
+    raise SystemExit(main())

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 };