@topmindspace/tms-skills 0.1.0

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

@@ -0,0 +1,698 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""TopPPT HTML · 模型驱动生成 HTML（消灭双写）
+
+用法:
+    python scripts/render_from_model.py report.model.json --template research.html --out report.html
+    python scripts/render_from_model.py report.html --inplace     # 用内嵌 REPORT_MODEL 重渲染正文区
+    python scripts/render_from_model.py report.model.json --body-only > body.html
+
+定位:
+    REPORT_MODEL 是内容唯一事实源。本脚本按锁定版式（layout-grammar P1–P12 / scaffold 同源类名）
+    从模型字段渲染 HTML 正文——智能体只填模型，不再手写正文与模型两份。
+    引擎标记块（__TOPPPT_*__）原样保留；正文区由模型重建。
+
+纪律:
+    · 模型字符串字段必须是纯文本（引用写 [n]）；本脚本负责转义
+    · 版式类名与 scaffold_report / components 锁定版式一致，禁止临场发明
+    · 渲染后必须跑 validate_report --strict
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import re
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+TPL = ROOT / 'assets' / 'templates'
+LC = json.loads((ROOT / 'scripts' / 'layout-constants.json').read_text(encoding='utf-8'))
+PAGE_TO_PRESET = ((LC.get('layoutSystem') or {}).get('pageToPreset') or {})
+
+CONTENT_RE = re.compile(
+    r'(<!-- __TOPPPT_CONTENT_START__ -->)[\s\S]*?(<!-- __TOPPPT_CONTENT_END__ -->)')
+MODEL_RE = re.compile(r'window\.REPORT_MODEL = \{[\s\S]*?\};')
+
+
+def esc(s) -> str:
+    return (str(s or '')
+            .replace('&', '&amp;').replace('<', '&lt;').replace('>', '&gt;')
+            .replace('"', '&quot;'))
+
+
+def cite(text: str) -> str:
+    """模型里 [n] → HTML 上标引用（模型保持纯文本）。"""
+    return re.sub(r'\[(\d+)\]',
+                  r'<a class="cite" href="#ref-\1">[\1]</a>',
+                  esc(text))
+
+
+def kp(k, v) -> str:
+    k, v = esc(k), cite(v) if isinstance(v, str) else esc(v)
+    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:
+    skel = PAGE_TO_PRESET.get(ptype, 'P4')
+    return (f'<section class="band" id="s{i}" data-skel="{skel}" '
+            f'data-page-type="{ptype}"{extra}>')
+
+
+def shead(sec: dict) -> str:
+    lead = sec.get('lead') or ''
+    lead_html = f'\n    <p class="t-lead shead__desc">{cite(lead)}</p>' if lead else ''
+    return (f'    <div class="shead rv">\n'
+            f'      <div class="t-eyebrow">{esc(sec.get("eyebrow") or "")}</div>\n'
+            f'      <h2 class="t-h1 shead__title">{esc(sec.get("title") or "")}</h2>'
+            f'{lead_html}\n    </div>')
+
+
+def sowhat(sec: dict) -> str:
+    t = sec.get('soWhat')
+    if not t:
+        return ''
+    return (f'    <div class="sowhat rv"><span class="sowhat__k">So what</span>'
+            f'<span class="sowhat__v">{cite(t)}</span></div>\n')
+
+
+def footnote(sec: dict) -> str:
+    t = sec.get('footnote')
+    if not t:
+        return ''
+    return f'    <div class="footnote">{cite(t)}</div>\n'
+
+
+def flags_block(sec: dict) -> str:
+    fl = sec.get('flags') or []
+    if not fl:
+        return ''
+    items = '\n'.join(f'      <li>{cite(x)}</li>' for x in fl)
+    return (f'    <div class="flagbar rv"><div class="flagbar__hd">待核实</div>\n'
+            f'      <ul>\n{items}\n      </ul>\n    </div>\n')
+
+
+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'
+            f'{shead(sec)}\n{body}{sowhat(sec)}{footnote(sec)}{flags_block(sec)}'
+            f'  </div>\n</section>')
+
+
+def pts_list(points) -> str:
+    if not points:
+        return '<ul class="ul"><li>（待填）</li></ul>'
+    lis = []
+    for p in points:
+        if isinstance(p, (list, tuple)) and len(p) >= 2:
+            lis.append(kp(p[0], p[1]))
+        elif isinstance(p, dict):
+            lis.append(kp(p.get('k') or p.get('t') or '', p.get('v') or p.get('d') or ''))
+        else:
+            lis.append(f'<li>{cite(p)}</li>')
+    return '<ul class="ul">' + ''.join(lis) + '</ul>'
+
+
+def chart_svg(chart: dict, idx: int, force_type: str | None = None) -> str:
+    ct = esc(force_type or (chart or {}).get('type') or 'bar')
+    return (f'      <svg class="chart" data-chart="{ct}" viewBox="0 0 560 220">\n'
+            f'        <!-- 数据以 REPORT_MODEL.chart 为准；复杂图形用 extract_snippet --chart {ct} -->\n'
+            f'        <text x="280" y="110" text-anchor="middle" class="f-txt3" font-size="12">'
+            f'{ct} · 见模型数据</text>\n'
+            f'      </svg>\n')
+
+
+# ── 页型渲染器（字段 → 锁定版式 HTML）──────────────────────────────────────────
+def r_points(i, sec):
+    pts = sec.get('points') or []
+    half = (len(pts) + 1) // 2 or 1
+    col1, col2 = pts[:half], pts[half:]
+    def card(title, items):
+        return (f'      <div class="card"><div class="card__hd"><h3 class="t-h3">{esc(title)}</h3></div>\n'
+                f'        {pts_list(items)}</div>')
+    body = ('    <div class="grid g-2 rv a-start">\n'
+            + card('要点一', col1 or pts[:1]) + '\n'
+            + card('要点二', col2 or [['', '（第二组要点）']]) + '\n'
+            + '    </div>\n')
+    if sec.get('metrics'):
+        body += metrics_row(sec['metrics'])
+    return wrap(i, 'points', body, sec)
+
+
+def metrics_row(metrics) -> str:
+    cells = []
+    for m in (metrics or [])[:6]:
+        if isinstance(m, (list, tuple)):
+            val, key = m[0], m[1] if len(m) > 1 else ''
+            note = m[2] if len(m) > 2 else ''
+        else:
+            val, key, note = m.get('v') or m.get('value') or '', m.get('k') or '', m.get('n') or ''
+        cells.append(
+            f'      <div class="metric"><div class="metric__v t-metric">{esc(val)}</div>'
+            f'<div class="metric__k">{esc(key)}</div>'
+            f'<div class="metric__n">{cite(note)}</div></div>')
+    return f'    <div class="grid g-4 rv a-start">\n' + '\n'.join(cells) + '\n    </div>\n'
+
+
+def r_metrics(i, sec):
+    return wrap(i, 'metrics', metrics_row(sec.get('metrics')), sec, ' band--top')
+
+
+def r_kpi(i, sec):
+    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 ''
+    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'
+        + '      <div class="grid g-2">\n'
+        + pts_list(sec.get('points') or [['支撑', '一句话。']])
+        + '\n      </div>\n    </div>\n')
+    return wrap(i, 'kpi', body, sec)
+
+
+def r_table(i, sec):
+    tbl = sec.get('table') or {}
+    head = tbl.get('head') or []
+    rows = tbl.get('rows') or []
+    th = ''.join(f'<th>{esc(h)}</th>' for h in head)
+    trs = []
+    for row in rows:
+        tds = ''.join(f'<td>{cite(c)}</td>' for c in row)
+        trs.append(f'<tr>{tds}</tr>')
+    body = ('    <div class="tbl-wrap rv"><table><thead><tr>' + th +
+            '</tr></thead><tbody>' + ''.join(trs) + '</tbody></table></div>\n')
+    extra = ' band--flow' if len(rows) > 10 else ''
+    return wrap(i, 'table', body, sec, extra)
+
+
+def r_bar(i, sec):
+    ch = sec.get('chart') or {}
+    body = (
+        '    <div class="grid g-side rv a-start">\n'
+        f'      <div class="fig"><div class="fig__cap">{esc(sec.get("title") or "图表")}</div>\n'
+        f'{chart_svg(ch, i)}      </div>\n'
+        '      <div class="stack gap-4"><h3 class="t-h3">怎么读这张图</h3>\n'
+        f'        {pts_list(sec.get("points") or [["结论一", "一句话。"], ["结论二", "一句话。"]])}\n'
+        '      </div>\n'
+        '    </div>\n')
+    return wrap(i, 'bar', body, sec)
+
+
+def r_donut(i, sec):
+    ch = dict(sec.get('chart') or {})
+    ch.setdefault('type', 'donut')
+    labels, values = ch.get('labels') or [], ch.get('values') or []
+    legend = []
+    total = sum(float(v or 0) for v in values) or 1
+    for lb, v in zip(labels, values):
+        pct = float(v or 0) / total * 100
+        legend.append(f'        <li><strong>{esc(lb)}。</strong>{esc(v)}（{pct:.0f}%）</li>')
+    body = (
+        '    <div class="grid g-side rv a-start">\n'
+        f'      <div class="fig" style="text-align:center"><div class="fig__cap">构成占比</div>\n'
+        f'{chart_svg(ch, i, "donut")}      </div>\n'
+        '      <div class="stack gap-4"><h3 class="t-h3">数值图例（禁止叠在弧上）</h3>\n'
+        '        <ul class="ul">' + ''.join(legend) + '</ul>\n'
+        '      </div>\n    </div>\n')
+    return wrap(i, 'donut', body, sec)
+
+
+def r_exhibit(i, sec):
+    ch = dict(sec.get('chart') or {})
+    st = (sec.get('type') or '').lower()
+    if st in ('donut', 'bar', 'halftable') and not ch.get('type'):
+        ch['type'] = 'donut' if st == 'donut' else 'bar'
+    no = sec.get('exhibitNo') or i
+    body = (
+        '    <div class="grid g-side rv a-start">\n'
+        '      <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>\n'
+        f'      {pts_list(sec.get("points") or [["结论", "一句话。"]])}\n'
+        '    </div>\n')
+    sec = dict(sec)
+    sec.pop('footnote', None)  # 已进来源行
+    return wrap(i, 'exhibit', body, sec)
+
+
+def r_twocol(i, sec):
+    paras = sec.get('paragraphs') or []
+    cols = []
+    for p in 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>')
+    body = '    <div class="cols-2 rv">\n' + '\n'.join(cols) + '\n    </div>\n'
+    return wrap(i, 'twocol', body, sec)
+
+
+def r_threecol(i, sec):
+    paras = sec.get('paragraphs') or []
+    cols = []
+    for p in paras[:6]:
+        if isinstance(p, (list, tuple)) and len(p) >= 2:
+            cols.append(f'      <div class="card"><h3 class="t-h3">{esc(p[0])}</h3>'
+                        f'<p class="t-body">{cite(p[1])}</p></div>')
+        else:
+            cols.append(f'      <div class="card"><p class="t-body">{cite(p)}</p></div>')
+    # cols-3 供校验「模型页型 ↔ 版式组件」对齐（TYPE_FEATURE.threecol）
+    body = ('    <div class="cols-3 grid g-3 rv a-start">\n' + '\n'.join(cols) + '\n    </div>\n')
+    return wrap(i, 'threecol', body, sec)
+
+
+def r_cards(i, sec):
+    cards = sec.get('cards') 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')
+    blocks = []
+    for cd in cards:
+        title = cd.get('title') if isinstance(cd, dict) else (cd[0] if cd else '')
+        points = cd.get('points') if isinstance(cd, dict) else ([['', cd[1]]] if isinstance(cd, (list, tuple)) and len(cd) > 1 else [])
+        blocks.append(
+            f'      <div class="card"><div class="card__hd"><h3 class="t-h3">{esc(title)}</h3></div>\n'
+            f'        {pts_list(points)}</div>')
+    body = f'    <div class="grid {cls} rv a-start">\n' + '\n'.join(blocks) + '\n    </div>\n'
+    return wrap(i, 'cards', body, sec)
+
+
+def r_split(i, sec):
+    def zone(el, side):
+        if not el:
+            return '      <div></div>'
+        t = (el.get('type') or ('points' if el.get('points') else 'bar'))
+        if t == 'table':
+            return ('      <div class="tbl-wrap"><table><thead><tr>' +
+                    ''.join(f'<th>{esc(h)}</th>' for h in (el.get('head') or [])) +
+                    '</tr></thead><tbody>' +
+                    ''.join('<tr>' + ''.join(f'<td>{cite(c)}</td>' for c in row) + '</tr>'
+                            for row in (el.get('rows') or [])) +
+                    '</tbody></table></div>')
+        if t == 'image':
+            im = el.get('image') or {}
+            cap = im.get('caption') or ''
+            return ('      <figure class="media media--r4-3 media--ph">'
+                    '<div class="media__ph"><b>配图占位</b><span>建议 1200×900px</span></div></figure>'
+                    + (f'\n      <div class="media__cap--below">{esc(cap)}</div>' if cap else ''))
+        if t == 'points' or el.get('points') and t not in ('bar', 'line', 'donut', 'hbar'):
+            return f'      <div class="stack gap-4">{pts_list(el.get("points"))}</div>'
+        return (f'      <div class="fig"><div class="fig__cap">{esc(el.get("cap") or "图表")}</div>\n'
+                f'{chart_svg(el, i)}      </div>')
+    body = ('    <div class="grid g-side rv a-start">\n'
+            f'{zone(sec.get("left"), "L")}\n{zone(sec.get("right"), "R")}\n'
+            '    </div>\n')
+    return wrap(i, 'split', body, sec)
+
+
+def r_comparison(i, sec):
+    def panel(d, accent=False):
+        style = ' style="background:var(--accent-soft);border-color:transparent"' if accent else ''
+        tcol = ' style="color:var(--accent)"' if accent else ''
+        return (f'      <div class="card"{style}><h3 class="t-h3"{tcol}>{esc((d or {}).get("title") or "")}</h3>\n'
+                f'        {pts_list((d or {}).get("points"))}</div>')
+    body = ('    <div class="grid g-half g-2 rv a-start">\n'
+            + panel(sec.get('left')) + '\n' + panel(sec.get('right'), True) + '\n'
+            + '    </div>\n')
+    if sec.get('verdict'):
+        body += (f'    <div class="sowhat rv"><span class="sowhat__k">结论</span>'
+                 f'<span class="sowhat__v">{cite(sec["verdict"])}</span></div>\n')
+    sec = dict(sec)
+    sec.pop('verdict', None)
+    return wrap(i, 'comparison', body, sec)
+
+
+def r_quote(i, sec):
+    body = (
+        '    <div class="shead shead--center rv">\n'
+        f'      <div style="font-size:clamp(40px,4.6vh,56px);font-weight:700;color:var(--accent)">「</div>\n'
+        f'      <p class="t-lead" style="max-width:860px;margin-inline:auto;font-weight:600">{cite(sec.get("quote") or "")}</p>\n'
+        f'      <p class="t-sm" style="color:var(--accent-text)">—— {esc(sec.get("author") or "")}'
+        + (f' · {esc(sec.get("context"))}' if sec.get('context') else '')
+        + '</p>\n    </div>\n')
+    return wrap(i, 'quote', body, sec, ' band--accent band--fit')
+
+
+def r_image(i, sec):
+    im = sec.get('image') or {}
+    layout = (im.get('layout') or 'full').lower()
+    ratio = {'half': 'r4-3', 'bleed': 'r21-9', 'grid': 'r4-3', 'compare': 'r4-3',
+             'wall': 'r1-1', 'full': 'r3-1'}.get(layout, 'r3-1')
+    cap = im.get('caption') or ''
+    media = (f'    <figure class="media media--{ratio} media--ph rv">'
+             f'<div class="media__ph"><b>配图占位</b><span>{esc(im.get("hint") or "建议尺寸见 imageSpec")}</span></div>'
+             f'</figure>\n')
+    if cap:
+        media += f'    <p class="media__src">{cite(cap)}</p>\n'
+    body = media
+    if layout == 'half' and sec.get('points'):
+        body = ('    <div class="grid g-side rv a-start">\n' + media +
+                f'      <div class="stack gap-4">{pts_list(sec.get("points"))}</div>\n    </div>\n')
+    return wrap(i, 'image', body, sec)
+
+
+def r_diagram(i, sec):
+    layers = sec.get('layers') or []
+    rows = []
+    for li, lay in enumerate(layers):
+        name = lay[0] if lay else ''
+        nodes = lay[1] if len(lay) > 1 else []
+        focus = len(lay) > 2 and lay[2] == 'focus'
+        nds = []
+        for nd in nodes[:8]:
+            if isinstance(nd, dict):
+                nds.append(f'          <div class="arch__node"><div class="arch__nt">{esc(nd.get("t") or "")}</div>'
+                           f'<div class="arch__nd">{esc(nd.get("d") or "")}</div></div>')
+            else:
+                nds.append(f'          <div class="arch__node"><div class="arch__nt">{esc(nd)}</div></div>')
+        rows.append(
+            f'      <div class="arch__layer{" arch__layer--focus" if focus else ""}">\n'
+            f'        <div class="arch__lname">{esc(name)}</div>\n'
+            f'        <div class="arch__nodes">\n' + '\n'.join(nds) + '\n        </div>\n      </div>')
+        if li < len(layers) - 1:
+            rows.append('      <div class="arch__conn" aria-hidden="true">'
+                        '<svg width="18" height="22" viewBox="0 0 18 22" fill="none" stroke="currentColor" '
+                        'stroke-width="2"><path d="M9 2v14"/><path d="M4 12l5 6 5-6"/></svg></div>')
+    legend = ''.join(f'<span class="chip">{esc(x)}</span>' for x in (sec.get('legend') or []))
+    body = ('    <div class="arch rv">\n' + '\n'.join(rows) + '\n    </div>\n'
+            + (f'    <div class="arch__legend">{legend}</div>\n' if legend else ''))
+    return wrap(i, 'diagram', body, sec, ' band--fit')
+
+
+def r_lane(i, sec):
+    lanes = sec.get('lanes') or []
+    rows = []
+    for ln in lanes:
+        hd = ln[0] if ln else ''
+        steps = ln[1] if len(ln) > 1 else []
+        parts = []
+        for si, st in enumerate(steps):
+            if isinstance(st, dict):
+                cls = 'lane__step lane__step--a' if st.get('accent') else 'lane__step'
+                parts.append(f'<span class="{cls}">{esc(st.get("t") or "")}</span>')
+            else:
+                parts.append(f'<span class="lane__step">{esc(st)}</span>')
+            if si < len(steps) - 1:
+                parts.append('<span class="lane__arr" aria-hidden="true"></span>')
+        rows.append(f'      <div class="lane"><div class="lane__hd">{esc(hd)}</div>'
+                    f'<div class="lane__body">' + ''.join(parts) + '</div></div>')
+    body = '    <div class="stack rv gap-3">\n' + '\n'.join(rows) + '\n    </div>\n'
+    return wrap(i, 'lane', body, sec, ' band--fit')
+
+
+def r_timeline(i, sec):
+    items = []
+    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 ''
+        else:
+            lab, name, desc, state = ph.get('label', ''), ph.get('name', ''), ph.get('d', ''), ph.get('s', '')
+        cls = 'tl__i'
+        if state == 'done':
+            cls += ' tl__i--done'
+        elif state == 'now':
+            cls += ' tl__i--now'
+        items.append(
+            f'        <div class="{cls}"><div class="tl__d"></div>'
+            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)
+
+
+def r_steps(i, sec):
+    items = []
+    for si, st in enumerate((sec.get('steps') or [])[:6]):
+        if isinstance(st, (list, tuple)):
+            t, d = (list(st) + ['', ''])[:2]
+            acc = False
+        else:
+            t, d, acc = st.get('t', ''), st.get('d', ''), bool(st.get('accent'))
+        cls = 'step step--a' if acc else 'step'
+        items.append(f'      <div class="{cls}"><div class="step__n">{si + 1:02d}</div>'
+                     f'<div class="step__t">{esc(t)}</div><div class="step__d">{cite(d)}</div></div>')
+    body = '    <div class="steps rv">\n' + '\n'.join(items) + '\n    </div>\n'
+    return wrap(i, 'steps', body, sec)
+
+
+def r_heatmap(i, sec):
+    rows, cols, cells = sec.get('rowHeads') or [], sec.get('colHeads') or [], sec.get('cells') or []
+    body = f'    <div class="heat rv" style="--heat-cols:{max(1, len(cols))}"><div class="heat__grid">\n'
+    body += '      <div></div>' + ''.join(f'<div class="heat__h">{esc(c)}</div>' for c in cols) + '\n'
+    for ri, rh in enumerate(rows):
+        body += f'      <div class="heat__rh">{esc(rh)}</div>'
+        row = cells[ri] if ri < len(cells) else []
+        for ci in range(len(cols)):
+            v = row[ci] if ci < len(row) else ''
+            body += f'<div class="heat__c">{esc(v)}</div>'
+        body += '\n'
+    body += '    </div></div>\n'
+    return wrap(i, 'heatmap', body, sec)
+
+
+def r_bullet(i, sec):
+    items = sec.get('items') or []
+    rows = []
+    for it in items:
+        if isinstance(it, (list, tuple)):
+            k, a, t = (list(it) + ['', 0, 0])[:3]
+        else:
+            k, a, t = it.get('k', ''), it.get('a', 0), it.get('t', 0)
+        mx = float(sec.get('max') or 100) or 100
+        fw = max(0, min(100, float(a or 0) / mx * 100))
+        tw = max(0, min(100, float(t or 0) / mx * 100))
+        rows.append(
+            f'      <div class="bul__row"><div class="bul__k">{esc(k)}</div>'
+            f'<div class="bul__track"><div class="bul__fill" style="width:{fw}%"></div>'
+            f'<div class="bul__tgt" style="left:{tw}%"></div></div>'
+            f'<div class="bul__v"><b>{esc(a)}</b> / {esc(t)}</div></div>')
+    body = '    <div class="bul rv">\n' + '\n'.join(rows) + '\n    </div>\n'
+    return wrap(i, 'bullet', body, sec)
+
+
+def r_pyramid(i, sec):
+    levels = sec.get('levels') or []
+    n = max(1, len(levels))
+    rows = []
+    for i2, lv in enumerate(levels):
+        if isinstance(lv, (list, tuple)):
+            t, d = (list(lv) + ['', ''])[:2]
+        else:
+            t, d = lv.get('t', ''), lv.get('d', '')
+        w = 40 + int(60 * (i2 + 1) / n)
+        rows.append(f'      <div class="pyr__lvl" style="--w:{w}%">'
+                    f'<div class="pyr__t">{esc(t)}</div><div class="pyr__d">{cite(d)}</div></div>')
+    body = '    <div class="pyr rv">\n' + '\n'.join(rows) + '\n    </div>\n'
+    return wrap(i, 'pyramid', body, sec)
+
+
+def r_halftable(i, sec):
+    """半表半图：g-half 左表右图（校验 TYPE_FEATURE.halftable）。"""
+    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)
+    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'
+        '    </div>\n')
+    return wrap(i, 'halftable', body, sec)
+
+
+def r_matrix(i, sec):
+    rows, cols, cells = sec.get('rowHeads') or [], sec.get('colHeads') or [], sec.get('cells') or []
+    body = f'    <div class="matrix heat rv" style="--heat-cols:{max(1, len(cols))}"><div class="heat__grid">\n'
+    body += '      <div></div>' + ''.join(f'<div class="heat__h">{esc(c)}</div>' for c in cols) + '\n'
+    for ri, rh in enumerate(rows):
+        body += f'      <div class="heat__rh">{esc(rh)}</div>'
+        row = cells[ri] if ri < len(cells) else []
+        for ci in range(len(cols)):
+            v = row[ci] if ci < len(row) else ''
+            if isinstance(v, dict):
+                v = v.get('t') or v.get('v') or ''
+            body += f'<div class="heat__c">{esc(v)}</div>'
+        body += '\n'
+    body += '    </div></div>\n'
+    return wrap(i, 'matrix', body, sec)
+
+
+def r_info(i, sec):
+    t = sec.get('type') or 'sankey'
+    body = (f'    <div class="fig rv"><div class="fig__cap">{esc(t)} 信息图</div>\n'
+            f'      <svg class="chart" data-chart="{esc(t)}" viewBox="0 0 900 400">\n'
+            f'        <text x="450" y="200" text-anchor="middle" class="f-txt3">{esc(t)} · 按 infographics 规格绘制</text>\n'
+            f'      </svg>\n    </div>\n')
+    return wrap(i, t, body, sec)
+
+
+RENDERERS = {
+    'points': r_points, 'metrics': r_metrics, 'kpi': r_kpi, 'table': r_table,
+    'bar': r_bar, 'donut': r_donut, 'exhibit': r_exhibit, 'twocol': r_twocol,
+    'threecol': r_threecol, 'cards': r_cards, 'split': r_split, 'comparison': r_comparison,
+    'quote': r_quote, 'image': r_image, 'diagram': r_diagram, 'lane': r_lane,
+    'timeline': r_timeline, 'steps': r_steps, 'heatmap': r_heatmap, 'bullet': r_bullet,
+    'pyramid': r_pyramid, 'halftable': r_halftable, 'matrix': r_matrix,
+    'sankey': r_info, 'treemap': r_info, 'boxplot': r_info, 'network': r_info,
+    'marimekko': r_info, 'streamgraph': r_info,
+}
+
+
+def render_body(model: dict) -> str:
+    parts = []
+    # 封面
+    parts.append(f'''<!-- 封面 -->
+<section class="band band--fit" id="cover">
+  <div class="wrap">
+    <div class="shead rv">
+      <div class="t-eyebrow">{esc(model.get("meta") or "")}</div>
+      <h1 class="t-display shead__title">{esc(model.get("title") or "")}</h1>
+      <p class="t-lead shead__desc">{esc(model.get("subtitle") or "")}</p>
+    </div>
+  </div>
+</section>''')
+    agenda = model.get('agenda') or []
+    secs = [s for s in (model.get('sections') or []) if isinstance(s, dict)]
+    # Agenda 与 sections 对齐：模型 agenda 缺失/条数不符时以 sections 为准（并回写模型）
+    if len(agenda) != len(secs):
+        model['agenda'] = [[f'{i:02d}', s.get('title') or '', s.get('eyebrow') or '']
+                           for i, s in enumerate(secs, 1)]
+        agenda = model['agenda']
+    if agenda or not (model.get('mode') == 'architecture' and len(secs) <= 4):
+        lis = []
+        for i, s in enumerate(secs, 1):
+            ag = agenda[i - 1] if i - 1 < len(agenda) else [f'{i:02d}', s.get('title') or '', s.get('eyebrow') or '']
+            num = ag[0] if isinstance(ag, (list, tuple)) and ag else f'{i:02d}'
+            title = ag[1] if isinstance(ag, (list, tuple)) and len(ag) > 1 else (s.get('title') or '')
+            desc = ag[2] if isinstance(ag, (list, tuple)) and len(ag) > 2 else (s.get('eyebrow') or '')
+            lis.append(
+                f'      <li class="agenda__i"><a class="agenda__a" href="#s{i}">'
+                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>')
+        parts.append(f'''<section class="band band--top" id="agenda">
+  <div class="wrap">
+    <div class="shead rv"><div class="t-eyebrow">目录</div>
+      <h2 class="t-h1 shead__title">报告大纲</h2></div>
+    <ol class="agenda rv">{''.join(lis)}</ol>
+  </div>
+</section>''')
+    ex_n = 0
+    for i, sec in enumerate(secs, 1):
+        t = (sec.get('type') or 'points').lower()
+        is_research_exhibit = (model.get('mode') == 'research'
+                               and t in ('exhibit', 'bar', 'halftable', 'donut'))
+        if is_research_exhibit:
+            ex_n += 1
+            sec = dict(sec)
+            sec['exhibitNo'] = ex_n
+        fn = RENDERERS.get(t, r_points)
+        if is_research_exhibit:
+            fn = r_exhibit
+        try:
+            parts.append(fn(i, sec))
+        except Exception as e:
+            parts.append(wrap(i, t, f'    <p class="t-body">渲染失败 {esc(e)}</p>', sec))
+    closing = model.get('closing') or {}
+    cpts = closing.get('points') or []
+    body = '    <div class="grid g-3 rv a-start">\n' + pts_list(cpts) + '\n    </div>\n'
+    parts.append(f'''<section class="band band--accent" id="closing">
+  <div class="wrap">
+    <div class="shead rv"><div class="t-eyebrow">下一步</div>
+      <h2 class="t-h1 shead__title">{esc(closing.get("title") or "收尾")}</h2></div>
+{body}  </div>
+</section>''')
+    # 参考资料
+    refs = []
+    all_text = json.dumps(model, ensure_ascii=False)
+    for n in sorted({int(x) for x in re.findall(r'\[(\d+)\]', all_text)}):
+        refs.append(f'      <li id="ref-{n}">[{n}] 来源名称，时间；口径。</li>')
+    parts.append(f'''<section class="band band--flow" id="refs">
+  <div class="wrap">
+    <div class="shead rv"><div class="t-eyebrow">附录</div>
+      <h2 class="t-h1 shead__title">参考资料</h2></div>
+    <ol class="refs">{''.join(refs) or '<li>（无外部引用）</li>'}</ol>
+  </div>
+</section>''')
+    return '\n\n'.join(parts)
+
+
+def load_model(path: Path) -> dict:
+    txt = path.read_text(encoding='utf-8')
+    if path.suffix.lower() == '.json':
+        return json.loads(txt)
+    m = re.search(r'window\.REPORT_MODEL\s*=\s*(\{[\s\S]*?\})\s*;', txt)
+    if not m:
+        raise SystemExit('未找到 window.REPORT_MODEL')
+    return json.loads(m.group(1))
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description='从 REPORT_MODEL 渲染 HTML 正文（模型驱动生成）')
+    ap.add_argument('src', help='model.json 或含 REPORT_MODEL 的 .html')
+    ap.add_argument('--template', help='模式模板名 presentation|research|architecture 或路径')
+    ap.add_argument('--out', help='输出 HTML')
+    ap.add_argument('--inplace', action='store_true', help='就地替换 src 的 CONTENT 区')
+    ap.add_argument('--body-only', action='store_true', help='只打印正文片段')
+    args = ap.parse_args()
+
+    src = Path(args.src)
+    model = load_model(src)
+    body = render_body(model)
+
+    if args.body_only:
+        sys.stdout.write(body)
+        return 0
+
+    if args.inplace:
+        t = src.read_text(encoding='utf-8')
+        if not CONTENT_RE.search(t):
+            print('错误：--inplace 需要 __TOPPPT_CONTENT__ 标记', file=sys.stderr)
+            return 2
+        t = CONTENT_RE.sub(
+            r'\1\n' + body.replace('\\', '\\\\') + r'\n\2', t, count=1)
+        # 同步模型（确保与渲染源一致）
+        t = MODEL_RE.sub('window.REPORT_MODEL = ' +
+                         json.dumps(model, ensure_ascii=False, indent=2) + ';', t, count=1)
+        src.write_text(t, encoding='utf-8')
+        print(f'已按模型重渲染正文：{src}（{len(body)} 字符）')
+        print(f'  下一步: python scripts/validate_report.py "{src}" --strict')
+        return 0
+
+    mode = model.get('mode') or 'presentation'
+    tpl = args.template or mode
+    tpl_path = Path(tpl) if Path(tpl).exists() else TPL / f'{tpl}.html'
+    if not tpl_path.exists():
+        print(f'错误：模板不存在 {tpl_path}', file=sys.stderr)
+        return 2
+    t = tpl_path.read_text(encoding='utf-8')
+    if not CONTENT_RE.search(t):
+        print('错误：模板缺少 CONTENT 标记', file=sys.stderr)
+        return 2
+    t = CONTENT_RE.sub(r'\1\n' + body.replace('\\', '\\\\') + r'\n\2', t, count=1)
+    t = MODEL_RE.sub('window.REPORT_MODEL = ' +
+                     json.dumps(model, ensure_ascii=False, indent=2) + ';', t, count=1)
+    out = Path(args.out or (src.with_suffix('.html')))
+    out.write_text(t, encoding='utf-8')
+    print(f'已从模型生成：{out}  sections={len(model.get("sections") or [])}')
+    print(f'  下一步: python scripts/validate_report.py "{out}" --strict')
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())