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 的兼容性 bug,修复后处理过程中 finalize_svg会主动添加参数的 bug。

hugohe3954264d84bbc
diff --git a/AGENTS.md b/AGENTS.md
index 5eff84d7..0d1bed4e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -45,7 +45,53 @@ Strategist → Executor (General/Consultant/Consultant_Top) → Optimizer_CRAP (
- **背景**: 使用 `<rect>` 元素
- **字体**: 优先使用系统 UI 字体栈
-### 3. 画布格式
+### 3. PPT 兼容性规则(必须遵守)
+
+为确保 SVG 导出到 PowerPoint 后效果一致,**必须遵守以下透明度规则**:
+
+#### 禁止使用的写法
+
+| ❌ 禁止 | ✅ 正确替代 |
+|--------|-----------|
+| `fill="rgba(255,255,255,0.1)"` | `fill="#FFFFFF" fill-opacity="0.1"` |
+| `stroke="rgba(0,0,0,0.5)"` | `stroke="#000000" stroke-opacity="0.5"` |
+| `<g opacity="0.2">...</g>` | 每个子元素单独设置 `opacity` / `fill-opacity` / `stroke-opacity` |
+| `<image ... opacity="0.3"/>` | 图片后添加遮罩层 `<rect fill="背景色" opacity="0.7"/>` |
+
+#### 透明度正确写法示例
+
+```xml
+<!-- ✅ 填充透明度 -->
+<rect fill="#FFFFFF" fill-opacity="0.15"/>
+
+<!-- ✅ 描边透明度 -->
+<circle stroke="#FFFFFF" stroke-width="1" stroke-opacity="0.1"/>
+
+<!-- ✅ 整体透明度(简单元素可用) -->
+<rect fill="#2E5A8B" opacity="0.15"/>
+
+<!-- ❌ 禁止:组透明度 -->
+<g opacity="0.1">
+ <circle .../>
+ <line .../>
+</g>
+
+<!-- ✅ 正确:每个元素单独设置 -->
+<circle stroke="#FFF" stroke-opacity="0.1"/>
+<line stroke="#FFF" stroke-opacity="0.1"/>
+```
+
+#### 图片透明度遮罩方案
+
+```xml
+<!-- 图片原始透明度 0.35 → 遮罩层 opacity 0.65 -->
+<image href="bg.png" x="0" y="0" width="1280" height="720"/>
+<rect x="0" y="0" width="1280" height="720" fill="#背景色" opacity="0.65"/>
+```
+
+> 📌 **记忆口诀**:PPT 不认 rgba、不认组透明、不认图片透明
+
+### 4. 画布格式
| 格式 | 尺寸 | viewBox |
|------|------|---------|
@@ -70,12 +116,9 @@ python3 tools/project_manager.py validate <路径>
# SVG 质量检查
python3 tools/svg_quality_checker.py <路径>
-# ⭐ 后处理(默认执行全部)
+# ⭐ 后处理(直接运行,无需参数)
python3 tools/finalize_svg.py <项目路径>
-# 只执行部分处理
-python3 tools/finalize_svg.py <项目路径> --only embed-icons fix-rounded
-
# 预览原始版本
python3 -m http.server -d <路径>/svg_output 8000
@@ -104,6 +147,7 @@ project/
- [ ] 无 `<foreignObject>` 元素
- [ ] 使用 `<tspan>` 手动换行
- [ ] 颜色符合设计规范
+- [ ] **PPT 兼容**: 无 `rgba()`、无 `<g opacity>`、图片用遮罩层
- [ ] **对齐**: 元素沿网格线对齐
- [ ] **对比**: 建立清晰的视觉层级
- [ ] **重复**: 同类元素风格一致
@@ -136,20 +180,14 @@ project/
### 后处理提示
-SVG 生成完成后,用户需要进行后处理:
+SVG 生成完成后,**直接运行以下两条命令**,无需任何参数:
```bash
-# 交互式后处理(推荐)
+# 1. 后处理(直接运行)
python3 tools/finalize_svg.py <项目路径>
-# 导出 PPTX
+# 2. 导出 PPTX
python3 tools/svg_to_pptx.py <项目路径> -s final
```
-后处理选项:
-- **嵌入图标** - 替换图标占位符为实际 SVG
-- **嵌入图片** - 将外部图片转为 Base64
-- **文本扁平化** - 将 `<tspan>` 转为独立 `<text>`(用于特殊渲染器)
-- **圆角转 Path** - 用于 PPT「转换为形状」时保留圆角
-
-这些工具由用户自行调用,AI 代理无需直接执行。
+> ⚠️ **注意**:不要添加 `--only` 等参数,直接运行即可完成全部处理。
diff --git a/README.md b/README.md
index 76ac0a52..0202db5b 100644
--- a/README.md
+++ b/README.md
@@ -663,15 +663,11 @@ A: 可以!在与 Strategist 沟通时,明确提出你的品牌色或偏好
- [x] 实现通用和咨询两种设计风格
- [x] 多格式画布支持(PPT 16:9/4:3、小红书、朋友圈、Story 等 10+ 格式)
- [x] 项目管理工具集(初始化、验证、质量检查、批量处理)
-- [x] 标准化图表模板库(13 种常用图表类型)
+- [x] 标准化图表模板库(33 种图表类型)
- [x] 640+ 矢量图标库(来源于 SVG Repo)
- [x] Strategist 主动建议功能(从被动提问升级为主动顾问)
- [x] **示例项目库**(14 个项目、209 页 SVG,涵盖咨询/通用/创意风格)
-
-### 🚧 进行中
-
-- [ ] 扩展图表库和可视化组件
-- [ ] GitHub Pages 自动部署(展示所有项目画廊)
+- [x] 在线示例展示([幻灯片展示库](https://notes.36sjs.com/pages/ppt/slides-library.html))
### 📋 计划中
diff --git a/docs/design_guidelines.md b/docs/design_guidelines.md
index bfef0d1f..b249b1c7 100644
--- a/docs/design_guidelines.md
+++ b/docs/design_guidelines.md
@@ -496,6 +496,92 @@ system-ui, -apple-system, BlinkMacSystemFont,
✓ 空白使用合理
```
+## PPT 兼容性规范
+
+为确保 SVG 导出到 PowerPoint 后视觉效果一致,必须遵守以下规则。
+
+### 透明度写法规范
+
+PowerPoint 对 SVG 透明度的支持有限,以下是兼容性对照表:
+
+| 写法 | PPT 支持 | 说明 |
+|------|---------|------|
+| `fill="#FFF" fill-opacity="0.1"` | ✅ | 推荐:填充透明度 |
+| `stroke="#FFF" stroke-opacity="0.1"` | ✅ | 推荐:描边透明度 |
+| `opacity="0.1"` (在单个元素上) | ✅ | 支持:整体透明度 |
+| `fill="rgba(255,255,255,0.1)"` | ❌ | 禁止:rgba 格式 |
+| `<g opacity="0.1">` | ❌ | 禁止:组透明度 |
+| `<image opacity="0.3"/>` | ❌ | 不支持:图片透明度 |
+
+### 禁止:rgba() 颜色格式
+
+```xml
+<!-- ❌ 错误写法 -->
+<rect fill="rgba(255,255,255,0.15)"/>
+
+<!-- ✅ 正确写法 -->
+<rect fill="#FFFFFF" fill-opacity="0.15"/>
+```
+
+### 禁止:组元素透明度
+
+PPT 不支持 `<g>` 元素上的 `opacity` 属性,必须将透明度设置到每个子元素上:
+
+```xml
+<!-- ❌ 错误写法:组透明度 -->
+<g opacity="0.1">
+ <circle cx="100" cy="100" r="50" fill="none" stroke="#FFF" stroke-width="1"/>
+ <circle cx="100" cy="100" r="30" fill="none" stroke="#FFF" stroke-width="1"/>
+ <line x1="0" y1="100" x2="200" y2="100" stroke="#FFF" stroke-width="1"/>
+</g>
+
+<!-- ✅ 正确写法:每个元素单独设置 -->
+<circle cx="100" cy="100" r="50" fill="none" stroke="#FFF" stroke-width="1" stroke-opacity="0.1"/>
+<circle cx="100" cy="100" r="30" fill="none" stroke="#FFF" stroke-width="1" stroke-opacity="0.1"/>
+<line x1="0" y1="100" x2="200" y2="100" stroke="#FFF" stroke-width="1" stroke-opacity="0.1"/>
+```
+
+### 图片透明度:遮罩层方案
+
+PPT 不支持 `<image>` 元素的 `opacity` 属性。使用**遮罩层叠加**实现相同效果:
+
+```xml
+<!-- ❌ 错误写法:图片透明度会丢失 -->
+<rect width="1280" height="720" fill="#2C3E50"/>
+<image href="bg.png" width="1280" height="720" opacity="0.35"/>
+
+<!-- ✅ 正确写法:遮罩层方案 -->
+<rect width="1280" height="720" fill="#2C3E50"/>
+<image href="bg.png" width="1280" height="720"/>
+<rect width="1280" height="720" fill="#2C3E50" opacity="0.65"/>
+```
+
+**原理**:
+- 原图片 `opacity="0.35"` → 遮罩层 `opacity="0.65"` (1 - 0.35)
+- 遮罩层颜色使用背景渐变的起始色或主背景色
+
+### 渐变定义中的透明度
+
+渐变 `<stop>` 中使用 `stop-opacity` 是支持的:
+
+```xml
+<!-- ✅ 正确:渐变中使用 stop-opacity -->
+<linearGradient id="fadeGradient">
+ <stop offset="0%" style="stop-color:#D4AF37;stop-opacity:0"/>
+ <stop offset="50%" style="stop-color:#D4AF37;stop-opacity:1"/>
+ <stop offset="100%" style="stop-color:#D4AF37;stop-opacity:0"/>
+</linearGradient>
+```
+
+### 检查清单
+
+生成 SVG 后,确保以下内容:
+
+- [ ] 搜索 `rgba(` - 应无结果
+- [ ] 搜索 `<g opacity` 或 `<g.*opacity` - 应无结果
+- [ ] 搜索 `<image.*opacity` - 应无结果,改用遮罩层
+- [ ] 所有透明度使用 `fill-opacity`、`stroke-opacity` 或单元素 `opacity`
+
## 常见问题与解决方案
### Q: 内容太多放不下?
diff --git a/roles/Executor_Consultant.md b/roles/Executor_Consultant.md
index f679ec50..d6b75c4c 100644
--- a/roles/Executor_Consultant.md
+++ b/roles/Executor_Consultant.md
@@ -83,9 +83,22 @@
- **严禁使用 `<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、不认组透明、不认图片透明
+
## 生成后自检
- [ ] viewBox 与画布尺寸一致
- [ ] 无 `<foreignObject>`
- [ ] 数据与源数据一致
- [ ] 简洁专业,留白充足
+- [ ] **PPT 兼容**: 无 `rgba()`、无 `<g opacity>`、图片用遮罩层
diff --git a/roles/Executor_Consultant_Top.md b/roles/Executor_Consultant_Top.md
index ad0fa86a..d353c16a 100644
--- a/roles/Executor_Consultant_Top.md
+++ b/roles/Executor_Consultant_Top.md
@@ -168,6 +168,18 @@
- **严禁使用 `<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、不认组透明、不认图片透明
+
---
## 生成后自检
@@ -176,6 +188,7 @@
- [ ] viewBox 与画布尺寸一致
- [ ] 无 `<foreignObject>`
- [ ] 数据与源数据一致
+- [ ] **PPT 兼容**: 无 `rgba()`、无 `<g opacity>`、图片用遮罩层
### 咨询质量检查
- [ ] **数据情境化**:每个数据点都有对比参照
diff --git a/roles/Executor_General.md b/roles/Executor_General.md
index ea914abc..37fbea99 100644
--- a/roles/Executor_General.md
+++ b/roles/Executor_General.md
@@ -19,6 +19,18 @@
- 使用 `<rect>` 定义背景色
- 优先使用系统 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、不认组透明、不认图片透明
+
## 图标使用
根据设计规范中确定的图标方式选择:
@@ -90,3 +102,4 @@
- [ ] 用 `<tspan>` 换行
- [ ] 元素不超出边界
- [ ] 颜色符合规范
+- [ ] **PPT 兼容**: 无 `rgba()`、无 `<g opacity>`、图片用遮罩层
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"
new file mode 100644
index 00000000..6810f229
Binary files /dev/null and "b/\351\207\215\345\272\206\345\270\202\345\214\272\345\237\237\346\212\245\345\221\21220251212.pdf" differ