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(templates): 标准化中汽研与中国电建模板的设计规范文档

hugohe374c0fd4232f5
diff --git "a/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\345\270\270\350\247\204/design_spec.md" "b/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\345\270\270\350\247\204/design_spec.md"
index fa3de941..4be1f37a 100644
--- "a/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\345\270\270\350\247\204/design_spec.md"
+++ "b/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\345\270\270\350\247\204/design_spec.md"
@@ -130,19 +130,58 @@
---
-## 七、SVG 技术约束
+## 七、布局模式(推荐)
+
+### 1. 左右分栏 (Split Column)
+- 经典图文混排,左文右图或左图右文。
+- 分栏比例推荐 1:1 或 2:3。
+
+### 2. 卡片阵列 (Card Grid)
+- 3列或4列卡片布局,用于展示项目案例或荣誉资质。
+- 卡片背景推荐使用辅助浅灰 `#F4F6F8`。
+
+### 3. 流程图 (Process)
+- 横向时间轴或流程图,展示项目进度。
+- 使用电建蓝作为主轴颜色,中国红标记关键节点。
+
+---
+
+## 八、间距规范
+
+| 属性 | 值 | 说明 |
+| ------------ | ----- | ------------------------ |
+| **基础单位** | 8px | 所有间距应为 8px 的倍数 |
+| **模块间距** | 32px | 大模块之间的标准间距 |
+| **卡片间距** | 24px | 卡片之间的间距 |
+| **内部留白** | 24px | 卡片内部的 Padding |
+| **文本行距** | 1.5 | 正文标准行距 |
+
+---
+
+## 九、SVG 技术约束
### 必须遵守
-1. viewBox: `0 0 1280 720`
-2. 背景使用 `<rect>` 元素
-3. 透明度使用 `fill-opacity` / `stroke-opacity`
-4. 禁止使用:`clipPath`、`mask`、`filter`、`<style>`、`class`
-5. 禁止使用:`textPath`、`animate*`、`script`、`marker`
+1. viewBox 固定为 `0 0 1280 720`
+2. 背景必须包含全屏 `<rect>`
+3. 文本换行使用 `<tspan>`
+4. 透明度必须使用 `fill-opacity` / `stroke-opacity`
+5. 箭头需使用 `<polygon>` 绘制,禁止 `marker`
+
+### 禁用元素 (黑名单)
+
+- `clipPath`, `mask` (裁剪/遮罩)
+- `<style>`, `class`, `id` (样式表)
+- `foreignObject` (外部对象)
+- `textPath` (路径文本)
+- `animate`, `animateTransform`, `set` (动画)
+- `<filter>` (滤镜)
+- `rgba()` 颜色格式 (必须用 hex + opacity)
+- `<g opacity="...">` (组透明度,需单独设置)
---
-## 八、占位符规范
+## 十、占位符规范
| 占位符 | 说明 |
| ------------------ | ------------------ |
@@ -153,12 +192,14 @@
| `{{CHAPTER_NUM}}` | 章节编号 |
| `{{PAGE_NUM}}` | 页码 |
| `{{DATE}}` | 日期 |
+| `{{CHAPTER_TITLE}}`| 章节标题 |
+| `{{PAGE_TITLE}}` | 页面标题 |
+| `{{CONTENT_AREA}}` | 内容区域标识 |
---
-## 九、设计亮点
+## 十一、使用说明(推荐)
-- **电建品牌蓝**: 专业稳重的品牌色系
-- **工程感斜线**: 体现建设行业特色
-- **中国红点缀**: 央企身份的体现
-- **几何网格装饰**: 现代化工程感
+1. **Logo 适配**: 封面页和结束页使用反白 Logo,内容页右上角使用彩色或反白 Logo。
+2. **图片资源**: 确保 template 目录下 `images/` 文件夹内包含必要的 Logo 文件。
+3. **字体**: 推荐安装“微软雅黑”以获得最佳显示效果。
diff --git "a/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\347\216\260\344\273\243/design_spec.md" "b/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\347\216\260\344\273\243/design_spec.md"
index 63b16f01..82010842 100644
--- "a/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\347\216\260\344\273\243/design_spec.md"
+++ "b/templates/layouts/\344\270\255\345\233\275\347\224\265\345\273\272_\347\216\260\344\273\243/design_spec.md"
@@ -67,7 +67,7 @@
---
-## 五、页面结构设计
+## 五、页面结构
### 通用导航栏 (y=0 to 100)
@@ -77,7 +77,7 @@
---
-## 六、页面类型详细设计
+## 六、页面类型
### 1. 封面页 (01_cover.svg)
- **视觉重心**: **"基石" (Foundation)** 概念。底部厚重深蓝支撑,顶部通透。
@@ -102,17 +102,55 @@
---
-## 七、SVG 技术约束 & 最佳实践
+## 七、布局模式(推荐)
+
+### 1. 科技卡片 (Tech Cards)
+- 带有微弱边框和 glowing 效果的卡片。
+- 适合展示关键技术指标或创新成果。
+
+### 2. 数据仪表盘 (Dashboard)
+- 结合图表和关键数据的组合布局。
+- 使用科技蓝作为图表主色。
+
+### 3. 工程图解 (Blueprint)
+- 利用经纬网格背景,通过线条和标注解释复杂结构。
+
+---
+
+## 八、间距规范
+
+| 属性 | 值 | 说明 |
+| ------------ | ----- | ------------------------ |
+| **基础单位** | 4px | 精密设计使用 4px 网格 |
+| **模块间距** | 40px | 宽大间距,增加呼吸感 |
+| **卡片间距** | 20px | 紧凑但清晰的间距 |
+| **内部留白** | 32px | 内容与边框的距离 |
+
+---
+
+## 九、SVG 技术约束
### 必须遵守
+
1. **渐变**: 使用 `<linearGradient>` 营造金属质感或光影感。
2. **网格**: 使用 `<pattern>` 定义精细网格背景,Opacity 控制在 0.05-0.1。
3. **透明度**: 严格使用 `fill-opacity` / `stroke-opacity`。
4. **禁区**: 无 `clipPath`, `mask`, `filter`。
+### 禁用元素 (黑名单)
+
+- `clipPath`, `mask` (裁剪/遮罩)
+- `<style>`, `class`, `id` (样式表)
+- `foreignObject` (外部对象)
+- `textPath` (路径文本)
+- `animate`, `animateTransform`, `set` (动画)
+- `<filter>` (滤镜)
+- `rgba()` 颜色格式 (必须用 hex + opacity)
+- `<g opacity="...">` (组透明度,需单独设置)
+
---
-## 八、占位符清单
+## 十、占位符规范
| 占位符 | 描述 |
| ------------------ | ------------------ |
@@ -124,4 +162,12 @@
| `{{CHAPTER_NUM}}` | 章节编号 (01, 02) |
| `{{PAGE_TITLE}}` | 内容页标题 |
| `{{STAT_1}}` | 统计数据1 |
+| `{{CONTENT_AREA}}` | 内容区域标识 |
+
+---
+
+## 十一、使用说明(推荐)
+1. **Logo**: 推荐使用白色 PNG Logo 以适应深色背景。
+2. **背景图**: 封面背景网格已嵌入 SVG,无需外部图片。
+3. **字体**: 优先使用无衬线字体,英文推荐 Roboto 或 Arial。
diff --git "a/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\225\206\345\212\241/design_spec.md" "b/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\225\206\345\212\241/design_spec.md"
index 4dcaa37a..fdf7fcb0 100644
--- "a/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\225\206\345\212\241/design_spec.md"
+++ "b/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\225\206\345\212\241/design_spec.md"
@@ -80,7 +80,7 @@
---
-## 六、页面类型详细设计
+## 六、页面类型
### 1. 封面页 (01_cover.svg)
- **视觉重心**: 左侧大面积留白或图片,右侧/底部深色科技感切割。
@@ -105,9 +105,34 @@
---
-## 七、SVG 技术约束 & 最佳实践
+## 七、布局模式(推荐)
+
+### 1. 卡片式列表 (Card List)
+- 宽卡片垂直排列,适合目录或要点陈述。
+- 使用阴影模拟(如透明黑色矩形)增加浮动感。
+
+### 2. 对比布局 (Contrast Layout)
+- 左右分栏,左深右浅或左图右文,强调对比。
+
+### 3. 中心辐射 (Radial)
+- 核心概念居中,四周环绕说明,适合章节页或总结页。
+
+---
+
+## 八、间距规范
+
+| 属性 | 值 | 说明 |
+| ------------ | ----- | ------------------------ |
+| **基础单位** | 8px | 8px 栅格系统 |
+| **模块间距** | 32px | 舒适的阅读间距 |
+| **卡片间距** | 16px | 紧凑与关联感 |
+
+---
+
+## 九、SVG 技术约束
### 必须遵守
+
1. **渐变支持**: 使用 `<linearGradient>` 和 `<radialGradient>` 定义在 `<defs>` 中。
2. **阴影模拟**: PPT不支持 SVG滤镜阴影,使用**半透明黑色矩形 (`fill="#000000" fill-opacity="0.1"`)** 错位叠加来模拟卡片阴影。
3. **透明度**: 严格使用 `fill-opacity` / `stroke-opacity`。
@@ -115,7 +140,7 @@
---
-## 八、占位符清单
+## 十、占位符规范
| 占位符 | 描述 |
| ------------------ | ------------------ |
@@ -127,3 +152,11 @@
| `{{CHAPTER_NUM}}` | 章节编号 (01, 02) |
| `{{LOGO_LARGE}}` | 封面/封底大Logo |
| `{{LOGO_HEADER}}` | 导航栏小Logo |
+
+---
+
+## 十一、使用说明(推荐)
+
+1. **阴影处理**: 所有卡片阴影已通过矢量矩形模拟,不仅兼容性好,而且支持无损缩放。
+2. **渐变**: 如需修改渐变色,请在 `<defs>` 区域调整 `stop-color`。
+3. **Logo**: 建议使用透明底 PNG,对于深色背景页使用反白 Logo。
diff --git "a/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\270\270\350\247\204/design_spec.md" "b/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\270\270\350\247\204/design_spec.md"
index 963862fc..52f8bde8 100644
--- "a/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\270\270\350\247\204/design_spec.md"
+++ "b/templates/layouts/\344\270\255\346\261\275\347\240\224_\345\270\270\350\247\204/design_spec.md"
@@ -44,7 +44,7 @@
| 角色 | 色值 | 用途 |
| -------------- | ----------- | ---------------------- |
| **主文字** | `#333333` | 正文、标题 |
-| **白色文字** | `#FFFFFF` | 深蓝色块上的文字 |
+| **白色文字** | `#FFFFFF` | 深色色块上的文字 |
| **辅助文字** | `#666666` | 置灰章节、辅助说明 |
| **浅色辅助** | `#999999` | 注释、页码、提示 |
@@ -137,7 +137,7 @@
---
-## 七、布局模式
+## 七、布局模式(推荐)
| 模式 | 适用场景 |
| ------------------ | -------------------------- |
@@ -202,21 +202,9 @@
---
-## 十一、图片资源
+## 十一、使用说明(推荐)
-模板目录可包含以下图片文件:
-
-| 文件名 | 尺寸 | 用途 |
-| ---------------- | ---------- | ------------------ |
-| 右上角 logo.png | 113×50 | 页眉Logo |
-| 大型 logo.png | 592×238 | 封面/结束页Logo |
-
----
-
-## 十二、使用说明
-
-1. 复制模板到项目目录
-2. 替换 images 目录中的 Logo 文件
-3. 根据内容需求选择合适的页面模板
-4. 使用占位符标记需要替换的内容
-5. 通过 Executor 角色生成最终 SVG
+1. **模板部署**: 复制模板到项目目录。
+2. **资源替换**: 替换 `images` 目录中的 `大型 logo.png` (592×238) 和 `右上角 logo.png` (113×50)。
+3. **内容生成**: 根据内容需求选择合适的页面模板,使用 `{{}}` 占位符替换内容。
+4. **生成 SVG**: 通过自动化脚本生成最终 SVG 文件。
diff --git "a/templates/layouts/\344\270\255\346\261\275\347\240\224_\347\216\260\344\273\243/design_spec.md" "b/templates/layouts/\344\270\255\346\261\275\347\240\224_\347\216\260\344\273\243/design_spec.md"
index 73e91aee..9dfbd6a1 100644
--- "a/templates/layouts/\344\270\255\346\261\275\347\240\224_\347\216\260\344\273\243/design_spec.md"
+++ "b/templates/layouts/\344\270\255\346\261\275\347\240\224_\347\216\260\344\273\243/design_spec.md"
@@ -81,7 +81,7 @@
---
-## 六、页面类型详细设计
+## 六、页面类型
### 1. 封面页 (01_cover.svg)
- **视觉重心**: **深邃空间感**。背景使用深蓝径向渐变。
@@ -110,8 +110,57 @@
---
-## 七、SVG 技术约束
+## 七、布局模式(推荐)
+
+### 1. 悬浮时间轴 (Floating Timeline)
+- 利用右侧空间展示时间或流程。
+- 节点使用 neon glowing effect。
+
+### 2. HUD 数据展示 (HUD Display)
+- 模拟抬头显示器风格,使用细线框和高亮数字展示关键 KPI。
+
+### 3. 不对称对比 (Asymmetric Contrast)
+- 利用页面非对称结构,创造动感的图文排版。
+
+---
+
+## 八、间距规范
+
+| 属性 | 值 | 说明 |
+| ------------ | ----- | ------------------------ |
+| **基础单位** | 8px | 科技感通常使用 8px 栅格 |
+| **模块间距** | 48px | 极为宽敞的现代感 |
+| **行距** | 1.6 | 增加行距提升可读性 |
+
+---
+
+## 九、SVG 技术约束
+
+### 必须遵守
1. **混合模式**: 尽量避免 `mix-blend-mode`,使用透明度 (`opacity`) 替代。
2. **渐变**: 多用 `linearGradient` 有角度的渐变 (e.g., `x1="0%" y1="0%" x2="100%" y2="50%"`) 制造光影。
3. **描边**: 使用细的 `stroke-width="1"` 加上低透明度 `stroke-opacity="0.2"` 模拟玻璃边缘。
+
+---
+
+## 十、占位符规范
+
+| 占位符 | 描述 |
+| ------------------ | ------------------ |
+| `{{TITLE}}` | 演示文稿主标题 |
+| `{{SUBTITLE}}` | 副标题 |
+| `{{AUTHOR}}` | 汇报单位 |
+| `{{PRESENTER}}` | 汇报人 |
+| `{{DATE}}` | 日期 |
+| `{{CHAPTER_NUM}}` | 章节编号 (01, 02) |
+| `{{PAGE_TITLE}}` | 内容页标题 |
+| `{{STAT_1}}` | 统计数据1 |
+
+---
+
+## 十一、使用说明(推荐)
+
+1. **光影效果**: 所有的光影均由 SVG 渐变实现,不依赖外部图片。
+2. **字体**: 为获得最佳科技感,数字建议强制使用 **Roboto** 或 **DIN** 字体。
+3. **背景**: 深色背景在投影仪上效果极佳,但需注意环境光尽可能暗。