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
优化SVG后处理工具,支持嵌入图标、图片、文本扁平化及圆角转Path功能。更新相关文档以提升用户体验和可读性。优化示例项目的final_svg及输出ppt文件。
hugohe3bcbceafc2973
diff --git a/AGENTS.md b/AGENTS.mdindex 7ab74e1b..5eff84d7 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -70,42 +70,30 @@ python3 tools/project_manager.py validate <路径># SVG 质量检查python3 tools/svg_quality_checker.py <路径>-# ⭐ 最终化处理(一键完成:复制 + 嵌入图标)+# ⭐ 后处理(默认执行全部)python3 tools/finalize_svg.py <项目路径>-# 最终化处理 + 嵌入图片(转 Base64)-python3 tools/finalize_svg.py <项目路径> --embed-images+# 只执行部分处理+python3 tools/finalize_svg.py <项目路径> --only embed-icons fix-rounded# 预览原始版本-python3 -m http.server --directory <路径>/svg_output 8000+python3 -m http.server -d <路径>/svg_output 8000# 预览最终版本-python3 -m http.server --directory <路径>/svg_final 8000-```--### 后处理工具(可选)+python3 -m http.server -d <路径>/svg_final 8000-```bash-# 文本扁平化(将 <tspan> 转为独立 <text>,用于特殊渲染器)-python3 tools/flatten_tspan.py <项目路径>/svg_output--# ⭐ 导出为 PPTX(原生 SVG 矢量嵌入)-python3 tools/svg_to_pptx.py <项目路径>-python3 tools/svg_to_pptx.py <项目路径> -s final # 使用 svg_final-python3 tools/svg_to_pptx.py <项目路径> -s flat # 使用扁平化版本-python3 tools/svg_to_pptx.py <项目路径> -s final_flat # 使用最终+扁平化版本+# ⭐ 导出为 PPTX+python3 tools/svg_to_pptx.py <项目路径> -s final```### 项目目录结构```project/-├── svg_output/ # 原始版本(带占位符,作为模板参考)-├── svg_final/ # 最终版本(嵌入图标/图片后)-├── svg_output_flattext/ # 扁平化版本(可选)-├── svg_final_flattext/ # 最终+扁平化版本(可选)-├── images/ # 图片资源-└── *.pptx # 导出的 PPT 文件(可选)+├── svg_output/ # 原始版本(带占位符,作为模板参考)+├── svg_final/ # 最终版本(后处理完成)+├── images/ # 图片资源+└── *.pptx # 导出的 PPT 文件```## 质量检查清单@@ -148,10 +136,20 @@ project/### 后处理提示-SVG 生成完成后,用户可能需要进行后处理:+SVG 生成完成后,用户需要进行后处理:++```bash+# 交互式后处理(推荐)+python3 tools/finalize_svg.py <项目路径>++# 导出 PPTX+python3 tools/svg_to_pptx.py <项目路径> -s final+```-- **最终化处理**: `python3 tools/finalize_svg.py <项目路径>` - 嵌入图标/图片-- **文本扁平化**: `python3 tools/flatten_tspan.py <目录>` - 将 `<tspan>` 转为独立 `<text>`(用于特殊渲染器)-- **导出 PPTX**: `python3 tools/svg_to_pptx.py <项目路径>` - 生成 PowerPoint 文件(原生 SVG 矢量嵌入)+后处理选项:+- **嵌入图标** - 替换图标占位符为实际 SVG+- **嵌入图片** - 将外部图片转为 Base64+- **文本扁平化** - 将 `<tspan>` 转为独立 `<text>`(用于特殊渲染器)+- **圆角转 Path** - 用于 PPT「转换为形状」时保留圆角这些工具由用户自行调用,AI 代理无需直接执行。diff --git a/README.md b/README.mdindex 7b03f6a9..76ac0a52 100644--- a/README.md+++ b/README.md@@ -163,9 +163,8 @@ PPT Master 是一个创新的 AI 辅助视觉内容创作系统,通过四个↓SVG 文件 (svg_output/)↓-后处理工具(用户自行调用,可选)- ├── finalize_svg.py → svg_final/(嵌入图标/图片)- ├── flatten_tspan.py → svg_output_flattext/(文本扁平化)+后处理工具(用户自行调用)+ ├── finalize_svg.py → svg_final/(嵌入图标/图片 + 文本扁平化 + 圆角转Path)└── svg_to_pptx.py → output.pptx(导出 PowerPoint)```@@ -317,19 +316,16 @@ SVG 文件 (svg_output/)5. **优化润色**(可选)使用 Optimizer_CRAP 进行 CRAP 原则优化-6. **后处理**(可选)+6. **后处理**(推荐)```bash- python3 tools/finalize_svg.py <项目路径> # 嵌入图标/图片- python3 tools/flatten_tspan.py <目录> # 文本扁平化+ python3 tools/finalize_svg.py <项目路径> # 执行全部后处理```7. **导出使用**```bash- # 导出为 PPTX(四种来源可选)- python3 tools/svg_to_pptx.py <项目路径> # svg_output(默认)- python3 tools/svg_to_pptx.py <项目路径> -s final # svg_final(嵌入图标后)- python3 tools/svg_to_pptx.py <项目路径> -s flat # svg_output_flattext(扁平化)- python3 tools/svg_to_pptx.py <项目路径> -s final_flat # svg_final_flattext(最终+扁平化)+ # 导出为 PPTX+ python3 tools/svg_to_pptx.py <项目路径> -s final # 使用 svg_final(推荐)+ python3 tools/svg_to_pptx.py <项目路径> # 使用 svg_output(原始版本)```或将 SVG 文件直接嵌入到其他演示环境中@@ -746,39 +742,33 @@ python3 tools/batch_validate.py examples --exportpython3 tools/generate_examples_index.py```-### 文本扁平化工具 (`flatten_tspan.py`)+### 后处理工具 (`finalize_svg.py`)-将 `<tspan>` 转换为独立的 `<text>` 元素(用于特殊渲染器或文本抽取):+统一后处理入口,执行嵌入图标/图片、文本扁平化、圆角转 Path:```bash-# 交互模式-python3 tools/flatten_tspan.py+# 执行全部后处理(默认)+python3 tools/finalize_svg.py <项目路径>-# 扁平化整个目录-python3 tools/flatten_tspan.py examples/<project>/svg_output--# 处理单个文件-python3 tools/flatten_tspan.py input.svg output.svg+# 只执行部分处理+python3 tools/finalize_svg.py <项目路径> --only embed-icons fix-rounded```-**注意**:生成阶段仍应使用 `<tspan>` 手动换行,此工具仅用于后处理。+**注意**:生成阶段仍应使用 `<tspan>` 手动换行,后处理会自动扁平化。### SVG 转 PPTX 工具 (`svg_to_pptx.py`)将 SVG 文件批量转换为 PowerPoint 演示文稿(原生 SVG 矢量嵌入):```bash-# 基本用法(使用 svg_output 目录)-python3 tools/svg_to_pptx.py <项目路径>+# 使用最终版本(推荐)+python3 tools/svg_to_pptx.py <项目路径> -s final-# 指定 SVG 来源目录-python3 tools/svg_to_pptx.py <项目路径> -s final # svg_final-python3 tools/svg_to_pptx.py <项目路径> -s flat # svg_output_flattext-python3 tools/svg_to_pptx.py <项目路径> -s final_flat # svg_final_flattext-python3 tools/svg_to_pptx.py <项目路径> -s <任意目录> # 自定义子目录+# 使用原始版本+python3 tools/svg_to_pptx.py <项目路径># 指定输出文件-python3 tools/svg_to_pptx.py <项目路径> -o output.pptx+python3 tools/svg_to_pptx.py <项目路径> -s final -o output.pptx```**特点**:SVG 以原生矢量格式嵌入,保持可编辑性,需要 PowerPoint 2016+ 查看。diff --git a/docs/canvas_formats.md b/docs/canvas_formats.mdindex 51eb7753..d2bb7d9b 100644--- a/docs/canvas_formats.md+++ b/docs/canvas_formats.md@@ -151,7 +151,7 @@### 所有格式通用规范- **格式**: SVG 矢量图- **viewBox**: 与实际尺寸一致-- **文本**: 禁用 `<foreignObject>`;生成阶段使用 `<tspan>` 手动换行;如需发布去除 `<tspan>`,使用 `tools/flatten_tspan.py` 后处理(默认输出到 `svg_output_flattext`)+- **文本**: 禁用 `<foreignObject>`;生成阶段使用 `<tspan>` 手动换行;后处理使用 `tools/finalize_svg.py`(输出到 `svg_final/`)- **颜色**: 使用 HEX 值- **字体**: 优先使用系统字体栈diff --git a/docs/design_guidelines.md b/docs/design_guidelines.mdindex aea1648f..bfef0d1f 100644--- a/docs/design_guidelines.md+++ b/docs/design_guidelines.md@@ -157,13 +157,11 @@ system-ui, -apple-system, BlinkMacSystemFont,### 文本换行与扁平化- 生成阶段:禁止使用 `<foreignObject>`,采用 `<tspan>` 手动换行,并通过 `x`/`dy` 控制行起点与行距,保证与版式行高规范一致。-- 发布/后处理:如需去除 `<tspan>` 以提升某些渲染器兼容性或便于文本抽取,使用 `tools/flatten_tspan.py` 将每个 `<tspan>` 扁平为独立的 `<text>` 节点。- - 交互模式:`python3 tools/flatten_tspan.py` 或 `python3 tools/flatten_tspan.py -i`- - 目录:`python3 tools/flatten_tspan.py examples/<project>/svg_output [output_dir]`- - 单文件:`python3 tools/flatten_tspan.py path/to/input.svg [path/to/output.svg]`- - 默认输出:目录输入若路径以 `svg_output` 结尾,输出到同级 `svg_output_flattext`;否则为 `<目录>_flattext`;文件输入输出为 `<文件名>_flattext.svg`-- 校验要点:对比 `svg_output` 与 `svg_output_flattext`,核对行序、样式(如 `font-size`、`font-weight`、`fill`)与定位(`x`/`y`/`transform`)一致;目标文件中不应残留 `<tspan>`。- - 安全性:目录模式下工具会自动跳过输出子目录,避免递归处理。+- 发布/后处理:推荐使用统一后处理工具 `tools/finalize_svg.py`,已包含文本扁平化功能:+ ```bash+ python3 tools/finalize_svg.py <项目路径>+ ```+- 校验要点:对比 `svg_output` 与 `svg_final`,核对行序、样式(如 `font-size`、`font-weight`、`fill`)与定位(`x`/`y`/`transform`)一致;目标文件中不应残留 `<tspan>`。## 布局原则diff --git a/docs/quick_reference.md b/docs/quick_reference.mdindex 8605f9b1..386a1e38 100644--- a/docs/quick_reference.md+++ b/docs/quick_reference.md@@ -387,27 +387,17 @@ yh_slide_02_kpi_dashboard.svg## 🔧 后处理工具-### 最终化处理(嵌入图标/图片)+### 最终化处理(默认执行全部)```bash-# 一键处理(复制 + 嵌入图标)+# 执行全部后处理(嵌入图标/图片 + 文本扁平化 + 圆角转Path)python3 tools/finalize_svg.py <项目路径>-# 同时嵌入图片(转 Base64)-python3 tools/finalize_svg.py <项目路径> --embed-images-```--### 文本扁平化(去 tspan)--```bash-# 交互模式-python3 tools/flatten_tspan.py--# 目录级扁平化(输出到 svg_output_flattext)-python3 tools/flatten_tspan.py <项目路径>/svg_output+# 只执行部分处理+python3 tools/finalize_svg.py <项目路径> --only embed-icons fix-rounded-# 单文件扁平化-python3 tools/flatten_tspan.py input.svg output.svg+# 安静模式+python3 tools/finalize_svg.py <项目路径> -q```### 导出为 PPTX(推荐)@@ -417,10 +407,8 @@ python3 tools/flatten_tspan.py input.svg output.svgpython3 tools/svg_to_pptx.py <项目路径># 指定 SVG 来源目录-python3 tools/svg_to_pptx.py <项目路径> -s output # svg_output(默认)-python3 tools/svg_to_pptx.py <项目路径> -s final # svg_final-python3 tools/svg_to_pptx.py <项目路径> -s flat # svg_output_flattext-python3 tools/svg_to_pptx.py <项目路径> -s final_flat # svg_final_flattext+python3 tools/svg_to_pptx.py <项目路径> -s output # svg_output(原始版本)+python3 tools/svg_to_pptx.py <项目路径> -s final # svg_final(推荐)# 指定输出文件python3 tools/svg_to_pptx.py <项目路径> -o presentation.pptxdiff --git a/docs/workflow_tutorial.md b/docs/workflow_tutorial.mdindex e0242a70..d3bf982c 100644--- a/docs/workflow_tutorial.md+++ b/docs/workflow_tutorial.md@@ -129,16 +129,17 @@│ └──────────────────┘ │└────────────┬───────────┘│- ┌────────────────┴────────────────┐- │ 后处理(可选) │- ▼ ▼- ┌─────────────────────┐ ┌─────────────────────┐- │ finalize_svg.py │ │ flatten_tspan.py │- │ 嵌入图标/图片 │ │ 文本扁平化 │- │ → svg_final/ │ │ → svg_output_flat/ │- └─────────────────────┘ └─────────────────────┘- │ │- └────────────────┬─────────────────┘+ ▼+ ┌────────────────────────┐+ │ 后处理(推荐) │+ │ ┌──────────────────┐ │+ │ │ finalize_svg.py │ │+ │ │ • 嵌入图标/图片 │ │+ │ │ • 文本扁平化 │ │+ │ │ • 圆角转 Path │ │+ │ │ → svg_final/ │ │+ │ └──────────────────┘ │+ └────────────┬───────────┘│▼┌────────────────────────┐@@ -500,27 +501,24 @@ Optimizer_CRAP:- 在浏览器中逐页查看- 检查一致性和质量-3. **后处理(可选)**+3. **后处理(推荐)**```bash- # 最终化处理(嵌入图标/图片)+ # 执行全部后处理(默认)python3 tools/finalize_svg.py <项目路径>- # 文本扁平化(用于特殊渲染器)- python3 tools/flatten_tspan.py <项目路径>/svg_output+ # 只执行部分处理+ python3 tools/finalize_svg.py <项目路径> --only embed-icons fix-rounded```4. **导出为 PPTX(推荐)**```bash- # 基本用法- python3 tools/svg_to_pptx.py <项目路径>-- # 使用最终版本(带嵌入图标)+ # 使用最终版本(推荐)python3 tools/svg_to_pptx.py <项目路径> -s final- # 使用扁平化版本- python3 tools/svg_to_pptx.py <项目路径> -s flat+ # 使用原始版本+ python3 tools/svg_to_pptx.py <项目路径>```生成的 PPTX 文件中,SVG 以原生矢量格式嵌入,需要 PowerPoint 2016+ 查看。@@ -804,26 +802,17 @@ Executor: 收到,我将从您指定的文件夹中引用图标。祝你创作顺利!如有任何问题,欢迎反馈。## 文本扁平化(去 tspan)-在生成阶段,按规范使用 `<tspan>` 进行手动换行。若发布链路或后续处理需要去除 `<tspan>`,可使用仓库自带工具进行后处理:+在生成阶段,按规范使用 `<tspan>` 进行手动换行。若发布链路或后续处理需要去除 `<tspan>`,推荐使用统一后处理工具:```bash-# 交互模式(等效)-python3 tools/flatten_tspan.py-python3 tools/flatten_tspan.py -i+# 推荐:使用 finalize_svg.py(已包含文本扁平化)+python3 tools/finalize_svg.py <项目路径>-# 扁平化整个 svg_output 目录(默认输出到同级 svg_output_flattext)-python3 tools/flatten_tspan.py examples/<project_name>_<format>_<YYYYMMDD>/svg_output--# 处理单个文件/自定义输出路径+# 单独使用 flatten_tspan.py(高级用法)+python3 tools/flatten_tspan.py <项目路径>/svg_outputpython3 tools/flatten_tspan.py path/to/input.svg path/to/output.svg```-默认输出:-- 目录输入:若路径以 `svg_output` 结尾,输出到同级 `svg_output_flattext`;否则为 `<目录>_flattext`-- 文件输入:输出为 `<文件名>_flattext.svg`--安全性:目录模式下工具会自动跳过输出子目录,避免递归处理。-检查要点:- 输出中不应存在 `<tspan>`;- 文本样式(`font-size`/`font-weight`/`fill`/`text-anchor` 等)与坐标/变换应与原图一致;diff --git a/roles/README.md b/roles/README.mdindex 5c45d930..d86a0249 100644--- a/roles/README.md+++ b/roles/README.md@@ -35,9 +35,8 @@↓SVG 文件 (svg_output/)↓-后处理工具 (可选,用户自行调用)- ├── finalize_svg.py → svg_final/ (嵌入图标/图片)- ├── flatten_tspan.py → svg_output_flattext/ (文本扁平化)+后处理工具 (推荐,用户自行调用)+ ├── finalize_svg.py → svg_final/ (嵌入图标/图片 + 文本扁平化 + 圆角转Path)└── svg_to_pptx.py → output.pptx (导出 PowerPoint)```diff --git a/tools/README.md b/tools/README.mdindex 5df2eb08..be993689 100644--- a/tools/README.md+++ b/tools/README.md@@ -79,6 +79,8 @@ python3 tools/project_manager.py info projects/my_presentation_ppt169_20251116### 3. flatten_tspan.py — 文本扁平化(去 `<tspan>`)+> **推荐**: 使用 `finalize_svg.py` 作为统一入口,已集成文本扁平化功能。以下为独立使用的高级用法。+将含有多行 `<tspan>` 的 `<text>` 结构扁平化为多条独立的 `<text>` 元素,便于部分渲染器兼容或文本抽取。**注意**: 生成端仍应使用 `<tspan>` 手动换行(禁止 `<foreignObject>`)。此工具仅用于后处理。@@ -86,17 +88,10 @@ python3 tools/project_manager.py info projects/my_presentation_ppt169_20251116**用法**:```bash-# 交互模式-python3 tools/flatten_tspan.py-python3 tools/flatten_tspan.py -i--# 扁平化整个输出目录(默认输出到同级 svg_output_flattext)-python3 tools/flatten_tspan.py examples/<project_name>_<format>_<YYYYMMDD>/svg_output+# 扁平化整个输出目录+python3 tools/flatten_tspan.py examples/<project>/svg_output-# 指定输出目录-python3 tools/flatten_tspan.py examples/<project>/svg_output examples/<project>/svg_output_flattext--# 处理单个 SVG(自定义输出路径)+# 处理单个 SVGpython3 tools/flatten_tspan.py path/to/input.svg path/to/output.svg```@@ -105,13 +100,7 @@ python3 tools/flatten_tspan.py path/to/input.svg path/to/output.svg- 逐个 `<tspan>` 计算绝对位置(综合 `x`/`y` 与 `dx`/`dy`),合并父/子样式,输出为独立 `<text>`- 复制父 `<text>` 的通用文本属性和 `style`,子级覆盖优先- 保留或合并 `transform`-- 输出采用 UTF-8 编码,无 XML 声明,保持与仓库示例风格一致--**建议校验**:--- 目标目录为 `svg_output_flattext`,不应含 `<tspan>`-- 抽检字号、字重、颜色、对齐和坐标是否与原文件一致-- 若发现偏差,优先在生成端修正 `<tspan>` 的 `x`/`dy` 或父 `<text>` 的样式后重跑+- 输出采用 UTF-8 编码,无 XML 声明**已知限制**:@@ -291,49 +280,33 @@ python3 tools/svg_quality_checker.py examples/project --export**用法**:```bash-# 基本用法(使用 svg_output 目录)-python3 tools/svg_to_pptx.py <项目路径>--# 指定 SVG 来源目录(预定义别名)-python3 tools/svg_to_pptx.py <项目路径> -s output # svg_output(默认)-python3 tools/svg_to_pptx.py <项目路径> -s final # svg_final-python3 tools/svg_to_pptx.py <项目路径> -s flat # svg_output_flattext-python3 tools/svg_to_pptx.py <项目路径> -s final_flat # svg_final_flattext+# 推荐:使用后处理完成的版本+python3 tools/svg_to_pptx.py <项目路径> -s final-# 直接指定任意子目录名-python3 tools/svg_to_pptx.py <项目路径> -s my_custom_folder+# 使用原始版本+python3 tools/svg_to_pptx.py <项目路径># 指定输出文件-python3 tools/svg_to_pptx.py <项目路径> -o output.pptx+python3 tools/svg_to_pptx.py <项目路径> -s final -o output.pptx# 静默模式-python3 tools/svg_to_pptx.py <项目路径> -q+python3 tools/svg_to_pptx.py <项目路径> -s final -q```**SVG 来源目录 (`-s`)**:| 参数 | 目录 | 说明 ||------|------|------|-| `-s output` | `svg_output/` | 原始版本(默认) |-| `-s final` | `svg_final/` | 带嵌入图标/图片 |-| `-s flat` | `svg_output_flattext/` | 扁平化文本 |-| `-s final_flat` | `svg_final_flattext/` | 最终版+扁平化 |+| `-s output` | `svg_output/` | 原始版本 |+| `-s final` | `svg_final/` | 后处理完成(推荐) || `-s <任意名>` | `<任意名>/` | 直接指定子目录 |**示例**:```bash-# 使用原始版本-python3 tools/svg_to_pptx.py examples/ppt169_demo--# 使用最终版本(带嵌入图标)+# 推荐流程:先后处理,再导出+python3 tools/finalize_svg.py examples/ppt169_demopython3 tools/svg_to_pptx.py examples/ppt169_demo -s final--# 使用扁平化文本版本-python3 tools/svg_to_pptx.py examples/ppt169_demo -s flat--# 直接指定自定义子目录-python3 tools/svg_to_pptx.py examples/ppt169_demo -s my_svg_folder```**依赖**:@@ -350,6 +323,56 @@ pip install python-pptx---+### 9. svg_rect_to_path.py — SVG 圆角矩形转 Path 工具++解决 SVG 在 PowerPoint 中「转换为形状」时圆角丢失的问题。++**问题**: PowerPoint 不能正确解析 `<rect>` 的 `rx`/`ry` 圆角属性++**解决方案**: 将 `<rect rx="12" ry="12">` 转换为等效的 `<path d="...圆弧...">`++**用法**:++```bash+# 处理项目中的 SVG(默认使用 svg_output)+python3 tools/svg_rect_to_path.py <项目路径>++# 指定 SVG 来源目录+python3 tools/svg_rect_to_path.py <项目路径> -s final++# 指定输出目录名+python3 tools/svg_rect_to_path.py <项目路径> -o svg_for_ppt++# 处理单个文件+python3 tools/svg_rect_to_path.py path/to/file.svg++# 详细输出+python3 tools/svg_rect_to_path.py <项目路径> -v+```++**示例**:++```bash+# 处理项目+python3 tools/svg_rect_to_path.py examples/ppt169_demo+# 输出到: examples/ppt169_demo/svg_rounded/++# 处理单个文件+python3 tools/svg_rect_to_path.py examples/ppt169_demo/svg_output/01_cover.svg+# 输出到: examples/ppt169_demo/svg_output/01_cover_rounded.svg+```++**使用场景**:++当你需要在 PowerPoint 中将 SVG「转换为形状」进行编辑时,先用此工具预处理 SVG,可以保留圆角效果。++**注意**:++- 如果只是嵌入 SVG 而不转换为形状,无需使用此工具+- 透明度在「转换为形状」后仍会丢失(PowerPoint 限制)++---+## 工作流集成### 典型工作流程@@ -366,35 +389,26 @@ pip install python-pptx3. **生成 SVG 文件**使用 AI 角色(Strategist → Executor → Optimizer)生成 SVG 并保存到 `svg_output/`-4. **质量检查**-- ```bash- # 检查 SVG 质量- python3 tools/svg_quality_checker.py projects/my_project_ppt169_20251116- ```--5. **验证项目**+4. **后处理(默认执行全部)**```bash- python3 tools/project_manager.py validate projects/my_project_ppt169_20251116- ```--6. **(可选)扁平化文本**-- ```bash- python3 tools/flatten_tspan.py projects/my_project_ppt169_20251116/svg_output+ # 默认执行全部后处理+ python3 tools/finalize_svg.py projects/my_project_ppt169_20251116++ # 只执行部分处理+ python3 tools/finalize_svg.py projects/my_project_ppt169_20251116 --only embed-icons fix-rounded```-7. **更新索引**(如果是 examples 目录)+5. **导出为 PPTX**```bash- python3 tools/generate_examples_index.py+ python3 tools/svg_to_pptx.py projects/my_project_ppt169_20251116 -s final```-8. **导出为 PPTX**+6. **(可选)验证项目**```bash- python3 tools/svg_to_pptx.py projects/my_project_ppt169_20251116+ python3 tools/project_manager.py validate projects/my_project_ppt169_20251116```### 批量操作diff --git a/tools/embed_icons.py b/tools/embed_icons.pyindex 2e79d2c4..58521384 100644--- a/tools/embed_icons.py+++ b/tools/embed_icons.py@@ -145,7 +145,7 @@ def process_svg_file(svg_path: Path, icons_dir: Path, dry_run: bool = False, ver替换的图标数量"""if not svg_path.exists():- print(f"❌ 文件不存在: {svg_path}")+ print(f"[ERROR] 文件不存在: {svg_path}")return 0content = svg_path.read_text(encoding='utf-8')@@ -156,7 +156,7 @@ def process_svg_file(svg_path: Path, icons_dir: Path, dry_run: bool = False, verif not matches:if verbose:- print(f"⏭️ 无图标占位符: {svg_path}")+ print(f"[SKIP] 无图标占位符: {svg_path}")return 0replaced_count = 0@@ -175,13 +175,13 @@ def process_svg_file(svg_path: Path, icons_dir: Path, dry_run: bool = False, verpaths = extract_paths_from_icon(icon_path)if not paths:- print(f"⚠️ 图标不存在: {icon_name} (in {svg_path.name})")+ print(f"[WARN] 图标不存在: {icon_name} (in {svg_path.name})")continuereplacement = generate_icon_group(attrs, paths)if verbose or dry_run:- print(f" 📍 {icon_name}: x={attrs.get('x', 0)}, y={attrs.get('y', 0)}, "+ print(f" [*] {icon_name}: x={attrs.get('x', 0)}, y={attrs.get('y', 0)}, "f"size={attrs.get('width', 16)}, fill={attrs.get('fill', '#000000')}")new_content = new_content[:match.start()] + replacement + new_content[match.end():]@@ -190,8 +190,8 @@ def process_svg_file(svg_path: Path, icons_dir: Path, dry_run: bool = False, verif not dry_run and replaced_count > 0:svg_path.write_text(new_content, encoding='utf-8')- status = "🔍 预览" if dry_run else "✅ 已处理"- print(f"{status}: {svg_path.name} ({replaced_count} 个图标)")+ status = "[PREVIEW]" if dry_run else "[OK]"+ print(f"{status} {svg_path.name} ({replaced_count} icons)")return replaced_count@@ -221,12 +221,12 @@ def main():# 验证图标目录if not args.icons_dir.exists():- print(f"❌ 图标目录不存在: {args.icons_dir}")+ print(f"[ERROR] 图标目录不存在: {args.icons_dir}")sys.exit(1)- print(f"📁 图标目录: {args.icons_dir}")+ print(f"[DIR] 图标目录: {args.icons_dir}")if args.dry_run:- print("🔍 预览模式(不修改文件)")+ print("[PREVIEW] 预览模式(不修改文件)")print()total_replaced = 0diff --git a/tools/embed_images.py b/tools/embed_images.pyindex d6a793d6..586fd7cf 100644--- a/tools/embed_images.py+++ b/tools/embed_images.py@@ -75,7 +75,7 @@ def embed_images_in_svg(svg_path, dry_run=False):full_path = img_pathif not os.path.exists(full_path):- print(f" ⚠️ Warning: Image not found: {img_path}")+ print(f" [WARN] Image not found: {img_path}")images_found.append((img_path, "NOT FOUND", 0))return match.group(0)@@ -100,17 +100,17 @@ def embed_images_in_svg(svg_path, dry_run=False):# 打印处理的图片if images_found:- print(f"\n📄 {os.path.basename(svg_path)}")+ print(f"\n[FILE] {os.path.basename(svg_path)}")for img_path, status, size in images_found:size_str = get_file_size_str(size) if size > 0 else ""if status == "EMBEDDED":- print(f" ✅ {img_path} ({size_str})")+ print(f" [OK] {img_path} ({size_str})")elif status == "WILL EMBED":- print(f" 📋 {img_path} ({size_str}) [dry-run]")+ print(f" [PREVIEW] {img_path} ({size_str}) [dry-run]")else:- print(f" ❌ {img_path} ({status})")+ print(f" [FAIL] {img_path} ({status})")- print(f" 📊 Size: {get_file_size_str(original_size)} → {get_file_size_str(new_size)}")+ print(f" [SIZE] {get_file_size_str(original_size)} -> {get_file_size_str(new_size)}")if not dry_run and images_embedded > 0:with open(svg_path, 'w', encoding='utf-8') as f:@@ -136,18 +136,18 @@ def main():args = parser.parse_args()if args.dry_run:- print("🔍 Dry-run mode: 只预览,不实际修改文件\n")+ print("[INFO] Dry-run mode: only preview, no modification\n")total_images = 0total_files = 0for svg_file in args.files:if not os.path.exists(svg_file):- print(f"❌ File not found: {svg_file}")+ print(f"[ERROR] File not found: {svg_file}")continueif not svg_file.endswith('.svg'):- print(f"⏭️ Skipping non-SVG file: {svg_file}")+ print(f"[SKIP] Skipping non-SVG file: {svg_file}")continueimages, _ = embed_images_in_svg(svg_file, dry_run=args.dry_run)@@ -157,9 +157,9 @@ def main():print(f"\n{'=' * 50}")if args.dry_run:- print(f"📋 预览完成: 将处理 {total_files} 个文件中的 {total_images} 张图片")+ print(f"[PREVIEW] Will process {total_images} images in {total_files} files")else:- print(f"✅ 处理完成: 已嵌入 {total_files} 个文件中的 {total_images} 张图片")+ print(f"[DONE] Embedded {total_images} images in {total_files} files")if __name__ == '__main__':main()diff --git a/tools/finalize_svg.py b/tools/finalize_svg.pyindex 9ad02de8..4b897f67 100644--- a/tools/finalize_svg.py+++ b/tools/finalize_svg.py@@ -1,21 +1,26 @@#!/usr/bin/env python3"""-SVG 最终化处理工具+PPT Master - SVG 后处理工具(统一入口)-将 svg_output/ 中的原始 SVG 复制到 svg_final/,并完成图标和图片的嵌入。-原始版本保留在 svg_output/ 作为模板参考。+将 svg_output/ 中的 SVG 文件处理后输出到 svg_final/。+默认执行全部处理,也可通过参数指定部分处理。用法:+ # 默认执行全部处理(推荐)python3 tools/finalize_svg.py <项目目录>++ # 只执行部分处理+ python3 tools/finalize_svg.py <项目目录> --only embed-icons fix-rounded示例:python3 tools/finalize_svg.py projects/my_project- python3 tools/finalize_svg.py examples/ppt169_demo+ python3 tools/finalize_svg.py examples/ppt169_demo --only embed-icons-流程:- 1. 复制 svg_output/ → svg_final/- 2. 嵌入图标(替换 <use data-icon="..."/>)- 3. 嵌入图片(转换为 Base64,可选)+处理选项:+ embed-icons - 替换 <use data-icon="..."/> 为实际图标 SVG+ embed-images - 将外部图片转换为 Base64 嵌入+ flatten-text - 将 <tspan> 转为独立 <text>(用于特殊渲染器)+ fix-rounded - 将 <rect rx="..."/> 转为 <path>(用于 PPT 转形状)"""import os@@ -30,14 +35,67 @@ from embed_icons import process_svg_file as embed_icons_in_filefrom embed_images import embed_images_in_svg-def finalize_project(project_dir: Path, embed_images: bool = False, dry_run: bool = False):+def safe_print(text):+ """安全打印,处理 Windows 终端编码问题"""+ try:+ print(text)+ except UnicodeEncodeError:+ text = text.replace('✅', '[OK]').replace('❌', '[ERROR]')+ text = text.replace('📁', '[DIR]').replace('📄', '[FILE]')+ print(text)+++def process_flatten_text(svg_file: Path, verbose: bool = False) -> bool:+ """对单个 SVG 文件进行文本扁平化处理(原地修改)"""+ try:+ from flatten_tspan import flatten_text_with_tspans+ from xml.etree import ElementTree as ET++ tree = ET.parse(str(svg_file))+ changed = flatten_text_with_tspans(tree)++ if changed:+ tree.write(str(svg_file), encoding='unicode', xml_declaration=False)+ if verbose:+ safe_print(f" [OK] {svg_file.name}: 文本已扁平化")+ return changed+ except Exception as e:+ if verbose:+ safe_print(f" [ERROR] {svg_file.name}: {e}")+ return False+++def process_rounded_rect(svg_file: Path, verbose: bool = False) -> int:+ """对单个 SVG 文件进行圆角矩形转换(原地修改)"""+ try:+ from svg_rect_to_path import process_svg++ with open(svg_file, 'r', encoding='utf-8') as f:+ content = f.read()++ processed, count = process_svg(content, verbose=False)++ if count > 0:+ with open(svg_file, 'w', encoding='utf-8') as f:+ f.write(processed)+ if verbose:+ safe_print(f" [OK] {svg_file.name}: {count} 个圆角矩形")+ return count+ except Exception as e:+ if verbose:+ safe_print(f" [ERROR] {svg_file.name}: {e}")+ return 0+++def finalize_project(project_dir: Path, options: dict, dry_run: bool = False, quiet: bool = False):"""最终化处理项目中的 SVG 文件Args:project_dir: 项目目录路径- embed_images: 是否嵌入图片(转为 Base64)+ options: 处理选项字典dry_run: 是否仅预览不执行+ quiet: 安静模式,减少输出"""svg_output = project_dir / 'svg_output'svg_final = project_dir / 'svg_final'@@ -45,114 +103,153 @@ def finalize_project(project_dir: Path, embed_images: bool = False, dry_run: boo# 检查 svg_output 是否存在if not svg_output.exists():- print(f"❌ 未找到 svg_output 目录: {svg_output}")+ safe_print(f"[ERROR] 未找到 svg_output 目录: {svg_output}")return False# 获取 SVG 文件列表svg_files = list(svg_output.glob('*.svg'))if not svg_files:- print(f"❌ svg_output 中没有 SVG 文件")+ safe_print(f"[ERROR] svg_output 中没有 SVG 文件")return False- print(f"📁 项目目录: {project_dir}")- print(f"📄 找到 {len(svg_files)} 个 SVG 文件")- print()+ if not quiet:+ print()+ safe_print(f"[DIR] 项目: {project_dir.name}")+ safe_print(f"[FILE] {len(svg_files)} 个 SVG 文件")if dry_run:- print("🔍 预览模式(不执行操作)")- print()- print("将执行以下操作:")- print(f" 1. 复制 svg_output/ → svg_final/")- print(f" 2. 在 svg_final/ 中嵌入图标")- if embed_images:- print(f" 3. 在 svg_final/ 中嵌入图片(Base64)")- print()- print("SVG 文件:")- for f in svg_files:- print(f" - {f.name}")+ safe_print("[PREVIEW] 预览模式,不执行操作")return True# 步骤 1: 复制目录- print("📋 步骤 1/3: 复制 svg_output → svg_final")if svg_final.exists():shutil.rmtree(svg_final)shutil.copytree(svg_output, svg_final)- print(f" ✅ 已复制 {len(svg_files)} 个文件")- print()++ if not quiet:+ print()# 步骤 2: 嵌入图标- print("🎨 步骤 2/3: 嵌入图标")- icons_count = 0- for svg_file in svg_final.glob('*.svg'):- count = embed_icons_in_file(svg_file, icons_dir, dry_run=False, verbose=False)- if count > 0:- print(f" ✅ {svg_file.name}: {count} 个图标")+ if options.get('embed_icons'):+ if not quiet:+ safe_print("[1/4] 嵌入图标...")+ icons_count = 0+ for svg_file in svg_final.glob('*.svg'):+ count = embed_icons_in_file(svg_file, icons_dir, dry_run=False, verbose=False)icons_count += count- if icons_count == 0:- print(" ⏭️ 无图标需要处理")- print()+ if not quiet:+ if icons_count > 0:+ safe_print(f" {icons_count} 个图标已嵌入")+ else:+ safe_print(" 无图标")- # 步骤 3: 嵌入图片(可选)- print("🖼️ 步骤 3/3: 嵌入图片")- if embed_images:+ # 步骤 3: 嵌入图片+ if options.get('embed_images'):+ if not quiet:+ safe_print("[2/4] 嵌入图片...")images_count = 0for svg_file in svg_final.glob('*.svg'):count, _ = embed_images_in_svg(str(svg_file), dry_run=False)- if count > 0:- images_count += count- if images_count == 0:- print(" ⏭️ 无图片需要处理")- else:- print(" ⏭️ 跳过(使用 --embed-images 启用)")- print()+ images_count += count+ if not quiet:+ if images_count > 0:+ safe_print(f" {images_count} 张图片已嵌入")+ else:+ safe_print(" 无图片")++ # 步骤 4: 文本扁平化+ if options.get('flatten_text'):+ if not quiet:+ safe_print("[3/4] 文本扁平化...")+ flatten_count = 0+ for svg_file in svg_final.glob('*.svg'):+ if process_flatten_text(svg_file, verbose=False):+ flatten_count += 1+ if not quiet:+ if flatten_count > 0:+ safe_print(f" {flatten_count} 个文件已处理")+ else:+ safe_print(" 无需处理")++ # 步骤 5: 圆角转 Path+ if options.get('fix_rounded'):+ if not quiet:+ safe_print("[4/4] 圆角转 Path...")+ rounded_count = 0+ for svg_file in svg_final.glob('*.svg'):+ count = process_rounded_rect(svg_file, verbose=False)+ rounded_count += count+ if not quiet:+ if rounded_count > 0:+ safe_print(f" {rounded_count} 个圆角矩形已转换")+ else:+ safe_print(" 无圆角矩形")# 完成- print("=" * 50)- print("✅ 处理完成!")- print()- print(f"📂 原始版本: {svg_output}/")- print(f"📂 最终版本: {svg_final}/")- print()- print("预览最终版本:")- print(f" cd {svg_final} && python3 -m http.server 8000")+ if not quiet:+ print()+ safe_print("[OK] 完成!")+ print()+ print("后续操作:")+ print(f" python tools/svg_to_pptx.py \"{project_dir}\" -s final")return Truedef main():parser = argparse.ArgumentParser(- description='SVG 最终化处理:复制并嵌入图标/图片',+ description='PPT Master - SVG 后处理工具',formatter_class=argparse.RawDescriptionHelpFormatter,epilog='''示例:- %(prog)s projects/my_project # 处理项目- %(prog)s --dry-run projects/my_project # 预览操作- %(prog)s --embed-images projects/xxx # 同时嵌入图片(Base64)--目录结构:- project/- ├── svg_output/ # 原始版本(保留)- ├── svg_final/ # 最终版本(生成)- └── images/ # 图片资源+ %(prog)s projects/my_project # 执行全部处理(默认)+ %(prog)s projects/my_project --only embed-icons fix-rounded+ %(prog)s projects/my_project -q # 安静模式++处理选项(用于 --only):+ embed-icons 嵌入图标+ embed-images 嵌入图片+ flatten-text 文本扁平化+ fix-rounded 圆角转 Path''')parser.add_argument('project_dir', type=Path, help='项目目录路径')- parser.add_argument('--embed-images', action='store_true',- help='同时将图片转换为 Base64 嵌入(默认保持外部引用)')+ parser.add_argument('--only', nargs='+', metavar='OPTION',+ choices=['embed-icons', 'embed-images', 'flatten-text', 'fix-rounded'],+ help='只执行指定的处理(默认执行全部)')parser.add_argument('--dry-run', '-n', action='store_true',help='仅预览操作,不实际执行')+ parser.add_argument('--quiet', '-q', action='store_true',+ help='安静模式,减少输出')args = parser.parse_args()if not args.project_dir.exists():- print(f"❌ 项目目录不存在: {args.project_dir}")+ safe_print(f"[ERROR] 项目目录不存在: {args.project_dir}")sys.exit(1)- success = finalize_project(args.project_dir, args.embed_images, args.dry_run)+ # 确定处理选项+ if args.only:+ # 只执行指定的处理+ options = {+ 'embed_icons': 'embed-icons' in args.only,+ 'embed_images': 'embed-images' in args.only,+ 'flatten_text': 'flatten-text' in args.only,+ 'fix_rounded': 'fix-rounded' in args.only,+ }+ else:+ # 默认执行全部+ options = {+ 'embed_icons': True,+ 'embed_images': True,+ 'flatten_text': True,+ 'fix_rounded': True,+ }++ success = finalize_project(args.project_dir, options, args.dry_run, args.quiet)sys.exit(0 if success else 1)if __name__ == '__main__':main()-diff --git a/tools/flatten_tspan.py b/tools/flatten_tspan.pyindex 881abaeb..70df4a02 100644--- a/tools/flatten_tspan.py+++ b/tools/flatten_tspan.py@@ -176,6 +176,24 @@ def flatten_text_with_tspans(tree: ET.ElementTree) -> bool:if parent is None:continue+ # 先检查是否有任何 tspan 需要扁平化(有 dy 且 dy != 0,或有独立的 y 属性)+ needs_flatten = False+ for child in list(text_el):+ if not is_svg_tag(child, "tspan"):+ continue+ t_dy_attr = get_attr(child, "dy")+ t_y_attr = get_attr(child, "y")+ dy_val = parse_first_number(t_dy_attr) if t_dy_attr is not None else None++ # 如果有 y 属性,或者有非零的 dy,则需要扁平化+ if t_y_attr is not None or (dy_val is not None and dy_val != 0):+ needs_flatten = True+ break++ # 如果没有任何 tspan 需要换行,跳过整个 text 元素+ if not needs_flatten:+ continue+base_x = parse_first_number(get_attr(text_el, "x")) or 0.0base_y = parse_first_number(get_attr(text_el, "y")) or 0.0cur_x, cur_y = base_x, base_y@@ -183,7 +201,7 @@ def flatten_text_with_tspans(tree: ET.ElementTree) -> bool:new_texts = []# Leading text directly under <text>- lead_text = (text_el.text or "").strip("\n")+ lead_text = (text_el.text or "").strip()if lead_text:ne = ET.Element(f"{{{SVG_NS}}}text")# Copy attrs from parent <text>diff --git a/tools/svg_rect_to_path.py b/tools/svg_rect_to_path.pynew file mode 100644index 00000000..2ba367d4--- /dev/null+++ b/tools/svg_rect_to_path.py@@ -0,0 +1,331 @@+#!/usr/bin/env python3+"""+PPT Master - SVG 圆角矩形转 Path 工具++解决 SVG 在 PowerPoint 中「转换为形状」时圆角丢失的问题:+将带 rx/ry 的 <rect> 转换为等效的 <path>++用法:+ python3 tools/svg_rect_to_path.py <SVG文件或目录>+ python3 tools/svg_rect_to_path.py <项目路径> -s output+ python3 tools/svg_rect_to_path.py <项目路径> -s final -o svg_rounded++示例:+ python3 tools/svg_rect_to_path.py examples/ppt169_demo+ python3 tools/svg_rect_to_path.py examples/ppt169_demo/svg_output/01_cover.svg++输出:+ - 目录模式:输出到 svg_rounded/ 子目录+ - 文件模式:输出到 <文件名>_rounded.svg+"""++import sys+import re+import argparse+from pathlib import Path+from typing import Tuple, Dict, List+from xml.etree import ElementTree as ET+++def rect_to_rounded_path(x: float, y: float, width: float, height: float,+ rx: float, ry: float) -> str:+ """+ 将圆角矩形转换为 SVG path 字符串+ 使用椭圆弧命令绘制圆角+ """+ # 限制圆角半径不超过宽高的一半+ rx = min(rx, width / 2)+ ry = min(ry, height / 2)++ # 计算关键点+ x1 = x + rx+ x2 = x + width - rx+ y1 = y + ry+ y2 = y + height - ry++ # 构建 path+ path = (+ f"M{x1:.2f},{y:.2f} "+ f"H{x2:.2f} "+ f"A{rx:.2f},{ry:.2f} 0 0 1 {x + width:.2f},{y1:.2f} "+ f"V{y2:.2f} "+ f"A{rx:.2f},{ry:.2f} 0 0 1 {x2:.2f},{y + height:.2f} "+ f"H{x1:.2f} "+ f"A{rx:.2f},{ry:.2f} 0 0 1 {x:.2f},{y2:.2f} "+ f"V{y1:.2f} "+ f"A{rx:.2f},{ry:.2f} 0 0 1 {x1:.2f},{y:.2f} "+ f"Z"+ )++ # 清理多余的小数+ path = re.sub(r'\.00(?=\s|,|[A-Za-z]|$)', '', path)++ return path+++def parse_float(val: str, default: float = 0.0) -> float:+ """安全解析浮点数"""+ if not val:+ return default+ try:+ # 移除单位+ val = re.sub(r'(px|pt|em|%|rem)$', '', val.strip())+ return float(val)+ except ValueError:+ return default+++def process_svg(content: str, verbose: bool = False) -> Tuple[str, int]:+ """+ 处理 SVG 内容,将圆角矩形转换为 path+ 返回 (处理后的内容, 转换数量)+ """+ converted_count = 0++ # 保存原始 XML 声明+ xml_declaration = ''+ if content.strip().startswith('<?xml'):+ match = re.match(r'(<\?xml[^?]*\?>)', content)+ if match:+ xml_declaration = match.group(1) + '\n'++ # 注册 SVG 命名空间+ ET.register_namespace('', 'http://www.w3.org/2000/svg')+ ET.register_namespace('xlink', 'http://www.w3.org/1999/xlink')++ try:+ root = ET.fromstring(content)+ except ET.ParseError as e:+ if verbose:+ print(f" XML 解析错误: {e}")+ return content, 0++ # 获取默认命名空间+ ns = ''+ if root.tag.startswith('{'):+ ns = root.tag.split('}')[0] + '}'++ def get_tag_name(tag):+ """获取不带命名空间的标签名"""+ if tag.startswith('{'):+ return tag.split('}')[1]+ return tag++ def process_element(elem):+ """处理单个元素"""+ nonlocal converted_count+ tag_name = get_tag_name(elem.tag)++ # 处理圆角矩形+ if tag_name == 'rect':+ rx = parse_float(elem.get('rx', '0'))+ ry = parse_float(elem.get('ry', '0'))++ # 如果只指定了一个,另一个取相同值+ if rx == 0 and ry > 0:+ rx = ry+ elif ry == 0 and rx > 0:+ ry = rx++ if rx > 0 or ry > 0:+ x = parse_float(elem.get('x', '0'))+ y = parse_float(elem.get('y', '0'))+ width = parse_float(elem.get('width', '0'))+ height = parse_float(elem.get('height', '0'))++ if width > 0 and height > 0:+ # 生成 path+ path_d = rect_to_rounded_path(x, y, width, height, rx, ry)++ # rect 特有属性+ rect_attrs = {'x', 'y', 'width', 'height', 'rx', 'ry'}++ # 修改元素为 path+ elem.tag = ns + 'path' if ns else 'path'+ elem.set('d', path_d)++ # 移除 rect 特有属性+ for attr in rect_attrs:+ if attr in elem.attrib:+ del elem.attrib[attr]++ converted_count += 1+ if verbose:+ print(f" 转换圆角矩形: rx={rx}, ry={ry}")++ # 递归处理子元素+ for child in elem:+ process_element(child)++ # 处理所有元素+ process_element(root)++ # 转换回字符串+ result = ET.tostring(root, encoding='unicode')++ # 添加 XML 声明(如果原来有的话)+ if xml_declaration:+ result = xml_declaration + result++ return result, converted_count+++def process_svg_file(input_path: Path, output_path: Path, verbose: bool = False) -> Tuple[bool, int]:+ """处理单个 SVG 文件"""+ try:+ with open(input_path, 'r', encoding='utf-8') as f:+ content = f.read()++ processed, count = process_svg(content, verbose)++ # 确保输出目录存在+ output_path.parent.mkdir(parents=True, exist_ok=True)++ with open(output_path, 'w', encoding='utf-8') as f:+ f.write(processed)++ return True, count++ except Exception as e:+ if verbose:+ print(f" 错误: {e}")+ return False, 0+++def find_svg_files(project_path: Path, source: str = 'output') -> Tuple[List[Path], str]:+ """查找项目中的 SVG 文件"""+ dir_map = {+ 'output': 'svg_output',+ 'final': 'svg_final',+ 'flat': 'svg_output_flattext',+ 'final_flat': 'svg_final_flattext',+ }++ dir_name = dir_map.get(source, source)+ svg_dir = project_path / dir_name++ if not svg_dir.exists():+ if (project_path / 'svg_output').exists():+ dir_name = 'svg_output'+ svg_dir = project_path / dir_name+ elif project_path.is_dir():+ svg_dir = project_path+ dir_name = project_path.name++ if not svg_dir.exists():+ return [], ''++ return sorted(svg_dir.glob('*.svg')), dir_name+++def main():+ parser = argparse.ArgumentParser(+ description='PPT Master - SVG 圆角矩形转 Path 工具',+ formatter_class=argparse.RawDescriptionHelpFormatter,+ epilog='''+示例:+ %(prog)s examples/ppt169_demo+ %(prog)s examples/ppt169_demo -s final+ %(prog)s examples/ppt169_demo/svg_output/01_cover.svg++处理内容:+ 将带 rx/ry 的 <rect> 转换为等效的 <path>+ 处理后的 SVG 在 PowerPoint 中「转换为形状」时能保留圆角+'''+ )++ parser.add_argument('path', type=str, help='SVG 文件或项目目录路径')+ parser.add_argument('-s', '--source', type=str, default='output',+ help='SVG 来源: output/final/flat/final_flat 或子目录名 (默认: output)')+ parser.add_argument('-o', '--output', type=str, default='svg_rounded',+ help='输出目录名 (默认: svg_rounded)')+ parser.add_argument('-v', '--verbose', action='store_true', help='详细输出')+ parser.add_argument('-q', '--quiet', action='store_true', help='静默模式')++ args = parser.parse_args()++ input_path = Path(args.path)++ if not input_path.exists():+ print(f"错误: 路径不存在: {input_path}")+ sys.exit(1)++ verbose = args.verbose and not args.quiet+ quiet = args.quiet++ if not quiet:+ print("PPT Master - SVG 圆角矩形转 Path 工具")+ print("=" * 50)++ total_converted = 0++ if input_path.is_file() and input_path.suffix.lower() == '.svg':+ # 单文件模式+ output_path = input_path.with_stem(input_path.stem + '_rounded')++ if not quiet:+ print(f" 输入: {input_path}")+ print(f" 输出: {output_path}")+ print()++ success, count = process_svg_file(input_path, output_path, verbose)+ total_converted = count++ if success:+ if not quiet:+ print(f"[完成] 已保存: {output_path}")+ else:+ print(f"[失败] 处理失败")+ sys.exit(1)++ else:+ # 目录/项目模式+ svg_files, source_dir = find_svg_files(input_path, args.source)++ if not svg_files:+ print("错误: 未找到 SVG 文件")+ sys.exit(1)++ output_dir = input_path / args.output++ if not quiet:+ print(f" 项目路径: {input_path}")+ print(f" SVG 来源: {source_dir}")+ print(f" 输出目录: {args.output}")+ print(f" 文件数量: {len(svg_files)}")+ print()++ success_count = 0+ for i, svg_file in enumerate(svg_files, 1):+ output_path = output_dir / svg_file.name++ if verbose:+ print(f" [{i}/{len(svg_files)}] {svg_file.name}")++ success, count = process_svg_file(svg_file, output_path, verbose)++ if success:+ success_count += 1+ total_converted += count+ if not verbose and not quiet:+ print(f" [{i}/{len(svg_files)}] {svg_file.name} OK")+ else:+ if not quiet:+ print(f" [{i}/{len(svg_files)}] {svg_file.name} FAILED")++ if not quiet:+ print()+ print(f"[完成] 成功: {success_count}/{len(svg_files)}")+ print(f" 输出目录: {output_dir}")++ # 显示统计+ if not quiet:+ print()+ print(f"转换统计: 圆角矩形 -> path: {total_converted} 个")++ sys.exit(0)+++if __name__ == '__main__':+ main()+diff --git a/tools/svg_to_pptx.py b/tools/svg_to_pptx.pyindex 535a3e87..d285a1ca 100644--- a/tools/svg_to_pptx.py+++ b/tools/svg_to_pptx.py@@ -132,10 +132,8 @@ def find_svg_files(project_path: Path, source: str = 'output') -> Tuple[List[PatArgs:project_path: 项目目录路径source: SVG 来源目录- - 'output': svg_output(默认,原始版本)- - 'final': svg_final(带嵌入图标/图片)- - 'flat': svg_output_flattext(扁平化文本)- - 'final_flat': svg_final_flattext(最终版+扁平化)+ - 'output': svg_output(原始版本)+ - 'final': svg_final(后处理完成,推荐)- 或任意子目录名称Returns:@@ -145,8 +143,6 @@ def find_svg_files(project_path: Path, source: str = 'output') -> Tuple[List[Patdir_map = {'output': 'svg_output','final': 'svg_final',- 'flat': 'svg_output_flattext',- 'final_flat': 'svg_final_flattext',}# 获取目录名(支持预定义别名或直接指定目录名)@@ -362,17 +358,14 @@ def main():formatter_class=argparse.RawDescriptionHelpFormatter,epilog='''示例:- %(prog)s examples/ppt169_demo- %(prog)s examples/ppt169_demo -s final- %(prog)s examples/ppt169_demo -s my_custom_folder+ %(prog)s examples/ppt169_demo -s final # 推荐:使用后处理完成的版本+ %(prog)s examples/ppt169_demo # 使用原始版本%(prog)s examples/ppt169_demo -o presentation.pptxSVG 来源目录 (-s):- output - svg_output(默认,原始版本)- final - svg_final(带嵌入图标/图片)- flat - svg_output_flattext(扁平化文本)- final_flat - svg_final_flattext(最终版+扁平化)- <任意名> - 直接指定项目下的子目录名+ output - svg_output(原始版本)+ final - svg_final(后处理完成,推荐)+ <任意名> - 直接指定项目下的子目录名特点:- SVG 以原生矢量格式嵌入,保持可编辑性@@ -383,7 +376,7 @@ SVG 来源目录 (-s):parser.add_argument('project_path', type=str, help='项目目录路径')parser.add_argument('-o', '--output', type=str, default=None, help='输出文件路径')parser.add_argument('-s', '--source', type=str, default='output',- help='SVG 来源: output/final/flat/final_flat 或任意子目录名')+ help='SVG 来源: output/final 或任意子目录名 (推荐 final)')parser.add_argument('-f', '--format', type=str, choices=list(CANVAS_FORMATS.keys()), default=None, help='指定画布格式')parser.add_argument('-q', '--quiet', action='store_true', help='静默模式')