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

fix comment

shandianchengzic74c76d5e154
diff --git a/AGENTS.md b/AGENTS.md
index 7c89c92f..fb6e07f8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -417,6 +417,9 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
# 导出 PPTX 但不嵌入备注
python3 tools/svg_to_pptx.py <项目路径> -s final --no-notes
+
+# ⭐ 拆分讲稿文件(将 total.md 拆分为多个讲稿文件)
+python3 tools/total_md_split.py <项目路径>
```
### 项目目录结构
diff --git a/README.md b/README.md
index 54bb5e36..af67f9fb 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,7 @@
在编辑器中打开 AI 聊天面板(Antigravity/Cursor/Copilot Chat)
3️⃣ 开始对话
- 告诉 AI AGENTS.md 的地址,并直接告诉 AI 你想创建什么内容,AI 会自动按照仓库中的角色定义工作
+ 直接告诉 AI 你想创建什么内容(若 AI 迷失上下文,可提示其参考 AGENTS.md),AI 会自动按照仓库中的角色定义工作
```
### 使用示例
@@ -975,6 +975,87 @@ python3 tools/svg_to_pptx.py <项目路径> -s final -o output.pptx
**特点**:SVG 以原生矢量格式嵌入,保持可编辑性,需要 PowerPoint 2016+ 查看。
+### 讲稿拆分工具 (`total_md_split.py`)
+
+将 `total.md` 讲稿文件拆分为多个独立的讲稿文件,每个文件对应一个 SVG 页面。
+
+**功能**:
+
+- 读取 `total.md` 文件,解析其中的一级标题和讲稿内容
+- 检查 `svg_output` 文件夹中的 SVG 文件是否都有对应的讲稿
+- 如果存在 SVG 没有对应的讲稿,会输出错误提示要求重新生成讲稿文件
+- 如果全部匹配,根据名称对文档进行拆分,分成多个文档
+- 拆分后的文档命名与 SVG 文件同名,后缀改为 `.md`
+- 拆分后的文档**不包含**一级标题
+
+**用法**:
+
+```bash
+# 基本用法
+python3 tools/total_md_split.py <项目路径>
+
+# 指定输出目录
+python3 tools/total_md_split.py <项目路径> -o <输出目录>
+
+# 静默模式
+python3 tools/total_md_split.py <项目路径> -q
+```
+
+**示例**:
+
+```bash
+# 基本用法
+python3 tools/total_md_split.py projects/<svg 标题>_ppt169_YYYYMMDD
+
+# 指定输出目录
+python3 tools/total_md_split.py projects/<svg 标题>_ppt169_YYYYMMDD -o notes
+
+# 静默模式
+python3 tools/total_md_split.py projects/<svg 标题>_ppt169_YYYYMMDD -q
+```
+
+**讲稿格式要求**:
+
+`total.md` 文件需要使用以下格式:
+
+```markdown
+# 01_<页面标题>
+
+讲稿内容...
+
+---
+
+# 02_<页面标题>
+
+讲稿内容...
+
+---
+
+# 03_<页面名称>
+
+讲稿内容...
+```
+
+- 每个章节以 `# ` 开头的一级标题开始
+- 章节之间用 `---` 分隔
+- 讲稿内容在标题之后,直到下一个标题或文件结束
+
+**错误处理**:
+
+如果存在 SVG 文件没有对应的讲稿,工具会输出错误信息:
+
+```
+错误: SVG 文件与讲稿不匹配
+ 缺失的讲稿: <N>_<页面标题>
+
+请重新生成讲稿文件,确保每个 SVG 都有对应的讲稿。
+```
+
+**依赖**:
+
+- Python 3.6+
+- 无外部依赖(仅使用标准库)
+
### 错误消息助手 (`error_helper.py`)
提供友好的错误消息和具体的修复建议:
diff --git a/README_EN.md b/README_EN.md
index 945fe209..8e8dff78 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -38,7 +38,7 @@ An AI-powered intelligent visual content generation system that transforms sourc
Open AI chat panel in your editor (Antigravity/Cursor/Copilot Chat)
3️⃣ Start Conversation
- Tell the AI the address of AGENTS.md, and tell the AI what content you want to create, it will automatically follow the role definitions in the repository
+ Tell the AI what content you want to create (if the AI loses context, you can suggest referring to AGENTS.md), it will automatically follow the role definitions in the repository
```
### Usage Example
diff --git a/roles/Executor_Consultant.md b/roles/Executor_Consultant.md
index 80e22dcd..6e911f90 100644
--- a/roles/Executor_Consultant.md
+++ b/roles/Executor_Consultant.md
@@ -221,26 +221,78 @@
## 演讲备注生成
-在**所有 SVG 页面生成完成并定稿后**,生成完整的演讲备注文稿,格式如下:
+### 任务 1. 生成完整演讲备注文稿
+
+在**所有 SVG 页面生成完成并定稿后**,进入"逻辑构建阶段",生成完整的演讲备注文稿。
+
+**为什么不一页一页生成 Note?**
+- 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺
+
+完整的演讲备注文稿格式如下:
```markdown
-# 第1页
+# 01_<页面标题>
这是第一页的讲稿内容...
-开场白、引入主题...
+讲稿正文,2-5 句。重点突出结论和数据支撑。
+可使用标记:[停顿] 强调关键点,[数据] 提示口语化表达。
+
+要点:①核心结论/支撑数据/下一步建议 ②... ③...
+时长:X 分钟
---
-# 第2页
+# 02_<页面标题>
这是第二页的讲稿内容...
-主要论点、关键信息...
+[过渡] 基于刚才的分析,我们来看...
+
+讲稿正文,2-5 句。重点突出结论和数据支撑。
+可使用标记:[停顿] 强调关键点,[数据] 提示口语化表达。
+
+要点:①核心结论/支撑数据/下一步建议 ②... ③...
+时长:X 分钟
---
-# 第3页
+# 03_<页面标题>
...
```
-然后自动拆分,写入 `notes/` 目录下的演讲备注文件中。
+**控场标记**:
+| 标记 | 用途 |
+|------|------|
+| `[停顿]` | 关键结论后留白,让听众消化 |
+| `[数据]` | 提示口语化:85% → "超过八成" |
+| `[过渡]` | 段首单独成段,必须放在每页正文开头,用于承上启下 |
+
+**要求**:
+
+- 结论先行,逻辑清晰
+- 数据建议口语化(如 30% → "约三成")
+- 用户可在 `notes/` 目录手动编辑覆盖
+
+### 任务 2. 拆分写入各页备注文件
+
+接下来,将 `notes/total.md` 自动拆分,写入 `notes/` 目录下的演讲备注文件中。
+
+**文件命名规范**:
+
+- **推荐**:与 SVG 同名(如 `01_封面.svg` 对应 `notes/01_封面.md`)
+- **兼容**:也支持 `slide01.md` 格式(向后兼容)
+
+---
+
+**自动拆分说明**:
+
+使用工具自动拆分讲稿文件:
+
+```bash
+python3 tools/total_md_split.py <项目路径>
+```
+
+该工具会:
+- 验证 SVG 文件与讲稿是否一一对应
+- 将 `notes/total.md` 自动拆分成各页独立文件
+- 拆分后的文件命名与 SVG 同名,后缀为 `.md`
**导出说明**:
diff --git a/roles/Executor_Consultant_Top.md b/roles/Executor_Consultant_Top.md
index 9e5651b6..8f36170a 100644
--- a/roles/Executor_Consultant_Top.md
+++ b/roles/Executor_Consultant_Top.md
@@ -328,30 +328,92 @@
## 演讲备注生成
-在**所有 SVG 页面生成完成并定稿后**,生成完整的演讲备注文稿,格式如下:
+### 任务 1. 生成完整演讲备注文稿
+
+在**所有 SVG 页面生成完成并定稿后**,进入"逻辑构建阶段",生成完整的演讲备注文稿,在 `notes/total.md` 文件中。
+
+**为什么不一页一页生成 Note?**
+- 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺
+
+完整的演讲备注文稿格式如下:
```markdown
-# 第1页
+# 01_<页面标题>
这是第一页的讲稿内容...
-开场白、引入主题...
+讲稿正文,2-5 句。采用金字塔结构:结论 → 论据 → 细节。
+控场标记:[停顿] 关键洞察后留白,[环视] 观察决策者反应,
+[数据] 口语化表达,[对标] 引用对比基准。
+
+要点:①核心洞察/数据支撑/战略意义 ②... ③...
+时长:X 分钟
+备选:[时间紧张可略过的内容]
---
-# 第2页
+# 02_<页面标题>
这是第二页的讲稿内容...
-主要论点、关键信息...
+[过渡] 承接刚才的战略框架,我们深入分析...
+
+讲稿正文,2-5 句。采用金字塔结构:结论 → 论据 → 细节。
+控场标记:[停顿] 关键洞察后留白,[环视] 观察决策者反应,
+[数据] 口语化表达,[对标] 引用对比基准。
+
+要点:①核心洞察/数据支撑/战略意义 ②... ③...
+时长:X 分钟
+备选:[时间紧张可略过的内容]
---
-# 第3页
+# 03_<页面标题>
...
```
-然后自动拆分,写入 `notes/` 目录下的演讲备注文件中。
+**控场标记**:
+| 标记 | 用途 |
+|------|------|
+| `[停顿]` | 关键洞察后留白,让高管消化 |
+| `[环视]` | 观察决策者反应,判断是否展开 |
+| `[数据]` | 提示口语化:85% → "超过八成" |
+| `[对标]` | 强调对比基准:vs 行业均值/竞品 |
+| `[过渡]` | 段首单独成段,必须放在每页正文开头,用于承上启下 |
+
+**要求**:
+
+- 金字塔结构:结论先行,论据跟进
+- 数据必须情境化(有对比、有趋势)
+- 咨询风格突出洞察传达
+- 用户可在 `notes/` 目录手动编辑覆盖
+
+### 任务 2. 拆分写入各页备注文件
+
+接下来,将 `notes/total.md` 自动拆分,写入 `notes/` 目录下的演讲备注文件中。
+
+注意:拆分时不应包含 `# 页面标题` 行。
+
+**文件命名规范**:
+
+- **推荐**:与 SVG 同名(如 `01_封面.svg` 对应 `notes/01_封面.md`)
+- **兼容**:也支持 `slide01.md` 格式(向后兼容)
+
+---
+
+**自动拆分说明**:
+
+使用工具自动拆分讲稿文件:
+
+```bash
+python3 tools/total_md_split.py <项目路径>
+```
+
+该工具会:
+- 验证 SVG 文件与讲稿是否一一对应
+- 将 `notes/total.md` 自动拆分成各页独立文件
+- 拆分后的文件命名与 SVG 同名,后缀为 `.md`
**导出说明**:
- 后续运行 `svg_to_pptx.py` 时,备注会自动嵌入到对应页面的演讲者备注区域
+- 顶级咨询风格演示通常需要精准的讲稿支持,建议生成备注
- 如不需要备注,使用 `--no-notes` 参数
---
diff --git a/roles/Executor_General.md b/roles/Executor_General.md
index 218411ac..405c42cc 100644
--- a/roles/Executor_General.md
+++ b/roles/Executor_General.md
@@ -218,26 +218,78 @@
## 演讲备注生成
-在**所有 SVG 页面生成完成并定稿后**,生成完整的演讲备注文稿,格式如下:
+### 任务 1. 生成完整演讲备注文稿
+
+在**所有 SVG 页面生成完成并定稿后**,进入"逻辑构建阶段",生成完整的演讲备注文稿。
+
+**为什么不一页一页生成 Note?**
+- 批量写备注能像写剧本一样规划转场语(Transition),确保演讲逻辑通顺
+
+完整的演讲备注文稿格式如下:
```markdown
-# 第1页
+# 01_<页面标题>
这是第一页的讲稿内容...
-开场白、引入主题...
+讲稿正文,2-5 句自然语言。可使用标记:
+[停顿] 给观众思考时间,[互动] 提问或引导参与。
+
+要点:①要点一 ②要点二 ③要点三
+时长:X 分钟
---
-# 第2页
+# 02_<页面标题>
这是第二页的讲稿内容...
-主要论点、关键信息...
+[过渡] 接下来我们来看...
+
+讲稿正文,2-5 句自然语言。可使用标记:
+[停顿] 给观众思考时间,[互动] 提问或引导参与。
+
+要点:①要点一 ②要点二 ③要点三
+时长:X 分钟
---
-# 第3页
+# 03_<页面标题>
...
```
-然后自动拆分,写入 `notes/` 目录下的演讲备注文件中。
+**控场标记**:
+| 标记 | 用途 |
+|------|------|
+| `[停顿]` | 关键展示后留白,让观众消化 |
+| `[互动]` | 提问或引导观众参与 |
+| `[过渡]` | 段首单独成段,必须放在每页正文开头,用于承上启下 |
+
+**要求**:
+
+- 讲稿应口语化、自然流畅
+- 突出页面核心信息和演讲要点
+- 用户可在 `notes/` 目录手动编辑覆盖
+
+### 任务 2. 拆分写入各页备注文件
+
+接下来,将 `notes/total.md` 自动拆分,写入 `notes/` 目录下的演讲备注文件中。
+
+**文件命名规范**:
+
+- **推荐**:与 SVG 同名(如 `01_封面.svg` 对应 `notes/01_封面.md`)
+- **兼容**:也支持 `slide01.md` 格式(向后兼容)
+
+---
+
+**自动拆分说明**:
+
+使用工具自动拆分讲稿文件:
+
+```bash
+python3 tools/total_md_split.py <项目路径>
+```
+
+该工具会:
+- 验证 SVG 文件与讲稿是否一一对应
+- 将 `notes/total.md` 自动拆分成各页独立文件
+- 拆分后的文件命名与 SVG 同名,后缀为 `.md`
**导出说明**:
diff --git a/roles/Strategist.md b/roles/Strategist.md
index 36e11890..7fbf53b1 100644
--- a/roles/Strategist.md
+++ b/roles/Strategist.md
@@ -173,24 +173,18 @@
### i. 演讲备注要求(默认,无需沟通)
-#### 文件命名
+#### 文件命名规则
- **推荐**:与 SVG 同名(如 `01_封面.svg` 对应 `notes/01_封面.md`)
- **兼容**:支持 `notes/slide01.md` 格式
-#### 内容结构
-
-一段讲稿,无换行,支持以下记号:
-
-```txt
-讲稿纯文本【演讲提示】(备选讲稿)**重点强调**
-```
-
#### 内容要求
-- 一段讲稿,无换行,除此无其他内容
-- 讲稿应口语化、自然流畅
-- 讲稿应结合页面核心信息和演讲要点
-- 用户可在 `notes/` 目录手动编辑覆盖
+根据内容确定以下要求,填入《设计规范》的「演讲备注要求」章节:
+
+1. 演讲总时长:[分钟]
+2. 备注风格:正式/口语化/互动式
+3. 讲演目的:告知/说服/激励/指导/汇报
+4. 特殊要求:不允许任何#标签行出现在备注文件中。
---
@@ -253,7 +247,7 @@
| **六、图标使用规范** | 来源说明、占位符语法、推荐图标清单 |
| **七、图片资源清单** | 文件名、尺寸、比例、用途、状态、生成描述(按需) |
| **八、内容大纲** | 按章节分组,每页含布局、标题、内容要点 |
-| **九、演讲备注要求** | 演讲时长、文件命名规则、内容结构、内容要求 |
+| **九、演讲备注要求** | 文件命名规则、内容结构说明 |
| **十、技术约束提醒** | SVG 生成规则、PPT 兼容性规则 |
| **十一、设计检查清单** | 生成前/生成后检查项 |
| **十二、下一步** | 明确后续流程(Image_Generator 或 Executor) |
diff --git a/tools/README.md b/tools/README.md
index d8de6a13..4afca248 100644
--- a/tools/README.md
+++ b/tools/README.md
@@ -88,6 +88,7 @@ graph TB
| ↳ 子工具 | `flatten_tspan.py` | 文本扁平化 |
| ↳ 子工具 | `svg_rect_to_path.py` | 圆角矩形转 Path |
| **导出** | `svg_to_pptx.py` | SVG 转 PowerPoint |
+| **讲稿处理** | `total_md_split.py` | 讲稿拆分工具 |
| **质量检查** | `svg_quality_checker.py`, `batch_validate.py` | 验证 SVG 规范 |
| **辅助** | `config.py`, `analyze_images.py`, `rotate_images.py` | 配置和图片处理 |
@@ -628,6 +629,89 @@ pip install python-pptx
---
+### 9. total_md_split.py — 讲稿拆分工具
+
+将 `total.md` 讲稿文件拆分为多个独立的讲稿文件,每个文件对应一个 SVG 页面。
+
+**功能**:
+
+- 读取 `total.md` 文件,解析其中的一级标题和讲稿内容
+- 检查 `svg_output` 文件夹中的 SVG 文件是否都有对应的讲稿
+- 如果存在 SVG 没有对应的讲稿,会输出错误提示要求重新生成讲稿文件
+- 如果全部匹配,根据名称对文档进行拆分,分成多个文档
+- 拆分后的文档命名与 SVG 文件同名,后缀改为 `.md`
+- 拆分后的文档**不包含**一级标题
+
+**用法**:
+
+```bash
+# 基本用法
+python3 tools/total_md_split.py <项目路径>
+
+# 指定输出目录
+python3 tools/total_md_split.py <项目路径> -o <输出目录>
+
+# 静默模式
+python3 tools/total_md_split.py <项目路径> -q
+```
+
+**示例**:
+
+```bash
+# 基本用法
+python3 tools/total_md_split.py projects/<svg 标题>_ppt169_YYYYMMDD
+
+# 指定输出目录
+python3 tools/total_md_split.py projects/<svg 标题>_ppt169_YYYYMMDD -o notes
+
+# 静默模式
+python3 tools/total_md_split.py projects/<svg 标题>_ppt169_YYYYMMDD -q
+```
+
+**讲稿格式要求**:
+
+`total.md` 文件需要使用以下格式:
+
+```markdown
+# 01_<页面标题>
+
+讲稿内容...
+
+---
+
+# 02_<页面标题>
+
+讲稿内容...
+
+---
+
+# 03_<页面名称>
+
+讲稿内容...
+```
+
+- 每个章节以 `# ` 开头的一级标题开始
+- 章节之间用 `---` 分隔
+- 讲稿内容在标题之后,直到下一个标题或文件结束
+
+**错误处理**:
+
+如果存在 SVG 文件没有对应的讲稿,工具会输出错误信息:
+
+```
+错误: SVG 文件与讲稿不匹配
+ 缺失的讲稿: <N>_<页面标题>
+
+请重新生成讲稿文件,确保每个 SVG 都有对应的讲稿。
+```
+
+**依赖**:
+
+- Python 3.6+
+- 无外部依赖(仅使用标准库)
+
+---
+
### 9. svg_position_calculator.py — SVG 位置计算与验证工具
图表坐标的**事前计算**和**事后验证**工具,帮助确保 SVG 元素位置准确无误。
diff --git a/tools/total_md_split.py b/tools/total_md_split.py
new file mode 100644
index 00000000..b321e308
--- /dev/null
+++ b/tools/total_md_split.py
@@ -0,0 +1,265 @@
+#!/usr/bin/env python3
+"""
+PPT Master - 讲稿拆分工具
+
+将 total.md 讲稿文件拆分为多个独立的讲稿文件,每个文件对应一个 SVG 页面。
+
+用法:
+ python3 tools/total_md_split.py <项目路径>
+ python3 tools/total_md_split.py <项目路径> -o output_dir
+
+示例:
+ python3 tools/total_md_split.py projects/<svg 标题>_ppt169_YYYYMMDD
+ python3 tools/total_md_split.py projects/<svg 标题>_ppt169_YYYYMMDD -o notes
+
+依赖:
+ 无(仅使用标准库)
+
+注意:
+ - 会检查 SVG 文件与讲稿的一一对应关系
+ - 如果存在 SVG 没有对应的讲稿,会输出提示
+ - 拆分后的文档不包含一级标题
+ - 拆分后的文档命名与 SVG 文件同名,后缀改为 .md
+"""
+
+import sys
+import os
+import argparse
+import re
+from pathlib import Path
+from typing import List, Dict, Tuple, Optional
+
+
+def find_svg_files(project_path: Path) -> List[Path]:
+ """
+ 查找项目中的 SVG 文件
+
+ Args:
+ project_path: 项目目录路径
+
+ Returns:
+ SVG 文件列表(按文件名排序)
+ """
+ svg_dir = project_path / 'svg_output'
+
+ if not svg_dir.exists():
+ print(f"错误: {svg_dir} 目录不存在")
+ return []
+
+ return sorted(svg_dir.glob('*.svg'))
+
+
+def parse_total_md(md_path: Path) -> Dict[str, str]:
+ """
+ 解析 total.md 文件,提取每个一级标题对应的讲稿内容
+
+ Args:
+ md_path: total.md 文件路径
+
+ Returns:
+ 字典,key 为一级标题(不含 #),value 为讲稿内容
+ """
+ if not md_path.exists():
+ print(f"错误: {md_path} 文件不存在")
+ return {}
+
+ try:
+ with open(md_path, 'r', encoding='utf-8') as f:
+ content = f.read()
+ except Exception as e:
+ print(f"错误: 无法读取文件 {md_path}: {e}")
+ return {}
+
+ # 按分隔符拆分内容
+ sections = re.split(r'\n---\n', content)
+
+ notes = {}
+
+ for section in sections:
+ section = section.strip()
+ if not section:
+ continue
+
+ # 查找一级标题
+ lines = section.split('\n')
+ title_line = None
+ content_lines = []
+
+ for line in lines:
+ if line.startswith('# '):
+ title_line = line
+ elif title_line is not None:
+ content_lines.append(line)
+
+ if title_line:
+ # 提取标题文本(去掉 # 和空格)
+ title = re.sub(r'^#+\s*', '', title_line).strip()
+ # 提取讲稿内容(去掉空行)
+ content = '\n'.join(content_lines).strip()
+
+ if title and content:
+ notes[title] = content
+
+ return notes
+
+
+def check_svg_note_mapping(svg_files: List[Path], notes: Dict[str, str]) -> Tuple[bool, List[str]]:
+ """
+ 检查 SVG 文件与讲稿的映射关系
+
+ Args:
+ svg_files: SVG 文件列表
+ notes: 讲稿字典(key 为标题)
+
+ Returns:
+ (是否全部匹配, 缺失的讲稿标题列表)
+ """
+ missing_notes = []
+
+ for svg_path in svg_files:
+ # 提取 SVG 文件名(不含扩展名)
+ svg_stem = svg_path.stem
+
+ # 检查是否在讲稿中存在对应的标题
+ if svg_stem not in notes:
+ missing_notes.append(svg_stem)
+
+ return len(missing_notes) == 0, missing_notes
+
+
+def split_notes(notes: Dict[str, str], output_dir: Path, verbose: bool = True) -> bool:
+ """
+ 根据讲稿字典拆分并保存为多个文件
+
+ Args:
+ notes: 讲稿字典(key 为标题,value 为内容)
+ output_dir: 输出目录
+ verbose: 是否输出详细信息
+
+ Returns:
+ 是否成功
+ """
+ if not notes:
+ print("错误: 没有找到讲稿内容")
+ return False
+
+ output_dir.mkdir(parents=True, exist_ok=True)
+
+ success_count = 0
+
+ for title, content in notes.items():
+ # 生成输出文件名(与 SVG 文件同名,后缀改为 .md)
+ output_path = output_dir / f"{title}.md"
+
+ try:
+ with open(output_path, 'w', encoding='utf-8') as f:
+ f.write(content)
+
+ if verbose:
+ print(f" 已生成: {output_path.name}")
+
+ success_count += 1
+
+ except Exception as e:
+ if verbose:
+ print(f" 错误: 无法写入文件 {output_path}: {e}")
+
+ if verbose:
+ print(f"\n[完成] 成功生成 {success_count}/{len(notes)} 个文件")
+
+ return success_count == len(notes)
+
+
+def main():
+ parser = argparse.ArgumentParser(
+ description='PPT Master - 讲稿拆分工具',
+ formatter_class=argparse.RawDescriptionHelpFormatter,
+ epilog='''
+示例:
+ %(prog)s projects/<svg 标题>_ppt169_YYYYMMDD
+ %(prog)s projects/<svg 标题>_ppt169_YYYYMMDD -o notes
+ %(prog)s projects/<svg 标题>_ppt169_YYYYMMDD -q
+
+功能:
+ - 读取 total.md 讲稿文件
+ - 检查 SVG 文件与讲稿的对应关系
+ - 拆分讲稿为多个独立文件
+ - 输出文件命名与 SVG 文件同名
+'''
+ )
+
+ parser.add_argument('project_path', type=str, help='项目目录路径')
+ parser.add_argument('-o', '--output', type=str, default=None, help='输出目录路径(默认:项目下的 notes 目录)')
+ parser.add_argument('-q', '--quiet', action='store_true', help='静默模式')
+
+ args = parser.parse_args()
+
+ project_path = Path(args.project_path)
+ if not project_path.exists():
+ print(f"错误: 路径不存在: {project_path}")
+ sys.exit(1)
+
+ # 确定输出目录
+ if args.output:
+ output_dir = Path(args.output)
+ else:
+ output_dir = project_path / 'notes'
+
+ verbose = not args.quiet
+
+ if verbose:
+ print("PPT Master - 讲稿拆分工具")
+ print("=" * 50)
+ print(f" 项目路径: {project_path}")
+ print(f" 输出目录: {output_dir}")
+ print()
+
+ # 查找 SVG 文件
+ svg_files = find_svg_files(project_path)
+
+ if not svg_files:
+ print("错误: 未找到 SVG 文件")
+ sys.exit(1)
+
+ if verbose:
+ print(f" 找到 {len(svg_files)} 个 SVG 文件")
+
+ # 解析 total.md
+ total_md_path = project_path / 'notes' / 'total.md'
+ notes = parse_total_md(total_md_path)
+
+ if not notes:
+ print("错误: 未找到讲稿内容")
+ sys.exit(1)
+
+ if verbose:
+ print(f" 找到 {len(notes)} 个讲稿章节")
+ print()
+
+ # 检查映射关系
+ all_match, missing_notes = check_svg_note_mapping(svg_files, notes)
+
+ if not all_match:
+ print("错误: SVG 文件与讲稿不匹配")
+ print(f" 缺失的讲稿: {', '.join(missing_notes)}")
+ print("\n请重新生成讲稿文件,确保每个 SVG 都有对应的讲稿。")
+ sys.exit(1)
+
+ if verbose:
+ print("[OK] SVG 文件与讲稿一一对应")
+ print()
+
+ # 拆分讲稿
+ success = split_notes(notes, output_dir, verbose)
+
+ if success:
+ if verbose:
+ print(f"\n[完成] 讲稿拆分完成")
+ sys.exit(0)
+ else:
+ print(f"\n[失败] 讲稿拆分失败")
+ sys.exit(1)
+
+
+if __name__ == '__main__':
+ main()