AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
docs(fonts): align portability and fallback contracts
hugohe3d4ef74b7d72f
diff --git a/docs/animations.md b/docs/animations.mdindex a0bdd9eb..e84850b9 100644--- a/docs/animations.md+++ b/docs/animations.md@@ -127,7 +127,8 @@ The generated sidecar targets stable top-level `<g id="...">` content groups. CoUse `python3 skills/ppt-master/scripts/pptx_animations.py --describe<canonical_effect>` to see exactly which options that effect accepts. Speed iscontrolled by `duration`; smooth start/end are controlled by-`accelerate`/`decelerate`.+`accelerate`/`decelerate`. Change Font's `font_name` is one concrete+target-installed PowerPoint face, never a CSS font stack.`trigger_shape` is group-only and points to a different group id on the sameslide. It affects only that row; the slide Start mode still controls all otherdiff --git a/docs/technical-design.md b/docs/technical-design.mdindex 323d9ad9..fa3ab738 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -397,7 +397,7 @@ The lock is also the per-page routing table. Beyond global colors and typography`--record-usage` writes a derived, input-hashed compact-output snapshot for an invoked page under `analysis/page-context/`. Token counting lazily uses `o200k_base`; a missing `tiktoken` installation records `tokens: null` without blocking execution. `page-context-report` excludes stale snapshots, reports existing snapshots, and lists unique reference fingerprints; telemetry may be partial. The once-loaded reference payloads and other session context remain intentionally unmeasured.-`update_spec.py` propagates an intentional deck-wide anchor change in two coordinated steps: write the new value to `spec_lock.md`, then literal-replace it across every `svg_output/*.svg`. The tool's scope is deliberately narrow — only `colors.*` (HEX values, case-insensitive replacement) and `typography.font_family` (attribute-scoped). Other fields (font sizes, icons, images, canvas) are intentionally **not supported** because their replacements would need attribute-scoped or semantic awareness whose risk/benefit doesn't justify bulk propagation. This reverse lock update is also valid when repeated contextual use is deliberately promoted into a named semantic role; it must not be used merely to empty an informational checker comparison. For unsupported fields, edit the owning artifact and re-author the affected pages.+`update_spec.py` propagates an intentional deck-wide anchor change in two coordinated steps: plan and literal-replace the value across every `svg_output/*.svg`, then write the authoritative `spec_lock.md` only after those SVG updates succeed. The tool's scope is deliberately narrow — only `colors.*` (HEX values, case-insensitive replacement) and universal `typography.font_family` (attribute-scoped). A universal font replacement also sets every existing `typography.*_family` lock row to the same value in one lock-file write, so title/body/role locks cannot retain values that the command has removed from every SVG. Other fields (font sizes, per-role font changes, icons, images, canvas) are intentionally **not supported** because their replacements would need attribute-scoped or semantic awareness whose risk/benefit doesn't justify bulk propagation. This reverse lock update is also valid when repeated contextual use is deliberately promoted into a named semantic role; it must not be used merely to empty an informational checker comparison. For unsupported fields, edit the owning artifact and re-author the affected pages.The tool refuses to back up: it relies on git for revert. Adding a backup mechanism would just duplicate git's job and create stale snapshots.diff --git a/docs/zh/animations.md b/docs/zh/animations.mdindex 384f55d4..158cefc5 100644--- a/docs/zh/animations.md+++ b/docs/zh/animations.md@@ -118,7 +118,8 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project>运行 `python3 skills/ppt-master/scripts/pptx_animations.py --describe<canonical_effect>` 可查看该效果实际接受的完整参数。速度由 `duration` 控制,-平滑开始/结束由 `accelerate`/`decelerate` 控制。+平滑开始/结束由 `accelerate`/`decelerate` 控制。Change Font 的 `font_name`+必须是目标环境已安装的一个具体 PowerPoint 字体名,不能写 CSS 字体列表。`trigger_shape` 只能写在对象组上,并指向同一页另一个分组 id。它只让当前动画行变为交互触发,其他行仍遵循页面 Start 模式;录制旁白不接受这种交互动画。diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.mdindex 66ef6a58..af694ba6 100644--- a/docs/zh/technical-design.md+++ b/docs/zh/technical-design.md@@ -391,7 +391,7 @@ Strategist 阶段产出两份看起来冗余但服务不同对象的产物:`--record-usage` 在 `analysis/page-context/` 下为实际调用的页面写入派生快照,记录输入 hash 和紧凑 stdout 的实测大小。token 计数按需加载 `o200k_base`;没有安装 `tiktoken` 时写入 `tokens: null`,但不阻塞执行。`page-context-report` 排除过期快照,汇总已有快照并列出唯一引用指纹;统计可以只覆盖部分页面。一次加载的大型引用 payload 与其他会话上下文有意不纳入统计。-`update_spec.py` 用两个协调步骤传播一次有意的 deck 级锚点修改:把新值写入 `spec_lock.md`,然后字面替换到每一份 `svg_output/*.svg`。工具的范围**故意收得很窄**——只支持 `colors.*`(HEX 值,大小写不敏感替换)和 `typography.font_family`(属性级)。其他字段(字号、图标、图片、画布)**有意不支持**——它们的替换需要属性级或语义级理解,风险/收益不值得做批量传播。当重复出现的上下文值被明确提升为具名语义角色时,反向回写 lock 同样合理;但不能只为了清空 checker 的信息提示而扩充 lock。其他字段应修改其权威产物并重做受影响页面。+`update_spec.py` 用两个协调步骤传播一次有意的 deck 级锚点修改:先规划并字面替换每一份 `svg_output/*.svg`,这些 SVG 更新成功后才写权威 `spec_lock.md`。工具的范围**故意收得很窄**——只支持 `colors.*`(HEX 值,大小写不敏感替换)和全局 `typography.font_family`(属性级)。全局字体替换还会在一次 lock 文件写入中,把所有既有 `typography.*_family` 行同步为同一值,避免标题、正文或其他角色保留已从全部 SVG 移除的旧字体。其他字段(字号、按角色字体变更、图标、图片、画布)**有意不支持**——它们的替换需要属性级或语义级理解,风险/收益不值得做批量传播。当重复出现的上下文值被明确提升为具名语义角色时,反向回写 lock 同样合理;但不能只为了清空 checker 的信息提示而扩充 lock。其他字段应修改其权威产物并重做受影响页面。工具拒绝做备份:依赖 git 回滚。加备份机制只是重复 git 的工作,还会留下过时快照。diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.mdindex 4b3acdb0..783315b1 100644--- a/skills/ppt-master/references/animations.md+++ b/skills/ppt-master/references/animations.md@@ -119,7 +119,7 @@ Rules:| `direction` | Directional Fly/Crawl/Wipe/Peek/Strips/Split/Stretch/Zoom and related entrance/exit effects || `amount` | Wheel spokes (`1`, `2`, `3`, `4`, `8`), emphasis Spin degrees, or Transparency ratio || `color` | Color-capable emphasis effects; `#RRGGBB` or `theme:<scheme-color>` |- | `font_name` | Change Font; required for `emphasis_change_font` |+ | `font_name` | Change Font; required for `emphasis_change_font`; one installed PowerPoint face, not a CSS list || `size` | Grow/Shrink || `relative` | Motion paths (`true` = shape-relative, `false` = fixed slide path) |- Any animation/group block may set `repeat_count` or `repeat_duration`diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex cbe1e5aa..5dbf8e0f 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -285,7 +285,7 @@ Structural typography anchors come from `spec_lock.md typography`. Use an exact**Missing required field — `typography.font_family`** → stop and return to Generate Step 4 / [`strategist.md`](strategist.md) §6.2 to repair `spec_lock.md`; do not infer a stack from `design_spec.md`.-**Hard rule**: every SVG `font-family` stack MUST resolve to a pre-installed exported Latin / EA typeface; use the Strategist §g safe set for locked roles and §2.1 for sparse display exceptions. PPTX has no runtime fallback — missing fonts degrade to Calibri.+**Hard rule**: every SVG `font-family` stack MUST resolve to target-installed/approved Latin and EA faces. PPTX writes one face per script; CSS tails affect preview only, and fonts are not embedded. Missing-face substitution is viewer-selected—not guaranteed Calibri or a later stack entry.---diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex e7e59d35..4060fc28 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -214,9 +214,9 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre- User or active template typography is authoritative. Otherwise ≥3 Stage-2 directions include concord (safe) and contrast (tension); never add a separate font-choice round or pair near-duplicate title/body families.- Every Stage-2 direction carries `heading` / `body` `cjk`, `latin`, `css`, and positive `body_size`; repeat user/template-fixed stacks.-- Use PowerPoint-installed exported faces. Safe anchors: CJK `Microsoft YaHei` / `SimHei` / `SimSun` / `FangSong` / `KaiTi`; Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`; Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Garamond` / `Book Antiqua`; mono `Consolas` / `Courier New`; display `Impact` / `Arial Black`. Other export-safe families are limited to sparse short display/ornament; structural or recurring use returns upstream.-- Keep each stack to four families or fewer. A non-installed brand or web face is legal only when the Design Spec explicitly records the install / embed requirement and a safe substitute.-- Avoid splitting roles across near-equivalents such as YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, or Times New Roman↔Times. A cross-platform counterpart may remain inside one fallback stack.+- Use concrete, target-installed PowerPoint faces. **Examples only, never a catalog/default** (verify locale): Chinese `DengXian` / `SimSun`; Japanese `Meiryo` / `Yu Gothic`; Korean `Malgun Gothic` / `Batang`; Latin `Arial` / `Georgia` / `Consolas` / `Impact`.+- Keep stacks to four families or fewer. A brand/web face may lead only after user-confirmed target installation/approved install; PPT Master does not embed fonts. Otherwise export a safe face and keep the unavailable face as Design Spec reference.+- Avoid near-equivalent role splits such as YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, or Times New Roman↔Times. Counterparts may aid SVG/browser preview; CSS tails are not deterministic PowerPoint fallbacks.- Choose by locked style and vary the axis instead of defaulting to YaHei/Arial: serif×sans, Kai/FangSong×hei, hei×song, double-serif, display×neutral, same-family weight, or sans+mono. These are recall seeds, not presets.**Strategist-owned role extension after confirmation**: Confirm UI keeps the heading/body choice unchanged. While authoring the complete §IX roster and §IV typography plan, scan the actual content for recurring roles that materially need a different family for character or legibility—such as `annotation`, `footer`, `footnote`, `data`, `emphasis`, `quote`, or `code`. Add a lowercase snake_case role and exact stack only when it recurs; inherited roles and one-off garnish stay omitted. The extension must remain coherent with the confirmed heading/body system and locked visual style, and it does not reopen confirmation. Only when an additional family role is added, record one compact `Role rationale` in §IV naming the added role(s) and why; otherwise omit the line.diff --git a/skills/ppt-master/references/template-designer.md b/skills/ppt-master/references/template-designer.mdindex f4b594c1..801276e4 100644--- a/skills/ppt-master/references/template-designer.md+++ b/skills/ppt-master/references/template-designer.md@@ -238,9 +238,10 @@ page_count: <N>- HEX values with role labels (primary / accent / background / text / etc.)- Brand-specific application rules when present (e.g. "KPI cards rotate blue→green→red→yellow")-## III. Typography (omit when using the default `Arial, "Microsoft YaHei", sans-serif` stack)-- Per-role font stacks ONLY when the template intentionally diverges (display serif title, brand typeface, etc.)-- Font-install or embedding requirement when a non-preinstalled font leads any stack+## III. Typography (omit without template-owned typeface identity)+- Per-role stacks for identity (display serif, brand face, etc.)+- A non-preinstalled face may lead only after user-confirmed target installation/approved install; no auto-embedding+- Otherwise export a safe face; unavailable proprietary faces stay references. CSS tails aid preview, not deterministic PowerPoint fallback- Body baseline px (informational; `spec_lock.md` owns the actual values per project)## IV. Signature Design Elementsdiff --git a/skills/ppt-master/references/visual-styles/glassmorphism.md b/skills/ppt-master/references/visual-styles/glassmorphism.mdindex 0d035548..b1f8a030 100644--- a/skills/ppt-master/references/visual-styles/glassmorphism.md+++ b/skills/ppt-master/references/visual-styles/glassmorphism.md@@ -13,9 +13,9 @@ Frosted-glass SaaS — translucent layered panels, flowing gradient light, float## 2. Typography character-- Clean modern sans; light / medium weights; airy. Headlines can carry a luminous gradient on the dark field.+- Clean modern sans; regular with selective bold; airy. Exact Light/Black requires a user-confirmed installed face. Headlines can carry a luminous gradient on the dark field.-> Families are chosen at confirmation `g`; this style asks for a clean, modern, slightly-light sans *character*.+> Families are chosen at confirmation `g`; this style asks for a clean, modern, airy sans *character*.## 3. Using the deck's colorsdiff --git a/skills/ppt-master/references/visual-styles/swiss-minimal.md b/skills/ppt-master/references/visual-styles/swiss-minimal.mdindex d4ac2527..0d133640 100644--- a/skills/ppt-master/references/visual-styles/swiss-minimal.md+++ b/skills/ppt-master/references/visual-styles/swiss-minimal.md@@ -14,7 +14,7 @@ Strict Swiss-grid discipline. Modular grid, sharp geometry, aggressive whitespac## 2. Typography character-- Sans-serif, single family; weight contrast (e.g. 900 / 300) over family contrast. Tight, rigorous spacing.+- Sans-serif, single family; regular/bold contrast. Exact Light/Black requires a user-confirmed installed face. Tight, rigorous spacing.- Strong size hierarchy — large headlines, small precise body. Left-aligned, flush.> Family is chosen at confirmation `g` by subject fit — this style asks for a grotesque / neo-grotesque *character*, not a specific font.diff --git a/skills/ppt-master/scripts/docs/pptx-animations.md b/skills/ppt-master/scripts/docs/pptx-animations.mdindex bc89702d..91075c06 100644--- a/skills/ppt-master/scripts/docs/pptx-animations.md+++ b/skills/ppt-master/scripts/docs/pptx-animations.md@@ -36,7 +36,7 @@ One resolved animation-pane row contains these fields:| Duration | Finite positive schedule duration; scalable native behavior trees preserve their internal timing ratios || Delay | Finite non-negative offset used by `after-previous` or as trigger-shape `TriggerDelayTime` || Order | Positive integer sidecar order; ties retain stable SVG order |-| Effect options | Effect-specific `direction`, `amount`, `color`, `font_name` (required for Change Font), `relative`, or `size` values from PowerPoint `EffectParameters` |+| Effect options | Effect-specific `direction`, `amount`, `color`, `font_name` (one installed PowerPoint face, required for Change Font; not a CSS list), `relative`, or `size` values from PowerPoint `EffectParameters` || Timing options | Repeat count/span, auto-reverse, rewind, accelerate/decelerate, bounce-end ratio, and restart policy || Completion | Optional dim/hide behavior and packaged `.m4a`/`.mp3`/`.wav` sound |diff --git a/skills/ppt-master/scripts/docs/update_spec.md b/skills/ppt-master/scripts/docs/update_spec.mdindex f88ac29c..c0202a38 100644--- a/skills/ppt-master/scripts/docs/update_spec.md+++ b/skills/ppt-master/scripts/docs/update_spec.md@@ -1,8 +1,9 @@# update_spec.py> **Scope boundary**: this tool updates only deterministic global color and font-> substitutions, writes the authoritative `spec_lock.md` first, and relies on-> version control for rollback instead of creating parallel backups.+> substitutions, writes the authoritative `spec_lock.md` only after the SVG+> updates succeed, and relies on version control for rollback instead of+> creating parallel backups.Propagate a `spec_lock.md` value change to both the lock file and every `svg_output/*.svg`. The single edit surface for bulk style tweaks after generation.@@ -17,8 +18,9 @@ Bare `<key>=<value>` (no dot) is treated as `colors.<key>=<value>` for backwardOne invocation = one change. The tool:1. Reads the old value from `<project_path>/spec_lock.md`-2. Writes the new value into `spec_lock.md`-3. Propagates the change into every `.svg` under `svg_output/`+2. Plans and propagates the change into every `.svg` under `svg_output/`+3. Writes the new value into `spec_lock.md`; a global font replacement updates+ every existing `typography.*_family` row together4. Prints the list of files touched## Examples@@ -32,14 +34,16 @@ python3 skills/ppt-master/scripts/update_spec.py projects/acme_ppt169_20260301 c# change the deck-wide font familypython3 skills/ppt-master/scripts/update_spec.py projects/acme_ppt169_20260301 \- 'typography.font_family="Inter", Arial, sans-serif'+ 'typography.font_family=Arial, "Microsoft YaHei", sans-serif'```## v2 scope- **Supported**:- `colors.*` — HEX value replacement across `svg_output/*.svg` (case-insensitive).- - `typography.font_family` — replaces the inner value of every `font-family="..."` / `font-family='...'` attribute.+ - `typography.font_family` — replaces the inner value of every+ `font-family="..."` / `font-family='...'` attribute and sets all existing+ `typography.*_family` lock rows to that universal family.- **Not supported**: typography sizes, icons, images, canvas, forbidden — these involve attribute-scoped or semantic replacements whose risk/benefit does not warrant bulk propagation. Edit `spec_lock.md` and the affected SVGs by hand, or re-author the pages.## When to use@@ -53,6 +57,8 @@ python3 skills/ppt-master/scripts/update_spec.py projects/acme_ppt169_20260301 \- HEX values (e.g. `#005587`) are unique enough in SVG content that literal replacement is safe- `font-family` substitution is scoped to the attribute; the outer quote character is preserved, and switched automatically if the new value contains the same quote+- a global font substitution rewrites all existing family-role lock rows in one+ file write, so the universal SVG result cannot leave stale title/body roles- The tool refuses non-HEX inputs, unknown keys, and unsupported sections- No backups are created — the project folder should be under git so you can diff / revertdiff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex b43b707e..904e50ca 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -12,7 +12,7 @@"skills/ppt-master/templates/schemas/*.json"],"exclude": [],- "max_tokens": 387100+ "max_tokens": 387200},"file_budgets": {"AGENTS.md": 2400,@@ -578,7 +578,7 @@"files": ["skills/ppt-master/workflows/profiles/beautify-pptx.md"],- "max_tokens": 6900+ "max_tokens": 6950},"stage.generate.refine-spec": {"description": "Explicit post-confirmation spec refinement runbook.",@@ -632,7 +632,7 @@"skills/ppt-master/scripts/docs/pptx-transitions.md","skills/ppt-master/scripts/docs/svg-pipeline.md"],- "max_tokens": 28700+ "max_tokens": 28725},"stage.generate.video-motion-plan": {"description": "Conditional resolved animation-to-video handoff contract.",diff --git a/skills/ppt-master/templates/brands/anthropic/templates/design_spec.md b/skills/ppt-master/templates/brands/anthropic/templates/design_spec.mdindex 062f1bae..eb579653 100644--- a/skills/ppt-master/templates/brands/anthropic/templates/design_spec.md+++ b/skills/ppt-master/templates/brands/anthropic/templates/design_spec.md@@ -35,10 +35,10 @@ The first two rows are literal Claude asset facts. Background and neutral rows a| Role | Family | Weight ||---|---|---|-| title | `"Styrene A", "Helvetica Neue", Arial, "Microsoft YaHei", sans-serif` | 600–700 |-| body | `"Anthropic Sans", "Helvetica Neue", Arial, "Microsoft YaHei", sans-serif` | 400 |+| title | `Arial, "Microsoft YaHei", sans-serif` | 600–700 |+| body | `Arial, "Microsoft YaHei", sans-serif` | 400 |-> `Styrene A` and `Anthropic Sans` are proprietary and unlikely to be installed on viewer machines. PPT Master does not bundle or automatically embed them; use the declared fallback chain unless the user supplies an installed/approved font workflow.+> `Styrene A` and `Anthropic Sans` are references. PPT Master neither auto-embeds fonts nor follows CSS tails in PowerPoint. The rows above are the default Windows/Office export; replace them only with a user-confirmed target-installed face.## IV. Logodiff --git a/skills/ppt-master/templates/brands/google/templates/design_spec.md b/skills/ppt-master/templates/brands/google/templates/design_spec.mdindex 450f1bcd..c43fda9d 100644--- a/skills/ppt-master/templates/brands/google/templates/design_spec.md+++ b/skills/ppt-master/templates/brands/google/templates/design_spec.md@@ -35,10 +35,10 @@ The four primary brand colors (Blue / Green / Yellow / Red) carry equal weight i| Role | Family | Weight ||---|---|---|-| title | `Google Sans, Roboto, "Microsoft YaHei", sans-serif` | 500–700 |-| body | `Roboto, "Microsoft YaHei", sans-serif` | 400 |+| title | `"Segoe UI", "Microsoft YaHei", sans-serif` | 500–700 |+| body | `"Segoe UI", "Microsoft YaHei", sans-serif` | 400 |-> `Google Sans` is proprietary. PPT Master does not bundle or automatically embed it; use the `Roboto` / `Microsoft YaHei` fallback unless the user supplies an installed/approved font workflow.+> `Google Sans` and `Roboto` are references. PPT Master neither auto-embeds fonts nor follows CSS tails in PowerPoint. The rows above are the default Windows/Office export; replace them only with a user-confirmed target-installed face.## IV. Logodiff --git a/skills/ppt-master/workflows/profiles/beautify-pptx.md b/skills/ppt-master/workflows/profiles/beautify-pptx.mdindex c97dd813..3a805e07 100644--- a/skills/ppt-master/workflows/profiles/beautify-pptx.md+++ b/skills/ppt-master/workflows/profiles/beautify-pptx.md@@ -73,7 +73,7 @@ python3 ${SKILL_DIR}/scripts/pptx_intake.py <project_path>/sources/<source.pptx>| Field | Use ||---|---|| `theme.palette.background` / `text` / `primary` / `accent1..6` | the deck's *declared* colors |-| `theme.fonts.title` / `body` (`ea` = CJK, `latin`) | the deck's *declared* fonts |+| `theme.fonts.title` / `body` (`latin` / `ea` / `cs`; `scripts` maps `Hans` / `Hant` / `Jpan` / `Hang` supplemental faces) | the deck's *declared* fonts; use the matching script when `ea` is empty || `theme.sizes.title` / `body` (pt) | the deck's *declared* placeholder sizes (master `txStyles`) — the size a run inherits when it sets no explicit `sz`; `body` is the **level-1** default (coarsest, commonly over-reads) || `theme.sizes.body_levels` (pt list) | the full master `bodyStyle` ramp (lvl1..lvl9, e.g. `[32, 28, 24, 20, …]`) — **reference context** so you can read a deeper level than the over-reading level-1, not an auto-seed || `observed.colors` / `observed.fonts` (`latin` / `ea`, frequency-ranked) | a usage **sample / frequency hint** — run-level fonts + explicit `srgbClr` fills across slides |diff --git a/skills/ppt-master/workflows/stages/customize-animations.md b/skills/ppt-master/workflows/stages/customize-animations.mdindex c8e30a58..0a22ac22 100644--- a/skills/ppt-master/workflows/stages/customize-animations.md+++ b/skills/ppt-master/workflows/stages/customize-animations.md@@ -319,7 +319,8 @@ selected effect. Before writing a parameterized effect, run`python3 skills/ppt-master/scripts/pptx_animations.py --describe<canonical_effect>` and use the returned values exactly. `duration` ownsPowerPoint Speed; `accelerate`/`decelerate` own smooth start/end, so do not-invent duplicate fields.+invent duplicate fields. Change Font's `font_name` is one concrete+target-installed PowerPoint face, never a CSS font stack.**Canonical example — every slide carries explicit transition + animation;groups appear only when they diverge**: