@lark-apaas/coding-steering 0.1.31 → 0.1.32-beta.0

package/steering/design-html/skills/pptx-style-extract/scripts/draft.py

@@ -0,0 +1,945 @@
+#!/usr/bin/env python3
+"""S15 草案生成器：把阶段一产物机械推导成「判断单草案 + 一页简报 + 候选联系表」。
+
+    python3 draft.py <stage1-outdir>
+
+产出 <stage1-outdir>/l-out/：
+    BRIEF.md          唯一必读简报：事实 + 草案依据 + 待判断清单
+    contact-sheet.png 候选图拼版（带编号，一次看完所有图）
+    manifest.yaml / frontmatter.yaml / layouts.yaml / body.md   四件草案，可直接进 package.py
+
+草案里所有数值都来自 extract.json；凡是需要「像人一样看」才能定的，写成 `TODO:` 行
+（package.py 见 TODO 即 FAIL），由 L 层改掉。
+"""
+import argparse
+import json
+import os
+import re
+import shutil
+import sys
+from collections import Counter, defaultdict
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+SKILL_ROOT = os.path.dirname(HERE)
+SYS_FALLBACK = '"PingFang SC", "Microsoft YaHei", sans-serif'
+
+
+# ---------------------------------------------------------------- 小工具
+def hex2rgb(h):
+    h = h.lstrip('#')
+    return tuple(int(h[i:i + 2], 16) for i in (0, 2, 4))
+
+
+def lum(rgb):
+    return (0.2126 * rgb[0] + 0.7152 * rgb[1] + 0.0722 * rgb[2]) / 255.0
+
+
+def satu(rgb):
+    mx, mn = max(rgb), min(rgb)
+    return 0.0 if mx == 0 else (mx - mn) / mx
+
+
+def slide_no(part):
+    m = re.search(r'slide(\d+)\.xml$', part)
+    return int(m.group(1)) if m else 9999
+
+
+def walk_sz(node, out):
+    if isinstance(node, dict):
+        if 'sz_px' in node and isinstance(node['sz_px'], (int, float)):
+            out.append(node['sz_px'])
+        for v in node.values():
+            walk_sz(v, out)
+    elif isinstance(node, list):
+        for v in node:
+            walk_sz(v, out)
+
+
+def shape_sz(s):
+    out = []
+    walk_sz(s.get('text') or {}, out)
+    walk_sz(s.get('lstStyle') or {}, out)
+    return max(out) if out else 0.0
+
+
+def shape_text(s, limit=24):
+    buf = []
+    for p in (s.get('text') or {}).get('paragraphs', []):
+        for r in p.get('runs', []):
+            t = (r.get('text') or '').strip()
+            if t:
+                buf.append(t)
+    txt = ' '.join(buf).replace('\n', ' ')
+    return txt[:limit]
+
+
+def q(v):
+    """写进 YAML 的标量：需要引号的加引号。"""
+    s = str(v)
+    if s and (s[0] in '#{[&*!|>%@`"\'' or ': ' in s or s.strip() != s):
+        return '"%s"' % s.replace('"', '\\"')
+    return s
+
+
+# ---------------------------------------------------------------- 颜色
+def draft_colors(d):
+    pool = [c for c in d['color_freq']
+            if c.get('class') == 'design' and abs((c.get('alpha') or 100) - 100) < 0.1]
+    seen, rows = set(), []
+    for c in pool:
+        h = c['hex'].upper()
+        if h in seen:
+            continue
+        seen.add(h)
+        rgb = hex2rgb(h)
+        rows.append({'hex': h, 'n': c['n'], 'lum': lum(rgb), 'sat': satu(rgb)})
+    rows.sort(key=lambda r: -r['n'])
+
+    tokens, used = [], set()
+
+    def take(pred, names):
+        for name in names:
+            for r in rows:
+                if r['hex'] in used or not pred(r):
+                    continue
+                used.add(r['hex'])
+                tokens.append((name, r))
+                break
+
+    take(lambda r: r['lum'] > 0.85 and r['sat'] < 0.15, ['surface', 'surface-alt'])
+    take(lambda r: r['lum'] < 0.32 and r['sat'] < 0.25, ['ink', 'ink-muted'])
+    take(lambda r: r['sat'] >= 0.35, ['primary', 'accent', 'accent-2', 'accent-3'])
+    take(lambda r: r['sat'] < 0.35, ['neutral'])
+    # 未取用但高频的留给 BRIEF 展示
+    rest = [r for r in rows if r['hex'] not in used][:6]
+    return tokens, rest, rows
+
+
+# ---------------------------------------------------------------- 字体
+def parse_fallback_table():
+    path = os.path.join(SKILL_ROOT, 'font-fallback.yaml')
+    if not os.path.exists(path):
+        return []
+    fams, cur = [], None
+    for line in open(path, encoding='utf-8'):
+        m = re.match(r'\s*-\s*family:\s*(.+)', line)
+        if m:
+            cur = {'family': m.group(1).strip(), 'match': [], 'fallback': [], 'category': ''}
+            fams.append(cur)
+            continue
+        if cur is None:
+            continue
+        m = re.match(r'\s*(match|fallback):\s*\[(.*)\]', line)
+        if m:
+            cur[m.group(1)] = [x.strip().strip('"\'') for x in m.group(2).split(',') if x.strip()]
+        m = re.match(r'\s*category:\s*(.+)', line)
+        if m:
+            cur['category'] = m.group(1).strip()
+    return fams
+
+
+def norm(s):
+    return re.sub(r'[\s\-_]', '', s or '').lower()
+
+
+def draft_fonts(d):
+    table = parse_fallback_table()
+    groups = defaultdict(lambda: {'rendered': 0, 'weights': set(), 'names': set(), 'bold': 0})
+    for f in d['font_families']:
+        if not f.get('rendered_n'):
+            continue
+        key = f.get('alias_group') or f['family']
+        g = groups[key]
+        g['rendered'] += f['rendered_n']
+        g['names'].add(f['family'])
+        g['bold'] += f.get('bold_runs') or 0
+        for v in f.get('variants', []):
+            if v.get('weight'):
+                g['weights'].add(v['weight'])
+    ranked = sorted(groups.items(), key=lambda kv: -kv[1]['rendered'])
+
+    def resolve(names):
+        for n in names:
+            for fam in table:
+                for m in fam['match']:
+                    if norm(m) == norm(n) or norm(m) in norm(n) or norm(n) in norm(m):
+                        return fam
+        return None
+
+    out = []
+    for key, g in ranked[:4]:
+        fam = resolve(sorted(g['names'], key=len))
+        stack = [sorted(g['names'], key=len)[0]]
+        if fam:
+            stack += [x for x in fam['fallback'] if x not in stack]
+        out.append({
+            'key': key, 'rendered': g['rendered'], 'names': sorted(g['names']),
+            'weights': sorted(g['weights']) or ([600] if g['bold'] else [400]),
+            'stack': stack, 'mapped': fam['family'] if fam else None,
+            'category': fam['category'] if fam else '',
+        })
+    return out
+
+
+def font_css(stack):
+    return ', '.join('"%s"' % s for s in stack) + ', ' + SYS_FALLBACK
+
+
+MIRROR = 'https://miaoda.feishu.cn/fonts/css2'
+
+
+def import_line(fonts):
+    """降级链里用到的镜像字体拼成一行 @import（check_v1 硬要求）。"""
+    webs = []
+    for f in fonts[:2]:
+        for name in f['stack'][1:]:
+            if name not in webs:
+                webs.append(name)
+    if not webs:
+        webs = ['Noto Sans SC']
+    fam = '&'.join('family=%s:wght@400' % w.replace(' ', '+') for w in webs)
+    return "@import url('%s?%s&display=swap');" % (MIRROR, fam), webs
+
+
+def draft_anchors(d, tokens, fonts, roles, assets, archetypes):
+    names = [t[0] for t in tokens]
+    chroma = [n for n in names if n.startswith(('primary', 'accent'))]
+    radii = d.get('radii_census') or []
+    zero = next((r for r in radii if r['px'] == 0), None)
+    total_r = sum(r['n'] for r in radii) or 1
+    geom = d.get('geom_census') or {}
+    eff = d.get('effects_census') or {}
+    A = []
+    if chroma:
+        A.append((chroma[0] + '-led-palette', 'token',
+                  '表达色只有 %s 这一组，其余全是中性底与墨色，见 colors' % '、'.join(chroma[:3])))
+    if zero and zero['n'] >= total_r * 0.7:
+        A.append(('zero-radius', 'token', '卡片、按钮、面板一律直角，圆角量在全 deck 压倒性为零'))
+    if any(a['kind'] == 'background' for a in assets):
+        A.append(('full-bleed-ground', 'pattern', '每页由整幅铺满的底图打底，元素浮在图上而不是浮在纯色块上'))
+    if any(a['kind'] == 'logo' for a in assets):
+        A.append(('corner-locked-logo', 'component', '品牌标识固定在同一角位，跨页不移动、不缩放'))
+    if geom.get('gradient_fills'):
+        A.append(('gradient-accent', 'pattern', '强调元素靠线性渐变承载，而不是纯色块'))
+    if len(fonts) >= 2:
+        A.append(('dual-family-typesetting', 'token', '中文与拉丁数字分属两套字族，同一行里混排'))
+    if eff.get('outerShdw'):
+        A.append(('soft-shadow-card', 'component', '卡片靠极浅外阴影托起，不用描边分隔'))
+    disp, body = roles.get('display'), roles.get('body')
+    if disp and body and disp['sz_px'] >= body['sz_px'] * 3:
+        A.append(('size-driven-hierarchy', 'pattern', '层级靠字号跨度拉开而不是字重，展示档与正文档差出数倍'))
+    A.append(('archetype-reuse', 'pattern', '全 deck 只用 %d 种页型反复排列，版面骨架高度复用' % len(archetypes)))
+    A.append(('safe-area-discipline', 'token', '正文一律落在统一安全区内，不贴画布边'))
+    seen, out = set(), []
+    for a in A:
+        if a[0] in seen:
+            continue
+        seen.add(a[0])
+        out.append(a)
+    return out[:8]
+
+
+# ---------------------------------------------------------------- 字号轴
+def draft_scale(d, archetypes=()):
+    ts = [t for t in d['text_scale'] if t['sz_px'] >= 10]
+    ts.sort(key=lambda t: -t['sz_px'])
+    if not ts:
+        return {}
+    by_px = {t['sz_px']: t for t in ts}
+    # display 优先取「真的当标题用过」的字号（archetype 首槽），而不是全局最大值
+    title_sz = Counter(s['sz'] for a in archetypes for s in a['slots'] if s['type'] == 'title')
+    display = by_px.get(max(title_sz)) if title_sz else None
+    big = [t for t in ts if t['n'] >= 2] or ts
+    display = display or big[0]
+    body_pool = [t for t in ts if t['sz_px'] <= 48]
+    body = max(body_pool, key=lambda t: t['n']) if body_pool else ts[-1]
+    heading_pool = [t for t in ts if body['sz_px'] * 1.3 <= t['sz_px'] < display['sz_px']]
+    heading = max(heading_pool, key=lambda t: t['n']) if heading_pool else None
+    small_pool = [t for t in ts if t['sz_px'] < body['sz_px']]
+    caption = max(small_pool, key=lambda t: t['n']) if small_pool else None
+    roles = {'display': display, 'body': body}
+    if heading:
+        roles['heading'] = heading
+    if caption:
+        roles['caption'] = caption
+    return roles
+
+
+def lh_of(t):
+    lhm = t.get('line_height_mult') or {}
+    if not lhm:
+        return None
+    best = max(lhm.items(), key=lambda kv: kv[1])[0]
+    try:
+        v = float(best)
+    except ValueError:
+        return None
+    return v if 0.9 <= v <= 2.2 else None
+
+
+# ---------------------------------------------------------------- 资产
+def probe_image(path):
+    info = {'w': None, 'h': None, 'alpha_mean': None, 'near_blank': False}
+    try:
+        from PIL import Image
+    except Exception:
+        return info
+    try:
+        im = Image.open(path)
+        info['w'], info['h'] = im.size
+        if im.mode in ('RGBA', 'LA') or 'transparency' in im.info:
+            px = im.convert('RGBA').getchannel('A').resize((64, 64)).tobytes()
+            info['alpha_mean'] = sum(px) / len(px)
+            info['near_blank'] = info['alpha_mean'] < 13  # <5% 不透明度
+    except Exception:
+        pass
+    return info
+
+
+def copy_logo_candidates(outdir, logo_pool):
+    if not logo_pool:
+        return []
+    dst_dir = os.path.join(outdir, 'ref', 'logo-candidates')
+    os.makedirs(dst_dir, exist_ok=True)
+    rows = []
+    for rank, (score, c) in enumerate(sorted(logo_pool, key=lambda kv: (-kv[0], -kv[1]['n'])), 1):
+        src = os.path.join(outdir, c.get('out') or '')
+        if not os.path.exists(src):
+            continue
+        name = '%02d-score%s-%s' % (rank, score, c['file'])
+        dst = os.path.join(dst_dir, name)
+        shutil.copy2(src, dst)
+        b = c.get('box') or {}
+        rows.append({
+            'rank': rank,
+            'score': score,
+            'file': c['file'],
+            'copy': os.path.relpath(dst, outdir),
+            'slides': c.get('slides') or [],
+            'box': [round(b.get(k, 0)) for k in ('x', 'y', 'w', 'h')],
+            'used_n': c.get('n', 0),
+        })
+    if rows:
+        with open(os.path.join(dst_dir, 'index.json'), 'w', encoding='utf-8') as f:
+            json.dump(rows, f, ensure_ascii=False, indent=2)
+            f.write('\n')
+    return rows
+
+
+def draft_assets(d, outdir, bg_needed=(), cover_media=None, bg_under=None):
+    imgs = {i['media']: i for i in d['images']}
+    cluster_of = {}
+    for c in d.get('media_clusters', []):
+        for m in c['members']:
+            cluster_of[m] = c['content_id']
+
+    cands = []
+    for m in d['media']:
+        if not m.get('exported'):
+            continue
+        img = imgs.get(m['media'], {})
+        out_rel = m.get('out') or ''
+        probe = probe_image(os.path.join(outdir, out_rel)) if out_rel else {}
+        boxes = img.get('boxes') or []
+        top = max(boxes, key=lambda b: b.get('count', 0)) if boxes else {}
+        parts = top.get('parts') or []
+        slides = sorted({slide_no(p) for p in parts if '/slides/' in p})
+        cands.append({
+            'media': m['media'], 'file': os.path.basename(out_rel), 'out': out_rel,
+            'bytes': m.get('bytes'), 'n': img.get('n', m.get('used_n', 0)),
+            'fullscreen': bool(img.get('fullscreen')), 'w_pct': img.get('max_w_pct', 0),
+            'box': top.get('box') or {}, 'slides': slides,
+            'layer_only': bool(parts) and not slides,
+            'repeat': bool(img.get('repeat_fixed')),
+            'cluster': cluster_of.get(m['media']),
+            'probe': probe, 'reasons': m.get('reasons', []),
+        })
+
+    # 同素材簇去重：留 n 最大的一张
+    best_of = {}
+    for c in cands:
+        k = c['cluster'] or c['media']
+        if k not in best_of or c['n'] > best_of[k]['n']:
+            best_of[k] = c
+    kept = sorted(best_of.values(), key=lambda c: (-c['n'], -(c['bytes'] or 0)))
+
+    assets, rejected, todos = [], [], []
+    logo_pool = []
+    bg_under = bg_under or {}
+    bg_i = 0
+    canvas_w = d['canvas']['px'][0]
+    for c in kept:
+        if c['probe'].get('near_blank'):
+            rejected.append((c, '近全透明（alpha 均值 %.0f/255），PPT 里看不见' % c['probe']['alpha_mean']))
+            continue
+        if c['fullscreen']:
+            if c['media'] == cover_media:
+                assets.append({'id': 'bg-cover', 'kind': 'background', 'role': 'cover',
+                               'src': c, 'use_full': True})
+            elif c['media'] in bg_needed and bg_i < 5:
+                bg_i += 1
+                assets.append({'id': 'bg-content-%d' % bg_i, 'kind': 'background',
+                               'role': 'content', 'src': c, 'use_full': False})
+            else:
+                rejected.append((c, '满屏图但没有页面以它为主底（只在版式层备用）'))
+        elif c['w_pct'] < 30 and c['n'] >= 2:
+            b = c['box']
+            score = 0
+            score += 3 if b.get('y', 999) < 160 else (1 if b.get('y', 0) > canvas_w * 0.5 else 0)
+            score += 2 if b.get('x', 999) < 200 or b.get('x', 0) > canvas_w * 0.7 else 0
+            ar = (b.get('w') or 1) / max(b.get('h') or 1, 1)
+            score += 1 if 1.0 <= ar <= 8.0 else 0
+            score += 1 if c['n'] >= 2 else 0
+            logo_pool.append((score, c))
+        else:
+            rejected.append((c, '内容区图片（占宽 %.0f%%，出现 %d 次）' % (c['w_pct'], c['n'])))
+
+    def on_bg_of(c):
+        """logo 压在浅底还是深底：直接采底图上它那块区域的亮度，不用人判。"""
+        bg = bg_under.get(c['slides'][0]) if c['slides'] else None
+        row = next((m for m in d['media'] if m['media'] == bg and m.get('out')), None)
+        if not row:
+            return None
+        try:
+            from PIL import Image
+            im = Image.open(os.path.join(outdir, row['out'])).convert('RGB')
+            b = c['box']
+            sx, sy = im.width / float(canvas_w), im.height / float(d['canvas']['px'][1])
+            crop = im.crop((int(b.get('x', 0) * sx), int(b.get('y', 0) * sy),
+                            max(int((b.get('x', 0) + b.get('w', 1)) * sx), 1),
+                            max(int((b.get('y', 0) + b.get('h', 1)) * sy), 1))).resize((16, 16))
+            raw = crop.tobytes()
+            px = [raw[i:i + 3] for i in range(0, len(raw), 3)]
+            return 'light' if sum(lum(p) for p in px) / len(px) > 0.55 else 'dark'
+        except Exception:
+            return None
+
+    logo_pool.sort(key=lambda kv: (-kv[0], -kv[1]['n']))
+    for i, (score, c) in enumerate(logo_pool):
+        b = c['box']
+        if i == 0 and score >= 5:
+            assets.append({'id': 'logo-primary', 'kind': 'logo', 'role': None, 'src': c,
+                           'use_full': False, 'on_bg': on_bg_of(c)})
+            todos.append('看联系表确认 `%s`（%.0fx%.0f @ %.0f,%.0f，出现 %d 次）真是品牌 logo；'
+                         '不是就把 manifest 的 logo-primary 换成别的候选或整条删掉'
+                         % (c['file'], b.get('w', 0), b.get('h', 0), b.get('x', 0), b.get('y', 0), c['n']))
+        else:
+            rejected.append((c, '重复小图（%.0fx%.0f @ %.0f,%.0f），logo 相似度低于首选'
+                             % (b.get('w', 0), b.get('h', 0), b.get('x', 0), b.get('y', 0))))
+
+    if not any(a['role'] == 'cover' for a in assets):
+        todos.append('没定出封面底图——从联系表挑一张补进 manifest（role: cover），或在 gaps 写明模板无封面主视觉')
+    copy_logo_candidates(outdir, logo_pool)
+    return assets, rejected, todos
+
+
+# ---------------------------------------------------------------- 版式聚类
+DECOR_MIN = 40.0
+
+
+def draft_layouts(d, outdir):
+    shapes = json.load(open(os.path.join(outdir, 'ref', 'shapes.json'), encoding='utf-8'))['shapes']
+    cW, cH = d['canvas']['px']
+    by_slide = defaultdict(list)
+    for s in shapes:
+        if s.get('layer') == 'slide':
+            by_slide[s['part']].append(s)
+
+    bg_of_slide, layout_of_slide = {}, {}
+    for s in d.get('slides', []):
+        bg = s.get('background')
+        bg_of_slide[s['part']] = json.dumps(bg, sort_keys=True) if isinstance(bg, dict) else bg
+        layout_of_slide[s['part']] = s.get('layout')
+    # 版式层的满屏底图（form=2 常态：底图挂在 layout 上）
+    bg_of_layout = {}
+    for s in shapes:
+        if (s.get('layer') == 'layout' and s.get('kind') == 'pic'
+                and s.get('w_pct', 0) >= 95 and s.get('h_pct', 0) >= 95):
+            bg_of_layout.setdefault(s['part'], s.get('media'))
+
+    pages = []
+    for part, sh in sorted(by_slide.items(), key=lambda kv: slide_no(kv[0])):
+        bg_media = None
+        for s in sh:
+            if s.get('kind') == 'pic' and s.get('w_pct', 0) >= 95 and s.get('h_pct', 0) >= 95:
+                bg_media = s.get('media')
+                break
+        if bg_media is None:
+            bg_media = bg_of_layout.get(layout_of_slide.get(part))
+        texts = []
+        for s in sh:
+            if s.get('kind') != 'sp':
+                continue
+            txt = shape_text(s)
+            if not txt:
+                continue
+            b = s.get('box') or {}
+            if b.get('w', 0) < DECOR_MIN or b.get('h', 0) < 16:
+                continue
+            texts.append({'sz': shape_sz(s), 'box': b, 'txt': txt})
+        texts.sort(key=lambda t: (-t['sz'], t['box'].get('y', 0)))
+        pics = [s for s in sh if s.get('kind') == 'pic' and s.get('w_pct', 0) < 95]
+        pages.append({'part': part, 'no': slide_no(part), 'bg_media': bg_media,
+                      'bg_color': bg_of_slide.get(part), 'texts': texts, 'pic_n': len(pics),
+                      'shape_n': len(sh)})
+
+    def kind_of(p):
+        n = len(p['texts'])
+        top = p['texts'][0]['sz'] if p['texts'] else 0
+        if p['no'] == 1:
+            return 'cover'
+        if n <= 3 and top >= 60:
+            return 'section'
+        if n >= 8 or p['pic_n'] >= 4:
+            return 'content-dense'
+        return 'content'
+
+    groups = defaultdict(list)
+    for p in pages:
+        groups[(p['bg_media'] or p['bg_color'] or 'none', kind_of(p))].append(p)
+
+    ranked = sorted(groups.items(), key=lambda kv: (-len(kv[1]), kv[1][0]['no']))
+    kept = [g for g in ranked if len(g[1]) >= 2 or g[0][1] == 'cover'][:8]
+    for g in ranked:                      # 名额没用满就把最大的孤例页也收进来
+        if len(kept) >= 8:
+            break
+        if g not in kept:
+            kept.append(g)
+    leftover = sorted(p['no'] for g in ranked if g not in kept for p in g[1])
+
+    archetypes = []
+    used = Counter()
+    for (bg_raw, kind), ps in kept:
+        rep = max(ps, key=lambda p: len(p['texts']))
+        used[kind] += 1
+        name = kind if used[kind] == 1 else '%s-%d' % (kind, used[kind])
+        # 标题按「位置 + 跨度」认，不按字号——巨号数值（21%、7,869）常比标题还大
+        band = [t for t in rep['texts']
+                if t['box'].get('y', 1e9) < cH * 0.28 and t['box'].get('w', 0) >= cW * 0.25]
+        title = max(band, key=lambda t: t['sz']) if band else (
+            max(rep['texts'], key=lambda t: t['sz']) if rep['texts'] else None)
+        rest = [t for t in rep['texts'] if t is not title]
+        rest.sort(key=lambda t: (t['box'].get('y', 0), t['box'].get('x', 0)))
+        ordered = ([title] if title else []) + rest
+        slots = []
+        for i, t in enumerate(ordered[:6]):
+            b = t['box']
+            if t is title:
+                role = typ = 'title'
+            elif (title and i == 1 and t['sz'] >= 28
+                  and abs(b.get('x', 0) - title['box'].get('x', 0)) < 120
+                  and 0 <= b.get('y', 0) - (title['box'].get('y', 0)
+                                            + title['box'].get('h', 0)) < 220):
+                role = typ = 'subtitle'
+            else:
+                role = typ = 'body'
+            slots.append({'role': role, 'box': [round(b.get('x', 0)), round(b.get('y', 0)),
+                                                round(b.get('w', 0)), round(b.get('h', 0))],
+                          'type': typ, 'sz': t['sz'], 'txt': t['txt']})
+        archetypes.append({'name': name, 'bg': None, 'bg_raw': bg_raw, 'slots': slots,
+                           'pages': sorted(p['no'] for p in ps), 'rep': rep['no'],
+                           'pic_n': rep['pic_n'],
+                           'confidence': 'high' if len(ps) >= 3 else
+                                         ('medium' if len(ps) == 2 else 'low')})
+    return archetypes, pages, leftover
+
+
+# ---------------------------------------------------------------- 联系表
+def layout_sheet(outdir, archetypes, path):
+    """把各 archetype 的代表页光栅出来拼成一张——版式命名得看得见页面。"""
+    reps = [a['rep'] for a in archetypes]
+    if not reps:
+        return None
+    import subprocess
+    r = subprocess.run([sys.executable, os.path.join(HERE, 'render_pages.py'), outdir,
+                        '--pages', 'slides', '--only', ','.join(map(str, reps)), '--no-html'],
+                       capture_output=True, text=True)
+    png_dir = os.path.join(outdir, 'ref', 'rebuild', 'png')
+    if r.returncode or not os.path.isdir(png_dir):
+        return None
+    try:
+        from PIL import Image, ImageDraw
+    except Exception:
+        return None
+    cols = 2 if len(archetypes) > 1 else 1
+    cw, ch, pad, lab = 480, 270, 16, 20
+    rows = (len(archetypes) + cols - 1) // cols
+    sheet = Image.new('RGB', (cols * (cw + pad) + pad, rows * (ch + pad + lab) + pad),
+                      (245, 245, 247))
+    dr = ImageDraw.Draw(sheet)
+    for i, a in enumerate(archetypes):
+        x = pad + (i % cols) * (cw + pad)
+        y = pad + (i // cols) * (ch + pad + lab)
+        f = os.path.join(png_dir, 'slide-%d.png' % a['rep'])
+        if os.path.exists(f):
+            im = Image.open(f).convert('RGB')
+            im.thumbnail((cw, ch))
+            sheet.paste(im, (x, y))
+        dr.rectangle([x, y, x + cw, y + ch], outline=(120, 120, 128))
+        dr.text((x + 2, y + ch + 5), '[%s]  slide %d  x%d pages  bg=%s'
+                % (a['name'], a['rep'], len(a['pages']), a.get('bg') or '-'),
+                fill=(20, 20, 24))
+    sheet.save(path, optimize=True)
+    return path
+
+
+def contact_sheet(outdir, cands, path):
+    try:
+        from PIL import Image, ImageDraw
+    except Exception:
+        return None
+    cell, pad, cols = 220, 20, 4
+    items = cands[:12]
+    if not items:
+        return None
+    rows = (len(items) + cols - 1) // cols
+    W = cols * (cell + pad) + pad
+    H = rows * (cell + pad + 18) + pad
+    sheet = Image.new('RGB', (W, H), (245, 245, 247))
+    dr = ImageDraw.Draw(sheet)
+    for idx, c in enumerate(items):
+        x = pad + (idx % cols) * (cell + pad)
+        y = pad + (idx // cols) * (cell + pad + 18)
+        # 棋盘格底，透明区看得见
+        for gy in range(0, cell, 16):
+            for gx in range(0, cell, 16):
+                if (gx // 16 + gy // 16) % 2 == 0:
+                    dr.rectangle([x + gx, y + gy, x + gx + 15, y + gy + 15], fill=(214, 214, 218))
+        try:
+            im = Image.open(os.path.join(outdir, c['out'])).convert('RGBA')
+            im.thumbnail((cell, cell))
+            sheet.paste(im, (x + (cell - im.width) // 2, y + (cell - im.height) // 2), im)
+        except Exception:
+            dr.text((x + 8, y + 8), 'unreadable', fill=(200, 0, 0))
+        dr.rectangle([x, y, x + cell, y + cell], outline=(120, 120, 128))
+        dr.text((x + 2, y + cell + 4), '[%d] %s  %dx%d  used=%d'
+                % (idx + 1, c['file'], c['probe'].get('w') or 0, c['probe'].get('h') or 0, c['n']),
+                fill=(20, 20, 24))
+    sheet.save(path, optimize=True)
+    return path
+
+
+# ---------------------------------------------------------------- 落盘
+def write(p, s):
+    with open(p, 'w', encoding='utf-8') as f:
+        f.write(s)
+
+
+def emit_manifest(d, assets, ldir):
+    L = ['version: alpha',
+         'name: TODO-style-name        # 英文 kebab，体现气质，不要用文件名',
+         'name_zh: TODO中文名',
+         'description: >',
+         '  TODO: 一句话说清这套模板的视觉性格（底色 / 主色 / 字形 / 版面骨架），给消费模型定调。']
+    themes = d['theme_topology'].get('themes') or ['single']
+    if themes != ['single'] and len(themes) > 1:
+        L += ['themes: [%s]' % ', '.join(themes), 'default-theme: %s' % themes[0]]
+    if assets:
+        L.append('assets:')
+        for a in assets:
+            L.append('  - id: %s' % a['id'])
+            L.append('    source_media: %s' % a['src']['file'])
+            L.append('    kind: %s' % a['kind'])
+            if a['role']:
+                L.append('    role: %s' % a['role'])
+            if a['kind'] in ('logo', 'slogan'):
+                L.append('    on-bg: %s' % (a.get('on_bg') or 'light'))
+            if a['use_full']:
+                L.append('    use_full: true')
+    write(os.path.join(ldir, 'manifest.yaml'), '\n'.join(L) + '\n')
+
+
+def emit_frontmatter(d, tokens, fonts, roles, anchors, gaps, ldir):
+    L = ['colors:']
+    for name, r in tokens:
+        L.append('  %s: "%s"' % (name, r['hex']))
+    body_font = fonts[1] if len(fonts) > 1 else (fonts[0] if fonts else None)
+    disp_font = fonts[0] if fonts else None
+    if disp_font:
+        L.append('typography:')
+        L.append("  fontFamily: '%s'" % font_css(disp_font['stack']))
+        if body_font and body_font is not disp_font:
+            L.append("  bodyFontFamily: '%s'" % font_css(body_font['stack']))
+        for role, t in roles.items():
+            lh = lh_of(t)
+            L.append('  %s: {fontSize: %dpx%s}' % (
+                role, round(t['sz_px']), ', lineHeight: %s' % lh if lh else ''))
+    sp = d.get('spacing_candidates') or {}
+    pads = sp.get('paddings') or []
+    edge = {}
+    for p in pads:
+        edge.setdefault(p['edge'], p['px'])
+    if edge:
+        L.append('spacing:')
+        L.append('  page-padding: {top: %s, right: %s, bottom: %s, left: %s}'
+                 % (edge.get('top', 73), edge.get('right', 90),
+                    edge.get('bottom', 95), edge.get('left', 90)))
+    radii = [r for r in (d.get('radii_census') or []) if r['px'] >= 2 and r['n'] >= 6]
+    if radii:
+        top = max(radii, key=lambda r: r['n'])
+        L.append('rounded:')
+        L.append('  card: %dpx' % round(top['px']))
+    L.append('safe-area:')
+    L.append('  content: {top: %s, right: %s, bottom: %s, left: %s, applies-to: [content]}'
+             % (edge.get('top', 73), edge.get('right', 90), edge.get('bottom', 95), edge.get('left', 90)))
+    L.append('  confidence: medium')
+    L.append('anchors:')
+    for aid, typ, desc in anchors:
+        L.append('  - {id: %s, type: %s, desc: "%s"}' % (aid, typ, desc))
+    L.append('gaps:')
+    for g in gaps:
+        L.append('  - "%s"' % g)
+    write(os.path.join(ldir, 'frontmatter.yaml'), '\n'.join(L) + '\n')
+
+
+def emit_layouts(archetypes, ldir):
+    L = ['# 只改 names 这一段：给每个页型起表意的中文名（看 layout-sheet.png）。下面 layouts 段不要动。',
+         'names:']
+    for a in archetypes:
+        L.append('  %s: TODO中文名（代表页 %s，共 %d 页）' % (a['name'], a['rep'], len(a['pages'])))
+    L.append('layouts:')
+    for a in archetypes:
+        L.append('  %s:' % a['name'])
+        L.append('    role: %s' % a['name'].split('-')[0])
+        if a['bg']:
+            L.append('    background: %s' % a['bg'])
+            L.append('    text_safe: TODO安全文字区[x,y,w,h]，按背景主体避让后填写')
+            L.append('    avoid: TODO禁放区列表；无禁放区写 []，有则写 [{box: [x,y,w,h], reason: "..."}]')
+            L.append('    pairing_rule: "TODO说明该页型必须配这张背景时，标题/正文/图表需要避让哪些区域"')
+        L.append('    slots:')
+        for s in a['slots']:
+            L.append('      - {role: %s, box: %s, type: %s}' % (s['role'], s['box'], s['type']))
+        L.append('    confidence: %s' % a.get('confidence', 'medium'))
+    write(os.path.join(ldir, 'layouts.yaml'), '\n'.join(L) + '\n')
+
+
+def emit_body(d, tokens, fonts, roles, assets, archetypes, exceptions, ldir):
+    canvas = d['canvas']['px']
+    cover = next((a for a in assets if a['id'] == 'bg-cover'), None)
+    logo = next((a for a in assets if a['kind'] == 'logo'), None)
+    content_bgs = [a['id'] for a in assets
+                   if a.get('kind') == 'background' and a.get('role') == 'content']
+    key_assets = []
+    for a in assets[:8]:
+        role = a.get('role') or a.get('kind')
+        key_assets.append('`%s` -> `%s` (%s)' % (a['id'], a.get('out_rel') or a['id'], role))
+
+    L = ['## Agent Fast Path', '',
+         '消费本风格时先读这一节；它是给生成 Agent 的短路径，目标是把风格理解控制在 1 分钟内，避免把审计材料重新理解一遍。',
+         '',
+         '- **时间预算**：风格导入最多做 1 次 `read_file design.md`；如需坐标，最多再读 1 次 `layouts.md`。完成这两步后必须直接开始生成，不要再探索风格包。',
+         '- **只读入口**：常规生成只需要 `design.md`；需要坐标时再打开 `layouts.md`。',
+         '- **附件/zip 兜底**：如果当前内容来自 zip 附件的文本摘要，直接使用摘要中 `design.md` / `layouts.md` 的文本；不要尝试修复 zip、解析二进制、搜索附件目录或重建压缩包。',
+         '- **禁止动作**：不要读取 `ref/color-freq-raw.json`、`ref/font-clusters.json`、`ref/extract.json`、`ref/rebuild/`、`ref/rebuild/png/*`；不要 summarize / view 参考页；不要重新统计颜色、字体或版式。',
+         '- **信息来源优先级**：本节 > `## Usage` > frontmatter `assets` / `colors` / `typography` > `layouts.md`。除此之外的文件只用于人工审计，不用于生成。',
+         '- **缺信息时降级**：如果某个细节本节没有写，用 frontmatter token 和最接近的 `layouts.md` archetype 推断；不要打开审计文件补证。',
+         '- **画布**：所有坐标按 `%dx%d` 绝对像素理解。' % (canvas[0], canvas[1])]
+    if cover:
+        L.append('- **封面背景**：优先使用 `%s`；整幅铺满画布，禁止自造渐变替代。' % cover['id'])
+    if content_bgs:
+        L.append('- **内容页背景**：按 `layouts.md` 中 archetype 的 `background` 字段取；常用内容背景为 %s。'
+                 % '、'.join('`%s`' % x for x in content_bgs[:4]))
+    if cover or content_bgs:
+        L.append('- **背景安全区**：背景图和版式必须配对。按 archetype 的 `background`、`text_safe`、`avoid` 一起放文字和卡片；标题、正文、关键数字、图表、卡片、时间线及其容器的外接矩形都不得压到背景视觉主体、强光斑、深色透明区上，透明容器也不能跨进禁放区。')
+    if logo:
+        L.append('- **标识资产**：只使用 `%s`；不得重画、不得改比例。' % logo['id'])
+    L += ['- **配色与字体**：颜色只取 frontmatter `colors`；字体/字号只取 frontmatter `typography`；内容主题不得引入新色相。',
+          '- **版式**：优先使用下面内联版式索引；需要更多 slot 时才读 `layouts.md`；不要用 `ref/rebuild/png` 反推坐标。']
+    if archetypes:
+        L += ['', '内联版式索引（先用这里，不要为了选页型再读文件）：']
+        for a in archetypes:
+            parts = ['`%s`' % a['name']]
+            if a.get('bg'):
+                parts.append('背景 `%s`' % a['bg'])
+            slots = []
+            for s in a['slots'][:4]:
+                slots.append('%s/%s %s' % (s['role'], s['type'], s['box']))
+            L.append('- %s：%s' % (' / '.join(parts), '；'.join(slots) or '按最接近用途套用'))
+    if key_assets:
+        L += ['', '关键资产：'] + ['- ' + a for a in key_assets]
+
+    L += ['', '## Overview', '',
+         'TODO: 两三句话讲清这套模板的性格与适用场景——看过联系表和页面事实之后再写，不要套话。', '',
+         '画布 %dx%d px，%d 页样张归纳出 %d 种页型；版式坐标全部放在 `layouts.md`。'
+         % (canvas[0], canvas[1], d['counts']['slides'], len(archetypes)), '',
+         '## Usage', '',
+         '搭一页 PPT 就三步：', '',
+         '1. **挑版式** —— 打开 `layouts.md`，按用途选一个 archetype，`slots[].box` 的 `[x, y, w, h]` 是 %dx%d 画布上的绝对像素，直接照搬，不要自己排版；同时遵守该 archetype 的 `text_safe` 和 `avoid`。'
+         % (canvas[0], canvas[1])]
+    if assets:
+        L.append('2. **铺资产** —— 背景和标识只用 `assets/` 里的文件，见下表；不要自造渐变或重画 logo。背景必须和版式配对，文字必须留在安全区内。')
+    else:
+        L.append('2. **铺背景** —— 本包无图片资产，背景用 `colors` 里的底色。')
+    L += ['3. **填色与字** —— 颜色只从 frontmatter 的 `colors` 取，字号只从 `typography` 取。', '']
+    if assets:
+        L += ['{{ASSET_TABLE}}', '']
+        L += ['## Background Safety', '',
+              '真实背景不是纯装饰底。填写本包时必须根据 `contact-sheet.png` 和 `layout-sheet.png` 补充每个 archetype 的 `text_safe`、`avoid`、`pairing_rule`；消费时文字、图表、卡片、表格、时间线、标题容器、正文容器和宽透明容器的外接矩形不得与 `avoid` 区域重叠。内容量超出安全区时换页型或拆页，不要扩大文字区域压住背景主体。', '']
+    L += ['**色板纪律**：整套页面只用 `colors` 里的 %d 个 token，内容主题（咖啡、医疗、金融……）不改变配色；'
+          '需要强调时用 `primary`，不要引入模板外的色相。' % len(tokens), '',
+          '## Colors', '', '| token | 值 | 用途 |', '|---|---|---|']
+    USE = {'surface': '页面与卡片主底色', 'surface-alt': '次级底色，分区/强调区块的浅底',
+           'ink': '正文与标题文字色', 'ink-muted': '次级文字色，说明与标签',
+           'primary': '主强调色：图表主序列、关键数字、行动点',
+           'accent': '副强调色，多与 primary 组成渐变',
+           'accent-2': '渐变与图表的第二落点色', 'accent-3': '渐变收尾色，用量最少',
+           'neutral': '中性弱化色：分隔线、次要标签'}
+    for name, r in tokens:
+        L.append('| `%s` | `%s` | %s |' % (name, r['hex'], USE.get(name, '按 token 名对应的角色使用')))
+    imp, webs = import_line(fonts)
+    L += ['', '## Typography', '']
+    for f in fonts[:2]:
+        L.append('- **%s** —— 栈 `%s`%s' % (
+            f['names'][0], font_css(f['stack']),
+            '，源为商业/内部字体无 web 分发源，按气质降级到 %s' % f['stack'][1]
+            if len(f['stack']) > 1 else ''))
+    L += ['', '字号轴：' + '、'.join('%s %dpx' % (k, round(v['sz_px'])) for k, v in roles.items()), '',
+          '字体加载（**HARD REQUIREMENT：下面这行 @import 原样写入全局样式首行，禁止替换为 '
+          'fonts.googleapis.com 或其他域**）：', '', '```', imp, '```', '',
+          '镜像只保证 wght 400 一档，更粗的字重由浏览器合成，不要把字重当唯一区分手段；'
+          '系统字体 PingFang SC / Microsoft YaHei 置于栈末保底，中文场景负字距一律清零。', '',
+          '## Layouts', '',
+          '**搭页前先读 `layouts.md`**——%d 个 archetype 的 slot 坐标都在那里，本文件不重复。'
+          % len(archetypes), '', '{{LAYOUT_LIST}}']
+    L += ['', '## Hard Rules', '']
+    if cover:
+        L.append('- 封面页背景必须铺 `bg-cover`（文件见 Usage 表），整幅铺满 %dx%d，不要自造渐变或换图。'
+                 % (canvas[0], canvas[1]))
+    if any(a['role'] == 'content' for a in assets):
+        L.append('- 内容页背景整幅铺满，用哪一张按 `layouts.md` 里该 archetype 的 `background` 字段取，不要混用。')
+    if logo:
+        b, pages = logo['src']['box'], logo['src']['slides']
+        where = ('只出现在源第 %s 页' % '、'.join(map(str, pages))
+                 if pages and len(pages) <= 4 else '每页放一次')
+        L.append('- `%s` 放在 (%d, %d)，尺寸 %dx%d px，%s；不要重画、不要替换成文字、不要改比例。'
+                 % (logo['id'], b.get('x', 0), b.get('y', 0), b.get('w', 0), b.get('h', 0), where))
+    L += ['- 版式坐标只从 `layouts.md` 的 `slots[].box` 取。',
+          '- 颜色只用 `colors` 里的 token；字号只用 `typography` 里的档位。',
+          '- `@import` 行原样写入，禁止替换域名。',
+          '- TODO: 补 1-2 条这套模板特有的硬规则（看过联系表之后写，例如主色只许用在哪类元素）。',
+          '', '## Exceptions', '']
+    if exceptions:
+        L += ['- ' + e for e in exceptions]
+    else:
+        L.append('- 无额外例外：所有页型都遵守上面的安全区与色板纪律。')
+    L.append('')
+    write(os.path.join(ldir, 'body.md'), '\n'.join(L) + '\n')
+
+
+def emit_brief(d, ctx, ldir):
+    (tokens, rest, fonts, roles, assets, rejected, todos, archetypes, cands, sheet,
+     leftover, lsheet) = ctx
+    canvas = d['canvas']['px']
+    L = ['# 抽取简报（草案已生成，读完这一页就能改）', '',
+         '源：`%s`  画布 %dx%d  %d 页 / %d 版式  主题 %s  form=%s'
+         % (d['source']['filename'], canvas[0], canvas[1], d['counts']['slides'],
+            d['counts']['layouts'], d['theme_topology']['themes'],
+            d['form_hint']['form']), '',
+         '## 待判断（草案里已标 TODO，逐条改掉）', '']
+    base_todos = ['给风格起名：`manifest.yaml` 的 name / name_zh / description（看两张图定气质）',
+                  '`layouts.yaml` 顶部 `names:` 一段填 %d 个中文页型名（看 layout-sheet.png，'
+                  '一次改完；下面 layouts 段不要动）' % len(archetypes),
+                  '`body.md` 的 Overview 与 Hard Rules 末条（Colors 用途列草案已填好，觉得不对再改）']
+    for t in base_todos + todos:
+        L.append('- ' + t)
+    L += ['', '## 联系表（一次看完所有候选图）', '',
+          '`l-out/contact-sheet.png`  —— 编号对应下表；看完再决定 logo / 封面归属。' if sheet
+          else '（Pillow 不可用，未生成联系表；逐张看 `media-out/`）', '',
+          '| # | 文件 | 尺寸 | 出现 | 满屏 | 页 | 草案判定 |', '|---|---|---|---|---|---|---|']
+    decided = {a['src']['file']: a['id'] for a in assets}
+    why = {c['file']: r for c, r in rejected}
+    for i, c in enumerate(cands[:12], 1):
+        L.append('| %d | `%s` | %sx%s | %d | %s | %s | %s |' % (
+            i, c['file'], c['probe'].get('w') or '?', c['probe'].get('h') or '?', c['n'],
+            'Y' if c['fullscreen'] else '', ','.join(map(str, c['slides'][:6])) or 'layout',
+            decided.get(c['file']) or ('✗ ' + why.get(c['file'], '未采纳'))))
+    L += ['', '## 颜色（草案 token 已写进 frontmatter.yaml）', '',
+          '| token | hex | 出现 |', '|---|---|---|']
+    for name, r in tokens:
+        L.append('| `%s` | %s | %d |' % (name, r['hex'], r['n']))
+    if rest:
+        L.append('')
+        L.append('未取用高频色：' + '、'.join('%s(%d)' % (r['hex'], r['n']) for r in rest))
+    L += ['', '## 字体 / 字号', '']
+    for f in fonts:
+        L.append('- `%s` 渲染 %d 处，字重 %s → 降级链 `%s`%s' % (
+            f['names'][0], f['rendered'], f['weights'], ' > '.join(f['stack']),
+            '（映射表命中 %s）' % f['mapped'] if f['mapped'] else '（映射表未命中，已留原名）'))
+    L.append('')
+    L.append('字号轴：' + '、'.join('%s=%dpx(n=%d)' % (k, round(v['sz_px']), v['n'])
+                                 for k, v in roles.items()))
+    L += ['', '## 版式聚类（草案已写进 layouts.yaml）', '',
+          '`l-out/layout-sheet.png` 是各页型代表页的重建图——**看它给页型起名**，'
+          '不用再逐页查 shapes。' if lsheet else '（未生成版式图，按下面的 slot 原文命名）', '',
+          '| archetype | 页数 | 代表页 | 背景 | slot 数 |', '|---|---|---|---|---|']
+    for a in archetypes:
+        L.append('| `%s` | %d | %s | %s | %d |' % (
+            a['name'], len(a['pages']), a['rep'], a['bg'] or '（无资产底图）', len(a['slots'])))
+    if leftover:
+        L += ['', '未归入 archetype 的页：%s —— 都是单页孤例，需要就自己补一个 archetype。'
+              % ', '.join(map(str, leftover))]
+    L += ['', '各 archetype 的 slot 原文（据此起中文页型名、改 role）：', '']
+    for a in archetypes:
+        L.append('- `%s`（第 %s 页，覆盖 %s）' % (a['name'], a['rep'], a['pages']))
+        for s in a['slots']:
+            L.append('  - %s %spx 「%s」' % (s['role'], round(s['sz']), s['txt']))
+    L += ['', '## 下一步', '',
+          '1. 看 `contact-sheet.png` 和 `layout-sheet.png`；'
+          '2. 用一次批量编辑/patch 改掉四份草案里的 TODO；3. 跑 `package.py`。']
+    write(os.path.join(ldir, 'BRIEF.md'), '\n'.join(L) + '\n')
+
+
+def main(argv=None):
+    ap = argparse.ArgumentParser()
+    ap.add_argument('outdir')
+    a = ap.parse_args(argv)
+    outdir = os.path.abspath(a.outdir)
+    d = json.load(open(os.path.join(outdir, 'extract.json'), encoding='utf-8'))
+    ldir = os.path.join(outdir, 'l-out')
+    os.makedirs(ldir, exist_ok=True)
+
+    tokens, rest, _ = draft_colors(d)
+    fonts = draft_fonts(d)
+    archetypes, pages, leftover = draft_layouts(d, outdir)
+    cover_media = next((a['bg_raw'] for a in archetypes if a['name'] == 'cover'), None)
+    bg_needed = {a['bg_raw'] for a in archetypes if a['bg_raw'] and a['bg_raw'].startswith('ppt/media')}
+    bg_under = {p['no']: p['bg_media'] for p in pages}
+    assets, rejected, todos = draft_assets(d, outdir, bg_needed, cover_media, bg_under)
+    media_to_asset = {a['src']['media']: a['id'] for a in assets}
+    for a in archetypes:
+        a['bg'] = media_to_asset.get(a['bg_raw'])
+    roles = draft_scale(d, archetypes)
+    cands = sorted([c for c in [a['src'] for a in assets]] +
+                   [c for c, _ in rejected], key=lambda c: (-c['n'], c['file']))
+    sheet = contact_sheet(outdir, cands, os.path.join(ldir, 'contact-sheet.png'))
+    lsheet = layout_sheet(outdir, archetypes, os.path.join(ldir, 'layout-sheet.png'))
+
+    anchors = draft_anchors(d, tokens, fonts, roles, assets, archetypes)
+    gaps, exceptions = [], []
+    for c, why in rejected:
+        if '近全透明' in why:
+            gaps.append('母版/版式里的 %s 是%s，不是设计资产，任何情况下不要当背景用。' % (c['file'], why))
+    for f in fonts[:2]:
+        if len(f['stack']) > 1:
+            gaps.append('源字体 %s 无 web 授权源，已按 font-fallback 表降级到 %s；字形细节与原稿有差异。'
+                        % (f['names'][0], f['stack'][1]))
+    if leftover:
+        exceptions.append('源 deck 第 %s 页是单页孤例，没有归纳成 archetype；需要类似构图时按最接近的页型改。'
+                          % '、'.join(map(str, leftover)))
+
+    emit_manifest(d, assets, ldir)
+    emit_frontmatter(d, tokens, fonts, roles, anchors, gaps, ldir)
+    emit_layouts(archetypes, ldir)
+    emit_body(d, tokens, fonts, roles, assets, archetypes, exceptions, ldir)
+    emit_brief(d, (tokens, rest, fonts, roles, assets, rejected, todos, archetypes, cands, sheet,
+                   leftover, lsheet), ldir)
+
+    print('草案就绪 -> %s' % ldir)
+    print('  资产 %d（%s）  版式 %d  色 %d  字体 %d'
+          % (len(assets), ', '.join(x['id'] for x in assets), len(archetypes), len(tokens), len(fonts)))
+    print('  先读 l-out/BRIEF.md，再看 l-out/contact-sheet.png')
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())