@lark-apaas/coding-steering 0.1.32-dev.6f4e4bc → 0.1.32-dev.7b2c2ad

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-steering",
-  "version": "0.1.32-dev.6f4e4bc",
+  "version": "0.1.32-dev.7b2c2ad",
   "description": "Stack-specific steering content for miaoda-coding templates",
   "type": "module",
   "files": [

package/steering/design-html/skills/pptx-style-extract/SKILL.md

@@ -130,7 +130,7 @@ Read `<pack_dir>/design.md` first, especially `## Usage`, `## Hard Rules`, color
 When generating a deck:
 
 1. Call `copy_starter_component` with `kind: "deck-stage.js"`.
-2. Build `<deck-stage width="<canvas width>" height="<canvas height>">` using the `canvas` declared in `layouts.md` — source decks are not always 16:9, and a default-sized stage shifts every coordinate on the page. Each slide is one static `<section data-pptx-layout="<chosen archetype>">`.
+2. Build `<deck-stage width="<canvas width>" height="<canvas height>">` using the `canvas` declared in `layouts.md` — source decks are not always 16:9, and a default-sized stage shifts every coordinate on the page. Each slide is one static `<section data-pptx-layout="<chosen archetype>">`. For a multi-theme pack, choose layouts compatible with `default-theme` by default. When a page intentionally switches theme, add `data-pptx-theme="<theme>"`; the theme must be listed by that layout's `themes`.
 3. Inline CSS variables from `design.md` into the HTML `<style>` block using a `--ppt-*` prefix.
 4. **位移动画用独立的 `translate` 属性**：`@keyframes fadeUp { from{opacity:0; translate:0 24px} to{opacity:1; translate:0 0} }`。`transform` 是单一属性，动画里碰它会覆盖掉元素原有的那条（`left:50%; transform:translateX(-50%)` 的居中就此丢失）；`translate` / `rotate` / `scale` 各自独立，与已有 `transform` 叠加。
 5. Map `layouts.md` slots to absolute-positioned elements inside each section: expand `box: [x,y,w,h]` mechanically to `left/top/width/height`, then apply the slot's `css` declaration string unchanged. `box` owns geometry; `css` owns all rendering style, including the template's text padding, typography, alignment, line height, letter spacing, and rotation. Do not reinterpret PPTX fields or replace slot CSS with your own type scale. A slot with `asset` is a fixed image element: use that exact asset at that box on that archetype only; do not omit or replace it. Do not reflow any of this as generic web grids.
@@ -142,7 +142,7 @@ When generating a deck:
    PYTHONDONTWRITEBYTECODE=1 python3 -B scripts/verify_layout_assets.py <pack_dir> <index.html> --asset-prefix <copied-assets-prefix>
    ```
 
-   `PPTX_LAYOUT_ASSETS: FAIL` means add every missing bound asset and remove every cross-layout use according to `layouts.md`, then rerun this command.
+   `PPTX_LAYOUT_ASSETS: FAIL` means fix every reported instance according to `layouts.md`, then rerun the same command. Do not deliver or call `run_commit` until it prints `PPTX_LAYOUT_ASSETS: PASS`.
 9. Run the slide preflight checks: no resource failures, no section overflow, and sampled screenshots follow the package colors, typography, layouts, assets, and Hard Rules.
 
 ## Export Consumer Attachments

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

@@ -981,6 +981,13 @@ def background_decor(background, canvas):
             'trace': 'canvas-background'}
 
 
+def background_identity(background):
+    """返回可用于聚类和审计的稳定背景标识，不改变背景的原始表达。"""
+    if isinstance(background, dict):
+        return json.dumps(background, sort_keys=True, separators=(',', ':'))
+    return background
+
+
 # ---------------------------------------------------------------- 版式聚类
 DECOR_MIN = 40.0
 
@@ -1236,7 +1243,21 @@ def layouts_from_template(d, shapes, cW, cH):
     sample_pages_of_layout = defaultdict(list)
     for slide_part, layout_part in lay_of_slide.items():
         sample_pages_of_layout[layout_part].append(slide_no(slide_part))
+    sampled_theme_counts = Counter(
+        theme_of_master.get(master_of.get(layout_part))
+        for layout_part in lay_of_slide.values()
+    )
+    sampled_theme_counts.pop(None, None)
     default_theme = topo.get('default')
+    if sampled_theme_counts:
+        highest = max(sampled_theme_counts.values())
+        leaders = sorted(
+            theme for theme, count in sampled_theme_counts.items()
+            if count == highest
+        )
+        if default_theme not in leaders:
+            default_theme = leaders[0]
+        topo['default'] = default_theme
     multi = len(topo.get('themes') or []) > 1
 
     rows = []
@@ -1539,16 +1560,19 @@ def draft_layouts(d, outdir, effective_alpha=None):
     image_marks = slide_image_marks(d, overlay_media)
 
     bg_of_slide, layout_of_slide = {}, {}
-    bg_of_layout = {row['part']: row.get('background') for row in d.get('layouts') or []}
+    background_of_layout = {
+        row['part']: row.get('background') for row in d.get('layouts') or []
+    }
     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
+        bg_of_slide[s['part']] = background_identity(bg)
         layout_of_slide[s['part']] = s.get('layout')
     # 版式层的满屏底图（form=2 常态：底图挂在 layout 上）
     composites = d.get('background_composites') or {}
+    bg_media_of_layout = {}
     for s in shapes:
         if s.get('layer') == 'layout' and is_bleed(s) and s.get('media'):
-            bg_of_layout[s['part']] = s['media']
+            bg_media_of_layout[s['part']] = s['media']
 
     pages = []
     for part, sh in sorted(by_slide.items(), key=lambda kv: slide_no(kv[0])):
@@ -1556,7 +1580,7 @@ def draft_layouts(d, outdir, effective_alpha=None):
         layout_shapes = by_layout.get(layout_part) or []
         bg_media = top_bleed_media(sh)
         if bg_media is None:
-            bg_media = bg_of_layout.get(layout_part)
+            bg_media = bg_media_of_layout.get(layout_part)
         rendered_bg = (composites.get(part)
                        or composites.get(layout_part)
                        or bg_media)
@@ -1602,7 +1626,7 @@ def draft_layouts(d, outdir, effective_alpha=None):
                 marks.append(mark)
         background = next((s.get('background') for s in d.get('slides') or []
                            if s.get('part') == part and s.get('background')), None)
-        background = background or bg_of_layout.get(layout_part)
+        background = background or background_of_layout.get(layout_part)
         pages.append({'part': part, 'no': slide_no(part), 'bg_media': bg_media,
                       'rendered_bg': rendered_bg,
                       'bg_color': bg_of_slide.get(part), 'background': background,
@@ -1632,7 +1656,11 @@ def draft_layouts(d, outdir, effective_alpha=None):
             # 不替模型下结论。和首页一样，拆组只避免它被聚类代表页吞掉。
             groups[('__last__', -2)] = [p]
             continue
-        groups[(p['bg_media'] or p['bg_color'] or 'none', density_band(p))].append(p)
+        background_key = background_identity(
+            p.get('rendered_bg') or p.get('bg_media')
+            or p.get('background') or p.get('bg_color')
+        ) or 'none'
+        groups[(background_key, density_band(p))].append(p)
 
     ranked = sorted(groups.items(), key=lambda kv: (-len(kv[1]), kv[1][0]['no']))
     # 首页所在的组一定收——deck 的第一页是模板的门面，孤例也不能被名额挤掉。
@@ -1654,15 +1682,9 @@ def draft_layouts(d, outdir, effective_alpha=None):
     leftover = sorted(p['no'] for g in ranked if g not in kept for p in g[1])
 
     archetypes = []
-    for gi, ((bg_raw, _band), ps) in enumerate(kept, 1):
+    for gi, ((_background_key, _band), ps) in enumerate(kept, 1):
         rep = max(ps, key=lambda p: len(p['texts']))
-        if bg_raw == '__first__':
-            bg_raw = rep['bg_media'] or rep['bg_color'] or 'none'
-        elif bg_raw == '__last__':
-            bg_raw = rep['bg_media'] or rep['bg_color'] or 'none'
-        rendered_bg = rep.get('rendered_bg')
-        if rendered_bg:
-            bg_raw = rendered_bg
+        bg_raw = rep.get('rendered_bg') or rep.get('bg_media')
         name = 'layout-%d' % gi
         # 标题按「位置 + 跨度」认，不按字号——big-number 类的巨号数值常比标题还大
         # 标题 = 该页最靠上的那批文本里最宽的一块。不按「画布前 28%」这类固定比例切：
@@ -1739,9 +1761,13 @@ def draft_layouts(d, outdir, effective_alpha=None):
                                p['layout'] for p in ps if p.get('layout')
                            }),
                            '_source_backgrounds': sorted({
-                               p.get('rendered_bg') or p.get('bg_media') or p.get('bg_color')
+                               background_identity(
+                                   p.get('rendered_bg') or p.get('bg_media')
+                                   or p.get('background') or p.get('bg_color')
+                               )
                                for p in ps
-                               if p.get('rendered_bg') or p.get('bg_media') or p.get('bg_color')
+                               if (p.get('rendered_bg') or p.get('bg_media')
+                                   or p.get('background') or p.get('bg_color'))
                            }),
                            '_text_n': len(rep['texts']),
                            '_last_page_candidate': rep['no'] == last_page_no,
@@ -2382,7 +2408,9 @@ def emit_manifest(d, assets, vision_groups, ldir, archetypes=()):
          '  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]]
+        default_theme = d['theme_topology'].get('default') or themes[0]
+        L += ['themes: [%s]' % ', '.join(themes),
+              'default-theme: %s' % default_theme]
     if assets:
         L.append('assets:')
         for a in assets:
@@ -2909,6 +2937,8 @@ def emit_layouts(archetypes, ldir, busy_hints=None, facts=None, recipes=None):
         L.append('  %s:' % a['name'])
         if a.get('role'):
             L.append('    role: %s' % a['role'])
+        if a.get('theme'):
+            L.append('    themes: [%s]' % a['theme'])
         if a['bg']:
             L.append('    background: %s' % a['bg'])
         fl = a.get('flow')
@@ -3044,6 +3074,8 @@ def emit_body(d, tokens, fonts, roles, assets, archetypes, exceptions, cusage, l
           '页数多于页型时，挑最接近的一个原样套用它的 slot：用不到的槽删掉，'
           '内容比槽多就按同类槽的间距等距加，**坐标一律沿用该页型给的那套，不要自己另起网格**。'
           '每个生成页面的 `<section>` 都写 `data-pptx-layout="<页型名>"`，'
+          '多主题包默认只选兼容 `default-theme` 的页型；确需切换时，该页同时写 '
+          '`data-pptx-theme="<主题名>"`，且主题必须属于该页型的 `themes`。'
           '交付前据此核验该页型绑定的背景与图片资产均已使用，且没有跨页型误用。' % sidecar,
           '3. **按页型给的形态落元素** —— 页型给 `flow` 就用流式，给 `slots` 就用绝对，'
           '两者只会出现一个。'
@@ -3063,8 +3095,13 @@ def emit_body(d, tokens, fonts, roles, assets, archetypes, exceptions, cusage, l
           '`[x, y, w, h]`（%dx%d 画布上的绝对像素），机械展开成 `left/top/width/height`；'
           'slot 的 `css` 是模板排版属性已转译好的声明串，原样写进 style，不要另选字号、'
           '内边距、颜色或对齐。'
-          '带 `asset` 的 slot 是固定图片元素，把该资产放在它自己的 `box` 里，不得省略或换图；'
-          '这个页型没有 `asset` 槽，这一页就不出现该资产。' % (canvas[0], canvas[1]),
+          '带 `asset` 的 slot 是固定图片实例：元素写 `data-pptx-asset="<asset id>"`，'
+          '引用复制后的原资产，并把 `box` 直接写成 inline '
+          '`position:absolute;left:<x>px;top:<y>px;width:<w>px;height:<h>px`。'
+          '元素必须可见，不得省略或换图，也不得隐藏或只在 CSS 里伪装引用；'
+          '这个页型没有 `asset` 槽，这一页就不出现该资产。'
+          '页型的 `background` 是图片资产时遵循同一实例契约，`box` 使用全画布 '
+          '`[0, 0, %d, %d]`。' % (canvas[0], canvas[1], canvas[0], canvas[1]),
           '5. **铺装饰几何** —— 页型的 `decor` 是这一页的图形骨架（图标托底的圆、'
           '卡片、分隔线）：每条渲染成一个绝对定位空元素，`box` 给位置，`css` 逐项原样写进 '
           'style；没有 `border-radius` 就按 `0`。只有 `geom: ellipse` 另加 '

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

@@ -61,6 +61,13 @@ class DesignConsumerContractTest(unittest.TestCase):
         self.assertIn('确认全部页型后再开始搭页', body)
         self.assertIn('不能只看摘要、前几个页型', body)
         self.assertIn('data-pptx-layout="<页型名>"', body)
+        self.assertIn('data-pptx-asset="<asset id>"', body)
+        self.assertIn(
+            'position:absolute;left:<x>px;top:<y>px;width:<w>px;height:<h>px',
+            body,
+        )
+        self.assertIn('元素必须可见', body)
+        self.assertIn('`box` 使用全画布 `[0, 0, 1920, 1080]`', body)
         self.assertIn('该页型绑定的背景与图片资产均已使用', body)
         self.assertIn('不得省略或换图', body)
 

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

@@ -15,6 +15,7 @@ from draft import (asset_vision_contexts, bound_visual_candidates,  # noqa: E402
                    cover_background_media,
                    emit_asset_vision_groups, emit_layouts, emit_manifest,
                    fullscreen_overlay_media,
+                   layouts_from_template,
                    needs_asset_judgment, preserve_image_bearing_groups,
                    select_asset_vision_groups, slide_image_marks, slot_style,
                    visual_slot_candidates)
@@ -24,6 +25,125 @@ from package import (FONTSIZE_RE, Fail, apply_asset_decisions,  # noqa: E402
 
 
 class LayoutCssTest(unittest.TestCase):
+    def test_template_layouts_use_sampled_theme_as_default_and_keep_theme_scope(self):
+        dark_master = 'ppt/slideMasters/slideMaster1.xml'
+        light_master = 'ppt/slideMasters/slideMaster2.xml'
+        dark_layout = 'ppt/slideLayouts/slideLayout1.xml'
+        light_layout = 'ppt/slideLayouts/slideLayout2.xml'
+        data = {
+            'layouts': [
+                {'part': dark_layout, 'name': 'Dark content', 'used_by_slides': 2},
+                {'part': light_layout, 'name': 'Light content', 'used_by_slides': 0},
+            ],
+            'slides': [],
+            'theme_topology': {
+                'themes': ['light', 'dark'],
+                'default': 'light',
+                'per_master': [
+                    {'master': dark_master, 'theme_label': 'dark'},
+                    {'master': light_master, 'theme_label': 'light'},
+                ],
+            },
+            'reference_graph': {
+                'master_of_layout': {
+                    dark_layout: dark_master,
+                    light_layout: light_master,
+                },
+                'layout_of_slide': {
+                    'ppt/slides/slide1.xml': dark_layout,
+                    'ppt/slides/slide2.xml': dark_layout,
+                },
+            },
+            'background_composites': {},
+        }
+        shapes = [
+            {
+                'part': part,
+                'layer': 'layout',
+                'kind': 'sp',
+                'box': {'x': 100, 'y': 100, 'w': 800, 'h': 100},
+                'ph': {'type': 'title', 'idx': '1'},
+                'text': {'paragraphs': [{'runs': [{'text': 'Title', 'sz_px': 40}]}]},
+            }
+            for part in (dark_layout, light_layout)
+        ]
+
+        archetypes = layouts_from_template(data, shapes, 1920, 1080)
+
+        self.assertEqual('dark', data['theme_topology']['default'])
+        self.assertEqual(
+            {'content': 'dark', 'content-2': 'light'},
+            {item['name']: item['theme'] for item in archetypes},
+        )
+        with tempfile.TemporaryDirectory() as output_dir:
+            emit_layouts(archetypes, output_dir)
+            emit_manifest(data, [], [], output_dir, archetypes)
+            with open(os.path.join(output_dir, 'layouts.yaml'), encoding='utf-8') as stream:
+                layouts = stream.read()
+            with open(os.path.join(output_dir, 'manifest.yaml'), encoding='utf-8') as stream:
+                manifest = stream.read()
+        self.assertIn('    themes: [dark]', layouts)
+        self.assertIn('    themes: [light]', layouts)
+        self.assertIn('default-theme: dark', manifest)
+
+    def test_template_twin_layouts_keep_topology_but_scope_retained_layout(self):
+        dark_master = 'ppt/slideMasters/slideMaster1.xml'
+        light_master = 'ppt/slideMasters/slideMaster2.xml'
+        dark_layout = 'ppt/slideLayouts/slideLayout1.xml'
+        light_layout = 'ppt/slideLayouts/slideLayout2.xml'
+        data = {
+            'layouts': [
+                {'part': dark_layout, 'name': 'Content', 'used_by_slides': 2},
+                {'part': light_layout, 'name': 'Content', 'used_by_slides': 0},
+            ],
+            'slides': [],
+            'theme_topology': {
+                'themes': ['light', 'dark'],
+                'default': 'light',
+                'per_master': [
+                    {'master': dark_master, 'theme_label': 'dark'},
+                    {'master': light_master, 'theme_label': 'light'},
+                ],
+            },
+            'reference_graph': {
+                'master_of_layout': {
+                    dark_layout: dark_master,
+                    light_layout: light_master,
+                },
+                'layout_of_slide': {
+                    'ppt/slides/slide1.xml': dark_layout,
+                    'ppt/slides/slide2.xml': dark_layout,
+                },
+            },
+            'background_composites': {},
+        }
+        shapes = [
+            {
+                'part': part,
+                'layer': 'layout',
+                'kind': 'sp',
+                'box': {'x': 100, 'y': 100, 'w': 800, 'h': 100},
+                'ph': {'type': 'title', 'idx': '1'},
+                'text': {'paragraphs': [{'runs': [{'text': 'Title', 'sz_px': 40}]}]},
+            }
+            for part in (dark_layout, light_layout)
+        ]
+
+        archetypes = layouts_from_template(data, shapes, 1920, 1080)
+
+        self.assertEqual(1, len(archetypes))
+        self.assertEqual('dark', archetypes[0]['theme'])
+        with tempfile.TemporaryDirectory() as output_dir:
+            emit_layouts(archetypes, output_dir)
+            emit_manifest(data, [], [], output_dir, archetypes)
+            with open(os.path.join(output_dir, 'layouts.yaml'), encoding='utf-8') as stream:
+                layouts = stream.read()
+            with open(os.path.join(output_dir, 'manifest.yaml'), encoding='utf-8') as stream:
+                manifest = stream.read()
+        self.assertIn('    themes: [dark]', layouts)
+        self.assertIn('themes: [light, dark]', manifest)
+        self.assertIn('default-theme: dark', manifest)
+
     def test_text_slot_emits_rendering_style_as_css_only(self):
         shape = {
             'text': {
@@ -1185,6 +1305,85 @@ layouts:
         self.assertIn('value: "[0, 0, 1920, 1080]"', manifest)
         self.assertIn('reason: "PPT 背景铺满画布"', manifest)
 
+    def test_sampled_layouts_group_inherited_structured_background(self):
+        layout_part = 'ppt/slideLayouts/slideLayout1.xml'
+        slides = [{
+            'part': 'ppt/slides/slide%d.xml' % index,
+            'layout': layout_part,
+            'background': None,
+        } for index in range(1, 4)]
+        data = {
+            'canvas': {'px': [1920, 1080]},
+            'form_hint': {'form': 1},
+            'layouts': [{
+                'part': layout_part,
+                'name': '内容',
+                'used_by_slides': 3,
+            }],
+            'slides': slides,
+            'images': [],
+            'media': [],
+            'theme_topology': {'themes': ['single'], 'per_master': [], 'default': 'single'},
+            'reference_graph': {
+                'master_of_layout': {},
+                'layout_of_slide': {
+                    slide['part']: layout_part for slide in slides
+                },
+            },
+            'background_composites': {},
+        }
+        shapes = [{
+            'part': slide['part'],
+            'layer': 'slide',
+            'kind': 'sp',
+            'box': {'x': 100, 'y': 100, 'w': 600, 'h': 100},
+            'ph': {'type': 'title', 'idx': '1'},
+            'text': {'paragraphs': [{'runs': [{
+                'text': 'Title %d' % index,
+                'sz_px': 40,
+            }]}]},
+        } for index, slide in enumerate(slides, 1)]
+
+        backgrounds = [{
+            'source': 'bgPr',
+            'type': 'solid',
+            'color': {'resolved': '#FAF9F5'},
+        }, {
+            'type': 'gradient',
+            'stops': [
+                {'pos': 0, 'color': {'resolved': '#4B5CF5'}},
+                {'pos': 100, 'color': {'resolved': '#233AFB'}},
+            ],
+            'angle_deg': 0,
+        }]
+        for background in backgrounds:
+            with self.subTest(background=background['type']):
+                data['layouts'][0]['background'] = background
+                with tempfile.TemporaryDirectory() as output_dir:
+                    os.makedirs(os.path.join(output_dir, 'ref'))
+                    with open(os.path.join(output_dir, 'ref', 'shapes.json'), 'w',
+                              encoding='utf-8') as stream:
+                        import json
+                        json.dump({'shapes': shapes}, stream)
+                    archetypes, pages, _ = draft_layouts(
+                        data, output_dir, effective_alpha={})
+
+                self.assertEqual([1, 2, 3], sorted(
+                    page for archetype in archetypes for page in archetype['pages']))
+                self.assertTrue(all(page['background'] == background for page in pages))
+                self.assertTrue(all(archetype['bg_raw'] is None
+                                    for archetype in archetypes))
+                self.assertTrue(all(
+                    any(decor.get('trace') == 'canvas-background'
+                        for decor in archetype['decor'])
+                    for archetype in archetypes
+                ))
+                self.assertTrue(all(
+                    all(isinstance(value, str)
+                        for value in archetype['_source_backgrounds'])
+                    for archetype in archetypes
+                ))
+
     def test_asset_vision_groups_fail_when_page_screenshot_is_unreadable(self):
         candidates = [{
             'id': 'asset-1',

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

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 """Regression tests for template asset placement in generated deck HTML."""
 import os
+import shutil
 import subprocess
 import sys
 import tempfile
@@ -12,7 +13,22 @@ from verify_layout_assets import validate_layout_assets
 
 
 class LayoutAssetContractTest(unittest.TestCase):
+    def write_asset(self, root, relative_path, contents, copied_prefix):
+        source = os.path.join(root, 'assets', relative_path)
+        copied = os.path.join(root, copied_prefix, relative_path)
+        os.makedirs(os.path.dirname(source), exist_ok=True)
+        os.makedirs(os.path.dirname(copied), exist_ok=True)
+        with open(source, 'wb') as stream:
+            stream.write(contents)
+        shutil.copyfile(source, copied)
+
     def write_pack(self, root):
+        self.write_asset(
+            root,
+            'logos/1.png',
+            b'logo',
+            'assets/pptx-volcengine',
+        )
         with open(os.path.join(root, 'design.md'), 'w', encoding='utf-8') as stream:
             stream.write(
                 '---\n'
@@ -50,6 +66,12 @@ class LayoutAssetContractTest(unittest.TestCase):
         return path
 
     def write_texture_pack(self, root):
+        self.write_asset(
+            root,
+            'textures/1.webp',
+            b'texture',
+            'assets/pptx-claude',
+        )
         with open(os.path.join(root, 'design.md'), 'w', encoding='utf-8') as stream:
             stream.write(
                 '---\n'
@@ -77,6 +99,12 @@ class LayoutAssetContractTest(unittest.TestCase):
             )
 
     def write_background_pack(self, root):
+        self.write_asset(
+            root,
+            'backgrounds/content.webp',
+            b'background',
+            'assets/pptx-claude',
+        )
         with open(os.path.join(root, 'design.md'), 'w', encoding='utf-8') as stream:
             stream.write(
                 '---\n'
@@ -100,6 +128,31 @@ class LayoutAssetContractTest(unittest.TestCase):
                 '---\n'
             )
 
+    def write_theme_pack(self, root):
+        with open(os.path.join(root, 'design.md'), 'w', encoding='utf-8') as stream:
+            stream.write(
+                '---\n'
+                'themes: [dark, light]\n'
+                'default-theme: dark\n'
+                'layouts: layouts.md\n'
+                '---\n'
+            )
+        with open(os.path.join(root, 'layouts.md'), 'w', encoding='utf-8') as stream:
+            stream.write(
+                '---\n'
+                'canvas: 1920x1080\n'
+                'layouts:\n'
+                '  dark-content:\n'
+                '    role: content\n'
+                '    themes: [dark]\n'
+                '    slots: []\n'
+                '  light-content:\n'
+                '    role: content\n'
+                '    themes: [light]\n'
+                '    slots: []\n'
+                '---\n'
+            )
+
     def test_logo_is_limited_to_every_archetype_with_its_slot(self):
         with tempfile.TemporaryDirectory() as root:
             self.write_pack(root)
@@ -107,10 +160,14 @@ class LayoutAssetContractTest(unittest.TestCase):
                 root,
                 '<deck-stage>'
                 '<section data-pptx-layout="cover">'
-                '<img src="assets/pptx-volcengine/logos/1.png"></section>'
+                '<img data-pptx-asset="logo-1" '
+                'style="position:absolute;left:64px;top:64px;width:224px;height:48px" '
+                'src="assets/pptx-volcengine/logos/1.png"></section>'
                 '<section data-pptx-layout="content"><h1>正文</h1></section>'
                 '<section data-pptx-layout="closing">'
-                '<img src="assets/pptx-volcengine/logos/1.png"></section>'
+                '<img data-pptx-asset="logo-1" '
+                'style="position:absolute;left:64px;top:64px;width:224px;height:48px" '
+                'src="assets/pptx-volcengine/logos/1.png"></section>'
                 '</deck-stage>',
             )
 
@@ -126,7 +183,9 @@ class LayoutAssetContractTest(unittest.TestCase):
                 root,
                 '<deck-stage>'
                 '<section data-pptx-layout="content">'
-                '<img src="assets/pptx-volcengine/logos/1.png"></section>'
+                '<img data-pptx-asset="logo-1" '
+                'style="position:absolute;left:64px;top:64px;width:224px;height:48px" '
+                'src="assets/pptx-volcengine/logos/1.png"></section>'
                 '</deck-stage>',
             )
 
@@ -142,7 +201,9 @@ class LayoutAssetContractTest(unittest.TestCase):
             html = self.write_html(
                 root,
                 '<deck-stage><section data-pptx-layout="cover">'
-                '<section class="content"><img src="assets/pptx-volcengine/logos/1.png">'
+                '<section class="content"><img data-pptx-asset="logo-1" '
+                'style="position:absolute;left:64px;top:64px;width:224px;height:48px" '
+                'src="assets/pptx-volcengine/logos/1.png">'
                 '</section></section></deck-stage>',
             )
 
@@ -164,6 +225,102 @@ class LayoutAssetContractTest(unittest.TestCase):
                 validate_layout_assets(root, html, 'assets/pptx-volcengine'),
             )
 
+    def test_missing_deck_slides_is_rejected_even_without_fixed_assets(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_theme_pack(root)
+            html = self.write_html(root, '<main><section>普通页面</section></main>')
+
+            self.assertEqual(
+                ['没有识别到 deck-stage 的直属 slide section，无法核验模板页型'],
+                validate_layout_assets(root, html, 'assets/pptx-theme'),
+            )
+
+    def test_layout_outside_default_theme_requires_explicit_theme(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_theme_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage>'
+                '<section data-pptx-layout="light-content">正文</section>'
+                '</deck-stage>',
+            )
+
+            self.assertEqual(
+                ['第 1 页页型 light-content 不支持当前主题 dark；'
+                 '允许主题: light。若确需切换，显式声明 data-pptx-theme'],
+                validate_layout_assets(root, html, 'assets/pptx-theme'),
+            )
+
+    def test_explicit_non_default_theme_must_match_layout(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_theme_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage>'
+                '<section data-pptx-layout="light-content" '
+                'data-pptx-theme="light">正文</section>'
+                '</deck-stage>',
+            )
+
+            self.assertEqual(
+                [],
+                validate_layout_assets(root, html, 'assets/pptx-theme'),
+            )
+
+    def test_unknown_explicit_theme_is_rejected(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_theme_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage>'
+                '<section data-pptx-layout="dark-content" '
+                'data-pptx-theme="brand-new">正文</section>'
+                '</deck-stage>',
+            )
+
+            self.assertEqual(
+                ['第 1 页声明了不存在的模板主题: brand-new'],
+                validate_layout_assets(root, html, 'assets/pptx-theme'),
+            )
+
+    def test_pack_without_fixed_assets_still_accepts_valid_layout(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_theme_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage>'
+                '<section data-pptx-layout="dark-content">正文</section>'
+                '</deck-stage>',
+            )
+
+            self.assertEqual(
+                [],
+                validate_layout_assets(root, html, 'assets/pptx-theme'),
+            )
+
+    def test_non_mapping_layout_entry_does_not_crash_theme_validation(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_theme_pack(root)
+            with open(os.path.join(root, 'layouts.md'), 'w', encoding='utf-8') as stream:
+                stream.write(
+                    '---\n'
+                    'canvas: 1920x1080\n'
+                    'layouts:\n'
+                    '  malformed: unavailable\n'
+                    '---\n'
+                )
+            html = self.write_html(
+                root,
+                '<deck-stage>'
+                '<section data-pptx-layout="malformed">正文</section>'
+                '</deck-stage>',
+            )
+
+            self.assertEqual(
+                [],
+                validate_layout_assets(root, html, 'assets/pptx-theme'),
+            )
+
     def test_logo_in_global_css_is_rejected(self):
         with tempfile.TemporaryDirectory() as root:
             self.write_pack(root)
@@ -209,7 +366,7 @@ class LayoutAssetContractTest(unittest.TestCase):
             self.assertEqual(1, len(problems))
             self.assertIn('cover', problems[0])
             self.assertIn('texture-1', problems[0])
-            self.assertIn('必须使用', problems[0])
+            self.assertIn('缺少固定实例', problems[0])
 
     def test_layout_bound_texture_on_an_unowned_layout_is_rejected(self):
         with tempfile.TemporaryDirectory() as root:
@@ -217,7 +374,9 @@ class LayoutAssetContractTest(unittest.TestCase):
             html = self.write_html(
                 root,
                 '<deck-stage><section data-pptx-layout="content">'
-                '<img src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
+                '<img data-pptx-asset="texture-1" '
+                'style="position:absolute;left:1142px;top:0;width:778px;height:1080px" '
+                'src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
             )
 
             problems = validate_layout_assets(root, html, 'assets/pptx-claude')
@@ -233,6 +392,7 @@ class LayoutAssetContractTest(unittest.TestCase):
             html = self.write_html(
                 root,
                 '<deck-stage><section data-pptx-layout="content" '
+                'data-pptx-asset="bg-content-1" '
                 'style="background-image:url('
                 '\'assets/pptx-claude/backgrounds/content.webp?v=2#slide\')">'
                 '正文</section></deck-stage>',
@@ -261,14 +421,15 @@ class LayoutAssetContractTest(unittest.TestCase):
             html = self.write_html(
                 root,
                 '<deck-stage><section data-pptx-layout="cover">'
-                '<img src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
+                '<img data-pptx-asset="texture-1" '
+                'style="position:absolute;left:0;top:0;width:100px;height:100px" '
+                'src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
             )
 
             problems = validate_layout_assets(root, html, 'assets/pptx-claude')
 
             self.assertEqual(1, len(problems))
-            self.assertIn('共 2 处', problems[0])
-            self.assertIn('缺少 1 处', problems[0])
+            self.assertIn('位置尺寸应为 [1800, 980, 100, 100]', problems[0])
 
     def test_legacy_logo_scope_entrypoint_keeps_failure_exit_code(self):
         with tempfile.TemporaryDirectory() as root:
@@ -296,6 +457,144 @@ class LayoutAssetContractTest(unittest.TestCase):
             self.assertEqual(1, result.returncode)
             self.assertIn('PPTX_LAYOUT_ASSETS: FAIL', result.stdout)
 
+    def test_copied_asset_must_keep_the_source_pptx_bytes(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_texture_pack(root)
+            copied = os.path.join(
+                root, 'assets', 'pptx-claude', 'textures', '1.webp')
+            with open(copied, 'wb') as stream:
+                stream.write(b'generated replacement')
+            html = self.write_html(
+                root,
+                '<deck-stage><section data-pptx-layout="cover">'
+                '<img data-pptx-asset="texture-1" '
+                'style="position:absolute;left:1142px;top:0;width:778px;height:1080px" '
+                'src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
+            )
+
+            problems = validate_layout_assets(root, html, 'assets/pptx-claude')
+
+            self.assertEqual(1, len(problems))
+            self.assertIn('已被替换或改写', problems[0])
+
+    def test_fixed_asset_must_keep_its_layout_box(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_texture_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage><section data-pptx-layout="cover">'
+                '<img data-pptx-asset="texture-1" '
+                'style="position:absolute;left:0;top:0;width:778px;height:1080px" '
+                'src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
+            )
+
+            problems = validate_layout_assets(root, html, 'assets/pptx-claude')
+
+            self.assertEqual(1, len(problems))
+            self.assertIn('位置尺寸必须为 [1142, 0, 778, 1080]', problems[0])
+
+    def test_fixed_asset_cannot_be_hidden(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_texture_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage><section data-pptx-layout="cover">'
+                '<div hidden><img data-pptx-asset="texture-1" '
+                'style="position:absolute;left:1142px;top:0;width:778px;height:1080px" '
+                'src="assets/pptx-claude/textures/1.webp"></div>'
+                '</section></deck-stage>',
+            )
+
+            problems = validate_layout_assets(root, html, 'assets/pptx-claude')
+
+            self.assertEqual(1, len(problems))
+            self.assertIn('不可隐藏', problems[0])
+
+    def test_zero_sized_fixed_asset_is_hidden(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_texture_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage><section data-pptx-layout="cover">'
+                '<img data-pptx-asset="texture-1" '
+                'style="position:absolute;left:1142px;top:0;width:0;height:1080px" '
+                'src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
+            )
+
+            problems = validate_layout_assets(root, html, 'assets/pptx-claude')
+
+            self.assertEqual(2, len(problems))
+            self.assertTrue(any('不可隐藏' in problem for problem in problems))
+            self.assertTrue(any('位置尺寸必须为' in problem for problem in problems))
+
+    def test_fixed_asset_reference_requires_an_instance_marker(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_texture_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage><section data-pptx-layout="cover">'
+                '<img style="position:absolute;left:1142px;top:0;width:778px;height:1080px" '
+                'src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
+            )
+
+            problems = validate_layout_assets(root, html, 'assets/pptx-claude')
+
+            self.assertEqual(2, len(problems))
+            self.assertTrue(any(
+                '缺少 data-pptx-asset' in problem for problem in problems))
+            self.assertTrue(any(
+                '缺少固定实例 texture-1' in problem for problem in problems))
+
+    def test_fixed_asset_cannot_hide_a_generated_source_behind_the_original_url(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_texture_pack(root)
+            html = self.write_html(
+                root,
+                '<deck-stage><section data-pptx-layout="cover">'
+                '<img data-pptx-asset="texture-1" '
+                'style="position:absolute;left:1142px;top:0;width:778px;height:1080px;'
+                'background-image:url(\'assets/pptx-claude/textures/1.webp\')" '
+                'src="assets/generated/replacement.webp"></section></deck-stage>',
+            )
+
+            problems = validate_layout_assets(root, html, 'assets/pptx-claude')
+
+            self.assertEqual(1, len(problems))
+            self.assertIn('未引用对应的 PPTX 原素材', problems[0])
+
+    def test_fixed_asset_nested_in_flow_is_checked_at_its_box(self):
+        with tempfile.TemporaryDirectory() as root:
+            self.write_texture_pack(root)
+            with open(os.path.join(root, 'layouts.md'), 'w', encoding='utf-8') as stream:
+                stream.write(
+                    '---\n'
+                    'canvas: 1920x1080\n'
+                    'layouts:\n'
+                    '  cover:\n'
+                    '    role: cover\n'
+                    '    flow:\n'
+                    '      top: 80\n'
+                    '      margin: [80, 80]\n'
+                    '      gap: 32\n'
+                    '      regions:\n'
+                    '        - kind: free\n'
+                    '          items:\n'
+                    '            - {role: texture, type: pic, box: [1142, 0, 778, 1080], asset: texture-1}\n'
+                    '---\n'
+                )
+            html = self.write_html(
+                root,
+                '<deck-stage><section data-pptx-layout="cover">'
+                '<img data-pptx-asset="texture-1" '
+                'style="position:absolute;left:1142px;top:0;width:778px;height:1080px" '
+                'src="assets/pptx-claude/textures/1.webp"></section></deck-stage>',
+            )
+
+            self.assertEqual(
+                [],
+                validate_layout_assets(root, html, 'assets/pptx-claude'),
+            )
+
 
 if __name__ == '__main__':
     unittest.main()

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

@@ -1,6 +1,8 @@
 #!/usr/bin/env python3
 """Verify that generated slides honor every asset bound to their PPTX layout."""
 import argparse
+import hashlib
+import os
 import posixpath
 import re
 import sys
@@ -40,14 +42,12 @@ def bound_asset_ids(value, known_asset_ids):
 
 def layout_asset_contract(pack):
     known_asset_ids = set(pack.assets)
-    required = {}
     owners = {}
     for layout_name, (layout, _) in pack.layouts.items():
-        asset_counts = bound_asset_ids(layout, known_asset_ids)
-        required[layout_name] = asset_counts
-        for asset_id in asset_counts:
+        for asset_id, _, _ in layout_asset_instances(
+                layout, known_asset_ids, pack.canvas):
             owners.setdefault(asset_id, set()).add(layout_name)
-    return required, owners
+    return owners
 
 
 def asset_urls(pack, asset_prefix, asset_ids):
@@ -63,10 +63,118 @@ def asset_urls(pack, asset_prefix, asset_ids):
         relative = normalized_path(path)
         if relative.startswith('assets/'):
             relative = relative[len('assets/'):]
-        urls[posixpath.join(prefix, relative)] = asset_id
+        urls.setdefault(posixpath.join(prefix, relative), set()).add(asset_id)
     return urls
 
 
+def bound_asset_instances(value, known_asset_ids):
+    """Return every positioned fixed-asset instance nested in slots or flow."""
+    instances = []
+    if isinstance(value, dict):
+        box = value.get('box')
+        asset_id = value.get('asset')
+        if (isinstance(box, list) and len(box) == 4
+                and isinstance(asset_id, str)
+                and asset_id in known_asset_ids):
+            instances.append((asset_id, value.get('role') or 'asset', box))
+        for key, child in value.items():
+            if key not in ('asset', 'background'):
+                instances.extend(bound_asset_instances(child, known_asset_ids))
+    elif isinstance(value, list):
+        for child in value:
+            instances.extend(bound_asset_instances(child, known_asset_ids))
+    return instances
+
+
+def layout_asset_instances(layout, known_asset_ids, canvas):
+    """Return every fixed image instance declared by one layout."""
+    if not isinstance(layout, dict):
+        return []
+    instances = []
+    background = layout.get('background')
+    if canvas and isinstance(background, str) and background in known_asset_ids:
+        instances.append(
+            (background, 'background', [0, 0, canvas[0], canvas[1]]))
+    instances.extend(bound_asset_instances(layout, known_asset_ids))
+    return instances
+
+
+def inline_styles(value):
+    styles = {}
+    for declaration in (value or '').split(';'):
+        if ':' not in declaration:
+            continue
+        name, raw = declaration.split(':', 1)
+        styles[name.strip().lower()] = re.sub(
+            r'\s*!important\s*$', '', raw.strip().lower())
+    return styles
+
+
+def css_number(value):
+    match = re.fullmatch(r'(-?(?:\d+(?:\.\d*)?|\.\d+))(?:px)?', value or '')
+    return float(match.group(1)) if match else None
+
+
+def element_box(reference, canvas):
+    styles = reference['styles']
+    if reference['slide_root'] and not any(
+            name in styles for name in ('left', 'top', 'width', 'height')):
+        return [0.0, 0.0, float(canvas[0]), float(canvas[1])]
+    values = [
+        css_number(styles.get(name))
+        for name in ('left', 'top', 'width', 'height')
+    ]
+    if styles.get('position') != 'absolute' or any(
+            value is None for value in values):
+        return None
+    return values
+
+
+def boxes_match(actual, expected, tolerance=1.0):
+    return actual is not None and all(
+        abs(actual_value - expected_value) <= tolerance
+        for actual_value, expected_value in zip(actual, expected)
+    )
+
+
+def file_sha256(path):
+    digest = hashlib.sha256()
+    with open(path, 'rb') as stream:
+        for chunk in iter(lambda: stream.read(1024 * 1024), b''):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def copied_asset_problems(pack, html_path, asset_prefix, asset_ids):
+    """Verify copied fixed assets still contain the source PPTX bytes."""
+    problems = []
+    html_root = os.path.dirname(os.path.abspath(html_path))
+    prefix = normalized_path(asset_prefix).rstrip('/')
+    for asset_id in sorted(asset_ids):
+        entry, _ = pack.assets.get(asset_id, (None, None))
+        path = entry.get('path') if isinstance(entry, dict) else None
+        if not isinstance(path, str) or not path:
+            continue
+        relative = normalized_path(path)
+        if relative.startswith('assets/'):
+            relative = relative[len('assets/'):]
+        source_path = os.path.join(pack.root, 'assets', *relative.split('/'))
+        copied_relative = posixpath.join(prefix, relative)
+        copied_path = os.path.join(html_root, *copied_relative.split('/'))
+        if not os.path.isfile(copied_path):
+            problems.append(
+                '固定素材 %s 未复制到项目: %s' % (asset_id, copied_relative))
+            continue
+        if not os.path.isfile(source_path):
+            problems.append(
+                '风格包中的固定素材 %s 不存在: %s' % (asset_id, path))
+            continue
+        if file_sha256(copied_path) != file_sha256(source_path):
+            problems.append(
+                '固定素材 %s 已被替换或改写，必须使用 PPTX 原文件' % asset_id)
+    return problems
+
+
 def urls_from_attrs(attrs):
     urls = []
     for key, value in attrs:
@@ -85,50 +193,72 @@ class SlideAssetParser(HTMLParser):
     def __init__(self):
         super().__init__()
         self.slides = []
-        self._tags = []
-        self._sections = []
-        self._active_slides = []
+        self._stack = []
         self._style_depth = 0
         self.outside_urls = []
 
     def handle_starttag(self, tag, attrs):
         tag = tag.lower()
+        attrs_map = {key.lower(): value for key, value in attrs}
         urls = urls_from_attrs(attrs)
-        parent = self._tags[-1] if self._tags else None
-        if tag == 'section':
-            slide = (
-                {'layout': dict(attrs).get('data-pptx-layout'), 'urls': urls}
-                if parent == 'deck-stage' else None
+        parent = self._stack[-1] if self._stack else None
+        parent_slide = parent['slide'] if parent else None
+        slide_root = bool(
+            tag == 'section' and parent and parent['tag'] == 'deck-stage')
+        slide = ({
+            'layout': attrs_map.get('data-pptx-layout'),
+            'theme': attrs_map.get('data-pptx-theme'),
+            'references': [],
+        } if slide_root else parent_slide)
+        if slide_root:
+            self.slides.append(slide)
+        styles = inline_styles(attrs_map.get('style'))
+        hidden = bool(
+            (parent and parent['hidden'])
+            or 'hidden' in attrs_map
+            or attrs_map.get('aria-hidden', '').lower() == 'true'
+            or styles.get('display') == 'none'
+            or styles.get('visibility') in ('hidden', 'collapse')
+            or styles.get('content-visibility') == 'hidden'
+            or css_number(styles.get('width')) == 0
+            or css_number(styles.get('height')) == 0
+            or (
+                css_number(styles.get('opacity')) is not None
+                and css_number(styles.get('opacity')) <= 0
             )
-            self._sections.append(slide)
-            if slide is not None:
-                self._active_slides.append(slide)
-        elif self._active_slides:
-            self._active_slides[-1]['urls'].extend(urls)
-        else:
+        )
+        if slide is not None and (urls or attrs_map.get('data-pptx-asset')):
+            slide['references'].append({
+                'asset': attrs_map.get('data-pptx-asset'),
+                'hidden': hidden,
+                'slide_root': slide_root,
+                'source': attrs_map.get('src'),
+                'styles': styles,
+                'tag': tag,
+                'urls': urls,
+            })
+        elif urls:
             self.outside_urls.extend(urls)
         if tag == 'style':
             self._style_depth += 1
         if tag not in VOID_TAGS:
-            self._tags.append(tag)
+            self._stack.append({
+                'hidden': hidden,
+                'slide': slide,
+                'tag': tag,
+            })
 
     def handle_startendtag(self, tag, attrs):
-        if self._active_slides:
-            self._active_slides[-1]['urls'].extend(urls_from_attrs(attrs))
-        else:
-            self.outside_urls.extend(urls_from_attrs(attrs))
+        self.handle_starttag(tag, attrs)
+        if tag.lower() not in VOID_TAGS:
+            self.handle_endtag(tag)
 
     def handle_endtag(self, tag):
         tag = tag.lower()
         if tag == 'style' and self._style_depth:
             self._style_depth -= 1
-        if tag == 'section' and self._sections:
-            slide = self._sections.pop()
-            if slide is not None:
-                self.slides.append(slide)
-                self._active_slides.pop()
-        if tag not in VOID_TAGS and self._tags:
-            self._tags.pop()
+        if tag not in VOID_TAGS and self._stack:
+            self._stack.pop()
 
     def handle_data(self, data):
         if not self._style_depth:
@@ -139,10 +269,13 @@ class SlideAssetParser(HTMLParser):
 def validate_layout_assets(pack_dir, html_path, asset_prefix):
     """Return violations of the asset contract declared by each layout."""
     pack = Pack(pack_dir)
-    required, owners = layout_asset_contract(pack)
+    owners = layout_asset_contract(pack)
     known_urls = asset_urls(pack, asset_prefix, owners)
-    if not known_urls:
-        return []
+    asset_urls_by_id = {
+        asset_id: url
+        for url, asset_ids in known_urls.items()
+        for asset_id in asset_ids
+    }
 
     with open(html_path, encoding='utf-8') as stream:
         text = stream.read()
@@ -150,10 +283,13 @@ def validate_layout_assets(pack_dir, html_path, asset_prefix):
     parser.feed(text)
     parser.close()
 
-    problems = []
+    problems = copied_asset_problems(pack, html_path, asset_prefix, owners)
+    if not parser.slides:
+        problems.append(
+            '没有识别到 deck-stage 的直属 slide section，无法核验模板页型')
+        return problems
     for url in parser.outside_urls:
-        asset_id = known_urls.get(normalized_path(url))
-        if asset_id:
+        for asset_id in sorted(known_urls.get(normalized_path(url), ())):
             problems.append(
                 '模板资产 %s 出现在 slide section 外，无法核验页型归属' % asset_id)
     for number, slide in enumerate(parser.slides, 1):
@@ -164,23 +300,102 @@ def validate_layout_assets(pack_dir, html_path, asset_prefix):
         if layout not in pack.layouts:
             problems.append('第 %d 页声明了不存在的模板页型: %s' % (number, layout))
             continue
-        used_asset_counts = Counter(
-            known_urls[normalized_path(url)]
-            for url in slide['urls']
-            if normalized_path(url) in known_urls
+        layout_entry = pack.layouts[layout][0]
+        explicit_theme = slide['theme']
+        default_theme = pack.design.data.get('default-theme')
+        active_theme = explicit_theme or default_theme
+        if explicit_theme and explicit_theme not in pack.themes:
+            problems.append(
+                '第 %d 页声明了不存在的模板主题: %s' % (number, explicit_theme))
+            continue
+        layout_themes = (
+            (layout_entry.get('themes') or [])
+            if isinstance(layout_entry, dict) else []
         )
+        if active_theme and layout_themes and active_theme not in layout_themes:
+            problems.append(
+                '第 %d 页页型 %s 不支持当前主题 %s；允许主题: %s。'
+                '若确需切换，显式声明 data-pptx-theme'
+                % (number, layout, active_theme, '、'.join(layout_themes)))
+            continue
+        expected = layout_asset_instances(
+            layout_entry, set(pack.assets), pack.canvas)
+        actual = []
+        for reference in slide['references']:
+            referenced_ids = set()
+            normalized_urls = [normalized_path(url) for url in reference['urls']]
+            for url in normalized_urls:
+                referenced_ids.update(known_urls.get(url, ()))
+            asset_id = reference['asset']
+            if not asset_id:
+                for referenced_id in sorted(referenced_ids):
+                    problems.append(
+                        '第 %d 页模板资产 %s 缺少 data-pptx-asset 实例标记'
+                        % (number, referenced_id))
+                continue
+            if asset_id not in pack.assets:
+                problems.append(
+                    '第 %d 页声明了不存在的模板资产: %s' % (number, asset_id))
+                continue
+            expected_url = asset_urls_by_id.get(asset_id)
+            uses_expected_source = (
+                len(normalized_urls) == 1
+                and normalized_urls[0] == expected_url
+                and (
+                    reference['tag'] != 'img'
+                    or (
+                        reference['source']
+                        and normalized_path(reference['source']) == expected_url
+                    )
+                )
+            )
+            if not uses_expected_source:
+                problems.append(
+                    '第 %d 页固定实例 %s 未引用对应的 PPTX 原素材'
+                    % (number, asset_id))
+            if reference['hidden']:
+                problems.append(
+                    '第 %d 页固定实例 %s 不可隐藏' % (number, asset_id))
+            actual.append({
+                'asset': asset_id,
+                'box': element_box(reference, pack.canvas),
+            })
+
+        used_asset_counts = Counter(instance['asset'] for instance in actual)
         for asset_id in sorted(used_asset_counts):
             if layout not in owners.get(asset_id, set()):
                 allowed = '、'.join(sorted(owners.get(asset_id) or ())) or '（无）'
                 problems.append(
                     '第 %d 页页型 %s 不得使用 %s；只允许: %s'
                     % (number, layout, asset_id, allowed))
-        for asset_id, required_count in sorted(required.get(layout, {}).items()):
-            missing_count = required_count - used_asset_counts[asset_id]
-            if missing_count > 0:
+        unmatched = list(actual)
+        for asset_id, _, expected_box in expected:
+            matching_index = next((
+                index for index, instance in enumerate(unmatched)
+                if instance['asset'] == asset_id
+                and boxes_match(instance['box'], expected_box)
+            ), None)
+            if matching_index is not None:
+                unmatched.pop(matching_index)
+                continue
+            same_asset = next((
+                instance for instance in unmatched
+                if instance['asset'] == asset_id
+            ), None)
+            if same_asset:
+                problems.append(
+                    '第 %d 页固定实例 %s 的位置尺寸必须为 %s，当前为 %s'
+                    % (number, asset_id, expected_box, same_asset['box']))
+                unmatched.remove(same_asset)
+            else:
+                problems.append(
+                    '第 %d 页页型 %s 缺少固定实例 %s，位置尺寸应为 %s'
+                    % (number, layout, asset_id, expected_box))
+        for instance in unmatched:
+            if layout in owners.get(instance['asset'], set()):
                 problems.append(
-                    '第 %d 页页型 %s 必须使用其绑定资产 %s 共 %d 处，当前缺少 %d 处'
-                    % (number, layout, asset_id, required_count, missing_count))
+                    '第 %d 页页型 %s 额外使用了固定实例 %s'
+                    % (number, layout, instance['asset']))
     return problems