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(templates): align icon and layout specs

hugohe3563305200982
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 58cffeb5..55f6a468 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -108,7 +108,7 @@ Strategist chooses the icon approach and approved inventory. Executor only imple
**Built-in icons — Placeholder method (recommended)**:
```xml
-<!-- chunk-filled (default — straight-line geometry, sharp corners, structured) -->
+<!-- chunk-filled (straight-line geometry, sharp corners, structured) -->
<use data-icon="chunk-filled/home" x="100" y="200" width="48" height="48" fill="#005587"/>
<!-- tabler-filled (bezier-curve forms, smooth & rounded contours) -->
@@ -130,7 +130,7 @@ Strategist chooses the icon approach and approved inventory. Executor only imple
> ⚠️ **Icon Color Rule**: For `<use data-icon="...">` tags, ALWAYS use `fill="#HEX"` to set the color. NEVER use `stroke` or `fill="none"` on these placeholders, even for stroke-style libraries.
>
-> Optional `stroke-width` on the placeholder (stroke-style libraries only — currently `tabler-outline`): default 2, pass 1.5 for thin, 3 for bold. Ignored on fill libraries (`chunk-filled` / `tabler-filled`).
+> Optional `stroke-width` on the placeholder (stroke-style libraries only — currently `tabler-outline`): default 2, pass 1.5 for thin, 3 for bold. Ignored on non-stroke libraries (`chunk-filled` / `tabler-filled` / `phosphor-duotone` / `simple-icons`).
>
> No need to manually run `embed_icons.py`; `finalize_svg.py` post-processing tool will auto-embed icons.
diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.md
index 6309b5ae..7ff70691 100644
--- a/skills/ppt-master/references/shared-standards.md
+++ b/skills/ppt-master/references/shared-standards.md
@@ -169,7 +169,7 @@ A single offending character invalidates the whole file and aborts the deck expo
- **Styles**: Use inline styles only (`fill="..."` `font-size="..."`); `<style>` / `class` are FORBIDDEN (`id` inside `<defs>` is legitimate)
- **Colors**: Use HEX values; for transparency use `fill-opacity` / `stroke-opacity`
- **Image references**: `<image href="../images/xxx.png" preserveAspectRatio="xMidYMid slice"/>`
-- **Icon placeholders**: `<use data-icon="chunk-filled/name" x="" y="" width="48" height="48" fill="#HEX"/>` (default library); or `tabler-filled/name` / `tabler-outline/name` when that library is chosen for the deck. (auto-embedded during post-processing). Always include the library prefix. **One presentation = one library — never mix libraries.**
+- **Icon placeholders**: `<use data-icon="<library>/<name>" x="" y="" width="48" height="48" fill="#HEX"/>` (auto-embedded during post-processing). Always include the library prefix. Generic icons must use exactly one stylistic library per presentation (`chunk-filled` / `tabler-filled` / `tabler-outline` / `phosphor-duotone`); `simple-icons` may co-exist only for real company / product / service brand marks. See [`../templates/icons/README.md`](../templates/icons/README.md).
### Inline Text Runs (Single Logical Line = Single `<text>`)
@@ -262,7 +262,7 @@ Logically related elements **MUST** be wrapped in `<g>` tags. This produces Powe
<g id="card-benefits-1">
<!-- This card floats over a colored panel — shadow is appropriate. On a flat white canvas, omit the filter. -->
<rect x="60" y="115" width="565" height="260" rx="20" fill="#FFFFFF" filter="url(#shadow)"/>
- <use data-icon="bolt" x="108" y="163" width="44" height="44" fill="#0071E3"/>
+ <use data-icon="chunk-filled/bolt" x="108" y="163" width="44" height="44" fill="#0071E3"/>
<text x="105" y="270" font-size="56" font-weight="bold" fill="#0071E3">10×</text>
<text x="250" y="270" font-size="30" font-weight="bold" fill="#1D1D1F">Faster</text>
<text x="105" y="310" font-size="18" fill="#6E6E73">Reduce production time from days to hours.</text>
diff --git a/skills/ppt-master/scripts/svg_finalize/embed_icons.py b/skills/ppt-master/scripts/svg_finalize/embed_icons.py
index e5ddc71e..f4360727 100644
--- a/skills/ppt-master/scripts/svg_finalize/embed_icons.py
+++ b/skills/ppt-master/scripts/svg_finalize/embed_icons.py
@@ -4,12 +4,16 @@ SVG Icon Embedding Tool
Replaces icon placeholders in SVG files with actual icon code.
-Placeholder syntax:
- <use data-icon="rocket" x="100" y="200" width="48" height="48" fill="#0076A8"/>
+Placeholder syntax (new SVGs must include a library prefix):
+ <use data-icon="chunk-filled/rocket" x="100" y="200" width="48" height="48" fill="#0076A8"/>
<use data-icon="tabler-filled/home" x="100" y="200" width="48" height="48" fill="#0076A8"/>
<use data-icon="tabler-outline/home" x="100" y="200" width="48" height="48" fill="#0076A8"/>
<use data-icon="tabler-outline/home" x="100" y="200" width="48" height="48" fill="#0076A8" stroke-width="3"/>
+Legacy compatibility accepted by the resolver:
+ <use data-icon="rocket" .../> -> chunk-filled/rocket
+ <use data-icon="chunk/rocket" .../> -> chunk-filled/rocket
+
Optional `stroke-width` (stroke-style libraries only — e.g. tabler-outline):
Default 2 (matches the source). Pass 1.5 for thin, 3 for bold.
Ignored on fill-style libraries.
diff --git a/skills/ppt-master/templates/README.md b/skills/ppt-master/templates/README.md
index f728f69b..0ec10b68 100644
--- a/skills/ppt-master/templates/README.md
+++ b/skills/ppt-master/templates/README.md
@@ -43,7 +43,7 @@ The `charts/` directory contains 57 standardized visualization templates. For ba
## Icon Library
-The `icons/` directory contains 11,500+ vector icons across five libraries:
+The `icons/` directory contains 11,600+ vector icons across five libraries:
| Library | Style | Count |
|---------|-------|-------|
diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.md
index e3362b13..34a47d28 100644
--- a/skills/ppt-master/templates/design_spec_reference.md
+++ b/skills/ppt-master/templates/design_spec_reference.md
@@ -200,14 +200,14 @@ Two views on the same font decisions — fill both, keep them consistent:
### Source
-- **Built-in icon library**: `templates/icons/` (6700+ icons across three libraries)
-- **Usage method**: Placeholder format `{{icon:category/icon-name}}`
+- **Built-in icon library**: `templates/icons/` (11,600+ icons across five libraries; see `templates/icons/README.md`)
+- **Usage method**: SVG placeholder `<use data-icon="library/icon-name" .../>`; Design Spec should list approved `library/icon-name` entries for Executor.
### Recommended Icon List (fill as needed)
| Purpose | Icon Path | Page |
| ------- | --------- | ---- |
-| [example] | `{{icon:interface/check-circle}}` | Slide XX |
+| [example] | `chunk-filled/circle-checkmark` | Slide XX |
---
diff --git a/skills/ppt-master/templates/icons/README.md b/skills/ppt-master/templates/icons/README.md
index 78540f17..1d53cdcd 100644
--- a/skills/ppt-master/templates/icons/README.md
+++ b/skills/ppt-master/templates/icons/README.md
@@ -1,6 +1,6 @@
# SVG Icon Library
-This directory provides **11000+ high-quality SVG icons** across five libraries that can be directly embedded into SVG files generated by PPT Master. Four are stylistic libraries (pick **one** per deck); one is a brand-logo library (`simple-icons`) used as an inset alongside the chosen stylistic library.
+This directory provides **11,600+ high-quality SVG icons** across five libraries that can be directly embedded into SVG files generated by PPT Master. Four are stylistic libraries (pick **one** per deck); one is a brand-logo library (`simple-icons`) used as an inset alongside the chosen stylistic library.
## Libraries
diff --git a/skills/ppt-master/templates/layouts/academic_defense/design_spec.md b/skills/ppt-master/templates/layouts/academic_defense/design_spec.md
index 01359cde..b2952c06 100644
--- a/skills/ppt-master/templates/layouts/academic_defense/design_spec.md
+++ b/skills/ppt-master/templates/layouts/academic_defense/design_spec.md
@@ -189,7 +189,7 @@
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (no `<foreignObject>`)
4. Use `fill-opacity` / `stroke-opacity` for transparency; no `rgba()`
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. `marker-start` / `marker-end` conditionally allowed (marker in `<defs>`, `orient="auto"`, shape = triangle/diamond/oval) — see shared-standards.md §1.1
diff --git a/skills/ppt-master/templates/layouts/ai_ops/design_spec.md b/skills/ppt-master/templates/layouts/ai_ops/design_spec.md
index 7c2a5db4..ef7f7c01 100644
--- a/skills/ppt-master/templates/layouts/ai_ops/design_spec.md
+++ b/skills/ppt-master/templates/layouts/ai_ops/design_spec.md
@@ -296,7 +296,7 @@ This template emulates the visual language of telecom technical reports. The cor
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (**`<foreignObject>` is strictly prohibited**)
4. Use `fill-opacity` / `stroke-opacity` for transparency; `rgba()` is prohibited
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject` (`id` inside `<defs>` is allowed)
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject` (`id` inside `<defs>` is allowed). `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. Prohibited: `<symbol>+<use>`, `<iframe>`, `@font-face`
8. Prohibited: `<g opacity="...">` (group opacity) — set opacity on each child element individually
diff --git a/skills/ppt-master/templates/layouts/anthropic/design_spec.md b/skills/ppt-master/templates/layouts/anthropic/design_spec.md
index 05787d39..4209ada3 100644
--- a/skills/ppt-master/templates/layouts/anthropic/design_spec.md
+++ b/skills/ppt-master/templates/layouts/anthropic/design_spec.md
@@ -200,7 +200,7 @@
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (**strictly no** `<foreignObject>`)
4. Use `fill-opacity` / `stroke-opacity` for transparency
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. Define gradients using `<defs>`
diff --git a/skills/ppt-master/templates/layouts/china_telecom_template/design_spec.md b/skills/ppt-master/templates/layouts/china_telecom_template/design_spec.md
index 76f7e4ab..a7c57665 100644
--- a/skills/ppt-master/templates/layouts/china_telecom_template/design_spec.md
+++ b/skills/ppt-master/templates/layouts/china_telecom_template/design_spec.md
@@ -163,7 +163,7 @@
## IX. SVG Technical Constraints
1. `viewBox` must remain `0 0 1280 720`
-2. Do not use `mask`, `clipPath`, `<style>`, `class`, `foreignObject`, or `rgba()`
+2. Do not use `mask`, `<style>`, `class`, `foreignObject`, or `rgba()`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
3. Use plain vector geometry and `<image>` references to packaged assets only
4. Transparency must use `fill-opacity` / `stroke-opacity`
5. Text wrapping should be handled with `<tspan>` if needed
diff --git a/skills/ppt-master/templates/layouts/exhibit/design_spec.md b/skills/ppt-master/templates/layouts/exhibit/design_spec.md
index 092ff0b6..345e4d63 100644
--- a/skills/ppt-master/templates/layouts/exhibit/design_spec.md
+++ b/skills/ppt-master/templates/layouts/exhibit/design_spec.md
@@ -180,7 +180,7 @@
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (no `<foreignObject>`)
4. Use `fill-opacity` / `stroke-opacity` for transparency; no `rgba()`
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. `marker-start` / `marker-end` conditionally allowed (marker in `<defs>`, `orient="auto"`, shape = triangle/diamond/oval) — see shared-standards.md §1.1
8. Define gradients using `<defs>` with `<linearGradient>`
diff --git a/skills/ppt-master/templates/layouts/google_style/design_spec.md b/skills/ppt-master/templates/layouts/google_style/design_spec.md
index 7430fb74..e07dc4a5 100644
--- a/skills/ppt-master/templates/layouts/google_style/design_spec.md
+++ b/skills/ppt-master/templates/layouts/google_style/design_spec.md
@@ -73,9 +73,9 @@
### Font Stack
-**Font Stack**: `system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif`
+**Font Stack**: `Arial, "Microsoft YaHei", sans-serif`
-> Uses system UI font stack to ensure cross-platform consistency and optimal rendering.
+> Uses PowerPoint-safe cross-platform fonts by default. Roboto may be used only when the target environment explicitly installs or embeds it.
### Font Size Hierarchy
@@ -230,7 +230,7 @@ Color order: Blue → Red → Yellow → Green
The following SVG features are prohibited (not PPT-compatible):
-- `clipPath`, `mask`
+- `mask`; `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
- `<style>` tag, `class` attribute
- `foreignObject`
- `textPath`
diff --git a/skills/ppt-master/templates/layouts/government_blue/design_spec.md b/skills/ppt-master/templates/layouts/government_blue/design_spec.md
index eaff3806..7a71f309 100644
--- a/skills/ppt-master/templates/layouts/government_blue/design_spec.md
+++ b/skills/ppt-master/templates/layouts/government_blue/design_spec.md
@@ -178,7 +178,7 @@
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (no `<foreignObject>`)
4. Use `fill-opacity` / `stroke-opacity` for transparency; `rgba()` is prohibited
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. `marker-start` / `marker-end` conditionally allowed (marker in `<defs>`, `orient="auto"`, shape = triangle/diamond/oval) — see shared-standards.md §1.1
diff --git a/skills/ppt-master/templates/layouts/government_red/design_spec.md b/skills/ppt-master/templates/layouts/government_red/design_spec.md
index 916e015d..75d0967c 100644
--- a/skills/ppt-master/templates/layouts/government_red/design_spec.md
+++ b/skills/ppt-master/templates/layouts/government_red/design_spec.md
@@ -174,7 +174,7 @@
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (no `<foreignObject>`)
4. Use `fill-opacity` / `stroke-opacity` for transparency; `rgba()` is prohibited
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. `marker-start` / `marker-end` conditionally allowed (marker in `<defs>`, `orient="auto"`, shape = triangle/diamond/oval) — see shared-standards.md §1.1
diff --git a/skills/ppt-master/templates/layouts/mckinsey/design_spec.md b/skills/ppt-master/templates/layouts/mckinsey/design_spec.md
index 73ee236c..940e54c9 100644
--- a/skills/ppt-master/templates/layouts/mckinsey/design_spec.md
+++ b/skills/ppt-master/templates/layouts/mckinsey/design_spec.md
@@ -198,7 +198,7 @@
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (no `<foreignObject>`)
4. Use `fill-opacity` / `stroke-opacity` for transparency; `rgba()` is prohibited
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. `marker-start` / `marker-end` conditionally allowed (marker in `<defs>`, `orient="auto"`, shape = triangle/diamond/oval) — see shared-standards.md §1.1
8. Define gradients using `<linearGradient>` within `<defs>`
diff --git a/skills/ppt-master/templates/layouts/medical_university/design_spec.md b/skills/ppt-master/templates/layouts/medical_university/design_spec.md
index 64f09447..60e553a1 100644
--- a/skills/ppt-master/templates/layouts/medical_university/design_spec.md
+++ b/skills/ppt-master/templates/layouts/medical_university/design_spec.md
@@ -211,8 +211,8 @@ To adapt to other medical institution branding, replace the corresponding values
| Prohibited Item | Alternative |
| -------------------- | ------------------------------ |
-| `clipPath` | Do not use clipping |
-| `mask` | Do not use masking |
+| `clipPath` | Allowed only on `<image>` under `shared-standards.md` §1.2 |
+| `mask` | Do not use masking |
| `<style>` | Use inline styles |
| `class` | Use inline attributes (`id` inside `<defs>` is allowed) |
| `foreignObject` | Use `<tspan>` for wrapping |
diff --git a/skills/ppt-master/templates/layouts/pixel_retro/design_spec.md b/skills/ppt-master/templates/layouts/pixel_retro/design_spec.md
index 2fb7bd86..ba1673a0 100644
--- a/skills/ppt-master/templates/layouts/pixel_retro/design_spec.md
+++ b/skills/ppt-master/templates/layouts/pixel_retro/design_spec.md
@@ -241,7 +241,7 @@ Apply glow filters to key text/elements:
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (no `<foreignObject>`)
4. Use `fill-opacity` / `stroke-opacity` for transparency; `rgba()` is prohibited
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. `marker-start` / `marker-end` conditionally allowed (marker in `<defs>`, `orient="auto"`, shape = triangle/diamond/oval) — see shared-standards.md §1.1
diff --git a/skills/ppt-master/templates/layouts/psychology_attachment/design_spec.md b/skills/ppt-master/templates/layouts/psychology_attachment/design_spec.md
index c4df3a22..9a67a7a7 100644
--- a/skills/ppt-master/templates/layouts/psychology_attachment/design_spec.md
+++ b/skills/ppt-master/templates/layouts/psychology_attachment/design_spec.md
@@ -91,9 +91,9 @@ The design adopts "**Secure Base**" as the core visual metaphor:
### Font Stack
-**Chinese Font Stack**: `"PingFang SC", "Microsoft YaHei", system-ui, -apple-system, sans-serif`
+**Chinese Font Stack**: `"Microsoft YaHei", "PingFang SC", sans-serif`
-**English Font Stack**: `system-ui, -apple-system, sans-serif`
+**English Font Stack**: `Arial, sans-serif`
### Font Size Hierarchy
@@ -301,24 +301,26 @@ The design adopts "**Secure Base**" as the core visual metaphor:
## IX. Icon Usage
+Use `tabler-outline` as the stylistic icon library for this template. It matches the professional, warm, low-noise psychology tone and avoids heavy filled symbols.
+
### Placeholder Format
```xml
-<use data-icon="icon-name" x="X" y="Y" width="32" height="32" fill="COLOR"/>
+<use data-icon="tabler-outline/icon-name" x="X" y="Y" width="32" height="32" fill="COLOR"/>
```
### Common Icon Mappings
| Concept | Icons |
| -------------------- | ------------------------- |
-| Attachment/Bonding | `heart`, `link` |
-| Secure Base | `home`, `shield-check` |
-| Mentalization | `brain`, `lightbulb` |
-| Affect Regulation | `activity`, `sliders` |
-| Awareness | `eye`, `compass` |
-| Trauma | `alert-triangle`, `zap` |
-| Repair | `refresh-cw`, `tool` |
-| Development | `trending-up`, `layers` |
+| Attachment/Bonding | `tabler-outline/heart`, `tabler-outline/link` |
+| Secure Base | `tabler-outline/home`, `tabler-outline/shield-check` |
+| Mentalization | `tabler-outline/brain`, `tabler-outline/bulb` |
+| Affect Regulation | `tabler-outline/activity`, `tabler-outline/adjustments-horizontal` |
+| Awareness | `tabler-outline/eye`, `tabler-outline/compass` |
+| Trauma | `tabler-outline/alert-triangle`, `tabler-outline/bolt` |
+| Repair | `tabler-outline/refresh`, `tabler-outline/tool` |
+| Development | `tabler-outline/trending-up`, `tabler-outline/layers-linked` |
---
@@ -334,7 +336,7 @@ The design adopts "**Secure Base**" as the core visual metaphor:
| Category | Prohibited Items |
| ------------------ | --------------------------------------- |
-| **Clipping/Masking** | `clipPath`, `mask` |
+| **Clipping/Masking** | `mask` is forbidden; `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2 |
| **Style System** | `<style>`, `class` (`id` inside `<defs>` is allowed) |
| **Structure/Nesting** | `<foreignObject>` |
| **Text/Font** | `textPath`, `@font-face` |
diff --git a/skills/ppt-master/templates/layouts/smart_red/design_spec.md b/skills/ppt-master/templates/layouts/smart_red/design_spec.md
index 1735cc79..09a064aa 100644
--- a/skills/ppt-master/templates/layouts/smart_red/design_spec.md
+++ b/skills/ppt-master/templates/layouts/smart_red/design_spec.md
@@ -173,7 +173,7 @@
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (**strictly no** `<foreignObject>`)
4. Use `fill-opacity` / `stroke-opacity` for transparency
-5. Prohibited: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. Define gradients using `<defs>`
diff --git "a/skills/ppt-master/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\345\270\270\350\247\204/design_spec.md" "b/skills/ppt-master/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\345\270\270\350\247\204/design_spec.md"
index c2294451..efb17234 100644
--- "a/skills/ppt-master/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\345\270\270\350\247\204/design_spec.md"
+++ "b/skills/ppt-master/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\345\270\270\350\247\204/design_spec.md"
@@ -170,7 +170,7 @@
### Forbidden Elements (Blacklist)
-- `clipPath`, `mask` (clipping/masking)
+- `mask` (masking); `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
- `<style>`, `class` (stylesheets; `id` within `<defs>` is allowed)
- `foreignObject` (foreign objects)
- `textPath` (text on path)
diff --git "a/skills/ppt-master/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\347\216\260\344\273\243/design_spec.md" "b/skills/ppt-master/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\347\216\260\344\273\243/design_spec.md"
index dffc6233..00a9bc85 100644
--- "a/skills/ppt-master/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\347\216\260\344\273\243/design_spec.md"
+++ "b/skills/ppt-master/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\347\216\260\344\273\243/design_spec.md"
@@ -53,7 +53,7 @@
### Font Stack
-**Primary Font Stack**: `"Microsoft YaHei", "PingFang SC", "Heiti SC", "Segoe UI", Arial, sans-serif`
+**Primary Font Stack**: `"Microsoft YaHei", Arial, sans-serif`
### Font Size Hierarchy (Enhanced Contrast)
@@ -135,11 +135,11 @@
1. **Gradients**: Use `<linearGradient>` to create metallic or light/shadow effects.
2. **Grid**: Use `<pattern>` to define precision grid backgrounds with opacity controlled at 0.05-0.1.
3. **Opacity**: Strictly use `fill-opacity` / `stroke-opacity`.
-4. **Forbidden**: No `clipPath`, `mask`.
+4. **Clipping/Masking**: `mask` is forbidden; `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2.
### Forbidden Elements (Blacklist)
-- `clipPath`, `mask` (clipping/masking)
+- `mask` (masking); `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
- `<style>`, `class` (stylesheets; `id` within `<defs>` is allowed)
- `foreignObject` (foreign objects)
- `textPath` (text on path)
@@ -174,4 +174,4 @@
1. **Logo**: Recommend using white PNG Logo to suit dark backgrounds.
2. **Background Images**: Cover background grid is embedded in SVG; no external images needed.
-3. **Fonts**: Prefer sans-serif fonts; Roboto or Arial recommended for English text.
+3. **Fonts**: Prefer PowerPoint-safe sans-serif fonts; use Arial for English text unless a custom font is explicitly installed or embedded.
diff --git "a/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\225\206\345\212\241/design_spec.md" "b/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\225\206\345\212\241/design_spec.md"
index 24dfe671..dc02efb6 100644
--- "a/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\225\206\345\212\241/design_spec.md"
+++ "b/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\225\206\345\212\241/design_spec.md"
@@ -134,9 +134,9 @@
### Mandatory Rules
1. **Gradient Support**: Use `<linearGradient>` and `<radialGradient>` defined within `<defs>`.
-2. **Shadow Simulation**: PPT does not support SVG filter shadows. Use **semi-transparent black rectangles (`fill="#000000" fill-opacity="0.1"`)** with offset stacking to simulate card shadows.
+2. **Shadow Handling**: Use restrained shadows only when an element genuinely floats above another layer. Prefer filter soft shadows from `shared-standards.md` §6; use stacked semi-transparent rectangles only when maximum compatibility is required.
3. **Opacity**: Strictly use `fill-opacity` / `stroke-opacity`.
-4. **Forbidden**: No `clipPath`, `mask`.
+4. **Clipping/Masking**: `mask` is forbidden; `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2.
---
@@ -161,6 +161,6 @@
## XI. Usage Notes (Recommended)
-1. **Shadow Handling**: All card shadows are simulated via vector rectangles, ensuring good compatibility and lossless scaling.
+1. **Shadow Handling**: Keep shadows subtle and sparse. Use shared-standards §6 as the authority; vector-rectangle shadows are the compatibility fallback.
2. **Gradients**: To modify gradient colors, adjust `stop-color` values in the `<defs>` section.
3. **Logo**: Recommend using transparent PNG. Use inverted (white) Logo for dark background pages.
diff --git "a/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\270\270\350\247\204/design_spec.md" "b/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\270\270\350\247\204/design_spec.md"
index 1f9a6224..a380392c 100644
--- "a/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\270\270\350\247\204/design_spec.md"
+++ "b/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\270\270\350\247\204/design_spec.md"
@@ -171,7 +171,7 @@
2. Use `<rect>` elements for backgrounds
3. Text wrapping via `<tspan>` (no `<foreignObject>`)
4. Opacity via `fill-opacity` / `stroke-opacity`, no `rgba()`
-5. Forbidden: `clipPath`, `mask`, `<style>`, `class`, `foreignObject`
+5. Forbidden: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Forbidden: `textPath`, `animate*`, `script`
7. `marker-start` / `marker-end` conditionally allowed (marker in `<defs>`, `orient="auto"`, shape = triangle/diamond/oval) — see shared-standards.md §1.1
diff --git "a/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\347\216\260\344\273\243/design_spec.md" "b/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\347\216\260\344\273\243/design_spec.md"
index 62b81900..46b1e43d 100644
--- "a/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\347\216\260\344\273\243/design_spec.md"
+++ "b/skills/ppt-master/templates/layouts/\344\270\255\346\261\275\347\240\224_\347\216\260\344\273\243/design_spec.md"
@@ -56,8 +56,8 @@
### Font Stack
-**Primary Font Stack**: `"Roboto", "Helvetica Neue", "Microsoft YaHei", "PingFang SC", sans-serif`
-*English and numbers are recommended to use Roboto or Arial for a tech geometric feel.*
+**Primary Font Stack**: `Arial, "Microsoft YaHei", sans-serif`
+*Use Arial for English and numbers by default. Roboto or DIN may be used only when the font is explicitly installed or embedded for the target environment.*
### Font Size Hierarchy
@@ -166,5 +166,5 @@
## XI. Usage Notes (Recommended)
1. **Light & Shadow Effects**: All light and shadow effects are achieved via SVG gradients, with no dependency on external images.
-2. **Fonts**: For optimal tech aesthetics, numbers are recommended to use **Roboto** or **DIN** fonts.
+2. **Fonts**: Use Arial for numbers by default. Roboto or DIN may be used only with an explicit font-install or font-embedding requirement.
3. **Backgrounds**: Dark backgrounds look excellent on projectors, but ensure the ambient lighting is as dim as possible.
diff --git "a/skills/ppt-master/templates/layouts/\346\213\233\345\225\206\351\223\266\350\241\214/design_spec.md" "b/skills/ppt-master/templates/layouts/\346\213\233\345\225\206\351\223\266\350\241\214/design_spec.md"
index a8a6d815..6f2e313b 100644
--- "a/skills/ppt-master/templates/layouts/\346\213\233\345\225\206\351\223\266\350\241\214/design_spec.md"
+++ "b/skills/ppt-master/templates/layouts/\346\213\233\345\225\206\351\223\266\350\241\214/design_spec.md"
@@ -123,7 +123,7 @@ Reference slides read before generation: `1, 2, 3, 4, 6, 9, 11, 13, 16, 18`.
## IX. SVG Technical Constraints
1. `viewBox` must stay `0 0 1280 720`
-2. No `clipPath`, `mask`, `<style>`, `class`, `foreignObject`, `textPath`, or animation tags
+2. No `mask`, `<style>`, `class`, `foreignObject`, `textPath`, or animation tags. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
3. Use plain hex colors with `fill-opacity` / `stroke-opacity`
4. Keep image assets semantic and minimal
5. Prefer vector reconstruction over embedding PPT-export fragments
diff --git "a/skills/ppt-master/templates/layouts/\347\247\221\346\212\200\350\223\235\345\225\206\345\212\241/design_spec.md" "b/skills/ppt-master/templates/layouts/\347\247\221\346\212\200\350\223\235\345\225\206\345\212\241/design_spec.md"
index 5dcc77b1..9eddbc6a 100644
--- "a/skills/ppt-master/templates/layouts/\347\247\221\346\212\200\350\223\235\345\225\206\345\212\241/design_spec.md"
+++ "b/skills/ppt-master/templates/layouts/\347\247\221\346\212\200\350\223\235\345\225\206\345\212\241/design_spec.md"
@@ -170,7 +170,7 @@
2. Use `<rect>` elements for backgrounds
3. Use `<tspan>` for text wrapping (**`<foreignObject>` is strictly prohibited**)
4. Use `fill-opacity` / `stroke-opacity` for transparency
-5. Prohibited: `clipPath` (avoid unless needed for image cropping), `mask`, `<style>`, `class`, `foreignObject`
+5. Prohibited: `mask`, `<style>`, `class`, `foreignObject`. `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
6. Prohibited: `textPath`, `animate*`, `script`
7. Define gradients in `<defs>`
diff --git "a/skills/ppt-master/templates/layouts/\351\207\215\345\272\206\345\244\247\345\255\246/design_spec.md" "b/skills/ppt-master/templates/layouts/\351\207\215\345\272\206\345\244\247\345\255\246/design_spec.md"
index 125c1a05..5593e1be 100644
--- "a/skills/ppt-master/templates/layouts/\351\207\215\345\272\206\345\244\247\345\255\246/design_spec.md"
+++ "b/skills/ppt-master/templates/layouts/\351\207\215\345\272\206\345\244\247\345\255\246/design_spec.md"
@@ -202,7 +202,7 @@ Small circle elements representing the nighttime lights of the Mountain City:
### Prohibited Elements
-- `clipPath`, `mask`, `<style>`, `class`
+- `mask`, `<style>`, `class`; `clipPath` is allowed only on `<image>` under `shared-standards.md` §1.2
- `foreignObject`, `textPath`, `animate*`
- `rgba()` color format
- `<g opacity="...">` (group opacity)