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

优化SVG后处理工具,支持嵌入图标、图片、文本扁平化及圆角转Path功能。更新相关文档以提升用户体验和可读性。优化示例项目的final_svg及输出ppt文件。

hugohe3bcbceafc2973
diff --git a/AGENTS.md b/AGENTS.md
index 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.md
index 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 --export
python3 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.md
index 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.md
index 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.md
index 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.svg
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 output # svg_output(原始版本)
+python3 tools/svg_to_pptx.py <项目路径> -s final # svg_final(推荐)
# 指定输出文件
python3 tools/svg_to_pptx.py <项目路径> -o presentation.pptx
diff --git a/docs/workflow_tutorial.md b/docs/workflow_tutorial.md
index 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_output
python3 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.md
index 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.md
index 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(自定义输出路径)
+# 处理单个 SVG
python3 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_demo
python3 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-pptx
3. **生成 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.py
index 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 0
content = 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, ver
if not matches:
if verbose:
- print(f"⏭️ 无图标占位符: {svg_path}")
+ print(f"[SKIP] 无图标占位符: {svg_path}")
return 0
replaced_count = 0
@@ -175,13 +175,13 @@ def process_svg_file(svg_path: Path, icons_dir: Path, dry_run: bool = False, ver
paths = 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})")
continue
replacement = 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, ver
if 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 = 0
diff --git a/tools/embed_images.py b/tools/embed_images.py
index 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_path
if 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 = 0
total_files = 0
for 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}")
continue
if not svg_file.endswith('.svg'):
- print(f"⏭️ Skipping non-SVG file: {svg_file}")
+ print(f"[SKIP] Skipping non-SVG file: {svg_file}")
continue
images, _ = 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.py
index 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_file
from 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 = 0
for 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 True
def 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.py
index 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.0
base_y = parse_first_number(get_attr(text_el, "y")) or 0.0
cur_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.py
new file mode 100644
index 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.py
index 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[Pat
Args:
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[Pat
dir_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.pptx
SVG 来源目录 (-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='静默模式')