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: describe new exports/ + backup/<ts>/ output layout

hugohe3f3c4e9c404da
diff --git a/README.md b/README.md
index 76fc8839..f0379be7 100644
--- a/README.md
+++ b/README.md
@@ -203,7 +203,7 @@ AI: Sure. Let's confirm the design spec:
The AI handles everything — content analysis, visual design, SVG generation, and PPTX export.
-> **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+.
+> **Output:** Main native-shapes `.pptx` (directly editable) saved to `exports/<name>_<timestamp>.pptx`. The SVG snapshot `_svg.pptx` and a copy of `svg_output/` are archived to `backup/<timestamp>/` for visual reference and pptx rebuild without re-running the LLM. 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 e07857a2..91ecad9c 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -207,7 +207,7 @@ AI:好的,先确认设计规范:
AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。
-> **输出说明:** 两个带时间戳的文件保存至 `exports/` — 原生形状版 `.pptx`(可直接编辑)和 `_svg.pptx` 快照版(视觉参考备份)。需要 Office 2016+。
+> **输出说明:** 原生形状版主 `.pptx`(可直接编辑)保存至 `exports/<name>_<timestamp>.pptx`;SVG 快照版 `_svg.pptx` 与 `svg_output/` 副本归档至 `backup/<timestamp>/`,便于回溯视觉参考或免去 LLM 重跑直接重建 pptx。需要 Office 2016+。
> **AI 迷失上下文?** 让它先读 `skills/ppt-master/SKILL.md`。
diff --git a/docs/faq.md b/docs/faq.md
index a9b7c4b1..ed4d5e62 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -32,7 +32,7 @@ Yes. PPT Master includes a built-in image generation script that supports multip
## Q: Can I edit the generated presentations?
-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.
+Yes. The main `.pptx` (native PowerPoint shapes — all text, graphics, and colors directly editable without any conversion) is saved to `exports/` with a timestamp. The SVG snapshot `_svg.pptx` plus a copy of `svg_output/` (the Executor's raw SVG source) are archived to `backup/<timestamp>/`, so you can revisit the visual reference or rebuild the pptx via `finalize_svg → svg_to_pptx` without re-running the LLM. `backup/<timestamp>/` directories can be deleted manually when no longer needed. 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 b9fc108d..6b881f6d 100644
--- a/docs/technical-design.md
+++ b/docs/technical-design.md
@@ -38,9 +38,12 @@ User Input (PDF/DOCX/XLSX/URL/Markdown)
↓
[Post-processing] → total_md_split.py (split notes) → finalize_svg.py → svg_to_pptx.py
↓
-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
+Output:
+ exports/
+ └── presentation_<timestamp>.pptx ← Native shapes (DrawingML) — recommended for editing & delivery
+ backup/<timestamp>/
+ ├── presentation_svg.pptx ← SVG snapshot — pixel-perfect visual reference backup
+ └── svg_output/ ← Archived Executor SVG source (rerun finalize_svg → svg_to_pptx to rebuild)
```
---
diff --git a/docs/zh/faq.md b/docs/zh/faq.md
index 6a06b50a..e637782b 100644
--- a/docs/zh/faq.md
+++ b/docs/zh/faq.md
@@ -32,7 +32,7 @@ PPT Master 可以在任何能读取文件和执行命令的 AI 编程代理中
## Q: 生成的 PPT 可以编辑吗?
-可以!两个文件均以时间戳命名保存至 `exports/`。原生版 `.pptx` 包含**原生 PowerPoint 形状**,所有文字、图形、颜色均可直接编辑,无需任何转换。`_svg.pptx` 为 SVG 快照版,作为视觉参考备份保留。需要 **Office 2016** 或更高版本。
+可以。主 `.pptx`(原生 PowerPoint 形状,文字、图形、颜色均可直接编辑,无需转换)以时间戳命名保存至 `exports/`。SVG 快照版 `_svg.pptx` 与 Executor 原始 SVG 源(`svg_output/` 副本)一同归档至 `backup/<timestamp>/`,便于回溯视觉参考或基于该版重跑 `finalize_svg → svg_to_pptx` 重建 pptx,无需再走 LLM。`backup/<timestamp>/` 目录可手动清理。需要 **Office 2016** 或更高版本。
## Q: 三种执行师有什么区别?
diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.md
index 06be3a15..696b9550 100644
--- a/docs/zh/technical-design.md
+++ b/docs/zh/technical-design.md
@@ -38,9 +38,12 @@
↓
[后处理] → total_md_split.py(拆分讲稿)→ finalize_svg.py → svg_to_pptx.py
↓
-输出: 两个带时间戳的文件保存至 exports/:
- ├── presentation_<timestamp>.pptx ← 原生形状版(DrawingML)— 推荐用于编辑与交付
- └── presentation_<timestamp>_svg.pptx ← SVG 快照版 — 像素级视觉参考备份
+输出:
+ exports/
+ └── presentation_<timestamp>.pptx ← 原生形状版(DrawingML)— 推荐用于编辑与交付
+ backup/<timestamp>/
+ ├── presentation_svg.pptx ← SVG 快照版 — 像素级视觉参考备份
+ └── svg_output/ ← Executor 原始 SVG 备份(重跑 finalize_svg → svg_to_pptx 即可重建 pptx)
```
---
diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.md
index d610ae83..d5e07b82 100644
--- a/skills/ppt-master/SKILL.md
+++ b/skills/ppt-master/SKILL.md
@@ -299,7 +299,10 @@ 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
-# Output: exports/<project_name>_<timestamp>.pptx + exports/<project_name>_<timestamp>_svg.pptx
+# Output:
+# exports/<project_name>_<timestamp>.pptx ← main native pptx
+# backup/<timestamp>/<project_name>_svg.pptx ← SVG snapshot
+# backup/<timestamp>/svg_output/ ← Executor SVG source backup
```
> ❌ **NEVER** substitute `cp` for `finalize_svg.py` — finalize performs multiple critical processing steps
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 15666130..91cf7736 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -315,5 +315,8 @@ python3 scripts/finalize_svg.py <project_path>
# 3. Export PPTX
python3 scripts/svg_to_pptx.py <project_path> -s final
-# Output: exports/<project_name>_<timestamp>.pptx + exports/<project_name>_<timestamp>_svg.pptx
+# Output:
+# exports/<project_name>_<timestamp>.pptx ← main native pptx
+# backup/<timestamp>/<project_name>_svg.pptx ← SVG snapshot
+# backup/<timestamp>/svg_output/ ← Executor SVG source backup
```
diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.md
index 710d0527..094abf11 100644
--- a/skills/ppt-master/references/shared-standards.md
+++ b/skills/ppt-master/references/shared-standards.md
@@ -291,7 +291,10 @@ 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
-# Output: exports/<project_name>_<timestamp>.pptx + exports/<project_name>_<timestamp>_svg.pptx
+# Output:
+# exports/<project_name>_<timestamp>.pptx ← main native pptx
+# backup/<timestamp>/<project_name>_svg.pptx ← SVG snapshot
+# backup/<timestamp>/svg_output/ ← Executor SVG source backup
```
**Prohibited**:
diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.md
index 71f3c7d4..1b0bc546 100644
--- a/skills/ppt-master/scripts/docs/svg-pipeline.md
+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md
@@ -38,7 +38,11 @@ python3 scripts/svg_to_pptx.py <project_path> -s final --auto-advance 3
```
Behavior:
-- Default output: timestamped pair in `exports/` — `<project_name>_<timestamp>.pptx` (native editable) + `<project_name>_<timestamp>_svg.pptx` (SVG snapshot)
+- Default output:
+ - `exports/<project_name>_<timestamp>.pptx` — main native editable pptx
+ - `backup/<timestamp>/<project_name>_svg.pptx` — SVG snapshot for visual reference
+ - `backup/<timestamp>/svg_output/` — copy of Executor SVG source, so the pptx can be rebuilt via `finalize_svg → svg_to_pptx` without re-running the LLM
+- Explicit `-o/--output` keeps the legacy side-by-side `_svg.pptx` next to the chosen path and skips `backup/`
- Recommended source directory: `svg_final/`
- Speaker notes are embedded automatically unless `--no-notes` is used
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 c1e52744..ec45f22b 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py
@@ -26,7 +26,7 @@ def main() -> None:
formatter_class=argparse.RawDescriptionHelpFormatter,
epilog=f'''
Examples:
- %(prog)s examples/ppt169_demo -s final # Default: timestamped pair saved to exports/
+ %(prog)s examples/ppt169_demo -s final # Default: main pptx -> exports/, SVG snapshot + svg_output -> backup/<ts>/
%(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)