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(svg-effects): route advanced treatments by visual job
hugohe3a50ffc102d1e
diff --git a/docs/powerpoint-svg-mapping.md b/docs/powerpoint-svg-mapping.mdindex cb70fbe3..ed65a389 100644--- a/docs/powerpoint-svg-mapping.md+++ b/docs/powerpoint-svg-mapping.md@@ -169,7 +169,7 @@ preset selection and authoring behavior are documented in| Dashed or dotted outline | Registered dash array | Preset or custom DrawingML dash | `Native-normalized` | Unsupported dash semantics are rejected || Line cap and join | Registered cap/join values | Native line cap/join properties | `Native-stable` within the fixed join contract | Import accepts one join; miter requires exact `lim="800000"` || Line arrowheads | Registered start/end markers | Native head/tail end properties | `Approximate` for marker size | Only triangle, stealth, arrow, diamond, and oval follow the conditional marker contract |-| Outer shadow | One supported shadow filter graph | Native outer shadow in `a:effectLst` | `Approximate`; one imported shape/connector/picture source `outerShdw` is reconstructed only when its non-zero offset remains classifiable | Zero-offset source shadows and unsupported graph shapes are not silently reclassified |+| Outer shadow | One supported shadow filter graph | Native outer shadow in `a:effectLst` | `Approximate`; one imported shape/connector/picture source `outerShdw` is reconstructed only when its non-zero offset is classifiable and its scale, skew, and rotation behavior are neutral or representable | Non-neutral `sx`/`sy`/`kx`/`ky`, rotate-with-shape behavior on a rotated target, zero offset, and unsupported attributes or graphs produce blocking diagnostics instead of silent simplification || Glow | One supported glow filter graph | Native glow in `a:effectLst` | `Approximate`; one imported shape/connector/picture source glow keeps the registered radius conversion | Review when the glow carries semantic emphasis || Imported text-run effect | Unchanged `metadata[data-pptx-part="txbody"]` on a logical shape; import-only blocking effect status for inherited Layout/Master list styles plus vertical, relationship-bearing, and table-cell fallback routes | Original slide-local native run effect inside `p:txBody` | `Native-stable` only while the raw slide-local payload remains usable; inherited effects, edits, or fallback routes that would drop a non-empty run `effectLst` / `effectDag` block | Not public authoring syntax; a table-cell run effect also disables the native Table replacement payload || Whole-object transparency | Atomic element `opacity` | Alpha distributed into supported native channels | `Native-normalized` | Prefer channel-specific alpha unless the whole atomic object fades |diff --git a/docs/zh/powerpoint-svg-mapping.md b/docs/zh/powerpoint-svg-mapping.mdindex 920cd8eb..2834a2bb 100644--- a/docs/zh/powerpoint-svg-mapping.md+++ b/docs/zh/powerpoint-svg-mapping.md@@ -164,7 +164,7 @@ PowerPoint 意图| 虚线或点线轮廓 | 已登记 dash array | 预设或自定义 DrawingML dash | `Native-normalized` | 拒绝不支持的 dash 语义 || 线端与连接样式 | 已登记 cap/join 值 | 原生 line cap/join 属性 | 固定 join 合同内为 `Native-stable` | 回导仅接受一个 join;miter 必须精确使用 `lim="800000"` || 线条箭头 | 已登记起点/终点 marker | 原生 head/tail end 属性 | marker 大小为 `Approximate` | 仅 triangle、stealth、arrow、diamond、oval 遵循条件 marker 合同 |-| 外阴影 | 一个受支持 shadow filter 图 | `a:effectLst` 中的原生外阴影 | `Approximate`;仅当非零偏移仍可稳定分类时,才重建单一 shape/connector/picture 来源 `outerShdw` | 零偏移来源阴影和不支持的图结构不会被静默改成其他效果 |+| 外阴影 | 一个受支持 shadow filter 图 | `a:effectLst` 中的原生外阴影 | `Approximate`;仅当非零偏移可稳定分类,且缩放、倾斜和旋转行为为中性或可表达时,才重建单一 shape/connector/picture 来源 `outerShdw` | 非中性的 `sx`/`sy`/`kx`/`ky`、旋转对象上的随形旋转、零偏移,以及不支持的属性或效果图均产生阻塞诊断,不做静默简化 || 发光 | 一个受支持 glow filter 图 | `a:effectLst` 中的原生发光 | `Approximate`;单一 shape/connector/picture 来源发光保持已登记的半径换算 | 发光承载语义强调时需复核 || 导入的文字 run 效果 | 逻辑 shape 上未变更的 `metadata[data-pptx-part="txbody"]`;继承自 Layout/Master 的列表样式以及竖排、含关系引用、表格单元格降级路径使用仅限导入的阻塞效果状态 | `p:txBody` 内原始的 slide-local 原生 run 效果 | 仅在原始 slide-local payload 仍可用时为 `Native-stable`;继承效果、编辑或降级路径若会丢失非空 run `effectLst` / `effectDag` 则被阻断 | 不是公开创作语法;表格单元格 run 效果还会禁用原生 Table 替换 payload || 整个对象透明度 | 原子元素 `opacity` | alpha 分发至受支持原生通道 | `Native-normalized` | 除非整个原子对象需要淡出,否则优先通道专属 alpha |diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 82687a8f..d41beb11 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -27,11 +27,12 @@ Always-loaded Executor authority for flat SVG page authoring and behavior shared## 1. Effect Capability Discovery-**Mandatory — select by visual job**: before authoring each page, run the-already-loaded [`svg-effects.md`](./svg-effects.md) §6.1 procedure and use its-§6.13 scenario routing. The catalog expands construction vocabulary; it does-not create an effect quota. Active cross-page continuous action additionally-loads [`animations.md`](./animations.md) §3.1 before authoring both endpoints.+**Mandatory — select by visual job**: establish each page's semantic skeleton,+then run the already-loaded [`svg-effects.md`](./svg-effects.md) §6.1 procedure+and Visual Job Router before finalizing; use §6.13 for a coordinated page+recipe when useful. The catalog expands construction vocabulary; it creates no+effect quota. Active cross-page continuous action additionally loads+[`animations.md`](./animations.md) §3.1 before authoring both endpoints.**Hard rule — discovery does not expand compatibility**: Follow`svg-effects.md` syntax and fallbacks; unsupported source/backdrop blur, blenddiff --git a/skills/ppt-master/references/image-layout-patterns.md b/skills/ppt-master/references/image-layout-patterns.mdindex 427a8ba0..b959c238 100644--- a/skills/ppt-master/references/image-layout-patterns.md+++ b/skills/ppt-master/references/image-layout-patterns.md@@ -25,6 +25,7 @@ Compact composition vocabulary for prepared images, illustrations, and rendered| Mechanism, not generic “mask” | Owner ||---|---|| Layout geometry | [`image-layout-spec.md`](./image-layout-spec.md) |+| Image-treatment implementation map | [`svg-effects.md`](./svg-effects.md) §6.1 Image-Treatment Implementation Map || Crop: policy / legality / wrapper | [`svg-image-embedding.md`](./svg-image-embedding.md) / [`shared-standards-core.md`](./shared-standards-core.md) / [`svg-effects.md`](./svg-effects.md) || Scrim / gradient / wash | [`svg-effects.md`](./svg-effects.md) || Shadow / glow / overlay-boundary elevation | [`svg-effects.md`](./svg-effects.md) §6.4 |diff --git a/skills/ppt-master/references/svg-effects.md b/skills/ppt-master/references/svg-effects.mdindex 96fdae9c..2141b2c4 100644--- a/skills/ppt-master/references/svg-effects.md+++ b/skills/ppt-master/references/svg-effects.md@@ -10,8 +10,8 @@ Authority for advanced paint, effects, transforms, freeform/radial geometry, and**Mandatory**: Default and Quick Generate read this file completely before SVGauthoring and keep its compatible techniques in active construction vocabulary.-Before constructing each page, run the §6.1 selection procedure and use §6.13-to route each diagnosed visual job.+Before finalizing each page, run the §6.1 selection procedure and Visual Job+Router. Use §6.13 when diagnosed jobs benefit from one coordinated page recipe.**Default — situational use (may override when plain construction is stronger)**:“Advanced” means capability depth, not an effect quota. During page authoring,@@ -27,16 +27,53 @@ rhythm, and style; apply those that materially help.| Aesthetic fit | Locked or Quick-resolved `visual_style` / `visual_style_behavior` || Per-page choice | Content purpose, hierarchy, legibility, semantics, and rhythm |-**Mandatory — job-first effect selection**: start from a readable, editable-plain construction, not from the effect catalog.+**Mandatory — job-first effect selection**: establish the editable semantic+skeleton first, then diagnose effect jobs before treating the page as complete.+Plain construction remains valid only when that diagnostic finds no unresolved+visual job.| Pass | Decision ||---|---|-| Baseline | Name the concrete job an effect would perform: separate planes, direct attention, integrate image and text, encode state/direction, or express the locked or Quick-resolved material/style. If plain hierarchy already performs it, keep the plain construction. |-| Surface | Identify the exact target—text, image, line, geometry, or a supported `<g>` / `<use>` subtree—and verify that the owning subsection allows that operation on the surface and states usable fidelity. |-| Select | Route the job through §6.13 and choose the smallest compatible technique that performs it. When alternatives communicate equally well, prefer `Native-stable` / `Native-normalized` over `Approximate` or `Bake-required`. |-| Integrate | Align paint, contour, light direction, hierarchy, and z-order with the page. Combine techniques only when each owns a different job; never stack shadow, glow, gradient, border, and tint merely to look advanced. |-| Gate / Stop | Check legibility, editability, object density, native fidelity, and style fit. Simplify for legibility/style failures; use a legal explicit layer or alternative for unsupported syntax; bake the smallest visual layer/asset only when the intent truly depends on pixels. Keep authoritative text/data native and review any material `Approximate` result in the exported PPTX. |+| Skeleton / diagnose | Establish native information, relationships, and hierarchy. Before completion, check image/text integration, plane separation, focus, state/direction, material/style, and the recurring motif; keep plain construction when none needs treatment. |+| Surface / select | Name the target, confirm its owning subsection and fidelity, then use the Router. Choose a compatible technique that fully performs the job; prefer simpler/native-stable alternatives only when communication is equal. `Approximate` requires review, not automatic rejection. |+| Integrate / stop | Align paint, contour, light, hierarchy, and z-order; combine only techniques with different jobs. Check legibility, editability, density, fidelity, and style; simplify failures, use legal alternatives, and bake only the smallest pixel-dependent layer. Keep authoritative text/data native. |++#### Visual Job Router++**Reference — not a quota**: route diagnosed problems through this table. A+page may use no listed technique, one technique, or several techniques with+different jobs.++| Diagnosed visual problem | Candidate technique | Authority / stop |+|---|---|---|+| Meaningful direction, continuous value, or center focus is missing | Linear/radial gradient or channel alpha | §6.2 / §6.3; otherwise keep solid paint |+| Picture/card/overlay elevation or boundary is unclear | Object or picture/carrier shadow, restrained glow, or hairline | §6.4; equal peers stay flat; one light direction |+| Native copy and image do not integrate | Scrim, fade, wash, vignette, off-center spotlight, or faux glass | §6.5 and the Image-Treatment Implementation Map; verify contrast; no backdrop blur |+| Relationship state, direction, continuity, or boundary is unclear | Draft/optional/future → dash; direction → marker; undirected → solid; continuous flow → gradient stroke; repeated boundary → frame/contour/crop edge; exact grid → multi-subpath | §6.6 / §6.3; every line needs a job |+| Short display text needs notation or silhouette | Removed/former → strike; eyebrow distinction → tracking; display silhouette → outline/gradient; luminous metric → glow; semantic list → native bullet | §6.7 / §6.4; no decorative body-copy treatment |+| Tilt, repetition, or reversible asset direction helps composition | Rotate, translate/mirror, or local `<use>` | §6.8; never mirror text, logos, or directional evidence |+| Resolved style needs hand, print, pixel, facets, layers, ribbon, or line-plus-area | Matching constructed recipe | §6.11; no generic decorative freeform |+| Meaning needs an unmatched silhouette, radial hierarchy, gauge, or custom route | Freeform, explicit arc/sector, or calculated arrowhead | §6.9 / §6.10; prefer an equal stock shape/marker |+| Look depends on dense texture, source blur, per-pixel composite, reflection, or skew | Native-safe alternative or prepared/baked asset | §6.12; text/data stay editable |++#### Image-Treatment Implementation Map++**Reference — not a constraint**: when image composition names one of these+modifier or prepared-asset treatments, resolve its implementation here.+`Effect-only` keeps a visible capability here without restoring a layout ID.++| Image handles / treatment | Construction / boundary |+|---|---|+| `M2 · 01/03/04/08/09` · scrim, wash, fade, grid | Explicit solid/linear/radial layers over one picture; §6.2 / §6.3 / §6.5 |+| `M2 · 06/07` · atmospheric wash, watermark/receded field | Reduced picture alpha + optional wash; subordinate to native content; §6.2 / §6.5 |+| `M2 · 02/05` · vignette or spotlight | Radial layer with movable `fx/fy` or `cx/cy`; outer geometry `Approximate`; §6.3 / §6.5 |+| `M3 · 04` · lifted picture panel / visible overlay edge | Picture/carrier shadow, glow, or hairline; shadow one support shape for a framed/captioned panel; §6.4 |+| `M3 · 01/02/05` · frame, print frame, contour/cut edge | Registered native stroke/path; §6.6 |+| `M3 · 03; M1 · 09` · rotation, misregistration, Riso offset | Transform + explicit duplicate layers; §6.8 / §6.11 |+| `M1 · 03` + effect-only forms · paper cut, facets/folds, ribbon, staging | Ordered paths/facets + consistent paint/light; §6.11 / [`native-shape-authoring.md`](./native-shape-authoring.md) §7 |+| `M1 · 01/02/04–08` · crop, opening, subtraction, reveal | Direct clip or materialized Boolean; no `<mask>`; [`shared-standards-core.md`](./shared-standards-core.md) §1.2 / [`native-shape-authoring.md`](./native-shape-authoring.md) §6 |+| Effect-only · faux glass | Visible field + translucent panel + highlight; no blur or frosted-crop substitution; §6.5 |+| `A1 · 02–04; A3 · 02/03` · blur, duotone, blend, frost, desaturation | Prepared local bitmap/composite/derivative; registered frost is a blurred derivative; §6.12 |**Reference — illustrative colors**: colors below demonstrate syntax only;generated pages choose paint from the Default locked or Quick-resolved identity@@ -73,7 +110,7 @@ contract, such as SVG's default fill or §6.3's required gradient-stop color.| Fill/text alpha | Opaque `fill` + `fill-opacity="0..1"` | Fill/run alpha; `Native-stable` || Stroke alpha | Opaque `stroke` + `stroke-opacity="0..1"` | Line/outline alpha; `Native-stable` || Gradient-stop alpha | Opaque `stop-color` + `stop-opacity="0..1"` | Per-stop alpha; `Native-stable` |-| Shadow/glow alpha | Opaque `flood-color` + `flood-opacity="0..1"` | Effect alpha; `Native-stable` within §6.4 |+| Shadow/glow alpha | Opaque `flood-color` + `flood-opacity="0..1"` | Glow is `Native-stable`; outer shadow is visually calibrated `Approximate` within §6.4 || Picture fade | `<image opacity="0..1">` | Picture `<a:alphaModFix>`; `Native-stable` || One atomic whole-object fade | Non-group element `opacity="0..1"` | Alpha compiled into its supported paint/effect channels; `Native-normalized` || Pattern alpha | Opaque pattern child paint + child fill/stroke opacity | Conditional; [`native-data-interface.md`](./native-data-interface.md) |@@ -181,6 +218,7 @@ Filters are native-effect metadata, not a general pixel-filter surface.| Definition/reference | Direct `<defs><filter id="...">` child with unique id; direct `filter="url(#id)"` attribute, never inline style || Public targets | `<rect>`, `<circle>`, `<image>`, `<path>`, `<text>`; an exact outer `<g filter>` is also registered when its sole visual child is one clipped `<image>` || Required primitive | `feDropShadow` or `feGaussianBlur` |+| Generated glow form | Zero-offset `feDropShadow` with flood paint, or the complete blur + flood + composite + merge graph below; never bare blur || Required parameters | Explicit `stdDeviation` on either effect primitive; explicit `dx`, `dy`, and `flood-opacity` on `feDropShadow`; explicit `flood-opacity` on `feFlood`; explicit `slope` on linear `feFuncA` || Accepted helpers | `feOffset`, `feFlood`, `feComposite`, `feMerge`, `feMergeNode`, `feComponentTransfer`, linear `feFuncA` || Alpha transfer | Linear `feFuncA` maps multiplicative `slope` only; `intercept` is unsupported |@@ -204,9 +242,10 @@ imported preset object referencing the hidden geometry carrier's filter—and thexact imported picture-crop carrier in §6.5, which keeps the effect outside itsviewport. Neither authorizes ordinary group filters or creates a secondPowerPoint object.-PPTX import preserves one registered shape/connector/picture shadow or glow and records-unsupported object/run effects as import diagnostics instead of exposing a new-authoring surface. See+PPTX import maps one classifiable shape/connector/picture outer shadow or glow+to this contract. Unsupported effects and outer-shadow variants whose scale,+skew, alignment, or rotation semantics cannot be retained become import+diagnostics instead of a silently simplified authoring surface. See[`conversion.md`](../scripts/docs/conversion.md#import-compatibility-and-recovery-boundary)for tolerant, strict, and release-handling behavior.The quality checker and exporter preflight enforce the same definition,@@ -237,7 +276,8 @@ native export.```Even `feDropShadow` with `dx="0" dy="0"` becomes glow. Use an existing accent-color for glow; black reads as diffuse shadow.+color; black reads as diffuse shadow. Bare `feGaussianBlur` remains compatible+input but is never generated: preview blurs the object while export emits glow.| Elevation | Use | `dy` | `stdDeviation` | Alpha ||---|---|---:|---:|---:|@@ -246,22 +286,21 @@ color for glow; black reads as diffuse shadow.| Raised | Primary CTA, focused card, overlay | 6–10 | 10–16 | 0.12–0.20 || Glow | Short display text, metric, focus accent | 0 offset | 4–8 | 0.35–0.55 |-**Strong default — single light source per page**: every `feOffset` shadow on-one slide shares the same `dx`/`dy` direction (default `dx="0"`, `dy="4"`–`dy="8"`,-light from upper front). Contradictory shadow directions read as multiple light-sources — a clear low-quality tell. The one sanctioned exception is a deliberate-upward paper-layer light, where every affected layer flips direction together;-never mix directions on the same plane. This is a strong default, not a-checker-enforced hard rule.--**Reference — not a constraint**: keep at most two-non-floor tiers; two or three shadowed objects usually suffice. Do not lift-every peer card or stack strong shadow, border, gradient, and tint on one-container. Same-family colored shadow is reserved for a focal accent. On dark-backgrounds, prefer a light hairline or restrained glow; never glow body copy.-Negative `dy` is valid for an intentional upward paper-layer light source when-every affected layer uses the same direction. For older/strict renderers,-replace a filter with two or three offset translucent shapes behind the object:+**Default — one light source per page (may override when every affected layer+uses one deliberate alternative direction)**: every `feOffset` shadow on one+slide shares the same `dx`/`dy` direction (default `dx="0"`,+`dy="4"`–`dy="8"`, light from upper front). Contradictory shadow directions+make one plane read as several incompatible surfaces. A deliberate upward+paper-layer treatment flips every affected layer together; never mix+directions on the same plane.++**Reference — not a constraint**: use no more elevation categories than the+hierarchy needs; a page may reuse one category across several related objects.+Do not lift every peer card or stack strong shadow, border, gradient, and tint+on one container. Same-family colored shadow is reserved for a focal accent.+On dark backgrounds, prefer a light hairline or restrained glow; never glow body copy.+For older/strict renderers, replace a filter with two or three offset+translucent shapes behind the object:alpha `0.03–0.05`, increasing offset/radius, and optional same-family tint near`0.04` (`Native-stable`).@@ -269,6 +308,8 @@ alpha `0.03–0.05`, increasing offset/radius, and optional same-family tint nea### 6.5 Image Treatments, Overlays, and Glass-like Surfaces+#### Image Carrier and Crop Contracts+| Need | Authoring contract | Fidelity ||---|---|---|| Cover/crop | Readable raster dimensions + aligned `slice` | Native `srcRect`; `Native-stable`; otherwise native crop cannot be guaranteed |@@ -330,12 +371,15 @@ plain `<image>`. Extra, indirect, or character content; unknown attributes;malformed or unrepresentable crops; and general nested viewports fail. Checkerand converter share this parser.+#### Image Overlay and Material Techniques+| Overlay | Construction | Typical stops / alpha ||---|---|---|| Directional scrim | Linear rect, darkest beside text | `0%: 0.88; 55%: 0.30; 100%: 0` || Bottom title fade | Vertical rect over lower image | black `0 → 0.72` || Vignette/spotlight | Radial rect; place the hotspot with `fx/fy` or `cx/cy` inside the canonical focus circle; outer center/radius remain approximate | black `0 → 0.58` || Brand wash | Directional existing brand-color gradient | `0.80 → 0.10` |+| Grid scrim | Seamless no-stroke rect cells over one image; vary neighboring alpha narrowly and irregularly | Keep the field subordinate; a regular alternation reads as a checkerboard || Faux glass | Visible fields + diagonal linear panel (`0,0 → 1,1`) + highlight stroke; optional §6.4 elevation | white `0.38 → 0.12`; stroke about `0.55` |Layer in document order: image → scrim/wash → text. True source/backdrop blur is@@ -679,7 +723,7 @@ filled `Native-normalized` arrowhead. Example:----### 6.11 Constructed Visual Styles+### 6.11 Constructed Technique Recipes**Hard rule — explicit construction**: these are supported-layer recipes, notbrowser-filter permissions.@@ -689,18 +733,18 @@ Quick-resolved style. Their curve recipes are explicit exceptions to theShape-first default above; they do not authorize decorative freeforms inanother style.-| Intent | Construction | Boundary / fidelity |-|---|---|---|-| Faux glass | §6.5 translucent panel + highlight stroke + visible fields | No backdrop blur; `Native-normalized` |-| Hand-drawn mark | Rotated translucent bar + irregular `Q/C` paths + round caps | No roughness filter; `Native-normalized` |-| Ink wash | Few same-family translucent closed curves/strokes | No feather/wet edge; `Native-normalized` |-| Riso offset | Duplicate text/shape with small offset, second ink, lower alpha | No blend mode; `Native-normalized` |-| Pixel grid | Integer-aligned rects on one cell grid | `shape-rendering` preview-only; `Native-stable` |-| Halftone | Sparse calculated circles | `Native-stable`; bake dense screens / use suitable [`native-data-interface.md`](./native-data-interface.md) preset |-| Isometric facets | Shared-vertex top/front/side polygons, one light direction | 2D only; `Native-normalized` |-| Paper cut | Ordered organic paths + consistent §6.4 shadow per layer | Filter each layer, not group; `Approximate` |-| Gradient ribbon | Non-degenerate cubic path + §6.3 gradient stroke; closed gradient-filled shape for horizontal/vertical ribbons | `Native-normalized`; no mesh gradient; re-import may flatten color |-| Line-plus-area data | Low-alpha closed area first, crisp line above | Keep area subordinate; `Native-normalized` |+| Family | Technique | Use when | Construction / boundary |+|---|---|---|---|+| Material / depth | Faux glass | Visible field must remain present behind a panel | §6.5 translucent panel + highlight; no backdrop blur; `Native-normalized` |+| Material / depth | Paper cut | Ordered layers/openings carry the material language | Organic paths + one §6.4 shadow per layer, never the group; `Approximate` |+| Hand / print | Hand-drawn mark | Annotation, underline, or highlighter gesture | Rotated translucent bar + restrained `Q/C` paths + round caps; no roughness filter; `Native-normalized` |+| Hand / print | Ink wash | Brush mass or atmosphere | Same-family translucent curves/strokes; no feather/wet edge; `Native-normalized` |+| Hand / print | Riso offset | Deliberate print misregistration | Offset duplicate, second ink, lower alpha; no blend mode; `Native-normalized` |+| Hand / print | Pixel grid | Sparse hard-cell digital accent | Integer-aligned rect grid; `shape-rendering` preview-only; `Native-stable` |+| Hand / print | Halftone | Sparse screen modulation | Calculated circles; `Native-stable`; bake dense screens or use [`native-data-interface.md`](./native-data-interface.md) |+| Form / geometry | Faceted or folded form | Isometric object, folded ribbon, dimensional numeral/band | Shared vertices, one light direction, same-hue alternating paint per [`native-shape-authoring.md`](./native-shape-authoring.md) §7.1; no 3D; `Native-normalized` |+| Form / geometry | Gradient ribbon | Continuous directional energy, not faceted depth | Cubic gradient stroke or closed gradient-filled band; no mesh gradient; `Native-normalized`, re-import may flatten color |+| Data expression | Line plus area | Magnitude context beneath an exact reading edge | Subordinate low-alpha area first, crisp line above; `Native-normalized` |**Minimal construction anchors**:@@ -760,40 +804,22 @@ import diagnostics. Resolve those diagnostics before release export; see----### 6.13 Scenario Routing+### 6.13 Page-Level Composition Recipes-**Reference — not a quota**: this table routes a job diagnosed in §6.1;-it is not a catalog checklist. Fidelity and the locked or Quick-resolved style-remain authoritative in the owning subsection.--| Decision family | Scenario routing | Authority / boundary |-|---|---|---|-| Paint | Directional or continuous value change → linear gradient; center-weighted focus → radial gradient; subordinate layer or overlap depth → channel alpha; short display emphasis → gradient text; hierarchy already clear → solid paint | §6.2 / §6.3; do not use color variation without a semantic or material job |-| Elevation | Object visibly above another surface → resting/raised shadow; overlay boundary against a dark or complex image → restrained glow or hairline; one focal CTA → restrained colored shadow; equal peers/background → flat; luminous short title/metric → glow | §6.4; one light direction; never body-copy glow |-| Image/material | Text over image → directional scrim; bottom title → bottom fade; centered hero → vignette; brand unification → brand wash; foreground panel over image → faux glass | §6.5; validate actual contrast; no backdrop blur |-| Lines | Draft/optional/future → dash; process direction → marker; undirected relationship → solid connector; continuous flow/series → gradient stroke; exact grid → multi-subpath path | §6.6 / §6.3 |-| Text | Removed/former value → line-through; short eyebrow → tracking; display heading needing a distinct silhouette → outline/gradient; luminous focal metric → glow; list → native bullet | §6.7 / §6.4; body copy may keep semantic decoration, but not decorative gradient/outline/glow/tracking |-| Composition | Physical tilt or directional energy → rotate; reversible non-text asset facing the wrong way → mirror; repeated exact static mark → local `<use>` | §6.8; preserve z-order; never mirror text, logos, or directional evidence |-| Hand/print | Annotation → highlighter/curve; ink wash → layered alpha paths; Riso → offset duplicate | §6.11; no turbulence, true bleed, or blend mode |-| Pixel/halftone | Pixel accent → integer rect grid; sparse screen → circles | §6.11; dense screen → §6.12 |-| Faceted/layered | Pseudo-3D → 2D facets; paper cut → direct shadow per layer | §6.11; no 3D transform/group composite shadow |-| Data/freeform | Series depth → area first + line above; unmatched organic silhouette → closed cubic; shaped image → [`shared-standards-core.md`](./shared-standards-core.md) §1.2 path clip | §6.11 / §6.9 |-| Radial | Donut/gauge → explicit arcs; sunburst → sector per node; position-insensitive ring → shorthand | §6.10; shorthand has 90° preview/native offset |-| Arrow | Straight relationship → `<line>` + marker; stock bend/curve → native Connector; unmatched custom route → separate calculated arrowhead if needed | §6.10 / §1.1 / native-shape authoring |-| Unsupported | Dense grain, complex per-pixel composite, or skew → explicit alternative or baked asset | §6.12; foreground text/data stay editable SVG |--#### Page-Level Stacks--Use the planned page skeleton; when images are active, select it through-[`image-layout-patterns.md`](./image-layout-patterns.md). Read each stack+**Reference — not a quota**: use the planned page skeleton; when images are+active, select it through+[`image-layout-patterns.md`](./image-layout-patterns.md). Read each recipeback-to-front and omit every layer without a distinct job.-| Page job | Back-to-front stack | Stop |+| Page / deck job | Back-to-front stack | Stop ||---|---|---|-| Cover | Hero visual/field → directional scrim/wash → one explicit opening or contour → native title/accent | Skip contrast treatment when copy is already safe; stop when title and field read as one composition |-| Divider | Image band or quiet field → restrained wash → recurring geometry → number/title | Reuse the deck language; introduce no new effect family |-| Evidence / metric | Context image/field → local contrast field → native leaders/labels/metric → optional focus/elevation | Keep claims native; remove atmosphere that weakens evidence |-| Comparison | Matched visual planes → optional shared wash/divider → matched labels → one difference marker | Keep crop, elevation, and paint symmetric unless asymmetry is the claim |-| Closing / CTA | Receded field → echoed contour/gradient → native action → optional raised accent | Add no new effect family; keep the action unambiguous and omit a competing image |+| Cover | Hero field → optional scrim/wash → purposeful opening/contour → native title | Stop when copy is safe and title/field read together |+| Divider | Image band or quiet field → restrained wash → recurring geometry → number/title | Reuse deck language; add no effect family |+| Text-led explanation | Quiet field → recurring material/contour → native hierarchy → optional local emphasis | Emphasis clarifies the argument, never decorates body copy |+| Process / system | Context field → native relation lines → nodes/labels → optional state/direction focus | Every connector stays semantic; atmosphere must not obscure flow |+| Evidence / metric | Context field → local contrast → native leaders/labels/metric → optional focus/elevation | Claims stay native; atmosphere must not weaken evidence |+| Comparison | Matched planes → optional shared wash/divider → matched labels → one difference marker | Keep crop, elevation, and paint symmetric unless asymmetry is the claim |+| Closing / CTA | Receded field → echoed contour/gradient → native action → optional raised accent | Add no effect family or competing image |+| Cross-page motif | Reuse contour, gradient direction, line language, texture, or light logic; vary scale, crop, or position by page job | Preserve recognition without copying the page or adding novelty effects |---diff --git a/skills/ppt-master/references/svg-image-embedding.md b/skills/ppt-master/references/svg-image-embedding.mdindex 60e32e3a..50c5bbf5 100644--- a/skills/ppt-master/references/svg-image-embedding.md+++ b/skills/ppt-master/references/svg-image-embedding.md@@ -8,7 +8,10 @@ Technical spec and workflow for adding images to SVG files.## Image Resource List Format-Each image carries an `Acquire Via` field plus a status annotation. This file is authoritative for status names and SVG embedding behavior.+Each image carries an `Acquire Via` field plus a status annotation. This file+owns status names, resource lifecycle, and embedding workflow;+[`svg-effects.md`](./svg-effects.md) §6.5 owns native carrier, crop transport,+and filter/clip contracts.| Mode | Resource authority and preparation timing ||---|---|diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 70470974..21c9bfa4 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": 398902+ "max_tokens": 399484},"file_budgets": {"AGENTS.md": 2400,@@ -25,7 +25,7 @@"skills/ppt-master/references/executor-notes.md": 900,"skills/ppt-master/references/shared-standards.md": 250,"skills/ppt-master/references/shared-standards-core.md": 11100,- "skills/ppt-master/references/svg-effects.md": 12807,+ "skills/ppt-master/references/svg-effects.md": 13337,"skills/ppt-master/references/native-data-interface.md": 6200,"skills/ppt-master/references/pptx-structure-interface.md": 4300,"skills/ppt-master/references/strategist.md": 14487,@@ -186,7 +186,7 @@"skills/ppt-master/references/svg-effects.md","skills/ppt-master/references/native-shape-authoring.md"],- "max_tokens": 54558+ "max_tokens": 55068},"route.generate.quick-generate.topic-research": {"description": "Quick Generate with gap-targeted factual research before direct resource preparation and SVG authoring.",@@ -196,7 +196,7 @@"stage.generate.topic-research"],"files": [],- "max_tokens": 56070+ "max_tokens": 56580},"route.generate.quick-generate.icon": {"description": "Quick Generate with project-local bundled icon selection and synchronization.",@@ -207,7 +207,7 @@"files": ["skills/ppt-master/templates/icons/README.md"],- "max_tokens": 56470+ "max_tokens": 56980},"route.generate.quick-generate.in-hand-image": {"description": "Quick Generate with supplied, extracted, or placeholder image resources prepared before SVG authoring.",@@ -217,7 +217,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 66151+ "max_tokens": 66734},"route.generate.quick-generate.formula": {"description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",@@ -229,7 +229,7 @@"files": ["skills/ppt-master/scripts/docs/image.md"],- "max_tokens": 69337+ "max_tokens": 69920},"route.generate.quick-generate.ai-two-types": {"description": "Quick Generate with AI resource preparation, representative rendering inputs, and two local image types.",@@ -240,7 +240,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 89256+ "max_tokens": 89839},"route.generate.quick-generate.web-image": {"description": "Quick Generate with web resource preparation, provenance, attribution, and image execution.",@@ -251,7 +251,7 @@"stage.generate.executor.web-image"],"files": [],- "max_tokens": 73904+ "max_tokens": 74487},"route.generate.planning-image": {"description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed, including the compact layout math and vocabulary.",@@ -261,7 +261,7 @@"stage.generate.strategist.image"],"files": [],- "max_tokens": 72937+ "max_tokens": 72961},"route.generate.planning-formula": {"description": "Formula-only planning context, including the shared image/formula layout math and vocabulary.",@@ -271,7 +271,7 @@"stage.generate.strategist.image"],"files": [],- "max_tokens": 72937+ "max_tokens": 72961},"route.generate.planning-ai": {"description": "Generate-PPTX planning when AI image direction is available, including representative multi-source custom rendering synthesis.",@@ -291,7 +291,7 @@"registry": "image-renderings"}],- "max_tokens": 77179+ "max_tokens": 77203},"stage.generate.apply-template-workspace": {"description": "Conditional Step 3 workspace validation, installation, and fusion framework.",@@ -403,7 +403,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 106077+ "max_tokens": 106595},"route.generate.flat-ai-two-types": {"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",@@ -461,7 +461,7 @@"profile.generate.beautify-pptx"],"files": [],- "max_tokens": 113084+ "max_tokens": 113602},"route.generate.flat-no-image-chart": {"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",@@ -474,7 +474,7 @@"stage.generate.verify-charts"],"files": [],- "max_tokens": 130413+ "max_tokens": 130931},"route.generate.brand-flat-no-image": {"description": "Brand-preset flat Generate-PPTX path without image acquisition.",@@ -486,7 +486,7 @@"stage.generate.template.brand"],"files": [],- "max_tokens": 113109+ "max_tokens": 113627},"route.generate.deck-structured-no-image": {"description": "Deck-preset structured Generate-PPTX path without image acquisition.",@@ -498,7 +498,7 @@"stage.generate.template.deck"],"files": [],- "max_tokens": 123046+ "max_tokens": 123564},"route.generate.layout-structured-no-image": {"description": "Layout-preset structured Generate-PPTX path without image acquisition.",@@ -510,7 +510,7 @@"stage.generate.template.layout"],"files": [],- "max_tokens": 123495+ "max_tokens": 124013},"route.generate.topic-only-flat-no-image": {"description": "Topic research followed by the default flat no-image Generate-PPTX path.",@@ -520,7 +520,7 @@"route.generate.flat-no-image"],"files": [],- "max_tokens": 107589+ "max_tokens": 108107},"stage.generate.executor.flat": {"description": "Incremental flat Executor core with complete visual-construction authorities and representative multi-source custom mode/style execution.",@@ -622,7 +622,7 @@"skills/ppt-master/workflows/stages/resume-execute.md","skills/ppt-master/references/artifact-ownership.md"],- "max_tokens": 68287+ "max_tokens": 68804},"stage.generate.resume-execute-image": {"description": "Fresh-session resume when the locked resource plan contains image rows.",@@ -796,7 +796,7 @@"skills/ppt-master/references/image-layout-spec.md","skills/ppt-master/references/image-layout-patterns.md"],- "max_tokens": 9828+ "max_tokens": 9852},"stage.generate.strategist.template": {"description": "Conditional Strategist module for an explicitly installed template workspace.",@@ -823,7 +823,7 @@"skills/ppt-master/references/image-layout-patterns.md","skills/ppt-master/references/svg-image-embedding.md"],- "max_tokens": 11613+ "max_tokens": 11666},"stage.generate.executor.web-image": {"description": "Conditional sourced-image attribution layered on image execution.",@@ -858,7 +858,7 @@"files": ["skills/ppt-master/references/svg-effects.md"],- "max_tokens": 12807+ "max_tokens": 13337}},"duplicates": {