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(technical-design): fix template flow and add missing quality check steps

hugohe37ff76e6099ef
diff --git a/docs/technical-design.md b/docs/technical-design.md
index ec04ac70..b9fc108d 100644
--- a/docs/technical-design.md
+++ b/docs/technical-design.md
@@ -21,17 +21,20 @@ User Input (PDF/DOCX/XLSX/URL/Markdown)
↓
[Create Project] → project_manager.py init <project_name> --format <format>
↓
-[Template Option] A) Use existing template B) Free design
+[Template (optional)] — default: skip, proceed with free design
+ User names a template: copy template files into the project
+ Need a new global template: use /create-template workflow separately
↓
-[Need New Template?] → Use /create-template workflow separately
+[Strategist] - Eight Confirmations & Design Specifications → design_spec.md + spec_lock.md
↓
-[Strategist] - Eight Confirmations & Design Specifications
+[Image_Generator] (When AI image generation is selected)
↓
-[Image_Generator] (When AI generation is selected)
+[Executor]
+ ├── Visual construction: generate all SVG pages → svg_output/
+ ├── [Quality Check] svg_quality_checker.py (mandatory — must pass with 0 errors)
+ └── Notes generation: complete speaker notes → notes/total.md
↓
-[Executor] - Two-Phase Generation
- ├── Visual Construction Phase: Generate all SVG pages → svg_output/
- └── Logic Construction Phase: Generate complete speaker notes → notes/total.md
+[Chart calibration (optional)] → verify-charts workflow (for decks containing data charts)
↓
[Post-processing] → total_md_split.py (split notes) → finalize_svg.py → svg_to_pptx.py
↓
diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.md
index 82cfa53f..06be3a15 100644
--- a/docs/zh/technical-design.md
+++ b/docs/zh/technical-design.md
@@ -21,17 +21,20 @@
↓
[创建项目] → project_manager.py init <项目名> --format <格式>
↓
-[模板选项] A) 使用已有模板 B) 自由设计
+[模板处理(可选)] — 默认跳过,直接自由设计
+ 用户主动点名模板时:复制模板文件到项目目录
+ 需要新建全局模板:使用 /create-template 工作流单独完成
↓
-[需要新模板?] → 使用 /create-template 工作流单独创建
+[Strategist] 策略师 - 八项确认与设计规范 → design_spec.md + spec_lock.md
↓
-[Strategist] 策略师 - 八项确认与设计规范
+[Image_Generator] 图片生成师(当选择 AI 生图时)
↓
-[Image_Generator] 图片生成师(当选择 AI 生成时)
+[Executor] 执行师
+ ├── 视觉构建:连续生成所有 SVG 页面 → svg_output/
+ ├── [Quality Check] svg_quality_checker.py(强制通过,0 错误)
+ └── 讲稿生成:完整讲稿 → notes/total.md
↓
-[Executor] 执行师 - 分阶段生成
- ├── 视觉构建阶段:连续生成所有 SVG 页面 → svg_output/
- └── 逻辑构建阶段:生成完整讲稿 → notes/total.md
+[图表校准(可选)] → verify-charts 工作流(含数据图表的幻灯片在此步骤校准坐标)
↓
[后处理] → total_md_split.py(拆分讲稿)→ finalize_svg.py → svg_to_pptx.py
↓