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

feat(arch): 架构重构与工具文档升级

hugohe3ace787c35d29
diff --git a/VERSION b/VERSION
deleted file mode 100644
index 0ec25f75..00000000
--- a/VERSION
+++ /dev/null
@@ -1 +0,0 @@
-v1.0.0
diff --git a/roles/Executor_General.md b/roles/Executor_General.md
index 7e7ced41..fd4d13bc 100644
--- a/roles/Executor_General.md
+++ b/roles/Executor_General.md
@@ -291,31 +291,3 @@ python3 tools/svg_to_pptx.py <项目路径> -s final
- 查看演讲备注是否正确嵌入
💡 **提示**:后处理和导出步骤由 AI 自动执行,无需手动干预。
-
----
-
-## 演讲备注生成
-
-生成每页 SVG 后,**同步创建**对应的演讲备注文件。
-
-**文件命名规范**:
-
-- **推荐**:与 SVG 同名(如 `01_封面.svg` 对应 `notes/01_封面.md`)
-- **兼容**:也支持 `slide01.md` 格式(向后兼容)
-
-**格式模板**:
-
-```markdown
-[过渡] 接下来我们来看...
-
-讲稿正文,2-5 句自然语言。可使用标记:
-[停顿] 给观众思考时间,[互动] 提问或引导参与。
-
-要点:①要点一 ②要点二
-时长:X 分钟
-```
-
-**要求**:
-
-- 讲稿应口语化、自然流畅
-- 用户可在 `notes/` 目录手动编辑覆盖
diff --git a/roles/Strategist.md b/roles/Strategist.md
index d89556fc..f89a7f13 100644
--- a/roles/Strategist.md
+++ b/roles/Strategist.md
@@ -57,16 +57,14 @@
**常用行业配色**:
-| 行业 | 主导色 | 辅助色 | 强调色 |
-| --------------- | ---------------- | --------- | ------------ |
-| **金融/商务** | `#1E3A5F` 深海蓝 | `#F8F9FA` | `#D4AF37` 金 |
-| **医疗/健康** | `#00A878` 薄荷绿 | `#FFFFFF` | `#4ECDC4` |
-| **科技/互联网** | `#6366F1` 靛蓝紫 | `#1E293B` | `#22D3EE` |
-| **政务/政府** | `#C41E3A` 中国红 | `#1A1A1A` | `#D4AF37` |
-| **教育/培训** | `#4A90D9` 天空蓝 | `#FFF8E7` | `#FFB347` |
-| **地产/建筑** | `#2F4F4F` 深板岩 | `#D3D3D3` | `#B8860B` |
+> 💡 以下为示例,完整配色方案(14 个行业)请参考 [tools/config.py](../tools/config.py) 中的 `INDUSTRY_COLORS`
-更多行业配色参考 [tools/config.py](../tools/config.py) 中的 `INDUSTRY_COLORS`
+| 行业 | 主导色 | 特点 |
+|------|--------|------|
+| **金融/商务** | `#003366` 深蓝 | 稳重信赖 |
+| **科技/互联网** | `#1565C0` 明蓝 | 创新活力 |
+| **医疗/健康** | `#00796B` 青绿 | 专业安心 |
+| **政务/政府** | `#C41E3A` 中国红 | 庄重权威 |
**配色规则**:
@@ -236,35 +234,16 @@
---
-## 3. 创建项目文件夹(必须执行)
+## 3. 项目文件夹(已由前置步骤创建)
-用户确认设计方案后,**立即执行以下命令创建项目文件夹**:
-
-```bash
-python3 tools/project_manager.py init <项目名称> --format <画布格式>
-```
-
-**示例**:
-
-```bash
-# PPT 16:9 格式
-python3 tools/project_manager.py init 季度业务报告 --format ppt169
-
-# 小红书格式
-python3 tools/project_manager.py init 产品推广 --format wechat
-```
-
-**执行后会创建**:
-
-```
-projects/<项目名>_<格式>_<YYYYMMDD>/
-├── README.md
-├── 设计规范与内容大纲.md(待保存)
-├── svg_output/
-└── images/(如需要)
-```
+> ⚠️ **注意**:项目文件夹应在进入策略师角色**之前**已创建完成。
+>
+> 如果文件夹尚未创建,请先返回主流程执行:
+> ```bash
+> python3 tools/project_manager.py init <项目名称> --format <画布格式>
+> ```
-**然后将《设计规范与内容大纲》保存到项目文件夹**:
+策略师的职责是将《设计规范与内容大纲》**保存到已创建的项目文件夹**:
```
projects/<项目名>_<格式>_<YYYYMMDD>/设计规范与内容大纲.md
diff --git a/tools/README.md b/tools/README.md
index eb959df1..2b6d7823 100644
--- a/tools/README.md
+++ b/tools/README.md
@@ -2,6 +2,97 @@
本目录包含用于项目管理、验证和文件处理的实用工具。
+## 工具架构总览
+
+```mermaid
+graph TB
+ subgraph Input["📥 输入转换"]
+ A1[pdf_to_md.py]
+ A2[web_to_md.py / .cjs]
+ end
+
+ subgraph Project["📁 项目管理"]
+ B1[project_manager.py]
+ B2[project_utils.py]
+ B1 --> B2
+ end
+
+ subgraph Finalize["⚙️ 后处理 (finalize_svg.py)"]
+ direction TB
+ C0[finalize_svg.py<br/>统一入口]
+ C1[embed_icons.py]
+ C2[crop_images.py]
+ C3[fix_image_aspect.py]
+ C4[embed_images.py]
+ C5[flatten_tspan.py]
+ C6[svg_rect_to_path.py]
+
+ C0 --> C1
+ C0 --> C2
+ C0 --> C3
+ C0 --> C4
+ C0 --> C5
+ C0 --> C6
+ end
+
+ subgraph Export["📤 导出"]
+ D1[svg_to_pptx.py]
+ end
+
+ subgraph Quality["🔍 质量检查"]
+ E1[svg_quality_checker.py]
+ E2[batch_validate.py]
+ end
+
+ subgraph Utils["🛠️ 辅助工具"]
+ F1[rotate_images.py]
+ F2[analyze_images.py]
+ F3[svg_position_calculator.py]
+ F4[config.py]
+ end
+
+ A1 --> B1
+ A2 --> B1
+ B1 -->|svg_output/| C0
+ C0 -->|svg_final/| D1
+ D1 -->|.pptx| Output[📊 PowerPoint]
+```
+
+### 核心工作流
+
+```
+源文档 → [pdf_to_md / web_to_md] → Markdown
+ ↓
+ [project_manager init]
+ ↓
+ AI 生成 SVG → svg_output/
+ ↓
+ [finalize_svg] ← 聚合 6 个子工具
+ ↓
+ svg_final/
+ ↓
+ [svg_to_pptx] → output.pptx
+```
+
+### 工具分类快速索引
+
+| 分类 | 工具 | 说明 |
+|------|------|------|
+| **输入转换** | `pdf_to_md.py`, `web_to_md.py/.cjs` | 将 PDF/网页转为 Markdown |
+| **项目管理** | `project_manager.py` | 创建、验证项目 |
+| **后处理** | `finalize_svg.py` ⭐ | 统一入口,调用下方 6 个工具 |
+| ↳ 子工具 | `embed_icons.py` | 嵌入图标占位符 |
+| ↳ 子工具 | `crop_images.py` | 智能裁剪图片 |
+| ↳ 子工具 | `fix_image_aspect.py` | 修复图片宽高比 |
+| ↳ 子工具 | `embed_images.py` | Base64 嵌入图片 |
+| ↳ 子工具 | `flatten_tspan.py` | 文本扁平化 |
+| ↳ 子工具 | `svg_rect_to_path.py` | 圆角矩形转 Path |
+| **导出** | `svg_to_pptx.py` | SVG 转 PowerPoint |
+| **质量检查** | `svg_quality_checker.py`, `batch_validate.py` | 验证 SVG 规范 |
+| **辅助** | `config.py`, `analyze_images.py`, `rotate_images.py` | 配置和图片处理 |
+
+---
+
## 工具列表
### 0. pdf_to_md.py — PDF 转 Markdown 工具(推荐首选)