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): forbid HTML named entities; require XML escapes for & < >
hugohe378f15955f223
diff --git a/CLAUDE.md b/CLAUDE.mdindex 1d01d92e..353bde3e 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -51,6 +51,8 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final## SVG Technical Constraints (Non-negotiable)+**Text characters (must be well-formed XML)**: typography & symbols (em dash, en dash, ©, ®, →, NBSP, full-width punctuation, emoji…) MUST be written as raw Unicode characters; HTML named entities like ` ` `—` `©` `–` `®` are forbidden. XML reserved characters (`&` `<` `>` `"` `'`) inside text or attribute values MUST be escaped as `&` `<` `>` `"` `'` (e.g. `R&D`, `error < 5%`). See `shared-standards.md` §1.0 for full rules.+**Banned features**: `mask` | `<style>` | `class` | external CSS | `<foreignObject>` | `textPath` | `@font-face` | `<animate*>` | `<script>` | `<iframe>` | `<symbol>`+`<use>` (`id` inside `<defs>` is a legitimate reference and is NOT banned)**Conditionally allowed**: `marker-start` / `marker-end` — the referenced `<marker>` must live in `<defs>`, use `orient="auto"`, and its shape must be a triangle (3-vertex closed path/polygon), diamond (4-vertex), or circle/ellipse. The converter maps these to native DrawingML `<a:headEnd>` / `<a:tailEnd>`. See `shared-standards.md` §1.1 for full constraints.diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.mdindex e039a48c..5c6e6a65 100644--- a/skills/ppt-master/references/shared-standards.md+++ b/skills/ppt-master/references/shared-standards.md@@ -8,6 +8,19 @@ Common technical constraints for PPT Master, eliminating cross-role file duplicaThe following features are **absolutely forbidden** when generating SVGs — PPT export will break if any are used:+### 1.0 Text characters: must be well-formed XML++SVG is strict XML. Two rules apply to all text and attribute values:++| Character category | Required form | Forbidden form |+|---|---|---|+| Typography & symbols (em dash, en dash, ©, ®, →, ·, NBSP, full-width punctuation, emoji…) | **Raw Unicode characters** — write `—` `–` `©` `®` `→` directly | HTML named entities — `—` `–` `©` `®` `→` `·` ` ` `…` `•` etc. |+| XML reserved characters (`&`, `<`, `>`, `"`, `'`) | **XML entities only** — `&` `<` `>` `"` `'` (e.g. `R&D`, `error < 5%`) | Bare `&` `<` `>` (e.g. `R&D`, `error < 5%`) |++A single offending character invalidates the whole file and aborts the deck export. Numeric character references (` ` / ` `) are XML-legal but discouraged.++**Structural blacklist** (in addition to the character rules above):+| Banned Feature | Description ||----------------|-------------|| `mask` | Masks |diff --git a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.mdindex 04c3349a..b9e13c85 100644--- a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md+++ b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md@@ -278,6 +278,8 @@ font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Micr| 禁用特性 | 替代方案 ||---------|---------|+| HTML 命名实体(` ` `—` `©` `–` `®` `…` `•` …) | 直接写原生 Unicode 字符(`—` `–` `©` `®` `→` NBSP …) |+| 文本/属性值中裸写 `& < > " '` | 必须写成 XML 实体 `&` `<` `>` `"` `'` || `<style>` / `class` | 内联属性(`id` 在 `<defs>` 内合法) || `<foreignObject>` | `<text>` + `<tspan>` || `mask` | 叠加遮罩矩形 / gradient overlay |@@ -420,6 +422,7 @@ font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Micr- [ ] 主要元素有语义化 `<g id="...">`- [ ] 无 `<style>`、`class`、`<foreignObject>`、`mask`、`rgba()`- [ ] `<g>` 标签无 `opacity` 属性+- [ ] 文本字符为原生 Unicode(`—` `©` `→` NBSP 等),无 HTML 命名实体(` ` `—` `©` 等);裸 `& < >` 已转义为 `& < >`### 阴影- [ ] 使用 `feFlood` 方案(非 `feComponentTransfer`)diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.mdindex 5e9b6671..e3362b13 100644--- a/skills/ppt-master/templates/design_spec_reference.md+++ b/skills/ppt-master/templates/design_spec_reference.md@@ -300,6 +300,7 @@ Generate corresponding speaker note files for each page, saved to the `notes/` d4. Transparency uses `fill-opacity` / `stroke-opacity`; `rgba()` FORBIDDEN5. FORBIDDEN: `mask`, `<style>`, `class`, `foreignObject`6. FORBIDDEN: `textPath`, `animate*`, `script`+7. Text characters: write typography & symbols as raw Unicode (em dash `—`, en dash `–`, `©`, `®`, `→`, NBSP, etc.); HTML named entities (` `, `—`, `©`, `®` …) are FORBIDDEN. XML reserved chars in text MUST be escaped as `&` `<` `>` `"` `'` (e.g. `R&D`, `error < 5%`). See shared-standards.md §1.07. `marker-start` / `marker-end` conditionally allowed: `<marker>` must be in `<defs>`, `orient="auto"`, shape must be triangle / diamond / circle (see shared-standards.md §1.1)8. `clipPath` conditionally allowed **only on `<image>` elements**: `<clipPath>` in `<defs>`, single shape child (circle / ellipse / rect with rx,ry / path / polygon). Do NOT apply to shapes / groups / text — draw the target geometry directly with the matching native element (`<circle>` / `<ellipse>` / `<rect rx>` / `<polygon>` / `<path>`). See shared-standards.md §1.2diff --git a/skills/ppt-master/templates/layouts/README.md b/skills/ppt-master/templates/layouts/README.mdindex 1b0ad98f..d7b4b7ea 100644--- a/skills/ppt-master/templates/layouts/README.md+++ b/skills/ppt-master/templates/layouts/README.md@@ -245,6 +245,8 @@ cp templates/layouts/government_red/* projects/<project>/templates/| Banned Element | Alternative ||----------------|-------------|+| HTML named entities in text (` ` `—` `©` `–` `®` …) | Write the raw Unicode character directly (`—` `–` `©` `®` `→` NBSP …); see shared-standards.md §1.0 |+| Bare `&` `<` `>` `"` `'` in text or attribute values | Escape as XML entities `&` `<` `>` `"` `'` (e.g. `R&D`, `error < 5%`) || `<foreignObject>` | Use `<text>` + `<tspan>` || `clipPath` on shapes / groups / text | Draw the target geometry directly with the matching native element (`<circle>` / `<ellipse>` / `<rect rx>` / `<polygon>` / `<path>`). `clipPath` on `<image>` elements is conditionally allowed — see shared-standards.md §1.2 || `mask` | Use `fill-opacity` |diff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.mdindex f85bd65c..0b1eeaf4 100644--- a/skills/ppt-master/templates/spec_lock_reference.md+++ b/skills/ppt-master/templates/spec_lock_reference.md@@ -86,3 +86,4 @@- rgba()- `<style>`, `class`, `<foreignObject>`, `textPath`, `@font-face`, `<animate*>`, `<script>`, `<iframe>`, `<symbol>`+`<use>`- `<g opacity>` (set opacity on each child element individually)+- HTML named entities in text (` `, `—`, `©`, `–`, `®`, `…`, `•` …) — write as raw Unicode (`—`, `©`, `→`, NBSP, etc.); XML reserved chars `& < > " '` must be escaped as `& < > " '`. See shared-standards.md §1.0