morph-ppt

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OfficeCLI Morph-PPT Skill

OfficeCLI Morph-PPT 技能

This skill is a scene layer on top of
officecli-pptx
. Every pptx hard rule — visual delivery floor (title ≥ 36pt / body ≥ 18pt / title ≥ 2× body), 12-column grid on 33.87×19.05cm, canonical palettes, chart-choice decision table, connector canon, shell escape, resident + batch, Delivery Gate 1–5a — is inherited, not re-taught. This file adds only what Morph needs on top: cross-slide shape-name binding, Scene Actors vs content prefixing, ghost discipline,

transition=morph

CLI quirks, 52-style visual library lookup, and a morph-specific fresh-eyes Gate 5b extension.

When the pptx base rules cover it, the text here says

→ see pptx v2 §X

. Read

skills/officecli-pptx/SKILL.md

first if you have not.

此技能是基于
officecli-pptx
的场景层。所有pptx硬性规则——视觉交付基准（标题≥36pt / 正文≥18pt / 标题字号≥正文2倍）、33.87×19.05cm画布上的12列网格、标准调色板、图表选择决策表、连接器规范、Shell转义、常驻模式+批量操作、交付关卡1–5a——均已继承，不再重复说明。本文件仅添加Morph所需的额外内容：跨幻灯片形状名称绑定、场景角色与内容前缀规则、隐藏元素规范、

transition=morph

CLI特性、52种视觉样式库查询，以及针对Morph的全新交付关卡5b扩展。

当pptx基础规则已覆盖相关内容时，本文会标注

→ 参见pptx v2 §X

。若未阅读过

skills/officecli-pptx/SKILL.md

，请先阅读该文档。

Setup

安装配置

officecli

is missing:

macOS / Linux:

curl -fsSL https://d.officecli.ai/install.sh | bash

Windows (PowerShell):

irm https://d.officecli.ai/install.ps1 | iex

Verify with

officecli --version

(open a new terminal if PATH hasn't picked up). If install fails, download a binary from https://github.com/iOfficeAI/OfficeCLI/releases.

若未安装

officecli

：

macOS / Linux：

curl -fsSL https://d.officecli.ai/install.sh | bash

Windows (PowerShell)：

irm https://d.officecli.ai/install.ps1 | iex

通过

officecli --version

验证安装（若PATH未更新，需打开新终端）。若安装失败，可从https://github.com/iOfficeAI/OfficeCLI/releases下载二进制文件。

⚠️ Help-First Rule

⚠️ 优先查阅帮助规则

This skill teaches the Morph workflow — when shape names must match, when to ghost, when the CLI auto-prefixes — not every command flag. When a prop name, enum, or preset is uncertain, consult help BEFORE guessing.

bash

officecli help pptx slide           # authoritative for: transition, advanceTime, advanceClick, background
officecli help pptx transition      # transition / transitionDuration / transitionSpeed (Parent: slide)
officecli help pptx shape           # name, preset, x/y/width/height, fill, rotation, opacity, animation
officecli help pptx animation       # preset + trigger + duration values
officecli help pptx <element> --json  # machine-readable schema

Help reflects the installed CLI version. When skill and help disagree, help wins. Every

--prop X=

in this file is grep-verified against

officecli help pptx <element>

. Specific confirmations:

transition=morph

is a listed value on

slide

;

advanceTime

advanceClick

are valid.

transition

is a real element (

officecli help pptx transition

, Parent: slide, set/get) — it exposes

transition

transitionDuration

, and

transitionSpeed

. Set the transition with the high-level path

set <slide> --prop transition=morph

; tune speed/duration with the combined shorthand

transition=morph-slow

(or

-fast

, or

transition=morph-<DUR_MS>

). Speed/duration are set only via that shorthand on the

transition

prop, not as independent sub-props. Both round-trip on readback:

transition=morph-slow

-fast

reads back as

transitionSpeed=slow

fast

, and

transition=morph-<DUR_MS>

(e.g.

morph-1500

) reads back as

transitionDuration=1500

本技能仅教授Morph工作流——包括形状名称何时必须匹配、何时需隐藏元素、CLI何时自动添加前缀——而非所有命令参数。 若不确定属性名、枚举值或预设，请先查阅帮助再尝试。

bash

officecli help pptx slide           # 权威参考：transition、advanceTime、advanceClick、background
officecli help pptx transition      # transition / transitionDuration / transitionSpeed（父元素：slide）
officecli help pptx shape           # name、preset、x/y/width/height、fill、rotation、opacity、animation
officecli help pptx animation       # preset + trigger + duration参数值
officecli help pptx <element> --json  # 机器可读的 schema

帮助内容与已安装的CLI版本同步。若技能文档与帮助内容冲突，以帮助内容为准。本文中所有

--prop X=

均已通过

officecli help pptx <element>

验证。具体确认项：

transition=morph

是

slide

的有效取值；

advanceTime

advanceClick

为合法属性；

transition

是真实元素（

officecli help pptx transition

，父元素为slide，支持设置/获取）——它包含

transition

、

transitionDuration

和

transitionSpeed

。通过高级路径

set <slide> --prop transition=morph

设置过渡效果；通过组合简写

transition=morph-slow

（或

-fast

，或

transition=morph-<DUR_MS>

）调整速度/时长。速度/时长仅能通过

transition

属性的简写设置，无法作为独立子属性设置。两种方式均可反向读取：

transition=morph-slow

-fast

读取为

transitionSpeed=slow

fast

，

transition=morph-<DUR_MS>

（如

morph-1500

）读取为

transitionDuration=1500

。

Mental Model & Inheritance

核心模型与继承规则

Inherits pptx v2. You should have read

skills/officecli-pptx/SKILL.md

first. This skill assumes you know how to: add slides + shapes + charts + connectors; address by

@name=

@id=

; quote paths; use

batch

heredocs; use

tailEnd=triangle

on flow connectors; run the Delivery Gate 1–5a; attribute

[AGENT-ERROR]

[RENDERER-BUG]

[SKILL gap]

. If any of those are unfamiliar, read pptx v2 first.

Inherited from pptx v2 (do NOT re-teach):

Visual delivery floor — title ≥ 36pt / body ≥ 18pt / title ≥ 2× body, cover-richness, contrast floor, no
```
\$\t\n
```
literals, ≤ 1 animation per slide / ≤ 600ms.
Grid math — 33.87 × 19.05cm, edge margin ≥ 1.27cm, inter-block gap ≥ 0.76cm, ≥ 20% negative space. For N-card grids:
```
col = (33.87 − 2·margin − (N−1)·gap) / N
```
.
Four canonical palettes (Executive navy / Forest & moss / Warm terracotta / Charcoal minimal) — morph decks may pick a different mood from
```
reference/styles/
```
, but contrast rules still apply.
Chart-choice table — column vs bar vs line vs pie vs scatter vs large-text KPI;
```
> 3 series + > 8 categories
```
= split.
Connector canon —
```
shape=straight|elbow|curve
```
,
```
@id=
```
for from/to (C-P-6),
```
tailEnd=triangle
```
on every flow.
Shell escape 3-layer —
```
$
```
single-quoted, heredocs for batch,
```
<a:br/>
```
for real newlines.
Resident mode + batch ≤ 12 ops,
```
<<'EOF'
```
single-quoted delimiter.
Delivery Gate 1-5a (schema, token grep, hyperlink rPr, slide-order, dark-on-dark) — every gate prints OK before declaring done.
Known Issues C-P-1..7 (hyperlink rPr, chart spPr warning, animation duration readback, animation remove, connector enum, connector
```
@name=
```
, chart color renderer normalization).
Attribution triage —
```
[AGENT-ERROR]
```
vs
```
[RENDERER-BUG]
```
vs
```
[SKILL gap]
```
.

Morph identity — what this skill owns (delta on top of pptx v2):

Cross-slide shape-name binding. PowerPoint's Morph engine pairs shapes by identical
name=
across adjacent slides and interpolates their position / size / rotation / fill / opacity. No matching name ⇒ no animation, silent fade. This is a workflow discipline, not a CLI feature.
Namespace prefixes:
```
!!scene-*
```
(persistent decoration, never ghosted) /
```
!!actor-*
```
(content that evolves then exits) /
```
#sN-*
```
(per-slide content, ghosted on slide N+1). Plan the names BEFORE you
```
add
```
.
Ghost position
x=36cm
(off the right edge of the 33.87cm canvas). Never delete a
```
!!
```
-prefixed shape — move it off-canvas so the morph exit animation still plays.
transition=morph
auto-prefix quirk. The CLI auto-prepends
```
!!
```
to every shape on a morph slide (
```
#s1-title
```
is stored as
```
!!#s1-title
```
).
```
@name=
```
path selectors still resolve —
```
get .../shape[@name=#s1-title]
```
returns the shape (matching is suffix/prefix-tolerant). The name you read back is the prefixed form. See §Known Issues.
Adjacent-slide spatial variety. Displacement ≥ 5cm or rotation ≥ 15° between pairs — otherwise morph interpolates nothing visible.
Renderer reality. Morph renders in PowerPoint 365 / Keynote / WPS. LibreOffice and many web viewers render as plain fade (runtime feature). Not a skill defect —
```
[RENDERER-BUG]
```
.

继承自pptx v2。你应已阅读

skills/officecli-pptx/SKILL.md

。本技能默认你已掌握：添加幻灯片/形状/图表/连接器；通过

@name=

@id=

定位元素；路径引用；使用

batch

heredocs；为流程连接器设置

tailEnd=triangle

；执行交付关卡1–5a；区分

[AGENT-ERROR]

[RENDERER-BUG]

[SKILL gap]

。若对以上内容不熟悉，请先阅读pptx v2文档。

从pptx v2继承的内容（不再重复说明）：

视觉交付基准——标题≥36pt / 正文≥18pt / 标题字号≥正文2倍、封面丰富度、对比度基准、禁止
```
\$\t\n
```
字面量、单幻灯片≤1个动画/时长≤600ms。
网格计算——33.87×19.05cm画布、边缘边距≥1.27cm、模块间距≥0.76cm、留白≥20%。对于N卡片网格：
```
col = (33.87 − 2·margin − (N−1)·gap) / N
```
。
四种标准调色板（行政海军蓝/森林苔藓绿/暖陶土色/极简炭灰色）——Morph演示文稿可从
```
reference/styles/
```
选择不同风格，但仍需遵循对比度规则。
图表选择表——柱状图/条形图/折线图/饼图/散点图/大文本KPI；
```
>3个系列 + >8个类别
```
需拆分。
连接器规范——
```
shape=straight|elbow|curve
```
、通过
```
@id=
```
指定连接目标（C-P-6）、所有流程连接器设置
```
tailEnd=triangle
```
。
Shell三层转义——
```
$
```
用单引号包裹、批量操作使用heredocs、用
```
<a:br/>
```
表示真实换行。
常驻模式+批量操作≤12个步骤、
```
<<'EOF'
```
单引号分隔符。
交付关卡1-5a（schema、令牌检查、超链接rPr、幻灯片顺序、暗底暗字）——所有关卡显示OK后方可完成交付。
已知问题C-P-1..7（超链接rPr、图表spPr警告、动画时长读取、移除动画、连接器枚举、连接器
```
@name=
```
、图表颜色渲染归一化）。
问题分类——
```
[AGENT-ERROR]
```
/
```
[RENDERER-BUG]
```
/
```
[SKILL gap]
```
。

Morph专属特性（在pptx v2基础上新增）：

跨幻灯片形状名称绑定。PowerPoint的Morph引擎通过相邻幻灯片间**完全相同的
```
name=
```
**匹配形状，并插值其位置/大小/旋转/填充/透明度。无匹配名称则无动画，仅显示默认淡入淡出。这是工作流规范，而非CLI功能。
命名空间前缀：
```
!!scene-*
```
（持久装饰元素，永不隐藏）/
```
!!actor-*
```
（动态变化后退出的内容）/
```
#sN-*
```
（单幻灯片内容，在第N+1张幻灯片隐藏）。添加元素前需规划好名称。
隐藏位置
x=36cm
（超出33.87cm画布右边缘）。切勿删除
```
!!
```
前缀的形状——将其移至画布外，以确保Morph退出动画正常播放。
transition=morph
自动前缀特性。CLI会自动为Morph幻灯片上的所有形状添加
```
!!
```
前缀（
```
#s1-title
```
存储为
```
!!#s1-title
```
）。
```
@name=
```
路径选择器仍可正常解析——
```
get .../shape[@name=#s1-title]
```
可返回对应形状（匹配时忽略前缀/后缀）。读取到的名称为带前缀的形式。参见§已知问题。
相邻幻灯片空间差异。配对形状的位移≥5cm或旋转≥15°——否则Morph无法生成可见的插值动画。
渲染环境限制。Morph可在PowerPoint 365/Keynote/WPS中正常渲染。LibreOffice及多数网页查看器仅渲染为普通淡入淡出（运行时特性）。这不属于技能缺陷——标记为
```
[RENDERER-BUG]
```
。

Reverse handoff — when to go BACK to pptx base (or sibling skills)

反向移交规则——何时回归pptx基础版（或同类技能）

Stay in pptx v2 base for any deck without cross-slide motion (board reviews, sales decks, all-hands, training). Stay in officecli-pitch-deck for fundraising narrative arcs without morph. Use this skill only when the user explicitly asks for "morph" / "smooth transitions" / "continuous animation" AND ≥ 2 consecutive slides share a visual element that transforms. "Animated deck" meaning one-off entrance animations → pptx v2 §Animations, not morph.

无跨幻灯片动效的演示文稿（董事会评审、销售演示、全员大会、培训材料）请使用pptx v2基础版。无Morph效果的筹款叙事文稿请使用officecli-pitch-deck。仅当用户明确要求"morph"/"smooth transitions"/"continuous animation"且≥2张连续幻灯片共享需变换的视觉元素时，方可使用本技能。若"动画演示文稿"指单张幻灯片的入场动画，请使用pptx v2 §Animations，而非本技能。

Shell & Execution Discipline

Shell与执行规范

Shell quoting, incremental execution,
$FILE
convention → see pptx v2 §Shell & Execution Discipline. Same rules verbatim.

Morph-specific additions:

!!
in shell values — single-quote. Bash / zsh history expansion eats unquoted
```
!!foo
```
. Always use
```
--prop 'name=!!scene-ring'
```
(single quotes). In Python
```
subprocess.run([...])
```
lists, no quoting needed — pass
```
"name=!!scene-ring"
```
as a plain string.
$
in prop text — single-quote (price tokens).
```
--prop text='$9/mo'
```
and
```
--prop text='$199/yr'
```
— NEVER
```
--prop text="$9/mo"
```
(zsh/bash eat
```
$9
```
as empty var → text rendered as
```
.
```
/ stray period). Same for
```
${VAR}
```
,
```
$USER
```
,
```
\n
```
,
```
\r
```
,
```
\t
```
inside a double-quoted prop. Gate 2 morph addendum below greps for the leak signature.
#
in shell values — safe, but quote anyway.
```
#
```
is a comment leader only at the start of a shell word.
```
--prop name=#s1-title
```
works, but
```
--prop 'name=#s1-title'
```
is the habit that stops you guessing.
Batch heredoc is the cleanest path for multi-shape slides.
```
<<'EOF' | officecli batch $FILE
```
disables all shell expansion — safe for
```
$
```
,
```
!!
```
,
```
#
```
,
```
'
```
inside the JSON body.

--json
responses wrap the payload in
.data.results[]
. Both

query

and

get

return a

.data.results[]

array. A single node's

format

sits at

.data.results[0].format.X

; that node's children sit at

.data.results[0].children[]

(each child's format at

.data.results[0].children[].format.X

). Always go through

.data.results[0]

— bare

.data.children[]

.data.format

returns null silently.

Variable:
```
FILE="deck.pptx"
```
at the top of every build script; every example below uses
```
$FILE
```
.
Gate shell pattern — COUNT, then if/else. Never write
```
grep … && echo LEAK || echo OK
```
— when grep exits 1 (0 matches), the
```
||
```
branch fires with empty stdout and prints "OK" confusingly (or prints "LEAK" from prior pipes). Canonical form:
```
COUNT=$(cmd | wc -l); if [ "$COUNT" -gt 0 ]; then echo "LEAK: …"; else echo "OK"; fi
```
.

Shell引用、增量执行、
$FILE
约定 → 参见pptx v2 §Shell & Execution Discipline。规则完全一致。

Morph专属补充规则：

Shell值中的
!!
——使用单引号。Bash/zsh历史扩展会解析未加引号的
```
!!foo
```
。请始终使用
```
--prop 'name=!!scene-ring'
```
（单引号）。在Python
```
subprocess.run([...])
```
列表中无需引号——直接传递
```
"name=!!scene-ring"
```
作为字符串。
属性文本中的
$
——使用单引号（价格令牌）。
```
--prop text='$9/mo'
```
和
```
--prop text='$199/yr'
```
——切勿使用
```
--prop text="$9/mo"
```
（zsh/bash会将
```
$9
```
解析为空变量，导致文本渲染为
```
/mo
```
或孤立点）。双引号属性中的
```
${VAR}
```
、
```
$USER
```
、
```
\n
```
、
```
\r
```
、
```
\t
```
同理。下文的关卡2 Morph补充规则会检查此类泄漏特征。
Shell值中的
#
——安全但仍建议加引号。
```
#
```
仅在Shell语句开头时作为注释符。
```
--prop name=#s1-title
```
可正常工作，但
```
--prop 'name=#s1-title'
```
是更稳妥的习惯，避免判断失误。
批量操作heredocs是多形状幻灯片的最佳方式。
```
<<'EOF' | officecli batch $FILE
```
会禁用所有Shell扩展——可安全处理JSON体中的
```
$
```
、
```
!!
```
、
```
#
```
、
```
'
```
。
--json
响应将负载包裹在
.data.results[]
中。
```
query
```
和
```
get
```
均返回
```
.data.results[]
```
数组。单个节点的
```
format
```
位于
```
.data.results[0].format.X
```
；该节点的子元素位于
```
.data.results[0].children[]
```
（每个子元素的
```
format
```
位于
```
.data.results[0].children[].format.X
```
）。请始终通过
```
.data.results[0]
```
访问——直接使用
```
.data.children[]
```
或
```
.data.format
```
会静默返回null。
变量约定：每个构建脚本顶部定义
```
FILE="deck.pptx"
```
；下文所有示例均使用
```
$FILE
```
。
Shell关卡模式——计数后判断。切勿编写
```
grep … && echo LEAK || echo OK
```
——当grep返回1（无匹配）时，
```
||
```
分支会触发并输出空内容，导致错误显示"OK"（或显示之前管道的"LEAK"）。标准形式：
```
COUNT=$(cmd | wc -l); if [ "$COUNT" -gt 0 ]; then echo "LEAK: …"; else echo "OK"; fi
```
。

Two primitives this skill owns

本技能核心的两个概念

Scene Actors = persistent
```
!!
```
-named shapes (decoration or content) paired by identical name across adjacent slides so Morph can interpolate them. Every
```
!!scene-*
```
/
```
!!actor-*
```
shape is a scene actor.
Choreography = the plan for how actors evolve — who moves where, who enters, who exits, on which slide pair. Written BEFORE code in the §Morph Pair Planning table.

Use this skill when the user asks for morph motion AND ≥ 2 consecutive slides share a visual element that transforms. Target-viewer caveat: morph needs PowerPoint 365 / Keynote / WPS — if the user is LibreOffice-only, warn first (see §Renderer honesty).

Speaker notes rule. Every content slide (non-cover, non-closing) MUST carry speaker notes via

officecli add "$FILE" /slide[N] --type notes --prop text='…'

. Missing notes = not shippable — inherits pptx v2 §Hard rules (H7). Morph decks tend to be visually minimal, so notes carry the narration.

场景角色 = 带
```
!!
```
前缀的持久形状（装饰或内容），通过相同名称在相邻幻灯片间配对，使Morph可插值动画。所有
```
!!scene-*
```
/
```
!!actor-*
```
形状均为场景角色。
编排 = 规划角色的演变方式——谁移动到何处、谁入场、谁退场、在哪些幻灯片对中执行。需在§Morph配对规划表中提前编写，再进行代码实现。

仅当用户要求Morph动效且≥2张连续幻灯片共享需变换的视觉元素时，方可使用本技能。目标查看器注意事项：Morph需要PowerPoint 365/Keynote/WPS——若用户仅使用LibreOffice，请提前告知（参见§渲染环境说明）。

演讲备注规则。所有内容幻灯片（非封面、非结尾）必须通过

officecli add "$FILE" /slide[N] --type notes --prop text='…'

添加演讲备注。缺失备注则不可交付——继承自pptx v2 §硬性规则（H7）。Morph演示文稿通常视觉简洁，备注需承载叙事内容。

What is Morph? (core mechanics)

Morph是什么？（核心机制）

PowerPoint's Morph transition creates smooth motion by interpolating shape properties between adjacent slides, matched by identical shape names.

Slide 1: shape name="!!scene-ring" x=5cm  width=8cm   fill=E94560 opacity=0.3
Slide 2: shape name="!!scene-ring" x=20cm width=12cm fill=E94560 opacity=0.6
         ↓  transition=morph on slide 2
Result:  Ring smoothly moves, grows, and fades darker over ~1 second

Morph only runs if slide N+1 carries

transition=morph

. Apply it via

officecli add / --type slide --prop transition=morph

on creation, or

officecli set "/slide[N]" --prop transition=morph

after the fact. Slides 2+ that omit this prop fall back to whatever the master defines (usually no transition) — motion dies silently.

Three-prefix naming system (non-negotiable):

Prefix	Role	Lifecycle	Example
`!!scene-*`	Background / decoration — persists across the entire deck	Set once, adjust position/size to create motion; rarely ghosted	`!!scene-ring` , `!!scene-bg-band` , `!!scene-grid`
`!!actor-*`	Content / foreground — evolves across a section	Introduced on slide N, modified on slide N+1, N+2…, ghosted to `x=36cm` on its exit slide	`!!actor-feature-box` , `!!actor-metric` , `!!actor-headline`
`#sN-*`	Per-slide content (titles, bullets, captions)	Added fresh on slide N, ghosted to `x=36cm` on slide N+1	`#s1-title` , `#s2-kpi` , `#s3-caption`

Hard rule:

!!scene-*

and

!!actor-*

names must NEVER collide (e.g.,

!!scene-card

!!actor-card

in the same deck — morph engine confuses them). Disambiguate:

!!scene-card-bg

!!actor-card-content

Charts can be morph-paired.

officecli add … --type chart

accepts

--prop name=!!…

(the name reads back), so a chart with an identical

!!

-name on adjacent slides participates in shape-name morph pairing — the chart frame interpolates position / size. Note morph cannot interpolate the plotted data inside the chart frame. For bar-grow / line-grow narratives where the bars themselves must animate: (a) accept plain fade-in of the chart as-is, OR (b) build N

!!actor-bar-K

rectangles manually sized to the values and morph those — each rect carries the same

!!actor-bar-K

name across adjacent slides while width / height / fill evolves.

Ghost accumulation is silent. Once a

!!

-prefixed shape appears on any slide, it stays visible on every subsequent morph slide unless explicitly moved to

x=36cm

final-check

helper does NOT detect

!!

shapes lingering in the visible area — only Gate 5b screenshot audit does. Plan every actor's exit slide in the pair table BEFORE coding.

Spatial variety rule. Adjacent slides must have noticeably different compositions — displacement ≥ 5cm OR rotation ≥ 15° OR size delta ≥ 30% on at least 3 morph-paired shapes. Without this, morph interpolates nothing visible and the transition collapses to a fade (silent-fail).

Simultaneous-timing constraint. All

!!

shapes in one morph pair animate simultaneously. To stagger shape A before shape B, insert an intermediate keyframe slide — there is no per-shape delay knob.

Paired vs enter vs exit — three behaviors, one rule. Same mechanism (shape-name match) produces three outcomes:

Behavior	Source slide A	Target slide B	Who carries `!!` ?
Paired morph (interpolate)	has `!!foo`	has `!!foo`	both slides, identical name
Enter (fade / morph-in)	— (no counterpart)	has `!!foo`	target only — new shape
Exit via ghost (slide off)	has `!!foo` at visible `x`	has `!!foo` at `x=36cm`	both — same name, B is off-canvas

Outgoing content (not incoming) is what gets
!!
-prefixed + ghosted.

!!actor-*

shapes silently "disappear" when you forget them — their name going missing on slide B reads as an unpaired exit (plain fade). Always explicit-ghost to

x=36cm

so the exit animation slides off the right edge visibly. One runnable example:

bash

undefined

PowerPoint的Morph过渡通过插值相邻幻灯片间形状的属性，创建平滑动效，匹配依据为完全相同的形状名称。

幻灯片1：shape name="!!scene-ring" x=5cm  width=8cm   fill=E94560 opacity=0.3
幻灯片2：shape name="!!scene-ring" x=20cm width=12cm fill=E94560 opacity=0.6
         ↓  幻灯片2设置transition=morph
结果：  圆环在约1秒内平滑移动、放大并加深透明度

仅当第N+1张幻灯片设置

transition=morph

时，Morph才会生效。可在创建幻灯片时通过

officecli add / --type slide --prop transition=morph

设置，或通过

officecli set "/slide[N]" --prop transition=morph

事后修改。未设置该属性的第2+张幻灯片会使用母版默认过渡（通常无过渡）——动效会静默失效。

三前缀命名系统（不可协商）：

前缀	作用	生命周期	示例
`!!scene-*`	背景/装饰——贯穿整个演示文稿	仅设置一次，调整位置/大小实现动效；极少隐藏	`!!scene-ring` , `!!scene-bg-band` , `!!scene-grid`
`!!actor-*`	内容/前景——在某章节内动态变化	在第N张幻灯片引入，在第N+1、N+2…张幻灯片修改，在退场幻灯片移至 `x=36cm` 隐藏	`!!actor-feature-box` , `!!actor-metric` , `!!actor-headline`
`#sN-*`	单幻灯片内容（标题、项目符号、说明文字）	在第N张幻灯片新增，在第N+1张幻灯片移至 `x=36cm` 隐藏	`#s1-title` , `#s2-kpi` , `#s3-caption`

硬性规则：

!!scene-*

和

!!actor-*

名称绝对不可冲突（例如，同一演示文稿中同时存在

!!scene-card

和

!!actor-card

——Morph引擎会混淆两者）。需明确区分：

!!scene-card-bg

!!actor-card-content

。

图表可进行Morph配对。

officecli add … --type chart

支持

--prop name=!!…

（名称可被读取），因此相邻幻灯片中带相同

!!

前缀名称的图表可参与形状名称Morph配对——图表框架会插值位置/大小。注意Morph无法插值图表框架内的绘制数据。若需实现条形图增长/折线图增长的叙事效果（条形本身需动画）：(a) 接受图表默认淡入，或(b) 手动创建N个

!!actor-bar-K

矩形，按数值调整大小，并在相邻幻灯片中使用相同

!!actor-bar-K

名称，同时调整宽度/高度/填充。

隐藏元素累积是静默的。一旦某张幻灯片出现

!!

前缀的形状，它会在后续所有Morph幻灯片中保持可见，除非明确移至

x=36cm

。

final-check

助手无法检测

!!

形状是否停留在可见区域——仅能通过关卡5b截图审核检测。请在编码前于配对表中规划每个角色的退场幻灯片。

空间差异规则。相邻幻灯片的布局必须明显不同——至少3个Morph配对形状的位移≥5cm或旋转≥15°或尺寸变化≥30%。若无此差异，Morph无法生成可见的插值动画，过渡效果会退化为淡入淡出（静默失效）。

同步时序限制。同一Morph配对中的所有

!!

形状会同时动画。若需让形状A先于形状B动画，需插入中间关键帧幻灯片——CLI中无单形状延迟参数。

配对/入场/退场——三种效果，同一规则。同一机制（形状名称匹配）可产生三种结果：

效果	源幻灯片A	目标幻灯片B	哪张幻灯片带 `!!` 前缀？
配对Morph（插值）	包含 `!!foo`	包含 `!!foo`	两张幻灯片均包含，名称完全相同
入场（淡入/Morph入场）	—（无对应形状）	包含 `!!foo`	仅目标幻灯片——新增形状
隐藏退场（滑出）	`!!foo` 位于可见 `x` 位置	`!!foo` 位于 `x=36cm`	两张幻灯片均包含——名称相同，B中形状位于画布外

需隐藏退场的是 outgoing 内容（而非 incoming）。若忘记处理

!!actor-*

形状，它们会静默"消失"——第B张幻灯片中缺失该名称会被视为未配对退场（普通淡入淡出）。请始终明确移至

x=36cm

隐藏，以实现可见的右侧滑出退场动画。可运行示例：

bash

undefined

Slide 2: actor is visible at x=5cm — Slide 3: same name, ghosted off-canvas → visible slide-off motion

幻灯片2：角色位于x=5cm可见位置 —— 幻灯片3：同一名称，移至画布外隐藏 → 可见滑出动效

officecli add "$FILE" "/slide[3]" --type shape --prop 'name=!!actor-metric'
--prop text="42%" --prop x=36cm --prop y=8cm --prop width=6cm --prop height=3cm


**Content (`#sN-*`) is added fresh per slide.** Because text changes every slide, Morph has no meaningful pairing to do on titles / body — it cross-fades them. This is why `#sN-*` get different names per slide (they are intentionally unpaired) and must be ghosted on slide N+1. Scene actors (`!!`) carry the continuity; content (`#`) carries the message.

officecli add "$FILE" "/slide[3]" --type shape --prop 'name=!!actor-metric'
--prop text="42%" --prop x=36cm --prop y=8cm --prop width=6cm --prop height=3cm


**内容（`#sN-*`）每张幻灯片新增**。由于每张幻灯片的文本不同，Morph无法对标题/正文进行有意义的配对——仅会交叉淡入淡出。因此`#sN-*`每张幻灯片使用不同名称（故意不配对），且必须在第N+1张幻灯片隐藏。场景角色（`!!`）保证视觉连续性；内容（`#`）传递信息。

Morph Pair Planning (pre-code, REQUIRED)

Morph配对规划（编码前必备）

Before planning morph pairs, if the deck's audience / purpose / narrative is underspecified, run the planning prompt in

reference/decision-rules.md

to emit a

brief.md

first — a morph arc without a narrative spine collapses into "slide with motion", not "story with motion".

Plan every transition in a table inside

brief.md

before writing any

officecli add

. Renaming shapes mid-build is the #1 cause of ghost accumulation bugs.

Pair	Slide A (start)	Slide B (end)	Actors in play	Ghost on Slide B
1→2	`!!scene-ring` centered 5cm, `#s1-title` visible	Ring shifts to x=20cm, grows 8→12cm; `#s2-subtitle` revealed	`!!scene-ring` evolves	`#s1-title` → x=36cm
2→3	`!!actor-feature-box` large (14cm wide)	Feature box small (6cm), `!!actor-metric` enters	`!!scene-ring` , `!!actor-feature-box` , `!!actor-metric`	`#s2-subtitle` → x=36cm
3→4	Content section A	Section B divider	—	`!!actor-feature-box` + `!!actor-metric` → x=36cm (section-exit); `#s3-*` → x=36cm

Planning rules:

Decide ALL
```
!!
```
names up front — each morph-paired shape must use the exact same name on both slides.
Classify every
```
!!
```
shape as
```
!!scene-*
```
or
```
!!actor-*
```
. Scene shapes persist; actors must have a planned exit slide.
Section-transition boundary: when moving into a new topic section, ghost ALL previous-section
```
!!actor-*
```
on the first slide of the new section. Only
```
!!scene-*
```
(whole-deck decoration) remains.
Do NOT start building until the table is complete. If the plan changes mid-build, redraw the table and re-verify affected slides.

规划Morph配对前，若演示文稿的受众/用途/叙事未明确，请运行

reference/decision-rules.md

中的规划提示，生成

brief.md

——无叙事主线的Morph弧会沦为"带动效的幻灯片"，而非"带动效的故事"。

编写任何

officecli add

命令前，需在

brief.md

的表格中规划所有过渡效果。构建过程中重命名形状是导致隐藏元素累积bug的首要原因。

配对	幻灯片A（起始）	幻灯片B（结束）	参与的角色	幻灯片B中隐藏的元素
1→2	`!!scene-ring` 居中5cm， `#s1-title` 可见	圆环移至x=20cm，尺寸从8→12cm； `#s2-subtitle` 显示	`!!scene-ring` 变化	`#s1-title` → x=36cm
2→3	`!!actor-feature-box` 大尺寸（宽14cm）	功能框缩小至6cm， `!!actor-metric` 入场	`!!scene-ring` , `!!actor-feature-box` , `!!actor-metric`	`#s2-subtitle` → x=36cm
3→4	内容章节A	章节B分隔页	—	`!!actor-feature-box` + `!!actor-metric` → x=36cm（章节退场）； `#s3-*` → x=36cm

规划规则：

提前确定所有
```
!!
```
名称——每个Morph配对形状在两张幻灯片中必须使用完全相同的名称。
将每个
```
!!
```
形状分类为
```
!!scene-*
```
或
```
!!actor-*
```
。场景形状持续存在；角色必须规划退场幻灯片。
章节过渡边界： 进入新主题章节时，在新章节的第一张幻灯片中隐藏所有前一章节的
```
!!actor-*
```
。仅保留
```
!!scene-*
```
（全演示文稿装饰元素）。
表格完成前请勿开始构建。若中途更改规划，请重新绘制表格并验证受影响的幻灯片。

Morph Recipes (4 patterns)

Morph示例（4种模式）

Four patterns cover ~95% of morph decks.

$FILE="deck.pptx"

throughout. Each block is self-contained and ≤ 20 lines.

4种模式可覆盖约95%的Morph演示文稿。下文均使用

$FILE="deck.pptx"

。每个代码块独立且≤20行。

(a) Single-element morph — size / position

(a) 单元素Morph——尺寸/位置变化

Visual outcome. A hero title centered on slide 1 (size 48pt at y=8cm), then slide 2 shrinks it to 32pt and shifts it to the top-left corner (x=1.5cm, y=1cm) — letting fresh slide-2 content take center stage. One shape, clean motion, no actors.

bash

FILE="deck.pptx"
officecli create "$FILE"; officecli open "$FILE"

视觉效果。幻灯片1居中显示大标题（48pt，y=8cm），幻灯片2将其缩小至32pt并移至左上角（x=1.5cm，y=1cm）——让幻灯片2的新内容占据中心。仅一个形状，动效简洁，无额外角色。

bash

FILE="deck.pptx"
officecli create "$FILE"; officecli open "$FILE"

Slide 1 — hero

幻灯片1——主标题

officecli add "$FILE" / --type slide --prop layout=blank --prop background=1E2761 officecli add "$FILE" /slide[1] --type shape --prop 'name=!!actor-headline'
--prop text="The one idea" --prop x=4cm --prop y=8cm --prop width=26cm --prop height=3cm
--prop font=Georgia --prop size=48 --prop bold=true --prop color=FFFFFF --prop align=center --prop fill=none

officecli add "$FILE" / --type slide --prop layout=blank --prop background=1E2761 officecli add "$FILE" /slide[1] --type shape --prop 'name=!!actor-headline'
--prop text="核心观点" --prop x=4cm --prop y=8cm --prop width=26cm --prop height=3cm
--prop font=Georgia --prop size=48 --prop bold=true --prop color=FFFFFF --prop align=center --prop fill=none

Slide 2 — headline shrinks + moves; new body takes stage

幻灯片2——标题缩小并移动；新正文显示

officecli add "$FILE" / --type slide --prop layout=blank --prop background=1E2761 --prop transition=morph officecli add "$FILE" /slide[2] --type shape --prop 'name=!!actor-headline'
--prop text="The one idea" --prop x=1.5cm --prop y=1cm --prop width=12cm --prop height=1.5cm
--prop font=Georgia --prop size=24 --prop bold=true --prop color=FFFFFF --prop align=left --prop fill=none officecli add "$FILE" /slide[2] --type shape --prop 'name=#s2-body'
--prop text="Here is the supporting evidence." --prop x=1.5cm --prop y=5cm --prop width=30cm --prop height=2cm
--prop font=Calibri --prop size=20 --prop color=CADCFC --prop fill=none

officecli close "$FILE"; officecli validate "$FILE"

undefined

officecli add "$FILE" / --type slide --prop layout=blank --prop background=1E2761 --prop transition=morph officecli add "$FILE" /slide[2] --type shape --prop 'name=!!actor-headline'
--prop text="核心观点" --prop x=1.5cm --prop y=1cm --prop width=12cm --prop height=1.5cm
--prop font=Georgia --prop size=24 --prop bold=true --prop color=FFFFFF --prop align=left --prop fill=none officecli add "$FILE" /slide[2] --type shape --prop 'name=#s2-body'
--prop text="以下是支撑论据。" --prop x=1.5cm --prop y=5cm --prop width=30cm --prop height=2cm
--prop font=Calibri --prop size=20 --prop color=CADCFC --prop fill=none

officecli close "$FILE"; officecli validate "$FILE"

undefined

(b) Multi-element coordinated morph — Actors / Choreography

(b) 多元素协同Morph——角色/编排

Visual outcome. Three scene actors (

!!scene-ring

!!scene-dot

!!scene-band

) repositioned across 3 slides to feel like a camera pan. Fresh per-slide titles fade in / out via the

#sN-*

ghost pattern. Use this when the narrative has a continuous visual backdrop.

bash

undefined

视觉效果。三个场景角色（

!!scene-ring

!!scene-dot

!!scene-band

）在3张幻灯片中重新定位，模拟镜头平移效果。单幻灯片标题通过

#sN-*

隐藏模式淡入/淡出。适用于叙事需连续视觉背景的场景。

bash

undefined

Slide 1 — anchor composition (already built via recipe a; here we add actors)

幻灯片1——锚定布局（已通过示例a构建；此处添加角色）

officecli add "$FILE" /slide[1] --type shape --prop 'name=!!scene-ring' --prop preset=ellipse
--prop fill=E94560 --prop opacity=0.3 --prop x=5cm --prop y=3cm --prop width=8cm --prop height=8cm officecli add "$FILE" /slide[1] --type shape --prop 'name=!!scene-dot' --prop preset=ellipse
--prop fill=0F3460 --prop x=28cm --prop y=15cm --prop width=1cm --prop height=1cm

Slide 2 — morph: ring moves + grows, dot slides left (spatial variety ≥ 5cm on both)

幻灯片2——Morph：圆环移动并放大，圆点向左滑动（两者空间差异≥5cm）

officecli set "$FILE" "/slide[2]" --prop transition=morph officecli add "$FILE" /slide[2] --type shape --prop 'name=!!scene-ring' --prop preset=ellipse
--prop fill=E94560 --prop opacity=0.6 --prop x=20cm --prop y=2cm --prop width=12cm --prop height=12cm officecli add "$FILE" /slide[2] --type shape --prop 'name=!!scene-dot' --prop preset=ellipse
--prop fill=0F3460 --prop x=3cm --prop y=16cm --prop width=1.5cm --prop height=1.5cm

Ghost slide-1 content (name path still resolves after morph — see Known Issues)

隐藏幻灯片1内容（Morph后名称路径仍可解析——参见已知问题）

officecli set "$FILE" "/slide[2]/shape[@name=#s1-title]" --prop x=36cm 2>/dev/null || true

Verify morph pair: identical names on slides 1 & 2

验证Morph配对：幻灯片1和2中的名称完全相同

officecli get "$FILE" /slide[1] --depth 1 --json | jq -r '.data.results[0].children[]?.format.name // empty' officecli get "$FILE" /slide[2] --depth 1 --json | jq -r '.data.results[0].children[]?.format.name // empty'

Compare —

!!scene-ring

and

!!scene-dot

MUST appear on both, byte-identical.

对比——

!!scene-ring

和

!!scene-dot

必须同时出现在两张幻灯片中，名称完全一致。

Note: morph stores names with a

!!

prefix; compare the prefixed forms.

注意：Morph存储名称时会添加

!!

前缀；请对比带前缀的名称。

undefined

undefined

(c) Continuous multi-slide morph (story arc) — use helpers

(c) 连续多幻灯片Morph（叙事弧）——使用助手工具

Visual outcome. A 5-slide arc telling one continuous story: same 2 scene actors drift across the canvas as the narrative progresses; content (

#sN-*

) refreshes per slide and is ghosted on the next. Building this by hand is ~60 commands — use

reference/morph-helpers.py

to keep the build script short and auto-verified.

python

#!/usr/bin/env python3

视觉效果。5张幻灯片组成的连续叙事：2个场景角色在画布上移动，配合叙事推进；内容（

#sN-*

）每张幻灯片更新，并在下一张幻灯片隐藏。手动构建需约60条命令——使用

reference/morph-helpers.py

可简化脚本并自动验证。

python

#!/usr/bin/env python3

Invoke the provided helper library for clone + ghost + verify

调用提供的助手库进行克隆+隐藏+验证

import subprocess, sys, os SCRIPT_DIR = os.path.dirname(os.path.abspath(file)) HELPERS = os.path.join(SCRIPT_DIR, "reference", "morph-helpers.py") FILE = "deck.pptx"

def helper(*args): subprocess.run([sys.executable, HELPERS, *[str(a) for a in args]], check=True)

import subprocess, sys, os SCRIPT_DIR = os.path.dirname(os.path.abspath(file)) HELPERS = os.path.join(SCRIPT_DIR, "reference", "morph-helpers.py") FILE = "deck.pptx"

def helper(*args): subprocess.run([sys.executable, HELPERS, *[str(a) for a in args]], check=True)

... assume slide 1 is built with 2 scene actors (!!scene-ring, !!scene-dot) + #s1-title

... 假设幻灯片1已构建完成，包含2个场景角色（!!scene-ring, !!scene-dot）+ #s1-title

Helper builds slide 2–5 with: clone from previous + apply transition=morph + ghost previous #sN- content

助手工具构建幻灯片2–5：克隆前一张幻灯片 + 设置transition=morph + 隐藏前一张的#s(n-1)-内容

clone

prints the cloned slide's shape list — read it to pick which shape indices carry the

clone

会打印克隆幻灯片的形状列表——读取列表以确定哪些形状索引对应前一张幻灯片的#s(n-1)-内容，然后将这些索引传递给

ghost

。

previous slide's #s(n-1)- content, then pass those explicit indices to

ghost

—

for n in range(2, 6): helper("clone", FILE, n - 1, n) # clone + set transition=morph + list shapes (note the #s(n-1)- indices) helper("ghost", FILE, n, 1, 2) # ghost the #s(n-1)- content shapes by index (here shapes 1 & 2) # …then add THIS slide's #sN- content via officecli add as normal… helper("final-check", FILE) # structural pass; DOES NOT catch !! lingering in visible area


Helper signatures and source: `reference/morph-helpers.py` (`clone`, `ghost`, `verify`, `final-check`). The shell equivalent is `reference/morph-helpers.sh` — pick one per platform; do not mix.

**When to use helpers vs raw `officecli`.** For 2-3 slide decks, raw commands (recipes a, b) are clearer. For 5+ slides with repeating clone/ghost/verify cadence, helpers save ~40% of commands and provide built-in verification. Every slide is still closed by `officecli validate` before delivery.

for n in range(2, 6): helper("clone", FILE, n - 1, n) # 克隆 + 设置transition=morph + 列出形状（记录#s(n-1)-内容的索引） helper("ghost", FILE, n, 1, 2) # 通过索引隐藏#s(n-1)-内容形状（此处为形状1和2） # …然后通过officecli add添加当前幻灯片的#sN-内容… helper("final-check", FILE) # 结构检查；无法检测!!形状是否停留在可见区域


助手工具签名及源码：`reference/morph-helpers.py`（`clone`, `ghost`, `verify`, `final-check`）。Shell版本为`reference/morph-helpers.sh`——根据平台选择其一，请勿混合使用。

**何时使用助手工具 vs 原生`officecli`**。对于2-3张幻灯片的演示文稿，原生命令（示例a、b）更清晰。对于5+张幻灯片且需重复克隆/隐藏/验证的场景，助手工具可减少约40%的命令，并提供内置验证。每张幻灯片仍需通过`officecli validate`验证后交付。

(d) Morph + fade hybrid — entrance on morph slide

(d) Morph+淡入混合——Morph幻灯片入场

Visual outcome. A morph pair where

!!scene-ring

moves continuously while a NEW per-slide card fades in simultaneously. Used when a morph-paired backdrop carries the eye and fresh foreground content needs a softer entrance than a raw appearance.

bash

undefined

视觉效果。Morph配对中

!!scene-ring

连续移动，同时新的单幻灯片卡片淡入。适用于Morph配对背景引导视线，而新前景内容需较柔和入场效果的场景。

bash

undefined

Slide 2 already has transition=morph and !!scene-ring. Add a new card with fade-entrance.

幻灯片2已设置transition=morph和!!scene-ring。添加带淡入入场效果的新卡片。

officecli add "$FILE" /slide[2] --type shape --prop 'name=#s2-card' --prop preset=roundRect
--prop fill=F5F7FA --prop line=none --prop x=2cm --prop y=12cm --prop width=10cm --prop height=5cm

Apply simultaneous-with-morph fade entrance to the new card.

为新卡片设置与Morph同步的淡入入场效果。

'fade-entrance-300-with' = fade in, 300ms, trigger=withPrevious (plays with the morph transition).

'fade-entrance-300-with' = 淡入，300ms，触发时机=withPrevious（与Morph过渡同时播放）。

officecli set "$FILE" "/slide[2]/shape[@name=#s2-card]" --prop animation=fade-entrance-300-with officecli get "$FILE" "/slide[2]/shape[@name=#s2-card]" --json | jq '.data.results[0].format.animation' # readback sanity — drops the trigger suffix, reads back as "fade-entrance-300"


**Why this works.** Morph animates the `!!scene-*` shapes only (they have a pair on slide 1); the new `#s2-card` has no slide-1 counterpart, so morph would default-fade it — `fade-entrance-300-with` makes that fade explicit and timed. Keep the animation per pptx v2 floor: ≤ 600ms, no bounce / swivel / fly-from-edge (`officecli help pptx animation` for the canonical preset list).

officecli set "$FILE" "/slide[2]/shape[@name=#s2-card]" --prop animation=fade-entrance-300-with officecli get "$FILE" "/slide[2]/shape[@name=#s2-card]" --json | jq '.data.results[0].format.animation' # 读取验证——会移除触发后缀，读取为"fade-entrance-300"


**原理**。Morph仅动画`!!scene-*`形状（它们在幻灯片1中有配对）；新的`#s2-card`在幻灯片1中无对应形状，因此Morph会默认淡入——`fade-entrance-300-with`使淡入效果明确并同步时序。动画需遵循pptx v2基准：时长≤600ms，无弹跳/旋转/边缘飞入效果（`officecli help pptx animation`可查看标准预设列表）。

Choreography — animation types + staggered timing

编排——动画类型+交错时序

How morph animates multiple shapes determines what the audience sees. Pick the right mechanism for each pair:

Animation type	How to achieve it (between Slide A and Slide B)
Simple move	Same `!!` name on both slides, same size, different `x` / `y` — morph interpolates position
Scale transform	Same name, different `width` / `height` — morph interpolates size (and re-positions the center)
Move + scale	Different `x` , `y` , `width` , `height` simultaneously — morph handles all dimensions at once
Color / opacity shift	Same name, different `fill` or `opacity` — morph cross-fades the fill
Rotation	Same name, different `rotation` (degrees) — morph rotates along the shortest arc
Font size change	Same name, different `size` (pt) on text shape — interpolates in PowerPoint 365; less reliable on Keynote / WPS / LibreOffice (may degrade to crossfade). For portable motion, pair `size` change with a matching `width` / `height` delta or an `x` / `y` displacement — the spatial change keeps motion visible when size interpolation drops out
Enter (fade in)	Shape exists only on Slide B (no counterpart on A) — morph fades it in
Exit (fade out)	Shape exists only on Slide A (no counterpart on B) — morph fades it out

Multi-shape timing constraint. All

!!

shapes in one morph pair animate simultaneously — there is no per-shape delay / duration knob in the CLI (help confirms: no

morph.duration

morph.delay

on slide). To stagger shape A before shape B, split the transition into two pairs with an intermediate slide:

Slide 2 → Slide 3:  !!actor-A moves (!!actor-B stays put)
Slide 3 → Slide 4:  !!actor-B moves (!!actor-A stays put or ghosts)

Slide 3 is an explicit intermediate keyframe. Do NOT attempt to fake staggering via timing props on the shape's

animation=

prop — Morph runs before per-shape animations.

Good-enough variety heuristic (Best Practice — creative flexibility). For a morph to read as "motion", change at least 3 of {x, y, width, height, rotation, fill, opacity} on the dominant paired shape, with displacement ≥ 5cm OR rotation ≥ 15° OR size delta ≥ 30%. One shape × 3 props is a valid creative pattern (focus on one hero element).

Delivery Gate 5b-morph-2 is stricter. The gate hard-asserts ≥ 3 DIFFERENT

!!

-prefixed shapes each vary by ≥ 1 of {x, y, width, height, rotation, font-size} across the pair — integrity check for "is this really a morph or a pretend-morph". Heuristic informs creative intent; Gate decides delivery. Brand-constant scenery (pinned header strip, footer bar, logo badge) does NOT count toward the 3-shape quota — these are supposed to stay put; motion must come from 3 other named shapes. When in doubt, satisfy the stricter Gate.

Deck-length rhythm. Filling every transition with morph reads as anxious, not cinematic. Pace morph moments to deck length:

8-10 slides (dense): 3-5 morph moments; motion can cluster.
12-18 slides (ceremonial): 3-5 TOTAL morphs, spaced every 4-6 slides; use
```
transition=morph
```
at section dividers so the animation reads as chapter punctuation, not continuous agitation.
18+ slides (Act-based): structure into 3 acts with 1 long section-divider morph between acts (5-10s of deliberate motion with a brief hold), plus 2-3 quieter morphs inside each act. Lean heavier on
```
!!scene-*
```
continuity than per-slide
```
!!actor-*
```
churn.

Morph对多形状的动画方式决定了受众的视觉感受。为每个配对选择合适的机制：

动画类型	实现方式（幻灯片A与B之间）
简单移动	两张幻灯片中形状名称相同，尺寸相同， `x` / `y` 不同——Morph插值位置
缩放变换	名称相同， `width` / `height` 不同——Morph插值尺寸（并重新定位中心）
移动+缩放	同时改变 `x` 、 `y` 、 `width` 、 `height` ——Morph同时处理所有维度
颜色/透明度变化	名称相同， `fill` 或 `opacity` 不同——Morph交叉淡入填充色
旋转	名称相同， `rotation` （角度）不同——Morph沿最短弧旋转
字号变化	名称相同，文本形状的 `size` （pt）不同——在PowerPoint 365中可插值；在Keynote/WPS/LibreOffice中可靠性较低（可能退化为交叉淡入）。如需兼容多环境，可将字号变化与 `width` / `height` 变化或 `x` / `y` 位移配对——空间变化可在尺寸插值失效时保持动效可见
入场（淡入）	形状仅存在于幻灯片B（幻灯片A中无对应）——Morph淡入
退场（淡出）	形状仅存在于幻灯片A（幻灯片B中无对应）——Morph淡出

多形状时序限制。同一Morph配对中的所有

!!

形状会同时动画——CLI中无单形状延迟/时长参数（帮助内容确认：slide无

morph.duration

morph.delay

属性）。若需让形状A先于形状B动画，需将过渡拆分为两个配对，插入中间幻灯片：

幻灯片2 → 幻灯片3:  !!actor-A移动（!!actor-B保持不动）
幻灯片3 → 幻灯片4:  !!actor-B移动（!!actor-A保持不动或隐藏）

幻灯片3为明确的中间关键帧。请勿尝试通过形状

animation=

属性的时序参数模拟交错——Morph会在单形状动画前运行。

足够差异的启发式规则（最佳实践——创意灵活性）。为使Morph呈现为"动效"，主导配对形状需至少改变{x, y, width, height, rotation, fill, opacity}中的3项，且位移≥5cm或旋转≥15°或尺寸变化≥30%。单个形状×3个属性是有效的创意模式（聚焦一个核心元素）。

交付关卡5b-morph-2更严格。该关卡硬性要求：每个配对中至少3个不同的

!!

前缀形状需在{x, y, width, height, rotation, font-size}中至少有一项差异——用于验证"这是否真的是Morph效果，而非伪Morph"。启发式规则指导创意意图；关卡决定是否可交付。品牌固定元素（固定页眉、页脚、Logo徽章）不计入3个形状的配额——这些元素应保持不动；动效应来自其他3个命名形状。若有疑问，请遵循更严格的关卡要求。

演示文稿长度节奏。每个过渡都使用Morph会显得过于繁琐，而非具有电影感。需根据演示文稿长度调整Morph的使用频率：

8-10张幻灯片（内容密集）：3-5次Morph；动效可集中使用。
12-18张幻灯片（正式场合）：总计3-5次Morph，每4-6张幻灯片使用一次；在章节分隔处使用
```
transition=morph
```
，使动画作为章节标点，而非持续干扰。
18+张幻灯片（分幕结构）：分为3幕，幕间使用1次长章节分隔Morph（5-10秒的刻意动效，短暂停顿），每幕内使用2-3次较柔和的Morph。更多依赖
```
!!scene-*
```
的连续性，而非单幻灯片
```
!!actor-*
```
的频繁变化。

Scene-actor spatial rule

场景角色空间规则

Scene actors and actors moving across the canvas MUST stay in predictable zones during morph — otherwise they cross over content and read as clutter.

Safe zones (prefer for scene actor rest positions and morph paths):

Top-right corner:   x ≥ 24cm, y ≤ 6cm
Bottom-right:       x ≥ 24cm, y ≥ 12cm
Bottom-left:        x ≤ 2cm,  y ≥ 12cm
Off-canvas (ghost): x ≥ 33.87cm  (canvas right edge; use x=36cm for explicit ghost)

Avoid resting actors in the content core:

x = 2~28cm, y = 3~16cm

. Actors may pass through the core during morph (that's the motion), but they should not end a slide parked there with high opacity unless they are content themselves (

!!actor-*

carrying the slide's message).

Before placing any scene actor, inspect existing shape bounds:

bash

officecli get "$FILE" "/slide[$N]" --depth 1 --json | \
  jq -r '.data.results[0].children[]? | "\(.format.name // .path)  x=\(.format.x) y=\(.format.y) w=\(.format.width) h=\(.format.height)"'

Confirm the actor's target position does not overlap any

#sN-*

content shape's bounding box (

x + width

y + height

). If it would overlap, lower actor

opacity

≤ 0.15 OR move it to a safe zone.

场景角色和跨画布移动的角色在Morph过程中必须位于可预测区域——否则会与内容重叠，显得杂乱。

安全区域（优先用于场景角色静止位置和Morph路径）：

右上角:   x ≥ 24cm, y ≤ 6cm
右下角:       x ≥ 24cm, y ≥ 12cm
左下角:        x ≤ 2cm,  y ≥ 12cm
画布外（隐藏）: x ≥ 33.87cm （画布右边缘；使用x=36cm明确隐藏）

避免将角色停留在内容核心区：

x = 2~28cm, y = 3~16cm

。角色在Morph过程中可穿过核心区（这是动效的一部分），但除非它们是内容本身（

!!actor-*

承载幻灯片信息），否则不应在高透明度下停留在核心区。

放置任何场景角色前，请检查现有形状边界：

bash

officecli get "$FILE" "/slide[$N]" --depth 1 --json | \
  jq -r '.data.results[0].children[]? | "\(.format.name // .path)  x=\(.format.x) y=\(.format.y) w=\(.format.width) h=\(.format.height)"'

确认角色目标位置不与任何

#sN-*

内容形状的边界框（

至

x + width

，

至

y + height

）重叠。若重叠，需将角色

opacity

降低至≤0.15，或移至安全区域。

Style library lookup workflow

样式库查询工作流

reference/styles/

holds 52 visual style directories (dark / light / warm / vivid / bw / mixed moods) — design inspiration, not templates. Use the library as on-demand reference, not as a content dump.

Why lookup, not copy. Each of the 52

build.sh

files is a complete style demo — but the coordinates were hand-tuned for that specific demo's content length. Copying them verbatim into a deck with different content produces overlaps and misalignment (flagged in

INDEX.md

L5-11). The library's value is the design logic: palette choice for a mood, signature shape, choreography pattern. Apply that logic to your own grid math.

Four-step lookup:

Browse INDEX.
```
reference/styles/INDEX.md
```
groups all 52 styles by palette category and mood (e.g.
```
dark--premium-navy
```
= authoritative / refined;
```
warm--earth-organic
```
= organic / grounded). The Quick Lookup table also shows each style's primary hex trio (bg / fg / accent) — if the user specified a brand color, scan the hex column to find the nearest match without opening every
```
style.md
```
. Pick 1 style that matches the topic mood OR aligns with the user-specified hex.
Read philosophy. Open
```
reference/styles/<style-id>/style.md
```
for design intent — type pairing, color logic, signature elements.
Glance technique. Open
```
reference/styles/<style-id>/build.sh
```
ONLY for technique reference (signature shapes, palette hex codes, choreography ideas) — coordinates are known-buggy per
INDEX.md
L5-11; do not copy them.
Apply on your own canvas. Build your deck using pptx v2 grid math + visual floor; borrow only the palette and the signature gesture.

Pointer:

→ see reference/styles/<style-id>/

— never inline-copy coordinates from a style build.sh.

reference/styles/

包含52个视觉样式目录（深色/浅色/暖色/鲜艳/黑白/混合风格）——用于设计灵感，而非模板。请将库作为按需参考，而非内容直接复用。

为何查询而非复制。每个

build.sh

文件都是完整的样式演示——但坐标是针对该演示的内容长度手动调整的。直接复制到内容不同的演示文稿中会导致重叠和对齐问题（

INDEX.md

L5-11已标记）。库的价值在于设计逻辑：针对风格的调色板选择、标志性形状、编排模式。将该逻辑应用到自己的网格计算中。

四步查询法：

浏览索引。
```
reference/styles/INDEX.md
```
按调色板类别和风格分组所有52种样式（例如
```
dark--premium-navy
```
= 权威/精致；
```
warm--earth-organic
```
= 自然/沉稳）。快速查询表还显示每种样式的主色调三元组（背景/前景/强调色）——若用户指定了品牌颜色，可扫描十六进制列找到最匹配的样式，无需打开每个
```
style.md
```
。选择1种匹配主题风格或用户指定颜色的样式。
阅读设计理念。打开
```
reference/styles/<style-id>/style.md
```
查看设计意图——字体搭配、颜色逻辑、标志性元素。
查看技术实现。仅打开
```
reference/styles/<style-id>/build.sh
```
参考技术实现（标志性形状、调色板十六进制代码、编排思路）——坐标存在已知问题（
INDEX.md
L5-11）；请勿复制。
应用到自己的画布。使用pptx v2网格计算+视觉基准构建演示文稿；仅借鉴调色板和标志性设计手法。

提示：

→ 参见reference/styles/<style-id>/

——切勿直接复制样式build.sh中的坐标。

Delivery Gate (inherits pptx v2 + morph additions)

交付关卡（继承pptx v2 + Morph补充）

Gate 1–5a: full port from pptx v2. → see pptx v2 §Delivery Gate. Schema (whitelisting C-P-2 chart spPr), token grep (

$…$

{{…}}

\$\t\n

()

[]

), hyperlink rPr (C-P-1), slide-order sanity, dark-on-dark contrast (Gate 5a). Refuse to declare done until every pptx Gate 1–5a prints its OK message. Morph decks have the same token / schema / order risks as any pptx.

关卡1–5a：完全继承自pptx v2。→ 参见pptx v2 §Delivery Gate。Schema（白名单C-P-2图表spPr）、令牌检查（

$…$

{{…}}

\$\t\n

()

[]

）、超链接rPr（C-P-1）、幻灯片顺序合理性、暗底暗字对比度（关卡5a）。所有pptx关卡1–5a显示OK后方可完成交付。Morph演示文稿与普通pptx存在相同的令牌/schema/顺序风险。

Gate 2 morph addendum — price / metric tokens eaten by zsh

关卡2 Morph补充——zsh解析价格/度量令牌

Pptx v2 Gate 2 covers

$…$

{{…}}

\$\t\n

literals, empty

()

[]

. Morph decks add a class of leaks: price / metric tokens (

$9/mo

$29/month

$199/yr

) written in double-quoted

--prop text="…"

— the shell eats

$9

as an empty variable and the CLI stores

/mo

or a stray period. Run this in addition to pptx Gate 2:

bash

undefined

pptx v2关卡2覆盖

$…$

、

{{…}}

、

\$\t\n

字面量、空

()

[]

。Morph演示文稿新增一类泄漏：价格/度量令牌（

$9/mo

、

$29/month

、

$199/yr

）使用双引号

--prop text="…"

——Shell会将

$9

解析为空变量，CLI存储为

/mo

或孤立点。除pptx关卡2外，还需运行以下检查：

bash

undefined

Gate 2 morph — price / metric token leaks + stray-period placeholders

关卡2 Morph——价格/度量令牌泄漏+孤立点占位符

Pattern hits: bare prices ($9, $29, $9.99), /unit suffix ($9/mo, $199/yr), ${VAR}, \n/\r/\t, lone period

匹配模式：裸价格($9, $9.99)、/单位后缀($9/mo, $199/yr)、${VAR}、\n/\r/\t、孤立点

LEAKS=$(officecli view "$FILE" text | grep -nE '$[0-9]+(.[0-9]+)?(/(mo|month|yr|year|day|wk|week|hr|hour))?|${[A-Z_]+}|\[nrt]|^.$' || true) if [ -z "$LEAKS" ]; then echo "Gate 2 morph OK"; else echo "LEAK: $LEAKS"; fi


Covers: `$9` `$9.99` `$29/month` `$199/yr` `$1/day` `${VAR}` `\n`/`\r`/`\t` literals + stray `.` placeholders. Fix: single-quote the prop (`--prop text='$9/mo'`).


覆盖：`$9` `$9.99` `$29/month` `$199/yr` `$1/day` `${VAR}` `\n`/`\r`/`\t`字面量 + 孤立点占位符。修复方法：使用单引号包裹属性（`--prop text='$9/mo'`）。

Gate 5b — Visual audit via HTML preview (MANDATORY) — extended for morph

关卡5b——HTML预览视觉审核（必填）——针对Morph扩展

Run

officecli view "$FILE" html

and Read the returned HTML path. For every slide, answer the pptx v2 Gate 5b questions (overlap / dark-on-dark / divider overlap / order sanity / missing arrowheads) PLUS these four morph-specific checks:

Important: selectors with prefix match.

officecli query

only supports operators

!=

~=

>=

<=

— there is NO

^=

prefix operator. A selector like

shape[name^=!!actor-]

returns an

invalid_selector

error. For "starts-with" filtering, use a

get --depth 1

loop +

jq startswith()

as shown below.

5b-morph-1 —
!!actor-*
leak into visible area after its section ends. For every

!!actor-*

that should have exited, confirm

x ≥ 33.87cm

(canvas right edge). Loop + filter (selector-safe):

bash

NSLIDES=$(officecli query "$FILE" slide --json | jq '.data.results | length')
for N in $(seq 1 $NSLIDES); do
  officecli get "$FILE" "/slide[$N]" --depth 1 --json | \
    jq -r --arg n "$N" '.data.results[0].children[]? |
      select(.format.name? // "" | startswith("!!actor-")) |
      select((.format.x // "0cm" | rtrimstr("cm") | tonumber) < 33.87) |
      "slide \($n) leak: \(.format.name) stuck at x=\(.format.x)"'
done

Any line printed = actor stuck visible.

final-check

misses this — only the loop + Read HTML do.

5b-morph-2 — Adjacent slides have identical spatial composition (no motion). Hard rule: between every morph pair, ≥ 3 DIFFERENT

!!

-prefixed shapes must each differ by ≥ 1 of {x, y, width, height, rotation, font-size}. Proof loop (dump both slides, diff same-name shapes, count differing shapes):

bash

for K in 1 2 3 4; do
  A=$(officecli get "$FILE" "/slide[$K]" --depth 1 --json | \
    jq -r '.data.results[0].children[]? | select(.format.name? // "" | startswith("!!")) |
      "\(.format.name)|\(.format.x)|\(.format.y)|\(.format.width)|\(.format.height)|\(.format.rotation // 0)"')
  B=$(officecli get "$FILE" "/slide[$((K+1))]" --depth 1 --json | \
    jq -r '.data.results[0].children[]? | select(.format.name? // "" | startswith("!!")) |
      "\(.format.name)|\(.format.x)|\(.format.y)|\(.format.width)|\(.format.height)|\(.format.rotation // 0)"')
  VARIES=$(diff <(echo "$A") <(echo "$B") | grep -c '^[<>]')
  if [ "$VARIES" -lt 6 ]; then echo "pair $K→$((K+1)) FLAT: only $VARIES diff-lines (need ≥ 6 = 3 shapes × 2 sides)"; fi
done

5b-morph-3 — Morph-pair name mismatches. Adjacent slides must share at least 2

!!

-prefixed names exactly. Proof (note: children live at

.data.results[0].children[]

— bare

.data.children[]

returns null):

bash

for N in 1 2 3 4 5; do
  echo "--- slide $N ---"
  officecli get "$FILE" "/slide[$N]" --depth 1 --json | \
    jq -r '.data.results[0].children[]? | select(.format.name? // "" | startswith("!!")) | .format.name'
done

Visually compare sequential blocks — shared

!!

names between N and N+1 are the morph pairs. Zero overlap = the pair is a plain fade.

5b-morph-4 —
#sN-*
lingering on slide N+1 (ghost leak). Per-slide content MUST be ghosted (

x=36cm

) on the NEXT slide. Loop + filter per N≥2:

bash

NSLIDES=$(officecli query "$FILE" slide --json | jq '.data.results | length')
for N in $(seq 2 $NSLIDES); do
  PREV=$((N-1))
  officecli get "$FILE" "/slide[$N]" --depth 1 --json | \
    jq -r --arg n "$N" --arg p "$PREV" '.data.results[0].children[]? |
      select(.format.name? // "" | startswith("#s\($p)-")) |
      select((.format.x // "0cm" | rtrimstr("cm") | tonumber) < 33.87) |
      "slide \($n) leak: \(.format.name) stuck at x=\(.format.x)"'
done

Any line printed = a

#s(N-1)-*

shape stayed visible on slide N. Ghost it.

REJECT the delivery if any 5b-morph-1..4 loop prints a line. Collect stdout from all four loops into one stream and enforce with the COUNT pattern:

LEAK_COUNT=$(...all four loops... | wc -l); if [ "$LEAK_COUNT" -gt 0 ]; then echo "REJECT: $LEAK_COUNT morph leaks"; else echo "Gate 5b-morph OK"; fi

运行

officecli view "$FILE" html

并读取返回的HTML路径。对每张幻灯片，除回答pptx v2关卡5b的问题（重叠/暗底暗字/分隔符重叠/顺序合理性/缺失箭头）外，还需完成以下四项Morph专属检查：

重要：前缀匹配选择器。

officecli query

仅支持运算符

、

!=

、

~=

、

>=

、

<=

、

——无

^=

前缀运算符。

shape[name^=!!actor-]

这类选择器会返回

invalid_selector

错误。如需"前缀匹配"过滤，请使用

get --depth 1

循环 +

jq startswith()

，如下所示。

5b-morph-1 —
!!actor-*
在章节结束后仍停留在可见区域。对于所有应退场的

!!actor-*

，确认

x ≥ 33.87cm

（画布右边缘）。循环+过滤（选择器安全）：

bash

NSLIDES=$(officecli query "$FILE" slide --json | jq '.data.results | length')
for N in $(seq 1 $NSLIDES); do
  officecli get "$FILE" "/slide[$N]" --depth 1 --json | \
    jq -r --arg n "$N" '.data.results[0].children[]? |
      select(.format.name? // "" | startswith("!!actor-")) |
      select((.format.x // "0cm" | rtrimstr("cm") | tonumber) < 33.87) |
      "slide \($n) leak: \(.format.name) stuck at x=\(.format.x)"'
done

任何输出行均表示角色停留在可见区域。

final-check

无法检测此问题——仅能通过循环+查看HTML检测。

5b-morph-2 — 相邻幻灯片空间布局完全相同（无动效）。硬性规则：每个Morph配对中，至少3个不同的

!!

前缀形状需在{x, y, width, height, rotation, font-size}中至少有一项差异。验证循环（导出两张幻灯片，对比同名形状，统计差异形状数量）：

bash

for K in 1 2 3 4; do
  A=$(officecli get "$FILE" "/slide[$K]" --depth 1 --json | \
    jq -r '.data.results[0].children[]? | select(.format.name? // "" | startswith("!!")) |
      "\(.format.name)|\(.format.x)|\(.format.y)|\(.format.width)|\(.format.height)|\(.format.rotation // 0)"')
  B=$(officecli get "$FILE" "/slide[$((K+1))]" --depth 1 --json | \
    jq -r '.data.results[0].children[]? | select(.format.name? // "" | startswith("!!")) |
      "\(.format.name)|\(.format.x)|\(.format.y)|\(.format.width)|\(.format.height)|\(.format.rotation // 0)"')
  VARIES=$(diff <(echo "$A") <(echo "$B") | grep -c '^[<>]')
  if [ "$VARIES" -lt 6 ]; then echo "pair $K→$((K+1)) FLAT: only $VARIES diff-lines (need ≥ 6 = 3 shapes × 2 sides)"; fi
done

5b-morph-3 — Morph配对名称不匹配。相邻幻灯片必须至少共享2个完全相同的
```
!!
```
前缀名称。验证方法（注意：子元素位于
```
.data.results[0].children[]
```
——直接使用
```
.data.children[]
```
会返回null）：
bash
```
for N in 1 2 3 4 5; do
  echo "--- slide $N ---"
  officecli get "$FILE" "/slide[$N]" --depth 1 --json | \
    jq -r '.data.results[0].children[]? | select(.format.name? // "" | startswith("!!")) | .format.name'
done
```
直观对比连续块——N和N+1之间的共享
```
!!
```
名称即为Morph配对。无重叠则配对为普通淡入淡出。

5b-morph-4 —
#sN-*
在幻灯片N+1中残留（隐藏泄漏）。单幻灯片内容必须在下一张幻灯片中隐藏（

x=36cm

）。循环+过滤（N≥2）：

bash

NSLIDES=$(officecli query "$FILE" slide --json | jq '.data.results | length')
for N in $(seq 2 $NSLIDES); do
  PREV=$((N-1))
  officecli get "$FILE" "/slide[$N]" --depth 1 --json | \
    jq -r --arg n "$N" --arg p "$PREV" '.data.results[0].children[]? |
      select(.format.name? // "" | startswith("#s\($p)-")) |
      select((.format.x // "0cm" | rtrimstr("cm") | tonumber) < 33.87) |
      "slide \($n) leak: \(.format.name) stuck at x=\(.format.x)"'
done

任何输出行均表示

#s(N-1)-*

形状在幻灯片N中仍可见。需隐藏该形状。

若5b-morph-1..4循环输出任何内容，拒绝交付。将四个循环的标准输出合并为一个流，并使用计数模式强制执行：

LEAK_COUNT=$(...all four loops... | wc -l); if [ "$LEAK_COUNT" -gt 0 ]; then echo "REJECT: $LEAK_COUNT morph leaks"; else echo "Gate 5b-morph OK"; fi

。

Renderer honesty

渲染环境说明

Morph renders in: PowerPoint 365 (Windows/Mac), Keynote, WPS, PowerPoint Online.

Morph does NOT render in: LibreOffice Impress (renders static, sometimes as fade), Google Slides web viewer (loses interpolation), most HTML / SVG viewers,

officecli view html

(structural only — morph is runtime). This is

[RENDERER-BUG]

, not a skill defect. Tell the user explicitly: "Open in PowerPoint 365 / Keynote / WPS to see the morph motion; other viewers will show static or plain fade."

Static screenshots from any renderer cannot verify morph motion (the motion only exists at runtime). Use Gate 5b queries above to prove pair correctness; use a live viewer to prove motion quality.

Morph支持的渲染环境： PowerPoint 365（Windows/Mac）、Keynote、WPS、PowerPoint Online。

Morph不支持的渲染环境： LibreOffice Impress（渲染为静态，有时为淡入淡出）、Google Slides网页查看器（丢失插值效果）、多数HTML/SVG查看器、

officecli view html

（仅显示结构——Morph是运行时特性）。这属于

[RENDERER-BUG]

，而非技能缺陷。请明确告知用户："请在PowerPoint 365/Keynote/WPS中打开以查看Morph动效；其他查看器会显示静态或普通淡入淡出。"

任何渲染环境的静态截图无法验证Morph动效（动效仅在运行时存在）。使用上述关卡5b查询验证配对正确性；使用实时查看器验证动效质量。

Ghost Discipline & Actor Lifecycle

隐藏元素规范与角色生命周期

Every
!!actor-*
and
#sN-*
shape must be managed across EVERY slide, not just its "exit" slide.

每个
!!actor-*
和
#sN-*
形状必须在每张幻灯片中管理，而非仅在其"退场"幻灯片中。

The Per-Slide Ghosting Rule

单幻灯片隐藏规则

When building a multi-slide morph deck:

Slide N: Introduce
!!actor-ring
(visible at x=0cm)
Slide N+1: Add new content. Before finishing, ghost
!!actor-ring
to
x=36cm
.
Slide N+2: Add more content. Re-ghost
!!actor-ring
to
x=36cm
again. (Not optional — even though it was already off-screen, each slide is a fresh canvas.)
Slide N+3: If
!!actor-ring
should be visible again, move it back to x=0cm or its new position.

Why: Each slide's shape list is independent. Moving a shape off-canvas on slide N does NOT carry over to slide N+1 — if you forget to re-ghost it, it will re-appear at its original position on N+1.

构建多幻灯片Morph演示文稿时：

幻灯片N：引入
!!actor-ring
（位于x=0cm可见位置）
幻灯片N+1：添加新内容。完成前，将
!!actor-ring
移至x=36cm隐藏。
幻灯片N+2：添加更多内容。再次将
!!actor-ring
移至x=36cm隐藏。（并非可选——即使已在画布外，每张幻灯片都是独立的画布。）
幻灯片N+3：若
!!actor-ring
需再次可见，移回x=0cm或新位置。

原因： 每张幻灯片的形状列表是独立的。在幻灯片N中将形状移至画布外不会延续到幻灯片N+1——若忘记再次隐藏，它会在N+1中回到原始位置。

Workflow Pattern (Bash)

工作流模式（Bash）

bash

undefined

bash

undefined

After adding new content shapes to slide $SLIDE:

向幻灯片$SLIDE添加新内容形状后：

for ACTOR in "!!actor-ring" "!!actor-dot" "!!actor-accent-bar"; do officecli set "$FILE" "/slide[$SLIDE]/shape[@name=$ACTOR]" --prop x=36cm || true done


Or in a build loop:

```bash
for SLIDE_NUM in 3 4 5 6 7 8 9 10 11; do
  # Add content specific to this slide
  officecli add "$FILE" "/slide[$SLIDE_NUM]" --type shape ...
  
  # IMMEDIATELY ghost all old actors (M-2 prevention)
  officecli set "$FILE" "/slide[$SLIDE_NUM]/shape[@name=!!actor-ring]" --prop x=36cm || true
  officecli set "$FILE" "/slide[$SLIDE_NUM]/shape[@name=!!actor-dot]" --prop x=36cm || true
done

for ACTOR in "!!actor-ring" "!!actor-dot" "!!actor-accent-bar"; do officecli set "$FILE" "/slide[$SLIDE]/shape[@name=$ACTOR]" --prop x=36cm || true done


或在构建循环中：

```bash
for SLIDE_NUM in 3 4 5 6 7 8 9 10 11; do
  # 添加当前幻灯片的内容
  officecli add "$FILE" "/slide[$SLIDE_NUM]" --type shape ...
  
  # 立即隐藏所有旧角色（防止M-2问题）
  officecli set "$FILE" "/slide[$SLIDE_NUM]/shape[@name=!!actor-ring]" --prop x=36cm || true
  officecli set "$FILE" "/slide[$SLIDE_NUM]/shape[@name=!!actor-dot]" --prop x=36cm || true
done

Detection: Ghost Count Gate

检测：隐藏元素计数关卡

morph-helpers.py final-check

counts all shapes at

x ≥ 34cm

. If count > 50, it prints:

REJECT: Found 135 accumulated ghosts — likely M-2 ghost accumulation.
Run: officecli query deck.pptx 'shape[x>=34cm]' --json | jq '.data.results | length'
Expected ≤ 50 (roughly 4–5 active actors × 10–12 slides).

Fix: Review the build log, ensure every slide re-ghosts all actors that should not appear in it. Re-run final-check. If still > 50, use

morph-helpers.py clean-accumulation deck.pptx

(see reference section).

morph-helpers.py final-check

会统计所有

x ≥ 34cm

的形状数量。若数量>50，会输出：

REJECT: Found 135 accumulated ghosts — likely M-2 ghost accumulation.
Run: officecli query deck.pptx 'shape[x>=34cm]' --json | jq '.data.results | length'
Expected ≤ 50 (roughly 4–5 active actors × 10–12 slides).

修复： 查看构建日志，确保每张幻灯片都重新隐藏了所有不应显示的角色。重新运行final-check。若仍>50，使用

morph-helpers.py clean-accumulation deck.pptx

（参见参考部分）。

Common Morph Pitfalls (design + workflow traps)

常见Morph陷阱（设计+工作流误区）

Base pptx pitfalls (shell quoting, zsh

[N]

globbing, hex

prefix,

\n

in prop text) → see pptx v2 §Common Pitfalls. These are the morph-specific traps:

Pitfall	Correct approach
`!!scene-card` and `!!actor-card` in the same deck	Names must be unique across prefixes. Rename: `!!scene-card-bg` vs `!!actor-card-content`
Renaming shapes mid-build after some slides are already done	Ghost accumulation bug waiting to happen. Stop, redraw the §Morph Pair Planning table, rerun affected slides
Placing `!!actor-*` into the content core without planning an exit	Every `!!actor-*` needs a ghost slide. Plan it in the pair table BEFORE coding
Ghost accumulation (M-2): forgetting to re-ghost `!!actor-*` on later slides	CRITICAL: When you add new content to slide N+1, ALL `!!actor-` from slide N that should not be visible must be moved to `x=36cm` again. Do NOT assume they stay off-screen once ghosted — each slide is independent. Build pattern: `for each new slide: add content shapes → then loop: set each active !!actor- to x=36cm` . `morph-helpers.py final-check` will REJECT if ghost count exceeds 50.
Forgetting `transition=morph` on a slide	Silent fade. Gate 5b-morph-2 (no motion) catches it; fix via `set /slide[N] --prop transition=morph`
Assuming `@name=` paths break on a morph slide	They do not — `@name=` still resolves after `transition=morph` (M-1); only the readback name gains a `!!` prefix
Adjacent slides visually identical	Morph has nothing to interpolate — collapses to plain fade. Apply §Scene-actor spatial rule and move ≥ 3 shapes by ≥ 5cm / ≥ 15°
Trying to stagger 2 shapes via per-shape timing	Not supported — split the pair into two transitions with an intermediate keyframe slide
Testing morph motion in LibreOffice or a browser	`[RENDERER-BUG]` , not skill defect. Test in PowerPoint 365 / Keynote / WPS
Deleting a `!!` shape on exit instead of ghosting it	Deletion breaks morph pairing — the shape vanishes without animation. Always ghost to `x=36cm`
Writing `--prop text="$9/mo"` with double quotes	Shell eats `$9` as empty variable → text stored as `/mo` or stray `.` . Use single quotes: `--prop text='$9/mo'` . Gate 2 morph addendum greps this leak.
Using `<a:br/>` literal inside `--prop text='line1<a:br/>line2'`	Stored as 7 literal characters, not a line break. Use `officecli add "/slide[N]/shape[@id=K]" --type paragraph` once per line (M-6).
Using `shape[name^=!!actor-]` selector	`officecli query` has no `^=` operator — returns `invalid_selector` . Use `get /slide[N] --depth 1 --json \| jq '.data.results[0].children[]? \| select(.format.name \| startswith("!!actor-"))'` .

基础pptx陷阱（Shell引用、zsh

[N]

globbing、十六进制

前缀、属性文本中的

\n

）→ 参见pptx v2 §Common Pitfalls。以下是Morph专属陷阱：

陷阱	正确做法
同一演示文稿中存在 `!!scene-card` 和 `!!actor-card`	前缀间名称必须唯一。重命名为： `!!scene-card-bg` vs `!!actor-card-content`
部分幻灯片完成后中途重命名形状	会导致隐藏元素累积bug。停止构建，重新绘制§Morph配对规划表，重新运行受影响的幻灯片
将 `!!actor-*` 放置在内容核心区但未规划退场	每个 `!!actor-*` 都需要退场幻灯片。编码前在配对表中规划
隐藏元素累积（M-2）：忘记在后续幻灯片中重新隐藏 `!!actor-*`	关键：向幻灯片N+1添加新内容后，必须将幻灯片N中所有不应显示的 `!!actor-` 再次移至x=36cm。请勿假设隐藏后会一直停留在画布外——每张幻灯片都是独立的。构建模式： `每张新幻灯片：添加内容形状 → 循环：将每个活跃的!!actor-设置为x=36cm` 。若隐藏元素数量超过50， `morph-helpers.py final-check` 会拒绝交付。
忘记在幻灯片上设置 `transition=morph`	动效静默失效。关卡5b-morph-2（无动效）会检测到；通过 `set /slide[N] --prop transition=morph` 修复
假设Morph幻灯片上的 `@name=` 路径失效	不会失效—— `@name=` 在 `transition=morph` 后仍可解析（M-1）；仅读取到的名称会添加 `!!` 前缀
相邻幻灯片视觉完全相同	Morph无内容可插值——退化为普通淡入淡出。遵循§场景角色空间规则，将至少3个形状移动≥5cm/旋转≥15°
尝试通过单形状时序参数交错两个形状	不支持——将配对拆分为两个过渡，插入中间关键帧幻灯片
在LibreOffice或浏览器中测试Morph动效	属于 `[RENDERER-BUG]` ，而非技能缺陷。请在PowerPoint 365/Keynote/WPS中测试
退场时删除 `!!` 形状而非隐藏	删除会破坏Morph配对——形状会无动画消失。始终移至x=36cm隐藏
使用双引号编写 `--prop text="$9/mo"`	Shell会将 `$9` 解析为空变量——文本存储为 `/mo` 或孤立点。使用单引号： `--prop text='$9/mo'` 。关卡2 Morph补充规则会检测此类泄漏。
在 `--prop text='line1<a:br/>line2'` 中使用 `<a:br/>` 字面量	会存储为7个字面字符，而非换行符。受众会看到 `line1<a:br/>line2` 原样渲染。使用 `officecli add "/slide[N]/shape[@id=K]" --type paragraph` 逐行添加（M-6）。
使用 `shape[name^=!!actor-]` 选择器	`officecli query` 无 `^=` 运算符——返回 `invalid_selector` 。使用 `get /slide[N] --depth 1 --json \| jq '.data.results[0].children[]? \| select(.format.name \| startswith("!!actor-"))'` 。

Known Issues & Pitfalls

已知问题与陷阱

Base pptx bugs C-P-1..7 (hyperlink rPr, chart ChartShapeProperties warning, animation duration readback, animation remove, connector enum, connector

@name=

, chart-color renderer normalization) all apply. → see pptx v2 §Known Issues C-P-1..7 for workarounds.

Morph-specific (M-1..5):

#	Symptom	Workaround
M-1	After `officecli set '/slide[N]' --prop transition=morph` , every shape on that slide has `!!` auto-prepended to its name ( `#s1-title` → `!!#s1-title` ). The readback name is the prefixed form. Selector filter caveat: after auto-prefix, `!!#sN-caption` coexists alongside `!!actor-*` — filtering "scene actors" in `jq` with `startswith("!!")` produces false matches on auto-prefixed content. Always filter with `startswith("!!actor-")` or `startswith("!!scene-")` , never bare `startswith("!!")` .	`@name=` path selectors still resolve — `/slide[N]/shape[@name=#s1-title]` returns the shape (matching is suffix/prefix-tolerant), so no path rewrite is needed. When you need the prefixed name in a jq filter, account for the leading `!!` .
M-2 🚨	Ghost accumulation — `!!actor-*` introduced on slide 3 stays visible on slides 4, 5, 6 unless EXPLICITLY ghosted every page. `final-check` helper detects this and rejects if ghost count > 50.	MANDATORY per-slide rule: After you add new content to a slide, immediately set ALL active `!!actor-*` from previous slides to `x=36cm` (or explicitly position them visible if they belong in the current context). Example: `officecli set /slide[4]/shape[@name=!!actor-ring] --prop x=36cm` . Run after EVERY slide addition, not just at the end. See §Ghost Discipline & Actor Lifecycle below.
M-3	Section-transition boundary — on the first slide of a new topic section, previous-section `!!actor-*` shapes visibly linger. No command errors; only visual clutter.	On every section-start slide, explicitly ghost ALL `!!actor-` from the previous section to `x=36cm` . Scene shapes ( `!!scene-` ) stay.
M-4	Agents sometimes invent `morph.duration=` / `transition.delay=` as independent props — they are rejected as UNSUPPORTED.	Use the combined shorthand on the `transition` prop: `transition=morph-slow` / `-fast` , or `transition=morph-<DUR_MS>` (e.g. `transition=morph-1500` ). Both round-trip on readback ( `transitionSpeed=slow` , `transitionDuration=1500` ). Only beyond what the shorthand exposes (fine control of the raw XML), fall back to `raw-set` on `<p:transition>` — see M-4 example block below.
M-5	`[RENDERER-BUG]` LibreOffice / Google Slides web viewer render morph slides as plain fade (no interpolation).	Test in PowerPoint 365 / Keynote / WPS. Not a skill defect — do not chase.
M-6	`<a:br/>` written inside `--prop text='line1<a:br/>line2'` is stored as the literal 7-character string, NOT interpreted as a line break. Audience sees `line1<a:br/>line2` rendered verbatim.	For multi-line bullets / captions, add one paragraph per line: `officecli add "/slide[N]/shape[@id=K]" --type paragraph --prop text='line1'` then repeat with `text='line2'` . See pptx v2 §Shell escape for the real-newline workflow.

M-4 example — slow down all morph transitions, raw-set fallback (prefer

transition=morph-slow

; use this only for control beyond the shorthand). Note

//p:transition

matches both

mc:Choice

and

mc:Fallback

on a morph slide, yielding

2 element(s) affected

bash

undefined

基础pptx bug C-P-1..7（超链接rPr、图表ChartShapeProperties警告、动画时长读取、移除动画、连接器枚举、连接器

@name=

、图表颜色渲染归一化）均适用。→ 参见pptx v2 §Known Issues C-P-1..7获取解决方法。

Morph专属问题（M-1..5）：

#	症状	解决方法
M-1	设置 `officecli set '/slide[N]' --prop transition=morph` 后，该幻灯片上的所有形状名称会自动添加 `!!` 前缀（ `#s1-title` → `!!#s1-title` ）。读取到的名称为带前缀的形式。选择器过滤注意事项：自动添加前缀后， `!!#sN-caption` 与 `!!actor-*` 共存——在 `jq` 中使用 `startswith("!!")` 过滤"场景角色"会误匹配自动添加前缀的内容。请始终使用 `startswith("!!actor-")` 或 `startswith("!!scene-")` 过滤，切勿使用裸 `startswith("!!")` 。	`@name=` 路径选择器仍可正常解析—— `/slide[N]/shape[@name=#s1-title]` 可返回对应形状（匹配时忽略前缀/后缀），无需重写路径。若在jq过滤中需要带前缀的名称，请考虑开头的 `!!` 。
M-2 🚨	隐藏元素累积——幻灯片3引入的 `!!actor-` 在幻灯片4、5、6中仍可见，除非明确在每张幻灯片中隐藏。* `final-check` 助手会检测此问题，若隐藏元素数量>50则拒绝交付。	每张幻灯片必填规则：向幻灯片添加新内容后，立即将之前幻灯片中所有活跃的 `!!actor-*` 设置为x=36cm（或在当前场景中需显示的位置）。示例： `officecli set /slide[4]/shape[@name=!!actor-ring] --prop x=36cm` 。每次添加幻灯片后都需执行，而非仅在最后执行。参见下文§隐藏元素规范与角色生命周期。
M-3	章节过渡边界——新主题章节的第一张幻灯片中，前一章节的 `!!actor-*` 形状仍可见。无命令错误；仅视觉杂乱。	在每个章节起始幻灯片中，明确将所有前一章节的 `!!actor-` 移至x=36cm隐藏。保留场景形状（ `!!scene-` ）。
M-4	有时会生成 `morph.duration=` / `transition.delay=` 作为独立属性——会被标记为UNSUPPORTED拒绝。	使用 `transition` 属性的组合简写： `transition=morph-slow` / `-fast` ，或 `transition=morph-<DUR_MS>` （如 `transition=morph-1500` ）。两种方式均可反向读取（ `transitionSpeed=slow` 、 `transitionDuration=1500` ）。若需超出简写的控制（XML细粒度控制），可回退到对 `<p:transition>` 使用 `raw-set` ——参见下文M-4示例块。
M-5	`[RENDERER-BUG]` LibreOffice/Google Slides网页查看器将Morph幻灯片渲染为普通淡入淡出（无插值）。	在PowerPoint 365/Keynote/WPS中测试。不属于技能缺陷——无需修复。
M-6	在 `--prop text='line1<a:br/>line2'` 中写入 `<a:br/>` 会存储为7个字面字符，而非换行符。受众会看到 `line1<a:br/>line2` 原样渲染。	对于多行项目符号/说明文字，逐行添加段落： `officecli add "/slide[N]/shape[@id=K]" --type paragraph --prop text='line1'` ，然后重复添加 `text='line2'` 。参见pptx v2 §Shell escape获取真实换行工作流。

M-4示例——减慢所有Morph过渡，回退到raw-set（优先使用

transition=morph-slow

；仅在需要超出简写的控制时使用）。注意

//p:transition

会匹配Morph幻灯片上的

mc:Choice

和

mc:Fallback

，导致

2 element(s) affected

：

bash

undefined

Per-slide: add spd="slow" to every transition element on slide N (2 XML hits per morph slide)

单幻灯片：为幻灯片N上的所有transition元素添加spd="slow"（每个Morph幻灯片有2个XML匹配项）

for N in 2 3 4; do officecli raw-set "$FILE" "/slide[$N]" --xpath "//p:transition" --action setattr --xml 'spd=slow' done officecli validate "$FILE"


Readback: `officecli query "$FILE" slide --json | jq '.data.results[].format | select(.transition=="morph") | .transitionSpeed'` prints `"slow"` for each affected slide.

for N in 2 3 4; do officecli raw-set "$FILE" "/slide[$N]" --xpath "//p:transition" --action setattr --xml 'spd=slow' done officecli validate "$FILE"


读取验证：`officecli query "$FILE" slide --json | jq '.data.results[].format | select(.transition=="morph") | .transitionSpeed'`会为每个受影响的幻灯片输出`"slow"`。

Outputs & delivery

输出与交付

Every morph deck ships with three artifacts, each as a standalone file:

```
<topic>.pptx
```
— the deck, closed +
```
officecli validate
```
clean (Delivery Gate 1 OK).
```
build.sh
```
or
```
build.py
```
— the re-runnable script (bash for shell-native builds; Python for multi-slide arcs using
```
morph-helpers.py
```
). Must recreate the deck from a fresh
```
officecli create
```
call.
```
brief.md
```
— standalone file, NOT embedded in anything else. Contains:
- Section 1: topic / audience / purpose / narrative / style direction (1 named style from
```
reference/styles/INDEX.md
```
  )
- Section 2: slide-by-slide outline (page type + one-sentence argument per slide)
- Section 3: §Morph Pair Planning table (Pair / Slide A / Slide B / Actors / Ghosts) — the design record the reviewer needs to audit choreography

Pre-deliver reminder to the user (verbatim-safe wording):

"The deck is ready with morph transitions. Open it in PowerPoint 365 / Keynote / WPS to see the motion — LibreOffice and web viewers render static."
"While the build script is running, the
```
.pptx
```
may be rewritten several times. If you want to preview progress, use
```
officecli watch "$FILE"
```
and open the live preview in AionUi — do NOT click 'Open with system app' during the build, or you'll hit a file lock."

每个Morph演示文稿需交付三个独立文件：

```
<topic>.pptx
```
—— 演示文稿，已关闭且
```
officecli validate
```
验证通过（交付关卡1 OK）。
```
build.sh
```
或
```
build.py
```
—— 可重新运行的脚本（Shell原生构建使用bash；使用
```
morph-helpers.py
```
的多幻灯片弧使用Python）。需能从
```
officecli create
```
重新创建演示文稿。
```
brief.md
```
—— 独立文件，不嵌入任何内容。包含：
- 第1节：主题/受众/用途/叙事/风格方向（来自
```
reference/styles/INDEX.md
```
  的1种命名风格）
- 第2节：幻灯片大纲（每页类型+单句论点）
- 第3节：§Morph配对规划表（配对/幻灯片A/幻灯片B/角色/隐藏元素）——审核编排所需的设计记录

交付前提醒用户（可直接使用的措辞）：

"演示文稿已完成，包含Morph过渡效果。请在PowerPoint 365/Keynote/WPS中打开以查看动效——LibreOffice和网页查看器会显示静态内容。"
"构建脚本运行时，
```
.pptx
```
可能会被多次重写。若需预览进度，请使用
```
officecli watch "$FILE"
```
并在AionUi中打开实时预览——构建过程中请勿点击'使用系统应用打开'，否则会触发文件锁定。"

Adjustments after creation

创建后调整

Standard adjustments table → see pptx v2 §Common Pitfalls /

swap

move

remove

set

. Morph caveat: after any
swap
or
move
that reorders morph-paired slides, re-verify the adjacency of shared
!!
names. Run Gate 5b-morph-3 query above on the affected pairs — if the swap broke a pair, either rename shapes or re-choreograph the transition.

Final sanity check before delivery. Run the full Delivery Gate (1 through 5b-morph-1..4), open the

.pptx

in PowerPoint 365 / Keynote / WPS, watch one full slide-to-slide morph to confirm motion is visible. If any Gate prints REJECT, fix and re-run — never deliver with a known-open gate.

标准调整表 → 参见pptx v2 §Common Pitfalls /

swap

move

remove

set

。Morph注意事项：任何
swap
或
move
重新排序Morph配对幻灯片后，需重新验证共享
!!
名称的相邻性。对受影响的配对运行上述关卡5b-morph-3查询——若交换破坏了配对，需重命名形状或重新编排过渡。

交付前最终检查。运行完整交付关卡（1至5b-morph-1..4），在PowerPoint 365/Keynote/WPS中打开

.pptx

，完整查看一次幻灯片间的Morph过渡，确认动效可见。若任何关卡输出REJECT，修复后重新运行——切勿交付已知存在问题的演示文稿。

References

参考资料

```
reference/decision-rules.md
```
— Pyramid Principle, SCQA, page-type menu,
```
brief.md
```
schema. Read during §Morph Pair Planning to decide narrative arc before writing commands.
```
reference/pptx-design.md
```
— residual design notes (Scene Actors mechanics, page-type table, choreography patterns). Canvas / fonts / colors live in pptx v2 — this file covers only the morph-unique material.
```
reference/morph-helpers.py
```
— Cross-platform (Mac / Windows / Linux) Python helpers for clone + ghost + verify + final-check. Import as a library or call via CLI args. Preferred for 5+ slide arcs.
```
reference/morph-helpers.sh
```
— Bash equivalent. Pick one per project; do not mix.
```
reference/styles/INDEX.md
```
— 52-style visual library, grouped by palette (dark / light / warm / vivid / bw / mixed) and mood. Lookup workflow in §Style library lookup workflow above.
```
skills/officecli-pptx/SKILL.md
```
— base pptx v2 rules (visual floor, grid, canonical palettes, chart-choice, connector canon, Delivery Gate 1–5a, Known Issues C-P-1..7, Shell escape 3-layer).

```
reference/decision-rules.md
```
—— 金字塔原理、SCQA、页面类型菜单、
```
brief.md
```
schema。§Morph配对规划阶段阅读，以在编写命令前确定叙事弧。
```
reference/pptx-design.md
```
—— 剩余设计说明（场景角色机制、页面类型表、编排模式）。画布/字体/颜色规则在pptx v2中——本文件仅覆盖Morph专属内容。
```
reference/morph-helpers.py
```
—— 跨平台（Mac/Windows/Linux）Python助手工具，用于克隆+隐藏+验证+final-check。可作为库导入或通过CLI参数调用。适用于5+张幻灯片的弧。
```
reference/morph-helpers.sh
```
—— Bash版本。每个项目选择其一，请勿混合使用。
```
reference/styles/INDEX.md
```
—— 52种视觉样式库，按调色板（深色/浅色/暖色/鲜艳/黑白/混合）和风格分组。查询工作流参见上文§样式库查询工作流。
```
skills/officecli-pptx/SKILL.md
```
—— 基础pptx v2规则（视觉基准、网格、标准调色板、图表选择、连接器规范、交付关卡1–5a、已知问题C-P-1..7、Shell三层转义）。

morph-ppt

Original

Translation

OfficeCLI Morph-PPT Skill

OfficeCLI Morph-PPT 技能

Setup

安装配置

⚠️ Help-First Rule

⚠️ 优先查阅帮助规则

Mental Model & Inheritance

核心模型与继承规则

Reverse handoff — when to go BACK to pptx base (or sibling skills)

反向移交规则——何时回归pptx基础版（或同类技能）

Shell & Execution Discipline

Shell与执行规范

Two primitives this skill owns

本技能核心的两个概念

What is Morph? (core mechanics)

Morph是什么？（核心机制）

Slide 2: actor is visible at x=5cm — Slide 3: same name, ghosted off-canvas → visible slide-off motion

幻灯片2：角色位于x=5cm可见位置 —— 幻灯片3：同一名称，移至画布外隐藏 → 可见滑出动效

Morph Pair Planning (pre-code, REQUIRED)

Morph配对规划（编码前必备）

Morph Recipes (4 patterns)

Morph示例（4种模式）

(a) Single-element morph — size / position

(a) 单元素Morph——尺寸/位置变化

Slide 1 — hero

幻灯片1——主标题

Slide 2 — headline shrinks + moves; new body takes stage

幻灯片2——标题缩小并移动；新正文显示

(b) Multi-element coordinated morph — Actors / Choreography

(b) 多元素协同Morph——角色/编排

Slide 1 — anchor composition (already built via recipe a; here we add actors)

幻灯片1——锚定布局（已通过示例a构建；此处添加角色）

Slide 2 — morph: ring moves + grows, dot slides left (spatial variety ≥ 5cm on both)

幻灯片2——Morph：圆环移动并放大，圆点向左滑动（两者空间差异≥5cm）

Ghost slide-1 content (name path still resolves after morph — see Known Issues)

隐藏幻灯片1内容（Morph后名称路径仍可解析——参见已知问题）

Verify morph pair: identical names on slides 1 & 2

验证Morph配对：幻灯片1和2中的名称完全相同

Compare — !!scene-ring and !!scene-dot MUST appear on both, byte-identical.

对比——!!scene-ring和!!scene-dot必须同时出现在两张幻灯片中，名称完全一致。

Note: morph stores names with a !! prefix; compare the prefixed forms.

注意：Morph存储名称时会添加!!前缀；请对比带前缀的名称。

(c) Continuous multi-slide morph (story arc) — use helpers

(c) 连续多幻灯片Morph（叙事弧）——使用助手工具

Invoke the provided helper library for clone + ghost + verify

调用提供的助手库进行克隆+隐藏+验证

... assume slide 1 is built with 2 scene actors (!!scene-ring, !!scene-dot) + #s1-title

... 假设幻灯片1已构建完成，包含2个场景角色（!!scene-ring, !!scene-dot）+ #s1-title

Helper builds slide 2–5 with: clone from previous + apply transition=morph + ghost previous #sN- content

助手工具构建幻灯片2–5：克隆前一张幻灯片 + 设置transition=morph + 隐藏前一张的#s(n-1)-内容

clone prints the cloned slide's shape list — read it to pick which shape indices carry the

clone会打印克隆幻灯片的形状列表——读取列表以确定哪些形状索引对应前一张幻灯片的#s(n-1)-内容，然后将这些索引传递给ghost。

previous slide's #s(n-1)- content, then pass those explicit indices to ghost.

(d) Morph + fade hybrid — entrance on morph slide

(d) Morph+淡入混合——Morph幻灯片入场

Slide 2 already has transition=morph and !!scene-ring. Add a new card with fade-entrance.

幻灯片2已设置transition=morph和!!scene-ring。添加带淡入入场效果的新卡片。

Apply simultaneous-with-morph fade entrance to the new card.

为新卡片设置与Morph同步的淡入入场效果。

'fade-entrance-300-with' = fade in, 300ms, trigger=withPrevious (plays with the morph transition).

'fade-entrance-300-with' = 淡入，300ms，触发时机=withPrevious（与Morph过渡同时播放）。

Choreography — animation types + staggered timing

编排——动画类型+交错时序

Scene-actor spatial rule

场景角色空间规则

Style library lookup workflow

样式库查询工作流

Delivery Gate (inherits pptx v2 + morph additions)

交付关卡（继承pptx v2 + Morph补充）

Gate 2 morph addendum — price / metric tokens eaten by zsh

关卡2 Morph补充——zsh解析价格/度量令牌

Gate 2 morph — price / metric token leaks + stray-period placeholders

关卡2 Morph——价格/度量令牌泄漏+孤立点占位符

Pattern hits: bare prices ($9, $29, $9.99), /unit suffix ($9/mo, $199/yr), ${VAR}, \n/\r/\t, lone period

匹配模式：裸价格($9, $9.99)、/单位后缀($9/mo, $199/yr)、${VAR}、\n/\r/\t、孤立点

Gate 5b — Visual audit via HTML preview (MANDATORY) — extended for morph

关卡5b——HTML预览视觉审核（必填）——针对Morph扩展

Compare —
`!!scene-ring`
and
`!!scene-dot`
MUST appear on both, byte-identical.

对比——
`!!scene-ring`
和
`!!scene-dot`
必须同时出现在两张幻灯片中，名称完全一致。

Note: morph stores names with a
`!!`
prefix; compare the prefixed forms.

注意：Morph存储名称时会添加
`!!`
前缀；请对比带前缀的名称。

`clone`
prints the cloned slide's shape list — read it to pick which shape indices carry the

`clone`
会打印克隆幻灯片的形状列表——读取列表以确定哪些形状索引对应前一张幻灯片的#s(n-1)-内容，然后将这些索引传递给
`ghost`
。

previous slide's #s(n-1)- content, then pass those explicit indices to
`ghost`
.