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
feat(export): redirect PPTX output to exports/ subdirectory
hugohe3dc41b146bf40
diff --git a/AGENTS.md b/AGENTS.mdindex a2258008..8d6435bf 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -51,7 +51,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 commandpython3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final-# Default: generates native shapes (.pptx) + SVG reference (_svg.pptx)+# Output: exports/<project_name>_<timestamp>.pptx + exports/<project_name>_<timestamp>_svg.pptx# Use --only native or --only legacy to generate just one version```diff --git a/CLAUDE.md b/CLAUDE.mdindex 121d29ce..0dff723b 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -35,7 +35,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 commandpython3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final-# Default: generates two files — native shapes (.pptx) + SVG reference (_svg.pptx)+# Output: exports/<project_name>_<timestamp>.pptx + exports/<project_name>_<timestamp>_svg.pptx# Use --only native to skip SVG reference version# Use --only legacy to only generate SVG image version```diff --git a/README.md b/README.mdindex 6a4da0b2..10a6966e 100644--- a/README.md+++ b/README.md@@ -89,7 +89,7 @@ AI: Sure. Let's confirm the design spec:The AI handles everything — content analysis, visual design, SVG generation, and PPTX export.-> **Output:** The `.pptx` file contains native shapes — directly editable. A second `_svg.pptx` reference file is also generated (use "Convert to Shape" in PowerPoint to edit). Requires Office 2016+.+> **Output:** Two timestamped files are saved to `exports/` — a native-shapes `.pptx` (directly editable) and an `_svg.pptx` snapshot for visual reference. Requires Office 2016+.> **AI lost context?** Ask it to read `skills/ppt-master/SKILL.md`.diff --git a/README_CN.md b/README_CN.mdindex 6cc01738..e58749e6 100644--- a/README_CN.md+++ b/README_CN.md@@ -89,7 +89,7 @@ AI:好的,先确认设计规范:AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。-> **输出说明:** `.pptx` 文件包含原生形状,可直接编辑。同时生成 `_svg.pptx` 参考版(在 PowerPoint 中使用"转换为形状"编辑)。需要 Office 2016+。+> **输出说明:** 两个带时间戳的文件保存至 `exports/` — 原生形状版 `.pptx`(可直接编辑)和 `_svg.pptx` 快照版(视觉参考备份)。需要 Office 2016+。> **AI 迷失上下文?** 让它先读 `skills/ppt-master/SKILL.md`。diff --git a/docs/faq.md b/docs/faq.mdindex d2c0e183..fe65cc5f 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -6,7 +6,7 @@## Q: Can I edit the generated presentations?-Yes! The default export (`.pptx`) produces **native PowerPoint shapes** — all text, graphics, and colors are directly editable in PowerPoint without any conversion. An SVG reference version (`_svg.pptx`) is also generated; for that file, select the content and use **"Convert to Shape"** to unlock editing. Requires **Office 2016** or later.+Yes! Both files are saved to `exports/` with a timestamp. The native `.pptx` produces **native PowerPoint shapes** — all text, graphics, and colors are directly editable without any conversion. The `_svg.pptx` is an SVG snapshot kept as a visual reference backup. Requires **Office 2016** or later.## Q: What's the difference between the three Executors?diff --git a/docs/technical-design.md b/docs/technical-design.mdindex f3cd3781..62cd3e77 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -35,10 +35,9 @@ User Input (PDF/DOCX/URL/Markdown)↓[Post-processing] → total_md_split.py (split notes) → finalize_svg.py → svg_to_pptx.py↓-Output: Two files are generated automatically:- ├── presentation.pptx ← Native shapes (DrawingML) — recommended for editing & delivery- └── presentation_svg.pptx ← SVG reference version — pixel-perfect visual reference; use- "Convert to Shape" in PowerPoint to unlock individual elements+Output: Two timestamped files saved to exports/:+ ├── presentation_<timestamp>.pptx ← Native shapes (DrawingML) — recommended for editing & delivery+ └── presentation_<timestamp>_svg.pptx ← SVG snapshot — pixel-perfect visual reference backup```---diff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex ef2ff67a..3e812aa8 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -6,7 +6,7 @@## Q: 生成的 PPT 可以编辑吗?-可以!默认导出的 PPTX(`.pptx`)包含**原生 PowerPoint 形状**,所有文字、图形、颜色均可在 PowerPoint 中直接编辑,无需任何转换操作。同时还会生成一份 SVG 参考版(`_svg.pptx`),该版本需选中内容后右键 **"转换为形状"** (Convert to Shape) 方可编辑。需要 **Office 2016** 或更高版本。+可以!两个文件均以时间戳命名保存至 `exports/`。原生版 `.pptx` 包含**原生 PowerPoint 形状**,所有文字、图形、颜色均可直接编辑,无需任何转换。`_svg.pptx` 为 SVG 快照版,作为视觉参考备份保留。需要 **Office 2016** 或更高版本。## Q: 三种执行师有什么区别?diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.mdindex fbb7ee53..486ea3ab 100644--- a/docs/zh/technical-design.md+++ b/docs/zh/technical-design.md@@ -35,10 +35,9 @@↓[后处理] → total_md_split.py(拆分讲稿)→ finalize_svg.py → svg_to_pptx.py↓-输出: 自动生成两个文件:- ├── presentation.pptx ← 原生形状版(DrawingML)— 推荐用于编辑与交付- └── presentation_svg.pptx ← SVG 参考版 — 像素级视觉参考;在 PowerPoint 中选中内容- 后使用"转换为形状"可解锁单独元素的编辑+输出: 两个带时间戳的文件保存至 exports/:+ ├── presentation_<timestamp>.pptx ← 原生形状版(DrawingML)— 推荐用于编辑与交付+ └── presentation_<timestamp>_svg.pptx ← SVG 快照版 — 像素级视觉参考备份```---diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex 3a8ae8e0..ad499530 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -278,7 +278,7 @@ python3 ${SKILL_DIR}/scripts/finalize_svg.py <project_path>**Step 7.3** — Export PPTX (embeds speaker notes by default):```bashpython3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> -s final-# Default: generates two files — native shapes (.pptx) + SVG reference (_svg.pptx)+# Output: exports/<project_name>_<timestamp>.pptx + exports/<project_name>_<timestamp>_svg.pptx# Use --only native to skip SVG reference version# Use --only legacy to only generate SVG image version```diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex ef560908..ffaa0a6a 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -247,5 +247,5 @@ python3 scripts/finalize_svg.py <project_path># 3. Export PPTXpython3 scripts/svg_to_pptx.py <project_path> -s final-# Default: generates native shapes (.pptx) + SVG reference (_svg.pptx)+# Output: exports/<project_name>_<timestamp>.pptx + exports/<project_name>_<timestamp>_svg.pptx```diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.mdindex 144049c6..8a19cb23 100644--- a/skills/ppt-master/references/shared-standards.md+++ b/skills/ppt-master/references/shared-standards.md@@ -225,7 +225,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-# Default: generates native shapes (.pptx) + SVG reference (_svg.pptx)+# Output: exports/<project_name>_<timestamp>.pptx + exports/<project_name>_<timestamp>_svg.pptx```**Prohibited**:diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex 0fdb867e..41e1118c 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -38,7 +38,7 @@ python3 scripts/svg_to_pptx.py <project_path> -s final --auto-advance 3```Behavior:-- Default output: native editable PPTX + SVG reference PPTX+- Default output: timestamped pair in `exports/` — `<project_name>_<timestamp>.pptx` (native editable) + `<project_name>_<timestamp>_svg.pptx` (SVG snapshot)- Recommended source directory: `svg_final/`- Speaker notes are embedded automatically unless `--no-notes` is useddiff --git a/skills/ppt-master/scripts/project_manager.py b/skills/ppt-master/scripts/project_manager.pyindex 3edb8f14..32d8b0a8 100644--- a/skills/ppt-master/scripts/project_manager.py+++ b/skills/ppt-master/scripts/project_manager.py@@ -128,6 +128,7 @@ class ProjectManager:"notes","templates",SOURCE_DIRNAME,+ "exports",):(project_path / rel_path).mkdir(parents=True, exist_ok=True)@@ -145,6 +146,7 @@ class ProjectManager:"- `notes/`: speaker notes\n""- `templates/`: project templates\n""- `sources/`: source materials and normalized markdown\n"+ "- `exports/`: generated PPTX files (timestamped history)\n"),encoding="utf-8",)diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.pyindex 41bb9aa0..41019b04 100644--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py@@ -25,7 +25,7 @@ def main() -> None:formatter_class=argparse.RawDescriptionHelpFormatter,epilog=f'''Examples:- %(prog)s examples/ppt169_demo -s final # Default: native + SVG reference (two files)+ %(prog)s examples/ppt169_demo -s final # Default: timestamped pair saved to exports/%(prog)s examples/ppt169_demo --only native # Only native shapes version%(prog)s examples/ppt169_demo --only legacy # Only SVG image version%(prog)s examples/ppt169_demo -o out.pptx # Explicit path (SVG ref -> out_svg.pptx)@@ -128,8 +128,10 @@ Speaker notes (enabled by default):stem = output_base.stemlegacy_path = output_base.parent / f"{stem}_svg{output_base.suffix}"else:- native_path = project_path / f"{project_name}_{timestamp}.pptx"- legacy_path = project_path / f"{project_name}_{timestamp}_svg.pptx"+ exports_dir = project_path / "exports"+ exports_dir.mkdir(parents=True, exist_ok=True)+ native_path = exports_dir / f"{project_name}_{timestamp}.pptx"+ legacy_path = exports_dir / f"{project_name}_{timestamp}_svg.pptx"native_path.parent.mkdir(parents=True, exist_ok=True)