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: mention --native flag as fallback in export commands

hugohe359a1cdce7425
diff --git a/AGENTS.md b/AGENTS.md
index 752fa7f5..7cc944c3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -41,6 +41,7 @@ python3 skills/ppt-master/scripts/total_md_split.py <project_path>
python3 skills/ppt-master/scripts/finalize_svg.py <project_path>
# ✅ Confirm no errors before running the next command
python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final
+# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
```
## Core Directories
diff --git a/CLAUDE.md b/CLAUDE.md
index 94f1387b..748b0a7a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -34,6 +34,8 @@ python3 skills/ppt-master/scripts/total_md_split.py <project_path>
python3 skills/ppt-master/scripts/finalize_svg.py <project_path>
# ✅ Confirm no errors before running the next command
python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final
+# Note: add --native to get pre-converted editable shapes if PowerPoint is unavailable
+# for manual "Convert to Shape". Less stable than PPT-native conversion; use as fallback only.
```
## Architecture
diff --git a/README.md b/README.md
index e6063cee..fcd99881 100644
--- a/README.md
+++ b/README.md
@@ -211,6 +211,7 @@ python3 skills/ppt-master/scripts/pdf_to_md.py <PDF_file>
python3 skills/ppt-master/scripts/total_md_split.py <project_path>
python3 skills/ppt-master/scripts/finalize_svg.py <project_path>
python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final
+# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
```
> 📖 For complete tool documentation, see [Tools Usage Guide](./skills/ppt-master/scripts/README.md)
diff --git a/README_CN.md b/README_CN.md
index c56acee4..1860507c 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -207,6 +207,7 @@ python3 skills/ppt-master/scripts/pdf_to_md.py <PDF文件>
python3 skills/ppt-master/scripts/total_md_split.py <项目路径>
python3 skills/ppt-master/scripts/finalize_svg.py <项目路径>
python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final
+# 备选:无 PowerPoint 时可加 --native 跳过手动"转换为形状",但稳定性不及 PPT 原生转换
```
diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.md
index 2f2597e1..871e258a 100644
--- a/skills/ppt-master/SKILL.md
+++ b/skills/ppt-master/SKILL.md
@@ -260,6 +260,7 @@ python3 ${SKILL_DIR}/scripts/finalize_svg.py <project_path>
**Step 7.3** — Export PPTX (embeds speaker notes by default):
```bash
python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> -s final
+# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
```
> ❌ **NEVER** use `cp` as a substitute for `finalize_svg.py` — it performs multiple critical processing steps
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index a753f94e..48bbeb0b 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -176,4 +176,5 @@ python3 scripts/finalize_svg.py <project_path>
# 3. Export PPTX
python3 scripts/svg_to_pptx.py <project_path> -s final
+# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
```
diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.md
index 3f22b8b3..eaa28971 100644
--- a/skills/ppt-master/references/shared-standards.md
+++ b/skills/ppt-master/references/shared-standards.md
@@ -93,6 +93,7 @@ python3 scripts/finalize_svg.py <project_path>
# 3. Export PPTX (from svg_final/, embeds speaker notes by default)
python3 scripts/svg_to_pptx.py <project_path> -s final
+# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
```
**Prohibited**:
diff --git a/skills/ppt-master/scripts/README.md b/skills/ppt-master/scripts/README.md
index 906c5cb6..a6f2febf 100644
--- a/skills/ppt-master/scripts/README.md
+++ b/skills/ppt-master/scripts/README.md
@@ -569,6 +569,9 @@ python3 scripts/svg_to_pptx.py <project_path> -t fade --transition-duration 1.0
# Silent mode
python3 scripts/svg_to_pptx.py <project_path> -s final -q
+
+# Native shapes (fallback when PowerPoint is unavailable for manual "Convert to Shape")
+python3 scripts/svg_to_pptx.py <project_path> -s final --native
```
**Speaker Notes**: