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/VERSIONdeleted file mode 100644index 0ec25f75..00000000--- a/VERSION+++ /dev/null@@ -1 +0,0 @@-v1.0.0diff --git a/roles/Executor_General.md b/roles/Executor_General.mdindex 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.mdindex 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>/设计规范与内容大纲.mddiff --git a/tools/README.md b/tools/README.mdindex 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 工具(推荐首选)