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(svg-export): clarify quality-gated re-export recovery

hugohe39b72ef4e8658
diff --git a/docs/animations.md b/docs/animations.md
index 850a45fa..16d8f3bb 100644
--- a/docs/animations.md
+++ b/docs/animations.md
@@ -18,7 +18,10 @@ sidecar schema, anchor rules, and package validation live in the
| Page transition | `fade`, 0.4 seconds | Slides change with a restrained visual transition |
| Element object animation | **`none` (off)** | Each slide appears as a complete page; opt in only when motion helps the presentation |
-Changing animation settings does not require regenerating the slides. Rerun `svg_to_pptx.py` against the same `svg_output/`.
+Changing animation settings does not require regenerating the slides. Reuse the
+same `svg_output/`; default release export still requires its current passing
+final SVG quality report. When no current matching passing final report exists,
+run the final checker and resolve its blockers before rerunning `svg_to_pptx.py`.
## Common Recipes
diff --git a/docs/zh/animations.md b/docs/zh/animations.md
index ca266584..9f3d7ca6 100644
--- a/docs/zh/animations.md
+++ b/docs/zh/animations.md
@@ -16,7 +16,9 @@ OOXML,而不是嵌入视频。对象动画包括进入、强调、动作路径
| 页间转场 | `fade`,0.4 秒 | 页面之间使用克制的视觉过渡 |
| 元素对象动画 | **`none`(关闭)** | 每页一次性完整出现;只有当动效确实有助于表达时才开启 |
-修改动画设置不需要重新生成页面,只需对同一份 `svg_output/` 重跑 `svg_to_pptx.py`。
+修改动画设置不需要重新生成页面,可以继续使用同一份 `svg_output/`。默认发布导出仍要求
+当前匹配且通过的最终 SVG 质量报告;不存在这样的报告时,先运行最终检查并解决其中的
+阻塞问题,再重跑 `svg_to_pptx.py`。
## 常用操作
diff --git a/skills/ppt-master/workflows/governance/failure-recovery.md b/skills/ppt-master/workflows/governance/failure-recovery.md
index fe4dd9ab..87bff556 100644
--- a/skills/ppt-master/workflows/governance/failure-recovery.md
+++ b/skills/ppt-master/workflows/governance/failure-recovery.md
@@ -39,7 +39,7 @@ Global stop/continue rules for all four top-level routes, plus concrete failure
| Step 7 image readiness missing manual files | Yes | None for manual assets; list required filenames and prompts | Yes | Step 7 image readiness gate |
| `total_md_split.py` failure while speaker notes are enabled | Yes | Fix notes format/path, rerun only Step 7.1 | Usually no | Step 7.1 |
| `finalize_svg.py` failure | Yes | Fix SVG/assets, rerun Step 7.2 | Only if source asset is missing | Step 7.2 |
-| `svg_to_pptx.py` failure | Yes | Fix conversion issue, rerun Step 7.3 | Only if required artifact is missing | Step 7.3 |
+| `svg_to_pptx.py` failure | Yes | If no current matching passing final SVG quality report exists, obtain the complete blocking issue set from the final checker as needed, fix it, rerun the checker against the updated `svg_output/`, and proceed to Step 7.3 only after it reports `passed`; otherwise fix the conversion issue and rerun Step 7.3 | Only if a required artifact is missing | Step 6 final quality gate or Step 7.3 |
| Export succeeds but user wants direct browser edits re-exported | No | Rerun Step 7.2 and Step 7.3 after applied edits | No | Post-export live-preview handling |
---