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.mdindex 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. 导出 PPTXpython3 tools/svg_to_pptx.py <项目路径> -s final```-后处理选项:-- **嵌入图标** - 替换图标占位符为实际 SVG-- **嵌入图片** - 将外部图片转为 Base64-- **文本扁平化** - 将 `<tspan>` 转为独立 `<text>`(用于特殊渲染器)-- **圆角转 Path** - 用于 PPT「转换为形状」时保留圆角--这些工具由用户自行调用,AI 代理无需直接执行。+> ⚠️ **注意**:不要添加 `--only` 等参数,直接运行即可完成全部处理。diff --git a/README.md b/README.mdindex 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.mdindex 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.mdindex 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.mdindex 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.mdindex 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 100644index 00000000..6810f229Binary 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