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转PPTX工具,支持批量将SVG文件转换为PowerPoint演示文稿,保持矢量图形的可编辑性。更新相关文档以反映新功能和使用指南,优化后处理工具的说明,提升用户体验。
hugohe381a912df670f
diff --git a/AGENTS.md b/AGENTS.mdindex a8fbf8b7..7ab74e1b 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -83,13 +83,29 @@ python3 -m http.server --directory <路径>/svg_output 8000python3 -m http.server --directory <路径>/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 # 使用最终+扁平化版本+```+### 项目目录结构```project/-├── svg_output/ # 原始版本(带占位符,作为模板参考)-├── svg_final/ # 最终版本(嵌入图标/图片后)-└── images/ # 图片资源+├── svg_output/ # 原始版本(带占位符,作为模板参考)+├── svg_final/ # 最终版本(嵌入图标/图片后)+├── svg_output_flattext/ # 扁平化版本(可选)+├── svg_final_flattext/ # 最终+扁平化版本(可选)+├── images/ # 图片资源+└── *.pptx # 导出的 PPT 文件(可选)```## 质量检查清单@@ -129,3 +145,13 @@ project/- 图标使用方式需在初次沟通中确认(Emoji / AI生成 / 内置库 / 自定义)- 图片使用方式需在初次沟通中确认(不使用 / 用户提供 / AI生成 / 占位符)- **SVG 生成不阻塞**:外部资源(AI 生成图片、用户提供图片)使用占位符或链接,生成完成后再处理++### 后处理提示++SVG 生成完成后,用户可能需要进行后处理:++- **最终化处理**: `python3 tools/finalize_svg.py <项目路径>` - 嵌入图标/图片+- **文本扁平化**: `python3 tools/flatten_tspan.py <目录>` - 将 `<tspan>` 转为独立 `<text>`(用于特殊渲染器)+- **导出 PPTX**: `python3 tools/svg_to_pptx.py <项目路径>` - 生成 PowerPoint 文件(原生 SVG 矢量嵌入)++这些工具由用户自行调用,AI 代理无需直接执行。diff --git a/README.md b/README.mdindex 3f78e1fd..9043d5be 100644--- a/README.md+++ b/README.md@@ -472,7 +472,8 @@ ppt-master/│ ├── finalize_svg.py # 最终化处理(嵌入图标/图片)│ ├── embed_icons.py # 图标嵌入工具│ ├── embed_images.py # 图片嵌入工具-│ └── flatten_tspan.py # tspan扁平化工具+│ ├── flatten_tspan.py # tspan扁平化工具+│ └── svg_to_pptx.py # SVG转PPTX工具(原生矢量嵌入)│└── projects/ # 用户项目工作区(进行中的项目)└── <your_project_name>_<YYYYMMDD>/@@ -737,6 +738,26 @@ python3 tools/flatten_tspan.py input.svg output.svg**注意**:生成阶段仍应使用 `<tspan>` 手动换行,此工具仅用于后处理。+### SVG 转 PPTX 工具 (`svg_to_pptx.py`)++将 SVG 文件批量转换为 PowerPoint 演示文稿(原生 SVG 矢量嵌入):++```bash+# 基本用法(使用 svg_output 目录)+python3 tools/svg_to_pptx.py <项目路径>++# 指定 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 <项目路径> -o output.pptx+```++**特点**:SVG 以原生矢量格式嵌入,保持可编辑性,需要 PowerPoint 2016+ 查看。+### 错误消息助手 (`error_helper.py`)提供友好的错误消息和具体的修复建议:diff --git a/docs/quick_reference.md b/docs/quick_reference.mdindex 6dd51237..8605f9b1 100644--- a/docs/quick_reference.md+++ b/docs/quick_reference.md@@ -385,27 +385,48 @@ yh_slide_02_kpi_dashboard.svg3. **保存版本**: 重要迭代保存独立版本4. **团队共享**: 建立团队的设计规范库-## 🔧 后处理:文本扁平化(去 tspan)+## 🔧 后处理工具++### 最终化处理(嵌入图标/图片)++```bash+# 一键处理(复制 + 嵌入图标)+python3 tools/finalize_svg.py <项目路径>++# 同时嵌入图片(转 Base64)+python3 tools/finalize_svg.py <项目路径> --embed-images+```++### 文本扁平化(去 tspan)```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+# 目录级扁平化(输出到 svg_output_flattext)+python3 tools/flatten_tspan.py <项目路径>/svg_output-# 单文件扁平化(自定义输出路径)-python3 tools/flatten_tspan.py path/to/input.svg path/to/output.svg+# 单文件扁平化+python3 tools/flatten_tspan.py input.svg output.svg```-默认输出:-- 目录输入:若路径以 `svg_output` 结尾,输出到同级 `svg_output_flattext`;否则为 `<目录>_flattext`-- 文件输入:输出为 `<文件名>_flattext.svg`+### 导出为 PPTX(推荐)++```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 <项目路径> -o presentation.pptx+```-要点:生成端使用 `<tspan>` 手动换行,发布/抽取文本时可运行本工具去除 `<tspan>`;输出应无 `<tspan>` 残留且样式/坐标一致。+**特点**:SVG 以原生矢量格式嵌入,需要 PowerPoint 2016+ 查看。---diff --git a/docs/workflow_tutorial.md b/docs/workflow_tutorial.mdindex 98abfdbb..e0242a70 100644--- a/docs/workflow_tutorial.md+++ b/docs/workflow_tutorial.md@@ -117,17 +117,38 @@│ └────────────┬───────────┘│ │└──────────────────┬───────────────┘- │- ▼- ┌────────────────────────┐- │ 最终输出 │- │ ┌──────────────────┐ │- │ │ svg_output/ │ │- │ │ ├── slide_01.svg │ │- │ │ ├── slide_02.svg │ │- │ │ └── ... │ │- │ └──────────────────┘ │- └────────────────────────┘+ │+ ▼+ ┌────────────────────────┐+ │ SVG 输出 │+ │ ┌──────────────────┐ │+ │ │ svg_output/ │ │+ │ │ ├── slide_01.svg │ │+ │ │ ├── slide_02.svg │ │+ │ │ └── ... │ │+ │ └──────────────────┘ │+ └────────────┬───────────┘+ │+ ┌────────────────┴────────────────┐+ │ 后处理(可选) │+ ▼ ▼+ ┌─────────────────────┐ ┌─────────────────────┐+ │ finalize_svg.py │ │ flatten_tspan.py │+ │ 嵌入图标/图片 │ │ 文本扁平化 │+ │ → svg_final/ │ │ → svg_output_flat/ │+ └─────────────────────┘ └─────────────────────┘+ │ │+ └────────────────┬─────────────────┘+ │+ ▼+ ┌────────────────────────┐+ │ 导出 PPTX(可选) │+ │ ┌──────────────────┐ │+ │ │ svg_to_pptx.py │ │+ │ │ → output.pptx │ │+ │ │ 原生 SVG 矢量嵌入 │ │+ │ └──────────────────┘ │+ └────────────────────────┘```### 流程要点说明@@ -479,8 +500,33 @@ Optimizer_CRAP:- 在浏览器中逐页查看- 检查一致性和质量-3. **转换格式(可选)**- - 转为 PNG 用于 PowerPoint+3. **后处理(可选)**++ ```bash+ # 最终化处理(嵌入图标/图片)+ python3 tools/finalize_svg.py <项目路径>++ # 文本扁平化(用于特殊渲染器)+ python3 tools/flatten_tspan.py <项目路径>/svg_output+ ```++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+ ```++ 生成的 PPTX 文件中,SVG 以原生矢量格式嵌入,需要 PowerPoint 2016+ 查看。++5. **其他格式转换**+ - 转为 PNG 用于其他演示软件- 转为 PDF 用于打印- 保留 SVG 用于后续编辑diff --git a/requirements.txt b/requirements.txtnew file mode 100644index 00000000..db27336d--- /dev/null+++ b/requirements.txt@@ -0,0 +1,14 @@+# PPT Master 依赖+# ================+#+# 大部分工具仅使用 Python 标准库,以下为可选依赖。+#+# 安装方式:+# pip install -r requirements.txt++# ─────────────────────────────────────────────────────────────+# SVG 转 PPTX 工具 (tools/svg_to_pptx.py)+# ─────────────────────────────────────────────────────────────+# 用于将 SVG 文件批量转换为 PowerPoint 演示文稿+# SVG 以原生矢量格式嵌入,需要 PowerPoint 2016+ 查看+python-pptx>=0.6.21diff --git a/roles/README.md b/roles/README.mdindex b250a575..5c45d930 100644--- a/roles/README.md+++ b/roles/README.md@@ -33,7 +33,12 @@[Optimizer_CRAP] 优化师 (可选)↓ CRAP原则优化↓-最终SVG演示文稿+SVG 文件 (svg_output/)+ ↓+后处理工具 (可选,用户自行调用)+ ├── finalize_svg.py → svg_final/ (嵌入图标/图片)+ ├── flatten_tspan.py → svg_output_flattext/ (文本扁平化)+ └── svg_to_pptx.py → output.pptx (导出 PowerPoint)```## 角色详解diff --git a/tools/README.md b/tools/README.mdindex f4e168bb..5df2eb08 100644--- a/tools/README.md+++ b/tools/README.md@@ -276,6 +276,80 @@ python3 tools/svg_quality_checker.py examples/project --export---+### 8. svg_to_pptx.py — SVG 转 PPTX 工具++将项目中的 SVG 文件批量转换为 PowerPoint 演示文稿,保留矢量图形的可编辑性。++**功能**:++- 批量将 SVG 转换为 PPTX+- 每个 SVG 对应一张幻灯片+- 自动检测画布格式并设置幻灯片尺寸+- 支持使用 svg_output 或 svg_final 目录+- SVG 在 PowerPoint 中保持可编辑++**用法**:++```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 my_custom_folder++# 指定输出文件+python3 tools/svg_to_pptx.py <项目路径> -o output.pptx++# 静默模式+python3 tools/svg_to_pptx.py <项目路径> -q+```++**SVG 来源目录 (`-s`)**:++| 参数 | 目录 | 说明 |+|------|------|------|+| `-s output` | `svg_output/` | 原始版本(默认) |+| `-s final` | `svg_final/` | 带嵌入图标/图片 |+| `-s flat` | `svg_output_flattext/` | 扁平化文本 |+| `-s final_flat` | `svg_final_flattext/` | 最终版+扁平化 |+| `-s <任意名>` | `<任意名>/` | 直接指定子目录 |++**示例**:++```bash+# 使用原始版本+python3 tools/svg_to_pptx.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+```++**依赖**:++```bash+pip install python-pptx+```++**注意**:++- SVG 以原生矢量格式嵌入,保持可编辑性+- 需要 PowerPoint 2016+ 才能正确显示+- 文件体积比 PNG 方案小很多++---+## 工作流集成### 典型工作流程@@ -312,10 +386,17 @@ python3 tools/svg_quality_checker.py examples/project --export```7. **更新索引**(如果是 examples 目录)+```bashpython3 tools/generate_examples_index.py```+8. **导出为 PPTX**++ ```bash+ python3 tools/svg_to_pptx.py projects/my_project_ppt169_20251116+ ```+### 批量操作**批量验证项目**:@@ -340,10 +421,22 @@ python3 tools/svg_quality_checker.py --all examples --export## 依赖要求-所有工具均使用 Python 3 标准库,无需额外依赖。+大部分工具使用 Python 3 标准库,无需额外依赖。**最低 Python 版本**: Python 3.6++**可选依赖**:++- `python-pptx` — SVG 转 PPTX 功能需要++安装依赖:++```bash+pip install -r requirements.txt+# 或单独安装+pip install python-pptx+```+## 故障排除### 问题:项目验证失败@@ -370,4 +463,4 @@ python3 tools/svg_quality_checker.py --all examples --export----_最后更新: 2025-11-16_+_最后更新: 2025-12-12_diff --git a/tools/svg_to_pptx.py b/tools/svg_to_pptx.pynew file mode 100644index 00000000..535a3e87--- /dev/null+++ b/tools/svg_to_pptx.py@@ -0,0 +1,442 @@+#!/usr/bin/env python3+"""+PPT Master - SVG 转 PPTX 工具++将项目中的 SVG 文件批量转换为 PowerPoint 演示文稿。+每个 SVG 文件对应一张幻灯片,SVG 以原生矢量格式嵌入。++用法:+ python3 tools/svg_to_pptx.py <项目路径>+ python3 tools/svg_to_pptx.py <项目路径> -o output.pptx+ python3 tools/svg_to_pptx.py <项目路径> --use-final++示例:+ python3 tools/svg_to_pptx.py examples/ppt169_demo+ python3 tools/svg_to_pptx.py examples/ppt169_demo -o presentation.pptx+ python3 tools/svg_to_pptx.py examples/ppt169_demo --use-final++依赖:+ pip install python-pptx++注意:+ - SVG 以原生矢量格式嵌入,保持可编辑性+ - 需要 PowerPoint 2016+ 才能正确显示+"""++import sys+import os+import argparse+import re+import zipfile+import shutil+import tempfile+from pathlib import Path+from typing import Optional, Tuple, List+from xml.etree import ElementTree as ET++# 检查 python-pptx 是否已安装+try:+ from pptx import Presentation+ from pptx.util import Emu+except ImportError:+ print("错误: 缺少 python-pptx 库")+ print("请运行: pip install python-pptx")+ sys.exit(1)++# 导入项目工具模块+sys.path.insert(0, str(Path(__file__).parent))+try:+ from project_utils import get_project_info, CANVAS_FORMATS+except ImportError:+ CANVAS_FORMATS = {+ 'ppt169': {'name': 'PPT 16:9', 'dimensions': '1280x720', 'viewbox': '0 0 1280 720'},+ 'ppt43': {'name': 'PPT 4:3', 'dimensions': '1024x768', 'viewbox': '0 0 1024 768'},+ 'wechat': {'name': '微信公众号头图', 'dimensions': '900x383', 'viewbox': '0 0 900 383'},+ 'xiaohongshu': {'name': '小红书', 'dimensions': '1242x1660', 'viewbox': '0 0 1242 1660'},+ 'moments': {'name': '朋友圈/Instagram', 'dimensions': '1080x1080', 'viewbox': '0 0 1080 1080'},+ 'story': {'name': 'Story/竖版', 'dimensions': '1080x1920', 'viewbox': '0 0 1080 1920'},+ 'banner': {'name': '横版 Banner', 'dimensions': '1920x1080', 'viewbox': '0 0 1920 1080'},+ 'a4': {'name': 'A4 打印', 'dimensions': '1240x1754', 'viewbox': '0 0 1240 1754'},+ }++ def get_project_info(path):+ return {'format': 'unknown', 'name': Path(path).name}+++# EMU 转换常量+EMU_PER_INCH = 914400+EMU_PER_PIXEL = EMU_PER_INCH / 96++# XML 命名空间+NAMESPACES = {+ 'a': 'http://schemas.openxmlformats.org/drawingml/2006/main',+ 'r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',+ 'p': 'http://schemas.openxmlformats.org/presentationml/2006/main',+ 'asvg': 'http://schemas.microsoft.com/office/drawing/2016/SVG/main',+}++# 注册命名空间+for prefix, uri in NAMESPACES.items():+ ET.register_namespace(prefix, uri)+++def get_slide_dimensions(canvas_format: str) -> Tuple[int, int]:+ """获取幻灯片尺寸(EMU 单位)"""+ if canvas_format not in CANVAS_FORMATS:+ canvas_format = 'ppt169'++ dimensions = CANVAS_FORMATS[canvas_format]['dimensions']+ match = re.match(r'(\d+)[×x](\d+)', dimensions)+ if match:+ width_px = int(match.group(1))+ height_px = int(match.group(2))+ else:+ width_px, height_px = 1280, 720++ return int(width_px * EMU_PER_PIXEL), int(height_px * EMU_PER_PIXEL)+++def get_pixel_dimensions(canvas_format: str) -> Tuple[int, int]:+ """获取画布像素尺寸"""+ if canvas_format not in CANVAS_FORMATS:+ canvas_format = 'ppt169'++ dimensions = CANVAS_FORMATS[canvas_format]['dimensions']+ match = re.match(r'(\d+)[×x](\d+)', dimensions)+ if match:+ return int(match.group(1)), int(match.group(2))+ return 1280, 720+++def detect_format_from_svg(svg_path: Path) -> Optional[str]:+ """从 SVG 文件的 viewBox 检测画布格式"""+ try:+ with open(svg_path, 'r', encoding='utf-8') as f:+ content = f.read(2000)++ match = re.search(r'viewBox="([^"]+)"', content)+ if match:+ viewbox = match.group(1)+ for fmt_key, fmt_info in CANVAS_FORMATS.items():+ if fmt_info['viewbox'] == viewbox:+ return fmt_key+ except Exception:+ pass+ return None+++def find_svg_files(project_path: Path, source: str = 'output') -> Tuple[List[Path], str]:+ """+ 查找项目中的 SVG 文件++ Args:+ project_path: 项目目录路径+ source: SVG 来源目录+ - 'output': svg_output(默认,原始版本)+ - 'final': svg_final(带嵌入图标/图片)+ - 'flat': svg_output_flattext(扁平化文本)+ - 'final_flat': svg_final_flattext(最终版+扁平化)+ - 或任意子目录名称++ Returns:+ (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():+ print(f" 警告: {dir_name} 目录不存在,尝试 svg_output")+ dir_name = 'svg_output'+ svg_dir = project_path / dir_name++ if not svg_dir.exists():+ # 直接在指定目录查找+ if project_path.is_dir():+ svg_dir = project_path+ dir_name = project_path.name+ else:+ return [], ''++ return sorted(svg_dir.glob('*.svg')), dir_name+++def create_slide_xml_with_svg(slide_num: int, svg_rid: str, width_emu: int, height_emu: int) -> str:+ """创建包含 SVG 图片的幻灯片 XML"""+ return f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>+<p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"+ xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"+ xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">+ <p:cSld>+ <p:spTree>+ <p:nvGrpSpPr>+ <p:cNvPr id="1" name=""/>+ <p:cNvGrpSpPr/>+ <p:nvPr/>+ </p:nvGrpSpPr>+ <p:grpSpPr>+ <a:xfrm>+ <a:off x="0" y="0"/>+ <a:ext cx="0" cy="0"/>+ <a:chOff x="0" y="0"/>+ <a:chExt cx="0" cy="0"/>+ </a:xfrm>+ </p:grpSpPr>+ <p:pic>+ <p:nvPicPr>+ <p:cNvPr id="2" name="SVG Image {slide_num}"/>+ <p:cNvPicPr>+ <a:picLocks noChangeAspect="1"/>+ </p:cNvPicPr>+ <p:nvPr/>+ </p:nvPicPr>+ <p:blipFill>+ <a:blip r:embed="{svg_rid}"/>+ <a:stretch>+ <a:fillRect/>+ </a:stretch>+ </p:blipFill>+ <p:spPr>+ <a:xfrm>+ <a:off x="0" y="0"/>+ <a:ext cx="{width_emu}" cy="{height_emu}"/>+ </a:xfrm>+ <a:prstGeom prst="rect">+ <a:avLst/>+ </a:prstGeom>+ </p:spPr>+ </p:pic>+ </p:spTree>+ </p:cSld>+ <p:clrMapOvr>+ <a:masterClrMapping/>+ </p:clrMapOvr>+</p:sld>'''+++def create_slide_rels_xml(svg_rid: str, svg_filename: str) -> str:+ """创建幻灯片关系文件 XML"""+ return f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">+ <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout1.xml"/>+ <Relationship Id="{svg_rid}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/{svg_filename}"/>+</Relationships>'''+++def create_pptx_with_native_svg(+ svg_files: List[Path],+ output_path: Path,+ canvas_format: Optional[str] = None,+ verbose: bool = True+) -> bool:+ """创建包含原生 SVG 的 PPTX 文件"""+ if not svg_files:+ print("错误: 没有找到 SVG 文件")+ return False++ # 自动检测画布格式+ if canvas_format is None:+ canvas_format = detect_format_from_svg(svg_files[0])+ if canvas_format and verbose:+ format_name = CANVAS_FORMATS.get(canvas_format, {}).get('name', canvas_format)+ print(f" 检测到画布格式: {format_name}")++ if canvas_format is None:+ canvas_format = 'ppt169'+ if verbose:+ print(f" 使用默认格式: PPT 16:9")++ width_emu, height_emu = get_slide_dimensions(canvas_format)+ pixel_width, pixel_height = get_pixel_dimensions(canvas_format)++ if verbose:+ print(f" 幻灯片尺寸: {pixel_width} x {pixel_height} px")+ print(f" SVG 文件数: {len(svg_files)}")+ print()++ # 创建临时目录+ temp_dir = Path(tempfile.mkdtemp())++ try:+ # 首先用 python-pptx 创建基础 PPTX+ prs = Presentation()+ prs.slide_width = width_emu+ prs.slide_height = height_emu++ # 添加空白幻灯片作为占位+ blank_layout = prs.slide_layouts[6]+ for _ in svg_files:+ prs.slides.add_slide(blank_layout)++ # 保存基础 PPTX+ base_pptx = temp_dir / 'base.pptx'+ prs.save(str(base_pptx))++ # 解压 PPTX+ extract_dir = temp_dir / 'pptx_content'+ with zipfile.ZipFile(base_pptx, 'r') as zf:+ zf.extractall(extract_dir)++ # 创建 media 目录+ media_dir = extract_dir / 'ppt' / 'media'+ media_dir.mkdir(exist_ok=True)++ # 处理每个 SVG 文件+ success_count = 0+ for i, svg_path in enumerate(svg_files, 1):+ slide_num = i+ svg_filename = f'image{i}.svg'+ svg_rid = 'rId2'++ try:+ # 复制 SVG 到 media 目录+ shutil.copy(svg_path, media_dir / svg_filename)++ # 更新幻灯片 XML+ slide_xml_path = extract_dir / 'ppt' / 'slides' / f'slide{slide_num}.xml'+ slide_xml = create_slide_xml_with_svg(slide_num, svg_rid, width_emu, height_emu)+ with open(slide_xml_path, 'w', encoding='utf-8') as f:+ f.write(slide_xml)++ # 创建/更新关系文件+ rels_dir = extract_dir / 'ppt' / 'slides' / '_rels'+ rels_dir.mkdir(exist_ok=True)+ rels_path = rels_dir / f'slide{slide_num}.xml.rels'+ rels_xml = create_slide_rels_xml(svg_rid, svg_filename)+ with open(rels_path, 'w', encoding='utf-8') as f:+ f.write(rels_xml)++ if verbose:+ print(f" [{i}/{len(svg_files)}] {svg_path.name}")++ success_count += 1++ except Exception as e:+ if verbose:+ print(f" [{i}/{len(svg_files)}] {svg_path.name} - 错误: {e}")++ # 更新 [Content_Types].xml 添加 SVG 类型+ content_types_path = extract_dir / '[Content_Types].xml'+ with open(content_types_path, 'r', encoding='utf-8') as f:+ content_types = f.read()++ # 添加 SVG 扩展类型(如果不存在)+ if 'Extension="svg"' not in content_types:+ content_types = content_types.replace(+ '</Types>',+ ' <Default Extension="svg" ContentType="image/svg+xml"/>\n</Types>'+ )+ with open(content_types_path, 'w', encoding='utf-8') as f:+ f.write(content_types)++ # 重新打包 PPTX+ with zipfile.ZipFile(output_path, 'w', zipfile.ZIP_DEFLATED) as zf:+ for file_path in extract_dir.rglob('*'):+ if file_path.is_file():+ arcname = file_path.relative_to(extract_dir)+ zf.write(file_path, arcname)++ if verbose:+ print()+ print(f"[完成] 已保存: {output_path}")+ print(f" 成功: {success_count}, 失败: {len(svg_files) - success_count}")++ return success_count == len(svg_files)++ finally:+ # 清理临时目录+ shutil.rmtree(temp_dir, ignore_errors=True)+++def main():+ parser = argparse.ArgumentParser(+ description='PPT Master - SVG 转 PPTX 工具(原生 SVG 嵌入)',+ 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 -o presentation.pptx++SVG 来源目录 (-s):+ output - svg_output(默认,原始版本)+ final - svg_final(带嵌入图标/图片)+ flat - svg_output_flattext(扁平化文本)+ final_flat - svg_final_flattext(最终版+扁平化)+ <任意名> - 直接指定项目下的子目录名++特点:+ - SVG 以原生矢量格式嵌入,保持可编辑性+ - 需要 PowerPoint 2016+ 查看+'''+ )++ 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 或任意子目录名')+ parser.add_argument('-f', '--format', type=str, choices=list(CANVAS_FORMATS.keys()), default=None, help='指定画布格式')+ 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)++ try:+ project_info = get_project_info(str(project_path))+ project_name = project_info.get('name', project_path.name)+ detected_format = project_info.get('format')+ except Exception:+ project_name = project_path.name+ detected_format = None++ canvas_format = args.format+ if canvas_format is None and detected_format and detected_format != 'unknown':+ canvas_format = detected_format++ svg_files, source_dir_name = find_svg_files(project_path, args.source)++ if not svg_files:+ print("错误: 未找到 SVG 文件")+ sys.exit(1)++ if args.output:+ output_path = Path(args.output)+ else:+ output_path = project_path / f"{project_name}.pptx"++ output_path.parent.mkdir(parents=True, exist_ok=True)++ verbose = not args.quiet+ if verbose:+ print("PPT Master - SVG 转 PPTX 工具(原生 SVG)")+ print("=" * 50)+ print(f" 项目路径: {project_path}")+ print(f" SVG 目录: {source_dir_name}")+ print(f" 输出文件: {output_path}")+ print()++ success = create_pptx_with_native_svg(+ svg_files,+ output_path,+ canvas_format=canvas_format,+ verbose=verbose+ )++ sys.exit(0 if success else 1)+++if __name__ == '__main__':+ main()