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

docs(create-template): 新增 SVG 功能黑名单与透明度处理指南

hugohe35669ec2d4494
diff --git a/.agent/workflows/create-template.md b/.agent/workflows/create-template.md
index 51c9dfdc..0b0293ad 100644
--- a/.agent/workflows/create-template.md
+++ b/.agent/workflows/create-template.md
@@ -224,3 +224,136 @@ cp templates/layouts/<新模板名称>/design_spec.md projects/<项目>/template
3. **占位符规范**:使用 `{{}}` 格式的占位符便于后续替换
4. **字体兼容性**:优先使用系统字体栈
5. **设计规范结构**:遵循 `templates/layouts/README.md` 中定义的标准章节顺序
+
+---
+
+## SVG 技术约束(强制执行)
+
+> ⚠️ **严重警告**:以下规则必须严格遵守,违反将导致 PPT 导出失败或显示异常。
+
+### 必须禁用的功能(黑名单)
+
+| 分类 | ❌ 禁用项 | 说明 |
+| --------------- | ----------------------------------- | ----------------------- |
+| **裁剪 / 遮罩** | `clipPath` | PPT 不支持 SVG 裁剪路径 |
+| | `mask` | PPT 不支持 SVG 遮罩 |
+| **样式系统** | `<style>` | 内部样式表不兼容 |
+| | `class` / `id` 选择器 | 使用内联属性替代 |
+| | 外部 CSS | 禁止引用外部样式 |
+| **结构 / 嵌套** | `<foreignObject>` | 使用 `<tspan>` 手动换行 |
+| | `<symbol>` + `<use>` 复杂用法 | 简单 `<use>` 引用可用 |
+| **文本 / 字体** | `textPath` | 路径文本不兼容 |
+| | Web 字体(`@font-face`) | 使用系统字体栈 |
+| **动画 / 交互** | SMIL 动画(`<animate*>` / `<set>`) | SVG 动画不导出 |
+| | `<script>` / 事件属性 | 禁止脚本和事件处理 |
+| **标记 / 箭头** | `marker` / `marker-end` | PPT 不支持 SVG 标记 |
+| | `<marker>` + `<defs>` | 使用 `<polygon>` 替代 |
+| **滤镜效果** | `<filter>` 元素 | PPT 不支持 SVG 滤镜 |
+| | `feGaussianBlur` 等滤镜原语 | 用阴影色块替代 |
+| **其他** | `<iframe>` | 不应出现在 SVG 中 |
+
+> 📌 **记忆口诀**:PPT 只认基础形状 + 内联样式 + 系统字体 + 实色填充
+
+---
+
+## PPT 透明度兼容性规则(强制执行)
+
+> ⚠️ **关键问题**:PPT 对 SVG 透明度支持有限,必须使用正确写法。
+
+### 禁止的透明度写法
+
+| ❌ 禁止 | 问题描述 | ✅ 正确替代方案 |
+| ------------------------------------ | -------------------------------- | -------------------------------------- |
+| `opacity="0.3"` (元素透明度) | PPT 可能不正确渲染 | 使用**浅色实色值**替代 |
+| `fill-opacity="0.3"` | PPT 支持有限 | 使用**浅色实色值**替代 |
+| `fill="rgba(255,255,255,0.1)"` | PPT 不支持 rgba 格式 | `fill="#FFFFFF" fill-opacity="0.1"` |
+| `stroke="rgba(0,0,0,0.5)"` | PPT 不支持 rgba 格式 | `stroke="#000000" stroke-opacity="0.5"`|
+| `<g opacity="0.2">...</g>` | PPT 不支持组透明度 | 每个子元素单独设置透明度 |
+| `<image ... opacity="0.3"/>` | PPT 不支持图片透明度 | 用遮罩层 `<rect fill="背景色" opacity="0.7"/>` |
+| `filter="url(#shadow)"` | PPT 不支持 SVG 滤镜 | 移除滤镜效果 |
+
+### 透明度的正确替代方案
+
+**推荐做法**:用**浅色实色值**代替透明度,确保 PPT 兼容。
+
+```xml
+<!-- ❌ 禁止:使用透明度 -->
+<path fill="#DE3545" opacity="0.3"/>
+<path fill="#DE3545" fill-opacity="0.4"/>
+
+<!-- ✅ 正确:使用计算后的浅色实色 -->
+<path fill="#F5A0A8"/> <!-- 相当于 #DE3545 + 30% 透明度 -->
+<path fill="#E97983"/> <!-- 相当于 #DE3545 + 40% 透明度 -->
+```
+
+### 常用半透明效果的实色替代色表
+
+| 原色 | 透明度 | 替代实色 | 备注 |
+| --------- | ------ | --------- | ------------------- |
+| `#DE3545` | 30% | `#F5A0A8` | 淡红色 |
+| `#DE3545` | 40% | `#E97983` | 浅红色 |
+| `#DE3545` | 50% | `#E86A76` | 中浅红色 |
+| `#DE3545` | 60% | `#E45967` | 中红色 |
+| `#333333` | 30% | `#ADADAD` | 淡灰色 |
+| `#333333` | 40% | `#999999` | 浅灰色 |
+| `#333333` | 50% | `#666666` | 中灰色 |
+| `#FFFFFF` | 30% | `#F5F5F5` | 近白色(浅灰背景) |
+
+> 💡 **计算公式**:混合色 = 原色 × 透明度 + 背景色 × (1 - 透明度)
+
+---
+
+## 箭头绘制方案
+
+PPT 不支持 SVG 的 `marker-end` 属性,需使用 `<polygon>` 三角形替代:
+
+```xml
+<!-- ❌ 禁止:使用 marker-end -->
+<defs>
+ <marker id="arrow" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+ <polygon points="0 0, 10 3.5, 0 7" fill="#DE3545"/>
+ </marker>
+</defs>
+<path d="M100 200 L200 200" marker-end="url(#arrow)"/>
+
+<!-- ✅ 正确:使用 line + polygon -->
+<line x1="100" y1="200" x2="195" y2="200" stroke="#DE3545" stroke-width="2"/>
+<polygon points="195,194 210,200 195,206" fill="#DE3545"/>
+```
+
+---
+
+## 模板验证检查清单
+
+生成模板后,必须逐项确认以下内容:
+
+### SVG 黑名单检查
+
+- [ ] 无 `clipPath`
+- [ ] 无 `mask`
+- [ ] 无 `<style>` 标签
+- [ ] 无 `class` 或 `id` 选择器(用于样式)
+- [ ] 无外部 CSS 引用
+- [ ] 无 `<foreignObject>`
+- [ ] 无 `textPath`
+- [ ] 无 `@font-face` 或 Web 字体
+- [ ] 无 `<animate>` / `<animateTransform>` / `<set>` 等动画元素
+- [ ] 无 `<script>` 或 `on*` 事件属性
+- [ ] 无 `marker` / `marker-end` / `<marker>` 定义
+- [ ] 无 `<filter>` 滤镜效果
+- [ ] 无 `<iframe>`
+
+### PPT 兼容性检查
+
+- [ ] 无 `rgba()` 颜色格式
+- [ ] 无 `<g opacity="...">` 组透明度
+- [ ] 无 `<image ... opacity="..."/>` 图片透明度
+- [ ] 所有透明效果已替换为**浅色实色值**
+- [ ] 颜色值统一使用 HEX 格式
+
+### 格式规范检查
+
+- [ ] viewBox 设置正确(`0 0 1280 720`)
+- [ ] 占位符格式一致(`{{PLACEHOLDER}}`)
+- [ ] 设计风格在所有页面中保持一致
+
diff --git a/templates/layouts/smart_red/01_cover.svg b/templates/layouts/smart_red/01_cover.svg
new file mode 100644
index 00000000..494bfa06
--- /dev/null
+++ b/templates/layouts/smart_red/01_cover.svg
@@ -0,0 +1,49 @@
+<svg width="1280" height="720" viewBox="0 0 1280 720" xmlns="http://www.w3.org/2000/svg">
+ <!-- Background -->
+ <rect x="0" y="0" width="1280" height="720" fill="#F5F5F7" />
+
+ <!-- 1. Top Left: Red Triangle (Primary) -->
+ <path d="M0 0 L380 0 L0 380 Z" fill="#DE3545" />
+
+ <!-- 1a. Top Left: Small accent triangle -->
+ <path d="M0 0 L180 0 L0 180 Z" fill="#E86A76" />
+
+ <!-- 2. Bottom Left: Dark Grey Triangle -->
+ <path d="M0 720 L320 720 L0 400 Z" fill="#333333" />
+
+ <!-- 2a. Bottom Left: Small accent -->
+ <path d="M0 720 L120 720 L0 600 Z" fill="#555555" />
+
+ <!-- 3. Bottom Right: Red Triangle (Primary) -->
+ <path d="M1280 720 L1280 300 L860 720 Z" fill="#DE3545" />
+
+ <!-- 3a. Bottom Right: Small accent triangle -->
+ <path d="M1280 720 L1280 520 L1080 720 Z" fill="#E86A76" />
+
+ <!-- 3b. Top Right: Small decorative triangle -->
+ <path d="M1280 0 L1200 0 L1280 80 Z" fill="#E97983" />
+
+ <!-- Content Area -->
+ <g transform="translate(460, 300)">
+
+ <!-- Main Title -->
+ <text x="0" y="0" font-family="'Microsoft YaHei', 'SimHei', sans-serif" font-size="72" font-weight="bold" fill="#333333" letter-spacing="4">{{TITLE}}</text>
+
+ <!-- Subtitle/English -->
+ <text x="5" y="50" font-family="Arial, sans-serif" font-size="20" fill="#DE3545" letter-spacing="3" font-weight="bold">COMPANY INTRODUCTION</text>
+
+ <!-- Decorative Line -->
+ <line x1="5" y1="78" x2="120" y2="78" stroke="#333333" stroke-width="4" />
+
+ <!-- Subtitle CN -->
+ <text x="5" y="130" font-family="'Microsoft YaHei', 'SimHei', sans-serif" font-size="32" fill="#666666">{{SUBTITLE}}</text>
+
+ <!-- Info -->
+ <text x="5" y="250" font-family="'Microsoft YaHei', 'SimHei', sans-serif" font-size="18" fill="#999999">
+ 汇报人:{{AUTHOR}}
+ </text>
+ <text x="5" y="280" font-family="'Microsoft YaHei', 'SimHei', sans-serif" font-size="18" fill="#999999">
+ 时间:{{DATE}}
+ </text>
+ </g>
+</svg>
diff --git a/templates/layouts/smart_red/02_chapter.svg b/templates/layouts/smart_red/02_chapter.svg
new file mode 100644
index 00000000..e2caeee7
--- /dev/null
+++ b/templates/layouts/smart_red/02_chapter.svg
@@ -0,0 +1,29 @@
+<svg width="1280" height="720" viewBox="0 0 1280 720" xmlns="http://www.w3.org/2000/svg">
+ <!-- Background -->
+ <rect x="0" y="0" width="1280" height="720" fill="#F5F5F7" />
+
+ <!-- Top Left Accent -->
+ <path d="M0 0 L180 0 L0 180 Z" fill="#DE3545" />
+ <path d="M0 0 L80 0 L0 80 Z" fill="#F5A0A8" />
+
+ <!-- Bottom Right Accent -->
+ <path d="M1280 720 L1100 720 L1280 540 Z" fill="#DE3545" />
+ <path d="M1280 720 L1180 720 L1280 620 Z" fill="#F5A0A8" />
+
+ <!-- Content Group -->
+ <g transform="translate(640, 360)" text-anchor="middle">
+
+ <!-- Chapter Number (watermark style) -->
+ <text x="0" y="-40" font-family="Arial, sans-serif" font-size="140" font-weight="bold" fill="none" stroke="#F8D0D3" stroke-width="3">{{CHAPTER_NUM}}</text>
+ <text x="0" y="-40" font-family="Arial, sans-serif" font-size="140" font-weight="bold" fill="#FADCDE">{{CHAPTER_NUM}}</text>
+
+ <!-- Chapter Title -->
+ <text x="0" y="30" font-family="'Microsoft YaHei', sans-serif" font-size="64" font-weight="bold" fill="#333333">{{CHAPTER_TITLE}}</text>
+
+ <!-- Decor Line -->
+ <line x1="-100" y1="70" x2="100" y2="70" stroke="#DE3545" stroke-width="4" />
+
+ <!-- English Title -->
+ <text x="0" y="120" font-family="Arial, sans-serif" font-size="24" fill="#999999" letter-spacing="6">CHAPTER SUMMARY</text>
+ </g>
+</svg>
diff --git a/templates/layouts/smart_red/02_toc.svg b/templates/layouts/smart_red/02_toc.svg
new file mode 100644
index 00000000..1cf37a25
--- /dev/null
+++ b/templates/layouts/smart_red/02_toc.svg
@@ -0,0 +1,59 @@
+<svg width="1280" height="720" viewBox="0 0 1280 720" xmlns="http://www.w3.org/2000/svg">
+ <!-- Background -->
+ <rect x="0" y="0" width="1280" height="720" fill="#F5F5F7" />
+
+ <!-- 1. Left Red Panel -->
+ <path d="M0 0 L400 0 L300 720 L0 720 Z" fill="#DE3545" />
+
+ <!-- 2. Bottom Left Accent (Dark Grey) -->
+ <path d="M0 720 L180 720 L0 550 Z" fill="#4A4A4A" />
+ <path d="M0 720 L80 720 L0 640 Z" fill="#666666" />
+
+ <!-- 3. Bottom Right Red Triangle Accent -->
+ <path d="M1280 720 L1280 580 L1140 720 Z" fill="#DE3545" />
+ <path d="M1280 720 L1280 650 L1210 720 Z" fill="#E97983" />
+
+ <!-- 4. Top Right small accent -->
+ <path d="M1280 0 L1220 0 L1280 60 Z" fill="#E97983" />
+
+ <!-- Title Area (Left, on Red Panel) -->
+ <g transform="translate(60, 200)">
+ <text x="0" y="0" font-family="'Microsoft YaHei', sans-serif" font-size="72" font-weight="bold" fill="#FFFFFF">目录</text>
+ <text x="0" y="40" font-family="Arial, sans-serif" font-size="24" letter-spacing="4" fill="#FFC1C1">CATALOGUE</text>
+ <!-- Decorative line -->
+ <line x1="0" y1="70" x2="100" y2="70" stroke="#FFFFFF" stroke-width="4" />
+ </g>
+
+ <!-- TOC Items (Right) -->
+ <g transform="translate(480, 150)">
+
+ <!-- Item 1 -->
+ <g transform="translate(0, 0)">
+ <circle cx="40" cy="40" r="32" fill="#FFFFFF" stroke="#DE3545" stroke-width="3" />
+ <text x="40" y="50" text-anchor="middle" font-family="Arial, sans-serif" font-size="28" font-weight="bold" fill="#DE3545">01</text>
+ <text x="95" y="45" font-family="'Microsoft YaHei', sans-serif" font-size="32" font-weight="bold" fill="#333333">{{TOC_ITEM_1}}</text>
+ </g>
+
+ <!-- Item 2 -->
+ <g transform="translate(0, 110)">
+ <circle cx="40" cy="40" r="32" fill="#DE3545" />
+ <text x="40" y="50" text-anchor="middle" font-family="Arial, sans-serif" font-size="28" font-weight="bold" fill="#FFFFFF">02</text>
+ <text x="95" y="45" font-family="'Microsoft YaHei', sans-serif" font-size="32" font-weight="bold" fill="#333333">{{TOC_ITEM_2}}</text>
+ </g>
+
+ <!-- Item 3 -->
+ <g transform="translate(0, 220)">
+ <circle cx="40" cy="40" r="32" fill="#FFFFFF" stroke="#DE3545" stroke-width="3" />
+ <text x="40" y="50" text-anchor="middle" font-family="Arial, sans-serif" font-size="28" font-weight="bold" fill="#DE3545">03</text>
+ <text x="95" y="45" font-family="'Microsoft YaHei', sans-serif" font-size="32" font-weight="bold" fill="#333333">{{TOC_ITEM_3}}</text>
+ </g>
+
+ <!-- Item 4 -->
+ <g transform="translate(0, 330)">
+ <circle cx="40" cy="40" r="32" fill="#DE3545" />
+ <text x="40" y="50" text-anchor="middle" font-family="Arial, sans-serif" font-size="28" font-weight="bold" fill="#FFFFFF">04</text>
+ <text x="95" y="45" font-family="'Microsoft YaHei', sans-serif" font-size="32" font-weight="bold" fill="#333333">{{TOC_ITEM_4}}</text>
+ </g>
+
+ </g>
+</svg>
diff --git a/templates/layouts/smart_red/03_content.svg b/templates/layouts/smart_red/03_content.svg
new file mode 100644
index 00000000..c3ac1078
--- /dev/null
+++ b/templates/layouts/smart_red/03_content.svg
@@ -0,0 +1,59 @@
+<svg width="1280" height="720" viewBox="0 0 1280 720" xmlns="http://www.w3.org/2000/svg">
+ <!-- Background -->
+ <rect x="0" y="0" width="1280" height="720" fill="#F5F5F7" />
+
+ <!-- Header Background (White strip) -->
+ <rect x="0" y="0" width="1280" height="80" fill="#FFFFFF" />
+ <line x1="0" y1="80" x2="1280" y2="80" stroke="#E0E0E0" stroke-width="1" />
+
+ <!-- Header Accent: Red Shapes on Top Right - Enhanced -->
+ <path d="M1280 0 L1180 0 L1280 100 Z" fill="#DE3545" />
+ <path d="M1180 0 L1120 0 L1200 80 L1280 80 Z" fill="#EEEEEE"/>
+ <path d="M1280 0 L1240 0 L1280 40 Z" fill="#E97983"/>
+
+ <!-- Left accent bar -->
+ <rect x="0" y="0" width="4" height="80" fill="#DE3545" />
+
+ <!-- Page Title Group -->
+ <g transform="translate(60, 40)">
+ <!-- Symbol 1: Dark Hollow Triangle -->
+ <path d="M0 0 L14 10 L0 20 Z" fill="none" stroke="#333333" stroke-width="2" transform="translate(0, -10)" />
+
+ <!-- Symbol 2: Solid Red Triangle -->
+ <path d="M18 0 L32 10 L18 20 Z" fill="#DE3545" transform="translate(0, -10)" />
+
+ <!-- Title Text -->
+ <text x="50" y="12" font-family="'Microsoft YaHei', sans-serif" font-size="32" font-weight="bold" fill="#333333">{{PAGE_TITLE}}</text>
+ </g>
+
+ <!-- Content Area Placeholder -->
+ <!-- Main Content Card (White Background for content) -->
+ <g transform="translate(60, 110)">
+ <rect x="0" y="0" width="1160" height="540" rx="8" ry="8" fill="#FFFFFF" stroke="#E0E0E0" stroke-width="1" />
+
+ <!-- Red accent line on top of card -->
+ <rect x="0" y="0" width="1160" height="4" rx="8" ry="8" fill="#E97983" />
+
+ <!-- Visual Guide for Content Area (Dotted Line) -->
+ <rect x="30" y="30" width="1100" height="480" rx="4" ry="4" fill="none" stroke="#CCCCCC" stroke-width="1" stroke-dasharray="8,8" />
+
+ <text x="580" y="270" text-anchor="middle" font-family="'Microsoft YaHei', sans-serif" font-size="24" fill="#CCCCCC">
+ {{CONTENT_AREA}}
+ </text>
+ </g>
+
+ <!-- Footer - Enhanced -->
+ <g transform="translate(0, 680)">
+ <!-- Footer background bar -->
+ <rect x="0" y="0" width="1280" height="40" fill="#FAFAFA"/>
+
+ <!-- Red accent -->
+ <rect x="0" y="0" width="4" height="40" fill="#DE3545"/>
+
+ <text x="70" y="25" font-family="Arial, sans-serif" font-size="14" fill="#999999">COMPANY INTRODUCTION</text>
+
+ <!-- Page Number with circle background -->
+ <circle cx="1210" cy="20" r="16" fill="#FDE8E9"/>
+ <text x="1210" y="26" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" fill="#333333" font-weight="bold">{{PAGE_NUM}}</text>
+ </g>
+</svg>
diff --git a/templates/layouts/smart_red/04_ending.svg b/templates/layouts/smart_red/04_ending.svg
new file mode 100644
index 00000000..c1313602
--- /dev/null
+++ b/templates/layouts/smart_red/04_ending.svg
@@ -0,0 +1,44 @@
+<svg width="1280" height="720" viewBox="0 0 1280 720" xmlns="http://www.w3.org/2000/svg">
+ <!-- Background -->
+ <rect x="0" y="0" width="1280" height="720" fill="#F5F5F7" />
+
+ <!-- 1. Top Left: Red Triangle -->
+ <path d="M0 0 L380 0 L0 380 Z" fill="#DE3545" />
+
+ <!-- 1a. Top Left: Small accent triangle -->
+ <path d="M0 0 L180 0 L0 180 Z" fill="#E86A76" />
+
+ <!-- 2. Bottom Left: Dark Grey Triangle -->
+ <path d="M0 720 L320 720 L0 400 Z" fill="#333333" />
+
+ <!-- 2a. Bottom Left: Small accent -->
+ <path d="M0 720 L120 720 L0 600 Z" fill="#555555" />
+
+ <!-- 3. Bottom Right: Red Triangle -->
+ <path d="M1280 720 L1280 300 L860 720 Z" fill="#DE3545" />
+
+ <!-- 3a. Bottom Right: Small accent triangle -->
+ <path d="M1280 720 L1280 520 L1080 720 Z" fill="#E86A76" />
+
+ <!-- 3b. Top Right: Small decorative triangle -->
+ <path d="M1280 0 L1200 0 L1280 80 Z" fill="#E97983" />
+
+ <!-- Content Group -->
+ <g transform="translate(640, 340)" text-anchor="middle">
+
+ <!-- Thank You Text -->
+ <text x="0" y="0" font-family="'Microsoft YaHei', sans-serif" font-size="80" font-weight="bold" fill="#333333" letter-spacing="4">谢谢观看</text>
+ <text x="0" y="60" font-family="Arial, sans-serif" font-size="24" fill="#DE3545" letter-spacing="10">THANKS FOR WATCHING</text>
+
+ <!-- Separator -->
+ <line x1="-150" y1="100" x2="150" y2="100" stroke="#CCCCCC" stroke-width="1" />
+
+ <!-- Closing Message -->
+ <text x="0" y="150" font-family="'Microsoft YaHei', sans-serif" font-size="24" fill="#666666">{{CLOSING_MESSAGE}}</text>
+
+ <!-- Contact Info Placeholder -->
+ <text x="0" y="200" font-family="Arial, sans-serif" font-size="16" fill="#999999">
+ http://www.yourcompany.com
+ </text>
+ </g>
+</svg>
diff --git a/templates/layouts/smart_red/design_spec.md b/templates/layouts/smart_red/design_spec.md
new file mode 100644
index 00000000..cd4b6381
--- /dev/null
+++ b/templates/layouts/smart_red/design_spec.md
@@ -0,0 +1,205 @@
+# smart_red - 智慧红橙商务风格设计规范
+
+> 适用于科技企业介绍、教育行业解决方案、智慧校园建设方案等场景,风格现代、活力。
+
+---
+
+## 一、模板概述
+
+| 属性 | 描述 |
+| -------------- | ------------------------------------------------------ |
+| **模板名称** | smart_red (智慧红橙商务风格) |
+| **适用场景** | 企业介绍、产品发布、解决方案演示、教育行业课件 |
+| **设计调性** | 现代、活力、专业、几何感 |
+| **主题模式** | 混合主题(深色/彩色封面 + 浅色内容页) |
+
+---
+
+## 二、画布规范
+
+| 属性 | 值 |
+| -------------- | ----------------------------- |
+| **格式** | 标准 16:9 |
+| **尺寸** | 1280 × 720 px |
+| **viewBox** | `0 0 1280 720` |
+| **安全边距** | 60px (左右), 50px (上下) |
+| **内容区域** | x: 60-1220, y: 100-670 |
+| **标题区域** | y: 50-100 |
+| **网格基准** | 40px |
+
+---
+
+## 三、配色方案
+
+### 主色系
+
+| 角色 | 色值 | 备注 |
+| ---------------- | ----------- | -------------------------------- |
+| **主色 Red** | `#DE3545` | 品牌识别、标题装饰、几何切角 |
+| **辅助色 Orange**| `#F0964D` | 几何点缀、渐变搭配 |
+| **深色背景 Dark**| `#333333` | 封面背景、几何切角、深色页脚 |
+
+### 中性色
+
+| 角色 | 色值 | 用途 |
+| -------------- | ----------- | ---------------------- |
+| **浅灰背景** | `#F5F5F7` | 页面背景 |
+| **边框灰** | `#E0E0E0` | 模块分割线、卡片边框 |
+| **正文黑** | `#333333` | 标题及正文标准色 |
+| **说明灰** | `#666666` | 副标题、注释文字 |
+| **纯白** | `#FFFFFF` | 卡片背景 |
+
+---
+
+## 四、排版体系
+
+### 字体方案
+
+**字体栈**: `Arial, "Helvetica Neue", "Microsoft YaHei", sans-serif`
+
+### 字号层级
+
+| 层级 | 用途 | 字号 | 字重 |
+| -------- | ---------------- | ------ | ------- |
+| H1 | 封面主标题 | 60-80px| Bold |
+| H2 | 页面标题 | 32-40px| Bold |
+| H3 | 小节/卡片标题 | 24-28px| Bold |
+| P | 正文内容 | 18-20px| Regular |
+| Caption | 辅助说明 | 14-16px| Regular |
+
+---
+
+## 五、核心设计原则
+
+### 几何商务风格
+
+1. **几何切角**: 封面、目录、过渡页使用大面积三角形切角设计。
+2. **红黑对比**: 红色主色搭配深灰色块,营造专业且有冲击力的视觉效果。
+3. **卡片式布局**: 内容页采用白色卡片承载内容,背景使用浅灰,增加层次感。
+4. **留白**: 保持适度留白,避免信息过载。
+
+### 高级美化特性 (v2.0)
+
+1. **多层几何叠加**: 主要三角形配合半透明小型三角形,增加视觉深度。
+2. **阴影效果**: 文字阴影、卡片阴影、圆形阴影,提升立体感。
+3. **双线装饰**: 装饰线采用双线样式(粗+细),更具设计感。
+4. **微妙光晕**: 在内容区域后添加极淡的色彩光晕,增加高端感。
+5. **纹理点缀**: 面板添加极淡的斜线纹理,增加质感。
+6. **圆形阴影**: 目录编号圆形带阴影,暗示交互性。
+
+---
+
+## 六、页面结构
+
+### 通用布局
+
+| 区域 | 位置/高度 | 内容说明 |
+| ---------- | ------------- | -------------------------------------- |
+| **顶部** | y=0-80 | 导航栏/标题区 |
+| **内容区** | y=100-660 | 主要内容区域(卡片/图示) |
+| **页脚** | y=680 | 页码及版权信息 |
+
+### 装饰设计
+
+- **三角形切角**: 封面和封底的核心视觉元素。
+- **侧边栏**: 目录页特有的左侧红色多边形面板。
+- **顶部装饰条**: 内容页顶部的红色切角装饰。
+
+---
+
+## 七、页面类型
+
+### 1. 封面页 (01_cover.svg)
+
+- **背景**: 浅灰背景 `#F5F5F7`
+- **左上角**: 红色大三角切角 (0,0 -> 350,0 -> 0,350)
+- **左下角**: 深灰色三角切角 (0,720 -> 300,720 -> 0,420)
+- **右下角**: 红色大三角切角 (1280,720 -> 1280,320 -> 880,720)
+- **标题区**: 居中偏右显示主标题 `{{TITLE}}` 和副标题 `{{SUBTITLE}}`
+- **信息区**: 底部显示汇报人 `{{AUTHOR}}` 和日期 `{{DATE}}`
+
+### 2. 目录页 (02_toc.svg)
+
+- **背景**: 浅灰背景 `#F5F5F7`
+- **左侧**: 全高红色多边形面板 + "目录"大字
+- **右侧**: 内容列表区域
+- **目录项**: 垂直排列,使用圆形数字索引 (01, 02...)
+
+### 3. 章节页 (02_chapter.svg)
+
+- **装饰**: 红色三角形呼应封面 (左上/右下)
+- **中心**: 大号章节编号 `{{CHAPTER_NUM}}` + 章节标题 `{{CHAPTER_TITLE}}`
+- **风格**: 简洁有力,色彩鲜明
+
+### 4. 内容页 (03_content.svg)
+
+- **顶部**: 白色导航栏 + 右上角红色切角装饰 + 标题双三角装饰
+- **背景**: 浅灰背景 `#F5F5F7`
+- **标题**: 居左显示页面标题 `{{PAGE_TITLE}}`
+- **内容**: `{{CONTENT_AREA}}` 使用白色卡片样式(圆角+描边)
+- **页脚**: 包含版权信息和页码
+
+### 5. 结束页 (04_ending.svg)
+
+- **布局**: 与封面完全呼应的三角布局(左上红、左下灰、右下红)
+- **居中**: 显示感谢语 "谢谢观看"
+- **底部**: 留白用于联系信息
+
+---
+
+## 八、常用组件
+
+### 卡片样式
+
+```xml
+<!-- 白色内容卡片 -->
+<rect x="60" y="110" width="1160" height="540" rx="4" ry="4" fill="#FFFFFF" stroke="#E0E0E0" stroke-width="1" />
+```
+
+### 目录圆形编号
+
+```xml
+<circle cx="40" cy="40" r="30" fill="#FFFFFF" stroke="#DE3545" stroke-width="2" />
+<text x="40" y="50" text-anchor="middle" font-family="Arial" font-size="28" font-weight="bold" fill="#DE3545">01</text>
+```
+
+---
+
+## 九、SVG 技术约束
+
+### 必须遵守
+
+1. viewBox: `0 0 1280 720`
+2. 背景使用 `<rect>` 元素
+3. 文本换行使用 `<tspan>`(**严禁** `<foreignObject>`)
+4. 透明度使用 `fill-opacity` / `stroke-opacity`
+5. 禁止使用:`clipPath`、`mask`、`<style>`、`class`、`foreignObject`
+6. 禁止使用:`textPath`、`animate*`、`script`
+7. 渐变使用 `<defs>` 定义
+
+---
+
+## 十、占位符规范
+
+| 占位符 | 说明 |
+| ------------------ | ------------------ |
+| `{{TITLE}}` | 主标题 |
+| `{{SUBTITLE}}` | 副标题 |
+| `{{AUTHOR}}` | 演讲者/作者 |
+| `{{DATE}}` | 日期 |
+| `{{PAGE_TITLE}}` | 页面标题 |
+| `{{CONTENT_AREA}}` | 内容区域标识 |
+| `{{CHAPTER_NUM}}` | 章节编号 |
+| `{{CHAPTER_TITLE}}`| 章节标题 |
+| `{{PAGE_NUM}}` | 页码 |
+| `{{TOC_ITEM_1}}` | 目录项 1 |
+| `{{CLOSING_MESSAGE}}`| 结束语 |
+
+---
+
+## 十一、使用说明
+
+1. 复制本目录到项目目录。
+2. 根据内容需求选择页面模板。
+3. 修改 SVG 中的文本内容或替换图片。
+4. 使用 `ppt-master` 工具生成 PPTX 文件。