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

更新文档,新增PPT兼容性规则,强调透明度标准写法,确保导出效果一致。删除不再需要的PDF文件,优化相关工具使用说明,提升用户体验和文档可读性。

hugohe30285517402c2
diff --git a/README.md b/README.md
index 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.md
index 386a1e38..bcffea47 100644
--- a/docs/quick_reference.md
+++ b/docs/quick_reference.md
@@ -385,19 +385,25 @@ yh_slide_02_kpi_dashboard.svg
3. **保存版本**: 重要迭代保存独立版本
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.md
index 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_output
python3 tools/flatten_tspan.py path/to/input.svg path/to/output.svg
```
diff --git a/tools/README.md b/tools/README.md
index 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.svg
4. **后处理(默认执行全部)**
```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 100644
index 6810f229..00000000
Binary 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