Skip to content

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): define fixed-layer picture carriers

hugohe3a10be802ce31
diff --git a/docs/powerpoint-svg-mapping.md b/docs/powerpoint-svg-mapping.md
index 5d76a75b..cb70fbe3 100644
--- a/docs/powerpoint-svg-mapping.md
+++ b/docs/powerpoint-svg-mapping.md
@@ -145,7 +145,7 @@ preset selection and authoring behavior are documented in
| Crop picture to fill | One registered alignment plus explicit `slice` | Native `a:srcRect` crop | `Native-stable` when source dimensions are readable | Alignment is case-sensitive; unknown modes and extra tokens are errors |
| Fit picture inside frame | Omitted default, or one registered alignment plus explicit `meet` | Native fitted picture frame | `Native-normalized` | Alignment-only shorthand is compatible input that receives a normalization recommendation |
| Picture transparency | Atomic image `opacity` | Native `a:alphaModFix` | `Native-stable` | Value must be finite and within the accepted opacity grammar |
-| Picture shadow or glow | One registered effect filter directly on an unclipped `<image>`; a clipped image or imported crop uses its exact single-picture outer carrier | Native `p:pic/p:spPr/a:effectLst` | `Approximate`; one effect round-trips as one editable picture | `filter` and `clip-path` cannot share one `<image>`; Layer/Placeholder/Binding/replacement ownership stays outside the carrier; ordinary group filters, other primitives, effect DAGs, and multiple independent effects remain unsupported |
+| Picture shadow or glow | One registered effect filter directly on an unclipped `<image>`; a clipped image or imported crop uses its exact single-picture outer carrier | Native `p:pic/p:spPr/a:effectLst` | `Approximate`; one effect round-trips as one editable picture, including a direct Master/Layout atom | `filter` and `clip-path` cannot share one `<image>`; only a direct fixed atom may put `data-pptx-layer="master|layout"` on the carrier, while Placeholder/Binding/replacement ownership stays outside; ordinary group filters, other primitives, effect DAGs, and multiple independent effects remain unsupported |
| Picture clipped to a shape | Registered image/crop-wrapper `clip-path` with one SVG-namespace shape | Picture preset or custom geometry | `Native-normalized` | Circle/ellipse/rect presets must cover the complete picture frame; use path/polygon for partial or offset contours; masks and winding-rule-dependent contours are not accepted |
| Imported cropped picture | Exact SVG-namespace nested crop wrapper produced by import, containing one direct unit-frame image in the visual root/`g` tree | Native signed `a:srcRect` on re-export | `Native-stable` within the crop contract, including negative crop values | Any generalized nested viewport, non-visual/render-only owner, extra visual child, unrepresentable crop window, redundant uncropped wrapper, or unresolved clip-marker pair is rejected |
| Picture recolor, artistic filter, blur, or complex mask | No general authoring mapping | Rebuild with supported overlays or pre-render | `Bake-required` | Unregistered SVG filters and blend modes fail the main contract |
diff --git a/docs/zh/powerpoint-svg-mapping.md b/docs/zh/powerpoint-svg-mapping.md
index 1da52094..920cd8eb 100644
--- a/docs/zh/powerpoint-svg-mapping.md
+++ b/docs/zh/powerpoint-svg-mapping.md
@@ -140,7 +140,7 @@ PowerPoint 意图
| 图片裁剪填充 | 一个已登记对齐值加显式 `slice` | 原生 `a:srcRect` 裁剪 | 源尺寸可读时为 `Native-stable` | 对齐值区分大小写;未知模式与额外 token 为 error |
| 图片适应框 | 省略时使用默认值,或一个已登记对齐值加显式 `meet` | 原生 fitted picture frame | `Native-normalized` | 仅写对齐值是兼容输入,Checker 会给出规范化建议 |
| 图片透明度 | 原子 image `opacity` | 原生 `a:alphaModFix` | `Native-stable` | 值必须有限,并在可接受 opacity 语法内 |
-| 图片阴影或发光 | 未裁剪 `<image>` 直接承载一个已登记效果 filter;裁剪图片或导入 crop 使用精确单图片外层载体 | 原生 `p:pic/p:spPr/a:effectLst` | `Approximate`;单一效果以一个可编辑图片往返 | `filter` 与 `clip-path` 不得同挂一个 `<image>`;Layer/Placeholder/Binding/替换所有权留在载体外层;普通组 filter、其他 primitive、效果 DAG 与多个独立效果仍不支持 |
+| 图片阴影或发光 | 未裁剪 `<image>` 直接承载一个已登记效果 filter;裁剪图片或导入 crop 使用精确单图片外层载体 | 原生 `p:pic/p:spPr/a:effectLst` | `Approximate`;单一效果以一个可编辑图片往返,也可作为直接 Master/Layout 原子 | `filter` 与 `clip-path` 不得同挂一个 `<image>`;仅直接固定原子可在载体上声明 `data-pptx-layer="master|layout"`,Placeholder/Binding/替换所有权仍留在外层;普通组 filter、其他 primitive、效果 DAG 与多个独立效果仍不支持 |
| 图片裁成形状 | 作用于 image/crop wrapper 且只含一个 SVG 命名空间形状的已登记 `clip-path` | picture preset 或 custom geometry | `Native-normalized` | circle/ellipse/rect preset 必须覆盖完整图片 frame;局部或偏移轮廓使用 path/polygon;不接受任意 mask 或依赖绕组规则(winding rule)的轮廓 |
| 导入的裁剪图片 | 导入器产生的精确 SVG 命名空间嵌套 crop wrapper,在可视根/`g` 树中内含一个直接 unit-frame image | 重新导出为原生 signed `a:srcRect` | crop 合同内为 `Native-stable`,包括负裁剪值 | 拒绝通用嵌套 viewport、非可视或仅渲染所属容器、额外可视子元素、不可表示的 crop window、无裁剪的冗余 wrapper,以及无法解析的 clip-marker 配对 |
| 图片重着色、艺术滤镜、模糊或复杂 mask | 无通用创作映射 | 使用受支持 overlay 重建或预渲染 | `Bake-required` | 未登记 SVG filter 和 blend mode 违反主合同 |
diff --git a/skills/ppt-master/references/svg-effects.md b/skills/ppt-master/references/svg-effects.md
index dce733fc..cde99ee6 100644
--- a/skills/ppt-master/references/svg-effects.md
+++ b/skills/ppt-master/references/svg-effects.md
@@ -295,10 +295,10 @@ filter directly on an unclipped `<image>`. For a clipped picture, keep
sole visual child is that image. Never combine `filter` and `clip-path` on the
same `<image>`: SVG would clip the preview effect while PowerPoint would not.
The carrier may keep object-local id, role, transform, and
-`data-pptx-carrier`; it must not own `data-pptx-layer`,
+`data-pptx-carrier`. It may own `data-pptx-layer="master|layout"` only when
+the carrier itself is the direct fixed atom. It must not own
`data-pptx-placeholder`, `data-pptx-binding`, or chart/table replacement
-metadata. In structured SVG, keep that ownership on the outer slot/layer
-boundary.
+metadata; keep slot ownership on the outer placeholder boundary.
**Hard rule — picture frames and sources are explicit and decodable**: every
SVG `<image>` has explicit positive `width`/`height` and exactly one non-empty
diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.json
index 7089b699..45d7df70 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": 397338
+ "max_tokens": 397351
},
"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": 12779,
+ "skills/ppt-master/references/svg-effects.md": 12792,
"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": 54532
+ "max_tokens": 54545
},
"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": 56044
+ "max_tokens": 56057
},
"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": 56444
+ "max_tokens": 56457
},
"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": 64616
+ "max_tokens": 64629
},
"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": 67802
+ "max_tokens": 67815
},
"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": 87721
+ "max_tokens": 87734
},
"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": 72369
+ "max_tokens": 72382
},
"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.",
@@ -403,7 +403,7 @@
"stage.generate.executor.notes"
],
"files": [],
- "max_tokens": 106072
+ "max_tokens": 106085
},
"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": 113079
+ "max_tokens": 113092
},
"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": 130408
+ "max_tokens": 130421
},
"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": 113104
+ "max_tokens": 113117
},
"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": 123041
+ "max_tokens": 123054
},
"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": 123490
+ "max_tokens": 123503
},
"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": 107584
+ "max_tokens": 107597
},
"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": 68282
+ "max_tokens": 68295
},
"stage.generate.resume-execute-image": {
"description": "Fresh-session resume when the locked resource plan contains image rows.",
@@ -858,7 +858,7 @@
"files": [
"skills/ppt-master/references/svg-effects.md"
],
- "max_tokens": 12779
+ "max_tokens": 12792
}
},
"duplicates": {