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
更新文档,新增PPT兼容性规则,强调透明度标准写法,确保导出效果一致。删除不再需要的PDF文件,优化相关工具使用说明,提升用户体验和文档可读性。
hugohe30285517402c2
diff --git a/README.md b/README.mdindex 0202db5b..df52dd19 100644--- a/README.md+++ b/README.md@@ -418,6 +418,18 @@ Optimizer_CRAP:- **文本**: 禁用 `<foreignObject>`,使用 `<tspan>`手动换行- **字体**: 优先使用系统 UI 字体栈+### PPT 兼容性规则(必须遵守)++为确保导出 PPT 后效果一致,透明度必须使用标准写法:++| ❌ 禁止 | ✅ 正确 |+|--------|--------|+| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |+| `<g opacity="0.2">...</g>` | 每个子元素单独设置透明度 |+| `<image opacity="0.3"/>` | 图片后加遮罩层 `<rect fill="背景色" opacity="0.7"/>` |++> 📌 **记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明+### 布局规范#### 通用灵活风格@@ -743,11 +755,8 @@ python3 tools/generate_examples_index.py统一后处理入口,执行嵌入图标/图片、文本扁平化、圆角转 Path:```bash-# 执行全部后处理(默认)+# 直接运行,无需参数python3 tools/finalize_svg.py <项目路径>--# 只执行部分处理-python3 tools/finalize_svg.py <项目路径> --only embed-icons fix-rounded```**注意**:生成阶段仍应使用 `<tspan>` 手动换行,后处理会自动扁平化。diff --git a/docs/quick_reference.md b/docs/quick_reference.mdindex 386a1e38..bcffea47 100644--- a/docs/quick_reference.md+++ b/docs/quick_reference.md@@ -385,19 +385,25 @@ yh_slide_02_kpi_dashboard.svg3. **保存版本**: 重要迭代保存独立版本4. **团队共享**: 建立团队的设计规范库+## ⚠️ PPT 兼容性规则++为确保导出 PPT 后效果一致,**透明度必须使用标准写法**:++| ❌ 禁止 | ✅ 正确 |+|--------|--------|+| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |+| `<g opacity="0.2">...</g>` | 每个子元素单独设置透明度 |+| `<image opacity="0.3"/>` | 图片后加遮罩层 `<rect fill="背景色" opacity="0.7"/>` |++> 📌 **记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明+## 🔧 后处理工具-### 最终化处理(默认执行全部)+### 最终化处理```bash-# 执行全部后处理(嵌入图标/图片 + 文本扁平化 + 圆角转Path)+# 直接运行,无需参数python3 tools/finalize_svg.py <项目路径>--# 只执行部分处理-python3 tools/finalize_svg.py <项目路径> --only embed-icons fix-rounded--# 安静模式-python3 tools/finalize_svg.py <项目路径> -q```### 导出为 PPTX(推荐)diff --git a/docs/workflow_tutorial.md b/docs/workflow_tutorial.mdindex d3bf982c..261fac46 100644--- a/docs/workflow_tutorial.md+++ b/docs/workflow_tutorial.md@@ -500,15 +500,13 @@ Optimizer_CRAP:- 在浏览器中逐页查看- 检查一致性和质量+ - **检查 PPT 兼容性**(见下方规则)3. **后处理(推荐)**```bash- # 执行全部后处理(默认)+ # 直接运行,无需参数python3 tools/finalize_svg.py <项目路径>-- # 只执行部分处理- python3 tools/finalize_svg.py <项目路径> --only embed-icons fix-rounded```4. **导出为 PPTX(推荐)**@@ -590,6 +588,23 @@ Optimizer_CRAP:导出所有SVG文件,可转为PNG后上传小红书```+## PPT 兼容性规则++为确保 SVG 导出到 PowerPoint 后效果一致,**必须遵守以下透明度规则**:++| ❌ 禁止 | ✅ 正确 |+|--------|--------|+| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |+| `<g opacity="0.2">...</g>` | 每个子元素单独设置透明度 |+| `<image opacity="0.3"/>` | 图片后加遮罩层 `<rect fill="背景色" opacity="0.7"/>` |++> 📌 **记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明++**检查清单**:+- [ ] 无 `rgba()` 颜色格式+- [ ] 无 `<g opacity="...">` 组透明度+- [ ] 图片透明度使用遮罩层实现+## 高级技巧### 技巧 1: 自定义配色@@ -802,14 +817,11 @@ Executor: 收到,我将从您指定的文件夹中引用图标。祝你创作顺利!如有任何问题,欢迎反馈。## 文本扁平化(去 tspan)-在生成阶段,按规范使用 `<tspan>` 进行手动换行。若发布链路或后续处理需要去除 `<tspan>`,推荐使用统一后处理工具:+在生成阶段,按规范使用 `<tspan>` 进行手动换行。后处理会自动扁平化:```bash-# 推荐:使用 finalize_svg.py(已包含文本扁平化)+# 直接运行,无需参数python3 tools/finalize_svg.py <项目路径>--# 单独使用 flatten_tspan.py(高级用法)-python3 tools/flatten_tspan.py <项目路径>/svg_outputpython3 tools/flatten_tspan.py path/to/input.svg path/to/output.svg```diff --git a/tools/README.md b/tools/README.mdindex be993689..0c2a65b4 100644--- a/tools/README.md+++ b/tools/README.md@@ -265,6 +265,20 @@ python3 tools/svg_quality_checker.py examples/project --export---+### PPT 兼容性规则++为确保导出 PPT 后效果一致,**透明度必须使用标准写法**:++| ❌ 禁止 | ✅ 正确 |+|--------|--------|+| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |+| `<g opacity="0.2">...</g>` | 每个子元素单独设置透明度 |+| `<image opacity="0.3"/>` | 图片后加遮罩层 `<rect fill="背景色" opacity="0.7"/>` |++> 📌 **记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明++---+### 8. svg_to_pptx.py — SVG 转 PPTX 工具将项目中的 SVG 文件批量转换为 PowerPoint 演示文稿,保留矢量图形的可编辑性。@@ -392,11 +406,8 @@ python3 tools/svg_rect_to_path.py examples/ppt169_demo/svg_output/01_cover.svg4. **后处理(默认执行全部)**```bash- # 默认执行全部后处理+ # 直接运行,无需参数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```5. **导出为 PPTX**diff --git "a/\351\207\215\345\272\206\345\270\202\345\214\272\345\237\237\346\212\245\345\221\21220251212.pdf" "b/\351\207\215\345\272\206\345\270\202\345\214\272\345\237\237\346\212\245\345\221\21220251212.pdf"deleted file mode 100644index 6810f229..00000000Binary files "a/\351\207\215\345\272\206\345\270\202\345\214\272\345\237\237\346\212\245\345\221\21220251212.pdf" and /dev/null differ