@lark-apaas/coding-steering 0.1.32-dev.f3c32d8 → 0.1.32-dev.f6e7ce8

package/package.json

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

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

@@ -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

@@ -3075,8 +3075,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_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'
@@ -107,10 +135,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 +158,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 +176,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>',
             )
 
@@ -209,7 +245,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 +253,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 +271,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 +300,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 +336,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,71 @@ 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'),
+            '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 +268,15 @@ 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 +284,9 @@ 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)
     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 +297,84 @@ 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
-        )
+        expected = layout_asset_instances(
+            pack.layouts[layout][0], 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