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.mdindex 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.mdindex 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.mdindex 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.mdindex 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.mdindex 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.mdindex 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.mdindex 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):```bashpython3 ${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 stepsdiff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 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 PPTXpython3 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.mdindex 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.mdindex 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 useddiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.pyindex 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)