@lark-apaas/coding-steering 0.1.32-dev.b2f659e → 0.1.32-dev.b6564ba

package/package.json

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

package/steering/design-html/skills/charts/SKILL.md

@@ -145,13 +145,20 @@ metadata:
 ```jsx
 function EChart({ option, style }) {
   const ref = React.useRef(null);
+  const chartRef = React.useRef(null);
   React.useEffect(() => {
     const el = ref.current;
     const chart = echarts.init(el);
-    chart.setOption(option);
-    const ro = new ResizeObserver(() => chart.resize());
-    ro.observe(el);
-    return () => { ro.disconnect(); chart.dispose(); };
+    chartRef.current = chart;
+    const resizeObserver = new ResizeObserver(() => chart.resize());
+    resizeObserver.observe(el);
+    return () => {
+      resizeObserver.disconnect();
+      chart.dispose();
+    };
+  }, []);
+  React.useEffect(() => {
+    chartRef.current.setOption(option);
   }, [option]);
   return <div ref={ref} style={{ width: '100%', minHeight: 300, ...style }} />;
 }

package/steering/design-html/skills/data-viz/SKILL.md

@@ -139,7 +139,7 @@ metadata:
 
 ### 6. 自检
 
-读一遍自己写出的代码（源码级自查），逐项验证以下几点：
+读一遍自己写出的代码，逐项验证以下几点（源码级自查，不用打开浏览器截图）：
 
 - 报表是否回答了步骤 1 确定的核心问题。
 - 信息层级是否清晰（读者能在 5 秒内抓到主要结论）。

package/steering/design-html/skills/hi-fi-design/SKILL.md

@@ -11,7 +11,7 @@ metadata:
 
 创建高保真、精细打磨的设计。
 
-遵循以下通用设计流程（用 todo list 记住）：
+遵循以下通用设计流程：
 1. 澄清关键信息：能从需求、附件、截图或常见模式合理推断的，直接继续；只在关键信息缺失且会影响设计方向时才向用户提问
 2. 查找现有 UI kit 并收集设计上下文——复制所有相关组件，阅读所有相关示例；如果找不到且会影响核心设计方向，再向用户询问
 3. 在文件开头写下假设、上下文和设计推理（把自己当作初级设计师，用户是你的主管），放好设计占位，并尽早展示给用户

package/steering/design-html/skills/interactive-prototype/SKILL.md

@@ -24,20 +24,4 @@ metadata:
 
 **面向桌面的场景**（管理后台、内部工具、数据密集型仪表盘）——不需要重排为移动端布局，但必须设 `min-width`（通常 1024px–1200px），窄于此宽度时整体水平滚动，而不是让布局被挤压变形。
 
-brief 未指明时默认按终端用户产品处理。
-
-## 宣告可升级为全栈应用
-
-宿主为交互原型提供「升级为全栈应用」入口，把纯前端原型转成带服务端的真实应用。入口是否出现，取决于原型有没有向父窗口宣告：
-
-```js
-function announceUpgrade() {
-  window.parent.postMessage({ type: 'miaoda:upgrade:available', kind: 'interactive-prototype' }, '*');
-}
-announceUpgrade();
-// 宿主在 iframe 'load' 时重置能力声明，脚本早于 load 执行时补一次
-if (document.readyState !== 'complete') window.addEventListener('load', announceUpgrade, { once: true });
-```
-
-- 重复宣告无副作用；宁可多发，也不要因时序错过让入口不出现。
-- 只宣告，不实现：原型侧不写升级逻辑，转全栈由宿主发起。
+brief 未指明时默认按终端用户产品处理。

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.

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

@@ -1243,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 = []
@@ -2394,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:
@@ -2921,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')
@@ -3056,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` 就用绝对，'
           '两者只会出现一个。'

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': {

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

@@ -128,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)
@@ -200,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)

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

@@ -207,6 +207,7 @@ class SlideAssetParser(HTMLParser):
             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:
@@ -270,8 +271,6 @@ def validate_layout_assets(pack_dir, html_path, asset_prefix):
     pack = Pack(pack_dir)
     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()
@@ -285,6 +284,10 @@ def validate_layout_assets(pack_dir, html_path, asset_prefix):
     parser.close()
 
     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:
         for asset_id in sorted(known_urls.get(normalized_path(url), ())):
             problems.append(
@@ -297,8 +300,26 @@ def validate_layout_assets(pack_dir, html_path, asset_prefix):
         if layout not in pack.layouts:
             problems.append('第 %d 页声明了不存在的模板页型: %s' % (number, layout))
             continue
+        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(
-            pack.layouts[layout][0], set(pack.assets), pack.canvas)
+            layout_entry, set(pack.assets), pack.canvas)
         actual = []
         for reference in slide['references']:
             referenced_ids = set()

package/steering/design-html/skills/slide-deck/SKILL.md

@@ -45,6 +45,8 @@ metadata:
 
 deck-stage 组件会对每个 slotted 子元素做绝对定位——**绝不**在幻灯片 `<section>` 元素上自行设置 position/inset/width/height。
 
+组件撑满的只是 `<section>` 本身，section 内的容器高度仍由内容撑开；高度由内容撑开的容器上，`justify-content` 等垂直分布声明静默无效。要垂直居中或上下分布，先给承载声明的容器高度（如 `height: 100%`）。
+
 ### 使用 PPTX 风格包
 
 如果前一步产出了 `pptx-style-extract` 风格包，必须把它当作本 deck 的设计系统：
@@ -104,7 +106,7 @@ deck-stage 组件会对每个 slotted 子元素做绝对定位——**绝不**
 
 - **动效。** 动效服务于叙事——引导视线、分层揭示信息、平滑衔接页面——而不是炫技或填空。默认克制，始终以不干扰阅读为底线。deck 动效的形态是**翻到该页时播放一次的入场 / 分步揭示**，不做环境循环——无限循环的装饰动画会持续争夺注意力。实现用 CSS 动画（幻灯片保持可直编的静态 HTML），两条契约（细节见 deck-stage.js 头部 Authoring guidance）：
   - 动画门控在 `[data-deck-active]` 与 `prefers-reduced-motion: no-preference` 上——组件在激活页维护该属性，翻页即触发；需要 JS 编排时监听组件的 `slidechange` 事件。
-  - 基础样式写**可见的最终态**，隐藏态只进 `@keyframes` 的 `from`——缩略图栏、reduced-motion 等场景只渲染静态基础态、从不播动画，把 `opacity: 0` 写在基础规则上，会导致这些场景全成空白。
+  - 基础样式写的就是**动画结束后的最终画面**，`@keyframes` 只描述进入它的路径——判据：删掉所有 `animation` 声明，静止画面应一个像素不变（缩略图栏、print、reduced-motion 渲染的正是这个无动画基态）。
 
 - **层次靠版式，不靠特效。** 页内层级由字号、字重、色块、边框、分隔线和留白建立；内容卡片和区块默认平面化——不加 box-shadow、发光、玻璃拟态（backdrop-filter + 半透明底），渐变默认只用于图上文字的保护渐变（见「图片呈现」）和数据可视化的连续色带。深色底 + 紫蓝渐变 + 发光卡片的「科技感」组合是模型默认值而非设计选择（frontend-design 校准清单第 4 种长相），除非品牌 / brief 明确要求，不要用它。
 
@@ -135,7 +137,7 @@ deck-stage 组件会对每个 slotted 子元素做绝对定位——**绝不**
 
 ## 规划步骤
 
-在常规规划之外，务必完成以下步骤：
+务必完成以下步骤：
 
 1. 如果不清楚受众、期望的品牌风格，先提问。
 2. 写出完整的标题序列。选择**一种**语法风格（例如短主题名词短语或简短陈述句），确保适合内容，并用该风格写出每一个标题。回头通读一遍，判断一个人**仅凭标题**能否跟上整个演示的脉络。标题应像书的章节——用直白的语言告诉读者接下来是什么。审阅这些标题并按需修订。将它们写入 scratchpad.md 文件。
@@ -162,4 +164,4 @@ deck-stage 组件会对每个 slotted 子元素做绝对定位——**绝不**
 - 没有被动空洞：边框 / 底色圈出的范围与其内容相称
 - 页面视觉重量在画布上分布均衡，没有大片区域读成「缺了东西」
 - 每页能指出视觉锚点；版式原型的重复经得起「内容使然还是没做选择」的追问
-- 带动效的元素在缩略图栏和打印视图下完整可见（基础样式即最终态，隐藏态只在 keyframes 的 `from` 里）
+- 带动效的元素在缩略图栏和打印视图下与激活页一致（基础样式即动画终态——删掉 `animation` 声明，静止画面不变）