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

feat(export): redirect PPTX output to exports/ subdirectory

hugohe3dc41b146bf40
diff --git a/AGENTS.md b/AGENTS.md
index 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 command
python3 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.md
index 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 command
python3 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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):
```bash
python3 ${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.md
index 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 PPTX
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
```
diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.md
index 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.md
index 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 used
diff --git a/skills/ppt-master/scripts/project_manager.py b/skills/ppt-master/scripts/project_manager.py
index 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.py
index 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.stem
legacy_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)