@lark-apaas/coding-steering 0.1.18-dev.857e860 → 0.1.18-dev.9dbf919

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

@@ -38,7 +38,7 @@ L 层判断单 schema（<l-out-dir> 四个文件，这段就是填写说明书
     assets:                           # 可选；无资产包可整段省略
       - id: bg-cover                  # 必填。命名规则 <kind 前缀>-<语义名>，
                                       #   logo- / slogan- / bg- / texture- / icon-
-        source_media: image-1-1.jpeg  # media-out/ 里的**原图**文件名（不是压缩版）
+        source_media: <原图文件名>     # media-out/ 里的**原图**文件名（不是压缩版）
         kind: background              # logo|slogan|background|texture|icon
         role: cover                   # background/icon 用；封闭枚举见规范 §2
         theme: dark                   # 双主题包按需
@@ -80,9 +80,9 @@ L 层判断单 schema（<l-out-dir> 四个文件，这段就是填写说明书
 
     colors:
       surface: "#FFFFFF"
-      primary: "#2D5A8E"
+      primary: "#RRGGBB"
     safe-area:
-      content: {top: 60, right: 90, bottom: 113, left: 90, applies-to: [content]}
+      content: {top: <px>, right: <px>, bottom: <px>, left: <px>, applies-to: [content]}
       confidence: medium
 
 --------------------------------------------------------------------------------
@@ -98,7 +98,8 @@ L 层判断单 schema（<l-out-dir> 四个文件，这段就是填写说明书
         role: cover
         background: bg-cover
         slots:
-          - {role: title, box: [257, 313, 1406, 130], type: title}
+          - {role: title, box: [<x>, <y>, <w>, <h>], type: title,
+             css: "<由源模板转译出的 CSS 声明串>"}
         confidence: high
 
   可选 `body:` 块标量 —— 追加到 layouts.md frontmatter 之后作为说明正文。
@@ -141,8 +142,8 @@ KIND_PREFIX = {'background': 'bg', 'logo': 'logo', 'slogan': 'slogan',
                'texture': 'texture', 'icon': 'icon'}
 # 交付包的 ref/ 只留 audit.yaml（人复核数值出处用，几 KB）。
 # 频次原表、聚类原始数据、extract.json、重建图、logo 候选图全部留在 stage1 抽取目录，
-# 不拷进包——规范说「下发时链路剥离」，但实测没人剥离，结果是几 MB 材料带着
-# 「别读我」一起进消费上下文（vo-lite 的包 4.2MB 里 2.6MB 是这些）。
+# 不拷进包——规范原本指望「下发时链路剥离」，但链路上没有环节真的剥离，结果
+# 审计材料带着「别读我」一起进消费上下文，还占掉包体的大头。
 REF_CARRY = ()
 
 
@@ -274,6 +275,10 @@ def truthy(v):
     return str(v).strip().lower() in ('1', 'true', 'yes', 'on')
 
 
+# 浏览器能解码的图片格式。落进包的资产必须在此列，否则消费端引用到就是一张空白图。
+WEB_SAFE_EXT = {'png', 'jpg', 'jpeg', 'webp', 'gif', 'svg', 'avif'}
+
+
 def asset_ext(name):
     return name.rsplit('.', 1)[-1].lower() if '.' in name else ''
 
@@ -353,12 +358,25 @@ def place_assets(manifest, extract, stage1, pack):
                 entry['path'] = 'assets/%ss/%s.%s' % (kind, base, cext)
                 if truthy(a.get('use_full')):
                     oext = asset_ext(row['out'])
-                    fdst = os.path.join(sub, '%s@full.%s' % (base, oext))
-                    shutil.copy2(orig_path, fdst)
-                    copied.append(fdst)
-                    entry['full'] = 'assets/%ss/%s@full.%s' % (kind, base, oext)
+                    if oext.lower() in WEB_SAFE_EXT:
+                        fdst = os.path.join(sub, '%s@full.%s' % (base, oext))
+                        shutil.copy2(orig_path, fdst)
+                        copied.append(fdst)
+                        entry['full'] = 'assets/%ss/%s@full.%s' % (kind, base, oext)
+                    else:
+                        # 原图是浏览器不解码的格式（tiff/bmp 之类）。落进包并在 design.md
+                        # 里声明成可用资源，消费端引用它就是一张空白图——实测踩过一次，
+                        # 封面与结束页因此空白。压缩版已经带着全部像素，full 不给。
+                        print('  ⚠ %s 的原图是 .%s，浏览器不解码，只给压缩版' % (aid, oext))
             else:
                 oext = asset_ext(row['out'])
+                if oext.lower() not in WEB_SAFE_EXT:
+                    # 转码两条路（Pillow / sips）都没成，原图又是浏览器不解码的格式。
+                    # 照落进去就是把一张永远显示不出来的图当资产下发——实测封面因此空白。
+                    raise Fail('%s: 原图是 .%s，浏览器不解码，而转码没有产物'
+                               '（extract.json 里看 transcode_blocked 的原因）。'
+                               '装上 Pillow 重跑抽取，或把这条资产从 manifest 删掉'
+                               '并在 gaps 写明。' % (aid, oext))
                 dst = os.path.join(sub, '%s.%s' % (base, oext))
                 shutil.copy2(orig_path, dst)
                 copied.append(dst)
@@ -384,7 +402,7 @@ def place_assets(manifest, extract, stage1, pack):
                 if boxes:
                     au['boxes'] = boxes
                     # aspect 取**未取整**的 box —— 从取整后的整数反算会明显偏
-                    # （volcano logo 224.1/47.8=4.688，用 224/48 算成 4.667）。
+                    # 先取整再相除，误差会落到小数点后两位，logo 这种细长框尤其明显。
                     raw = clusters[0]['box']
                     if raw.get('h'):
                         au['aspect'] = round(raw['w'] / float(raw['h']), 3)
@@ -490,7 +508,7 @@ def render_assets_block(consumer):
 
 # ------------------------------------------------- 数值可追溯机检（抄错即 FAIL）
 HEX_RE = re.compile(r'#([0-9A-Fa-f]{6})\b')
-FONTSIZE_RE = re.compile(r'\bfontSize:\s*([\d.]+)px')
+FONTSIZE_RE = re.compile(r'\b(?:fontSize|font-size):\s*([\d.]+)px')
 BOX_RE = re.compile(r'\bbox:\s*\[\s*(-?[\d.]+)\s*,\s*(-?[\d.]+)\s*,'
                     r'\s*(-?[\d.]+)\s*,\s*(-?[\d.]+)\s*\]')
 KEYLINE_RE = re.compile(r'^(\s*)-?\s*([A-Za-z_][\w-]*):\s*(.*)$')
@@ -633,6 +651,42 @@ def _box_hit(box, idx):
 JUDGEMENT_KEYS = frozenset(('avoid', 'text_safe', 'pairing_rule'))
 
 
+def media_integrity(stage1, extract):
+    """extract.json 记录的尺寸，必须和磁盘上那个文件真实的尺寸一致。
+
+    这条挡的是「记录全对、文件被顶替」——两个 media 的输出名撞车时，后写的覆盖先写的，
+    extract.json 里各自的记录都还是对的，任何只读记录的检查都发现不了；只有把记录和
+    文件本身对一遍才抓得到。实测某模板因此把一张 109x109 的图当成了整页背景。
+    """
+    try:
+        from PIL import Image
+    except Exception:
+        return []                      # 没有 Pillow 就量不了，跳过而不是假装通过
+    bad, seen = [], {}
+    for m in extract.get('media') or []:
+        for key, rel in (('source_px', m.get('out')),
+                         ('compressed_px', m.get('compressed_out'))):
+            rec = m.get(key)
+            if not rel or not rec:
+                continue
+            path = os.path.join(stage1, rel)
+            if not os.path.exists(path):
+                bad.append('%s 的 %s 指向 %s，文件不存在' % (m['media'], key, rel))
+                continue
+            try:
+                with Image.open(path) as im:
+                    real = list(im.size)
+            except Exception:
+                continue
+            if real != list(rec):
+                bad.append('%s 的 %s 记录 %s，但 %s 实际是 %s'
+                           % (m['media'], key, rec, rel, real))
+            if rel in seen and seen[rel] != m['media']:
+                bad.append('%s 与 %s 都写到 %s' % (seen[rel], m['media'], rel))
+            seen[rel] = m['media']
+    return bad
+
+
 def trace_check(pack, extract, shapes, derived_values, derived_tokens, factor):
     """产物里每个 hex / 字号 / slot 坐标都必须可追溯到普查值或 derived 声明。"""
     idx = build_trace_index(extract, shapes)
@@ -849,6 +903,58 @@ def build_design(manifest, l_frontmatter, consumer, body, has_sidecar, canvas):
     return text
 
 
+def shrink_safe_area(lines):
+    """text_safe 与 avoid 相交时把安全区收掉重叠的那部分。
+
+    text_safe 是脚本按「该背景各页型的槽位并集」算的，而模板里的槽位本身可能就压在
+    主视觉上；avoid 是看图的人填的。两者从不同来源来，会直接打架——实测一张背景的
+    text_safe 有 34% 落在 avoid 里，消费端按 text_safe 把标题放进了禁放区，正好压在
+    背景的山峰主体上。这里以 avoid 为准收缩：能不能放字是看图的人说了算。
+    """
+    def parse_box(s):
+        m = re.findall(r'-?\d+', s)
+        return [int(x) for x in m[:4]] if len(m) >= 4 else None
+
+    ts_i = ts = None
+    avoids = []
+    for i, ln in enumerate(lines):
+        st = ln.strip()
+        if st.startswith('text_safe:'):
+            ts_i, ts = i, parse_box(st.split(':', 1)[1].split('#')[0])
+        elif st.startswith('avoid:'):
+            for chunk in re.findall(r'box:\s*\[[^\]]*\]', st):
+                b = parse_box(chunk)
+                if b:
+                    avoids.append(b)
+    if ts is None or not avoids:
+        return lines, None
+    x0, y0, x1, y1 = ts[0], ts[1], ts[0] + ts[2], ts[1] + ts[3]
+    for a in avoids:
+        ax0, ay0, ax1, ay1 = a[0], a[1], a[0] + a[2], a[1] + a[3]
+        if ax1 <= x0 or ax0 >= x1 or ay1 <= y0 or ay0 >= y1:
+            continue                       # 不相交
+        # 从被侵占得最少的一边切：优先保留面积最大的剩余矩形
+        cands = []
+        if ax0 > x0:
+            cands.append((x0, y0, ax0, y1))
+        if ax1 < x1:
+            cands.append((ax1, y0, x1, y1))
+        if ay0 > y0:
+            cands.append((x0, y0, x1, ay0))
+        if ay1 < y1:
+            cands.append((x0, ay1, x1, y1))
+        if not cands:
+            return lines, 'text_safe 被 avoid 完全覆盖，这张背景没有可放文字的区域'
+        x0, y0, x1, y1 = max(cands, key=lambda c: (c[2] - c[0]) * (c[3] - c[1]))
+    new = [x0, y0, x1 - x0, y1 - y0]
+    if new == ts:
+        return lines, None
+    lines = list(lines)
+    lines[ts_i] = '    text_safe: [%d, %d, %d, %d]   # 已按 avoid 收缩（原 %s）' % (
+        new[0], new[1], new[2], new[3], ts)
+    return lines, None
+
+
 def build_layouts_md(layouts_blocks, canvas):
     blocks = {k: (inline, lines) for k, inline, lines in layouts_blocks}
     if 'canvas' in blocks:
@@ -857,12 +963,13 @@ def build_layouts_md(layouts_blocks, canvas):
         raise Fail('layouts.yaml 缺顶层键 `layouts:`')
     # `names:` / `bg_rules:` 是给 L 层集中填判断的两块扁平区——在这里并回各
     # archetype，本身不进产物。让 L 层只改扁平键值，别去动 layouts 里的
-    # slots/confidence 结构（实测两次都在那里编辑出事故）。
-    names = {}
-    for line in blocks.get('names', ('', []))[1]:
-        m = re.match(r'^\s{2}([\w-]+):\s*(.+?)\s*$', line)
-        if m:
-            names[m.group(1)] = unquote(m.group(2))
+    # slots/confidence 结构（嵌套结构手改极易破坏缩进，进而静默改变语义）。
+    names, roles = {}, {}
+    for key, sink in (('names', names), ('roles', roles)):
+        for line in blocks.get(key, ('', []))[1]:
+            m = re.match(r'^\s{2}([\w-]+):\s*(.+?)\s*$', line)
+            if m:
+                sink[m.group(1)] = unquote(m.group(2))
     bg_rules, cur = {}, None
     for line in blocks.get('bg_rules', ('', []))[1]:
         # 键后面允许行内注释（草案会标「用它的页型：…」）
@@ -875,20 +982,53 @@ def build_layouts_md(layouts_blocks, canvas):
             bg_rules[cur].append('    ' + line.strip())
     out = ['---', 'canvas: %dx%d' % tuple(canvas)]
     # 禁放区是背景的属性，按背景写一次；页型只留 `background:` 指针。
-    # 合并进每个页型会把同一句话复制 N 遍（实测某模板 14 个页型 14 条一字不差）。
+    # 合并进每个页型会把同一句话按页型数复制 N 遍。
     if bg_rules:
         out.append('backgrounds:')
         for bg, lines in bg_rules.items():
+            lines, err = shrink_safe_area(lines)
+            if err:
+                raise Fail('%s: %s' % (bg, err))
             out.append('  %s:' % bg)
             out += lines
     out.append('layouts:')
     for line in blocks['layouts'][1]:
+        # 判断单里的结构事实（栅格、间距序列、样张字数、命中配方）是给 L 层判断用的，
+        # 不进产物——消费端要的是结论，不是推导过程。
+        if line.lstrip().startswith('#'):
+            continue
         out.append(line)
         m = re.match(r'^  ([\w-]+):\s*$', line)
         if m and m.group(1) in names:
             out.append('    name: "%s"' % names.pop(m.group(1)))
+        if m and m.group(1) in roles:
+            out.append('    role: %s' % roles.pop(m.group(1)))
     if names:
         raise Fail('names 里这些页型在 layouts 下找不到：%s' % ', '.join(sorted(names)))
+    if roles:
+        raise Fail('roles 里这些页型在 layouts 下找不到：%s' % ', '.join(sorted(roles)))
+    missing_role = [k for k in re.findall(r'^  ([\w-]+):\s*$', '\n'.join(blocks['layouts'][1]), re.M)
+                    if not re.search(r'^  %s:\s*$(?:\n(?!  \S).*)*?\n    role:' % re.escape(k),
+                                     '\n'.join(out), re.M)]
+    if missing_role:
+        raise Fail('这些页型没有 role（在 layouts.yaml 的 roles 段填）：%s' % ', '.join(missing_role))
+    # flow 与 slots 二选一：两份都留下，消费端不知道该听哪份坐标——design.md 正文与
+    # layouts.md 打架就是这么来的，别重演。
+    both, cur, has = [], None, {}
+    for line in blocks['layouts'][1]:
+        m = re.match(r'^  ([\w-]+):\s*$', line)
+        if m:
+            if cur and has.get('flow') and has.get('slots'):
+                both.append(cur)
+            cur, has = m.group(1), {}
+            continue
+        m = re.match(r'^    (flow|slots):\s*$', line)
+        if m:
+            has[m.group(1)] = True
+    if cur and has.get('flow') and has.get('slots'):
+        both.append(cur)
+    if both:
+        raise Fail('这些页型同时留了 flow 和 slots，二选一删掉另一个：%s' % ', '.join(both))
     declared = set(re.findall(r'^    background:\s*(\S+)\s*$',
                               '\n'.join(blocks['layouts'][1]), re.M))
     stray = set(bg_rules) - declared
@@ -1032,6 +1172,12 @@ def main(argv=None):
     shapes = json.load(open(sp, encoding='utf-8'))['shapes'] if os.path.exists(sp) else []
     problems, checked = trace_check(pack, extract, shapes,
                                     derived_values, derived_tokens, factor)
+    integrity = media_integrity(stage1, extract)
+    if integrity:
+        print('\n--- 媒体产物完整性 ---')
+        for b in integrity:
+            print('  FAIL ' + b)
+        raise Fail('media-out 里的文件和 extract.json 的记录对不上（%d 处）' % len(integrity))
     print('\n--- 数值可追溯机检 ---')
     print('  受检 hex %d / fontSize %d / slot box %d；derived 豁免 %d%s%s'
           % (checked['hex'], checked['size'], checked['box'], checked['exempt'],

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

@@ -39,15 +39,15 @@ class Package:
         self.masters = sorted((n for n in self.names if MASTER_RE.match(n)), key=_num)
         self.themes, self.theme_discovery = self._find_themes(ct)
         # zip directory entries ('ppt/media/') must not be counted as assets —
-        # 票 03 recon counted one, which is why its media totals run one high.
+        # they inflate media totals by one.
         self.media = sorted(n for n in self.names
                             if n.startswith('ppt/media/') and not n.endswith('/'))
 
     def _find_themes(self, ct):
         """Theme parts come from [Content_Types].xml, not from a path pattern.
 
-        Compressors relocate them — 飞书压缩版 puts them at
-        ppt/slideMasters/theme/themeN.xml — and a `ppt/theme/` regex then finds
+        Compressors relocate them — some rewrite them under
+        ppt/slideMasters/theme/ — and a `ppt/theme/` regex then finds
         nothing to bind the masters to, so every schemeClr resolves to
         UNRESOLVED:no-scheme. The path regex stays as the fallback for packages
         whose content types are unreadable.
@@ -393,6 +393,9 @@ def walk_tree(el, ctx, out, path=(), xf=(1.0, 1.0, 0.0, 0.0), depth=0):
             blip = sp.find('p:blipFill/a:blip', NS)
             if blip is not None:
                 rec['media'] = ctx.media_of(blip.get(R_EMBED)) or ctx.media_of(blip.get(R_LINK))
+                alpha = blip.find('a:alphaModFix', NS)
+                if alpha is not None and alpha.get('amt') is not None:
+                    rec['opacity'] = round(int(alpha.get('amt')) / 100000.0, 6)
                 svg = blip.find('a:extLst//asvg:svgBlip', NS)
                 if svg is not None:
                     rec['media_svg'] = ctx.media_of(svg.get(R_EMBED))

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

@@ -266,8 +266,8 @@ def _recipe_css(fill, line, radii, effects):
 
 def _sig(fill, line, effects):
     """分组键 = 填充 + 描边 + 效果。**不含圆角**——OOXML 圆角是 min(w,h) 的百分比，
-    同一配方在不同尺寸的卡上绝对 px 必然不同（feishu 三张 glassCard 实测 10.8/12.8/19.5），
-    把它计入键会把一个配方拆成三组；归一到哪一档是 L11 的判断，脚本只报区间。"""
+    同一配方在不同尺寸的卡上绝对 px 必然不同，把它计入键会把一个配方拆成多组；
+    归一到哪一档是判断，脚本只报区间。"""
     f = 'none'
     if isinstance(fill, dict):
         if fill.get('type') == 'solid':

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

@@ -279,18 +279,19 @@ def render_shape(shape, media_url, stats):
 
 HEAD = """<style>
 body{margin:0;background:#2b2b2b;font-family:%s}
-.page{position:relative;width:1920px;height:1080px;overflow:hidden}
+.page{position:relative;width:%dpx;height:%dpx;overflow:hidden}
 .sp{position:absolute;box-sizing:border-box}
 .sp p{margin:0}
 .ph{position:absolute;left:6px;top:4px;font:16px/1.2 monospace;color:#ff2b88;background:#fff9;padding:1px 4px}
 </style>
-""" % CJK_STACK
+"""
 
+# 缩略框跟着画布比例走，缩放比也一起算——写死 16:9 会把非 16:9 模板的页面裁掉一截
 INDEX_EXTRA = """<style>
-.wrap{width:960px;margin:0 auto;padding:16px 0}
+.wrap{width:%dpx;margin:0 auto;padding:16px 0}
 .lbl{color:#eee;font:13px/1.6 monospace;margin:14px 0 4px}
-.box{width:960px;height:540px;overflow:hidden;margin-bottom:6px}
-.box .page{transform:scale(.5);transform-origin:top left}
+.box{width:%dpx;height:%dpx;overflow:hidden;margin-bottom:6px}
+.box .page{transform:scale(%g);transform-origin:top left}
 </style>
 """
 
@@ -508,7 +509,8 @@ def render_pages_png(pages, outdir, data, scale=0.5):
                    for m in data.get('media') or [] if m.get('exported') and m.get('out')}
     png_dir = os.path.join(outdir, 'ref', 'rebuild', 'png')
     os.makedirs(png_dir, exist_ok=True)
-    W, H = int(1920 * scale), int(1080 * scale)
+    cpx = ((data.get('canvas') or {}).get('px') or [1920, 1080])
+    W, H = int(cpx[0] * scale), int(cpx[1] * scale)
     for kind, n, label, layers, default_color, page_bg in pages:
         canvas = Image.new('RGBA', (W, H), _rgba(page_bg) or (136, 136, 136, 255))
         g = _grad_stops(page_bg or '')
@@ -646,11 +648,15 @@ def main():
         pages = [p for p in pages if p[1] in only]
 
     stats = {'shapes': 0, 'text': 0, 'img_ok': 0, 'img_missing': 0, 'no_box': 0}
-    index = [HEAD, INDEX_EXTRA, '<div class="wrap">']
+    cw, ch = ((data.get('canvas') or {}).get('px') or [1920, 1080])[:2]
+    head = HEAD % (CJK_STACK, cw, ch)   # 视口跟画布走，非 16:9 模板不能按 1920x1080 裁
+    thumb_scale = 960.0 / cw
+    index = [head, INDEX_EXTRA % (960, 960, round(ch * thumb_scale), thumb_scale),
+             '<div class="wrap">']
     for kind, n, label, layers, default_color, page_bg in (() if args.no_html else pages):
         html = page_html(layers, default_color, page_bg, media_url, stats)
         with open(os.path.join(rebuild, '%s-%d.html' % (kind, n)), 'w', encoding='utf-8') as f:
-            f.write(HEAD + html)
+            f.write(head + html)
         index += ['<div class="lbl">%s</div>' % esc(label),
                   '<div class="box">%s</div>' % html]
     index.append('</div>')

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

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""Focused regression tests for deterministic picture compositing."""
+import io
+import os
+import sys
+import unittest
+
+from PIL import Image
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from extract import _draw_picture  # noqa: E402
+
+
+class _Archive:
+    def __init__(self, media, raw):
+        self.names = {media}
+        self.zip = self
+        self.raw = raw
+
+    def read(self, media):
+        if media not in self.names:
+            raise KeyError(media)
+        return self.raw
+
+
+def _png(pixels):
+    image = Image.new('RGBA', (len(pixels), 1))
+    image.putdata(pixels)
+    output = io.BytesIO()
+    image.save(output, 'PNG')
+    return output.getvalue()
+
+
+class BackgroundCompositeTest(unittest.TestCase):
+    def test_applies_flip_and_opacity_once(self):
+        media = 'ppt/media/source.png'
+        package = _Archive(media, _png([(255, 0, 0, 255), (0, 0, 255, 255)]))
+        canvas = Image.new('RGBA', (2, 1), (255, 255, 255, 255))
+
+        drawn = _draw_picture(canvas, {
+            'media': media,
+            'box_unrotated': {'x': 0, 'y': 0, 'w': 2, 'h': 1},
+            'flipH': True,
+            'opacity': 0.5,
+        }, package)
+
+        self.assertTrue(drawn)
+        left, right = canvas.getpixel((0, 0)), canvas.getpixel((1, 0))
+        self.assertEqual(left[:3], (128, 128, 255))
+        self.assertEqual(right[:3], (255, 128, 128))
+        self.assertEqual(left[3], 255)
+        self.assertEqual(right[3], 255)
+
+
+if __name__ == '__main__':
+    unittest.main()

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

@@ -0,0 +1,98 @@
+#!/usr/bin/env python3
+"""Regression tests for the consumer-facing layout slot CSS contract."""
+import os
+import sys
+import tempfile
+import unittest
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from check_v2 import Pack, rule_v2_16  # noqa: E402
+from draft import emit_layouts, slot_style  # noqa: E402
+from package import FONTSIZE_RE, build_layouts_md, split_top_blocks  # noqa: E402
+
+
+class LayoutCssTest(unittest.TestCase):
+    def test_text_slot_emits_rendering_style_as_css_only(self):
+        shape = {
+            'text': {
+                'bodyPr': {
+                    'anchor': 'ctr',
+                    'insets_px': {'lIns': 12, 'tIns': 8, 'rIns': 10, 'bIns': 6},
+                    'rot': '900000',
+                },
+                'lstStyle': {
+                    'lvl1pPr': {
+                        'sz_px': 48,
+                        'weight': 600,
+                        'italic': True,
+                        'underline': 'sng',
+                        'strike': 'sngStrike',
+                        'spc_px': 1.5,
+                        'color': {'resolved': '#123456'},
+                        'algn': 'ctr',
+                        'lnSpc': {'mult': 1.0},
+                    },
+                },
+                'paragraphs': [],
+            },
+        }
+        slot = {
+            'role': 'title',
+            'type': 'title',
+            'box': [100, 80, 800, 160],
+            'sz': 48,
+            'txt': '标题',
+        }
+        slot.update(slot_style(shape))
+        archetype = {
+            'name': 'layout-1',
+            'zh': '标题页',
+            'role': 'content',
+            'bg': None,
+            'slots': [slot],
+            'decor': [],
+            'pages': [1],
+            'rep': 1,
+            'pic_n': 0,
+            'confidence': 'high',
+        }
+
+        with tempfile.TemporaryDirectory() as output_dir:
+            emit_layouts([archetype], output_dir)
+            with open(os.path.join(output_dir, 'layouts.yaml'), encoding='utf-8') as stream:
+                layouts_yaml = stream.read()
+            layouts_md = build_layouts_md(split_top_blocks(layouts_yaml), (1920, 1080))
+
+        self.assertIn(
+            'css: "box-sizing: border-box; padding: 8px 10px 6px 12px; '
+            'font-size: 48px; font-weight: 600; font-style: italic; '
+            'text-decoration: underline line-through; letter-spacing: 1.5px; color: #123456; '
+            'text-align: center; line-height: 1.2; display: flex; '
+            'flex-direction: column; justify-content: center; rotate: 15deg"',
+            layouts_md,
+        )
+        for legacy_key in ('size', 'weight', 'color', 'align', 'valign', 'insets_px'):
+            self.assertNotRegex(layouts_md, rf'[,{{]\s*{legacy_key}:')
+        self.assertEqual(FONTSIZE_RE.findall(layouts_md), ['48'])
+
+    def test_layout_gate_rejects_legacy_slot_style_keys(self):
+        with tempfile.TemporaryDirectory() as pack_dir:
+            with open(os.path.join(pack_dir, 'design.md'), 'w', encoding='utf-8') as stream:
+                stream.write('---\nversion: alpha\nlayouts: layouts.md\n---\n\nRead layouts.md.\n')
+            with open(os.path.join(pack_dir, 'layouts.md'), 'w', encoding='utf-8') as stream:
+                stream.write(
+                    '---\ncanvas: 1920x1080\nlayouts:\n  cover:\n    role: cover\n'
+                    '    slots:\n      - {role: title, type: title, box: [0, 0, 800, 100], '
+                    'size: 48, align: center}\n    confidence: high\n---\n'
+                )
+
+            result = rule_v2_16(Pack(pack_dir))
+
+        self.assertEqual(result.level, 'FAIL')
+        self.assertEqual(len(result.fails), 1)
+        self.assertIn('旧样式键 align/size', result.fails[0])
+
+
+if __name__ == '__main__':
+    unittest.main()

package/steering/design-html/skills/pptx-style-extract/v2-format-spec.md

@@ -16,7 +16,7 @@
 
 - 消费方直接读 design.md，靠目录约定找 sidecar 与资产；frontmatter `path` 是唯一文件引用点。
 - manifest（`manifest.json`，识别靠内部 `schemaVersion` 字面量不靠文件名）服务存储、索引、校验和迁移；消费模型不需要读它。
-- `ref/` 只放 `audit.yaml`（数值出处的人工复核记录，几 KB）。频次原表、聚类原始数据、`extract.json`、重建图、logo 候选图**留在抽取工作目录，不进交付包**——原设计是「下发时链路剥离」，实测没有环节做剥离，结果几 MB 审计材料带着「别读我」一起进消费上下文（某样本包 4.2MB 里 2.6MB 是它）。
+- `ref/` 只放 `audit.yaml`（数值出处的人工复核记录，几 KB）。频次原表、聚类原始数据、`extract.json`、重建图、logo 候选图**留在抽取工作目录，不进交付包**——原设计是「下发时链路剥离」，但链路上没有环节真的做剥离，审计材料会连带进消费上下文并占掉包体的大头。
 
 ## 1. design.md frontmatter 新增键
 
@@ -53,10 +53,10 @@ canvas: 1920x1080      # layouts.md 首键；px = round(EMU / sldSz_cx * 1920)
 themes: [dark, light]
 default-theme: dark            # 双主题包必填（V2-13）
 colors:                        # v1 单层扁平，主题进 token 名
-  dark-surface: "#0A0E1E"
-  dark-on-surface: "#FFFFFF"
-  light-surface: "#FFFFFF"
-  primary: "#3C7FFF"           # 共用色不加前缀
+  dark-surface: "#RRGGBB"
+  dark-on-surface: "#RRGGBB"
+  light-surface: "#RRGGBB"
+  primary: "#RRGGBB"           # 共用色不加前缀
 ```
 
 - token 前缀约定（`dark-X`/`light-X` = 主题专属，无前缀 = 共用）在 `## Usage` 里向消费者写一句；主题机制溯源（clrMap 反转等）落 `ref/audit.yaml`。
@@ -65,7 +65,7 @@ colors:                        # v1 单层扁平，主题进 token 名
 
 ### 1.3 排除色
 
-- **排除色进 `## Hard Rules` 带证据计数**，正向给替代（如「`#FBAE40` 为编辑器参考线色（出现 72 次），非设计色」）。频次原表与 color-confidence 证据进 `ref/`。
+- **排除色进 `## Hard Rules` 带证据计数**，正向给替代（如「`<hex>` 为编辑器参考线色（出现 <N> 次），非设计色」）。频次原表与 color-confidence 证据进 `ref/`。
 - 排除色断言必须以**解析后频次**为准，`styleRef` 主题兜底引用（不渲染）与真实设计用色分开。
 
 ## 2. `assets` 段
@@ -84,7 +84,7 @@ assets:
     kind: background
     role: cover                # cover | content | section | closing | accent
     theme: dark
-    recipe: "linear-gradient(135deg, #0A0E1E 0%, #12204A 100%)"   # 可选：CSS 重绘配方
+    recipe: "linear-gradient(<angle>, <color> 0%, <color> 100%)"   # 可选：CSS 重绘配方
   bg-content-solid:            # 纯色背景：无 path/url，引 colors token
     kind: background
     role: content
@@ -123,13 +123,17 @@ layouts:
     themes: [dark, light]      # 深浅孪生合并
     background: {dark: bg-cover-dark, light: bg-cover-light}
     slots:
-      - {role: title, box: [110, 340, 970, 160], type: title}
-      - {role: logo,  box: [120, 121, 235, 74], asset: {dark: logo-on-dark, light: logo-on-light}}
+      - {role: title, box: [<x>, <y>, <w>, <h>], type: title, css: "<CSS 声明串>"}
+      - {role: logo,  box: [<x>, <y>, <w>, <h>], asset: {dark: logo-on-dark, light: logo-on-light}}
+    decor:
+      - {box: [<x>, <y>, <w>, <h>], geom: ellipse, css: "<CSS 声明串>"}
     confidence: high
 ```
 
 - **`background` 三形态**：`<asset-id>` / `{<theme>: <asset-id>}` / `{color: <colors-token>}`（`color` 是保留键，主题名禁止叫 color）。`asset` 两形态：`<asset-id>` / `{<theme>: <asset-id>}`。
 - **背景安全扩展**：有真实背景图的 archetype 建议写 `text_safe: [x,y,w,h]`、`avoid: [{box: [x,y,w,h], reason: "..."}]`、`pairing_rule: "..."`。这些是消费约束，不参与封闭枚举；用于避免标题、正文、图表、卡片、表格、时间线及其容器外接矩形覆盖背景视觉主体、强光斑或深色透明区；透明容器也不能跨进禁放区。
+- **`decor`（可选）**：这一页无文字的图形骨架——图标托底的圆、卡片、分隔线。每条 `{box, geom, css}`：`box` 定位，`css` 是可直接写进 style 的声明串，`geom` 取源形状的 prst（`ellipse` 另加 `border-radius: 50%`）。层级在背景之上、`slots` 之下；带 `asset` 的槽落在 decor 之上是版式本意，不算重叠。
+- **slot 样式契约**：`box` 只承载 `[x,y,w,h]` 几何；可渲染属性统一放进 `css`，并可直接写入 HTML `style`。PPTX `bodyPr.insets_px` 转成 `box-sizing: border-box; padding: ...`，字号/字重/颜色/水平与垂直对齐/行高/字距/旋转分别转成标准 CSS。禁止在 slot 中输出 `size` / `weight` / `color` / `align` / `valign` / `insets_px` 等旧字段。
 - **`type` 封闭枚举**：`title | subtitle | body | pic | table | chart | media | slide-number | footer`。大数字/序号走 `type: title`，语义由 `role`（如 `big-number`）承担。
 - **`slots.*.role` 开放不校验**（语义槽位）：优先复用已知词表（OOXML ST_SlideLayoutType / Slidev 20 布局 / Google PredefinedLayout，如 big-number、caption、main-point），确无对应再自造。
 - archetype ≤15（内联降级形态 ≤11）；深浅孪生合并为一条；版式溯源/母版取舍进 `ref/`。
@@ -139,14 +143,14 @@ layouts:
 
 ```yaml
 safe-area:                     # 开放命名 map，可多套边距体系
-  content:    {top: 214, right: 133, bottom: 77, left: 133, applies-to: [content, quote]}
-  editorial:  {left: 120, right: 120, applies-to: [cover, section, closing]}
+  content:    {top: <px>, right: <px>, bottom: <px>, left: <px>, applies-to: [content, quote]}
+  editorial:  {left: <px>, right: <px>, applies-to: [cover, section, closing]}
   confidence: medium
 ```
 
 冲突裁决：`slots.box` 是实例真值，`safe-area` 是归纳框架，**以 slots.box 为准**。
 
-## 5. check_v2 校验（16 行：V2-1..V2-13 + V2-R5/R6/R7）
+## 5. check_v2 校验（19 行：V2-1..V2-16 + V2-R5/R6/R7）
 
 check_v1 全部规则原样生效。扫描范围 = 包目录，V2-1/V2-2 跨 design.md + layouts.md 求并集。
 
@@ -165,6 +169,9 @@ check_v1 全部规则原样生效。扫描范围 = 包目录，V2-1/V2-2 跨 des
 | V2-11 | 键名命中 YAML 1.1 布尔字面量 | FAIL |
 | V2-12 | `path`/`url`/`color` 恰好存在一个；`color` 仅 background 允许；`full` 仅可伴随 `path` | FAIL |
 | V2-13 | 多主题（`themes` 长度 >1）缺 `default-theme`（只看 design.md frontmatter——冲突以 design.md 为准） | WARN |
+| V2-14 | 版式的 `flow` 与 `slots` 互斥（同时出现 = FAIL）；`flow.regions[].kind` 在 `grid`/`stack`/`free` 内，`grid` 必带 `cols` | FAIL |
+| V2-15 | 同段字段自洽：`backgrounds.*` 的 `text_safe` 不得与任一 `avoid` 相交；两者形态须为 `[x, y, w, h]` 四个数且 w/h 为正 | FAIL |
+| V2-16 | slot/flow item 的渲染样式只通过 `css` 承载；出现 `size/weight/color/align/valign/insets_px` 旧键 | FAIL |
 | V2-R5 | sidecar frontmatter 重复 design.md 已有顶层键（`layouts` 载荷键与 `canvas` 除外——canvas 的家就在 sidecar） | WARN |
 | V2-R6 | assets 条目出现审计字段（boxes/aspect/mark/confidence）或 design.md 顶层出现 canvas/canvas-source/theme-mechanism/color-confidence——应移 `ref/audit.yaml` / layouts.md | WARN |
 | V2-R7 | 有 layouts sidecar 指针但正文未出现 `layouts.md` 字样（弱指针，消费者到不了版式数据） | WARN |