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(charts): 重构图表模板库文档并增加角色绘制指引 - 重构 [templates/charts/README.md],将长列表优化为表格化索引,方便快速查找全部 33 种图表 - 在多个执行者角色文档中(Consultant、General等),增加绘制前阅读参考 SVG 模板的建议,以提升生成质量

hugohe32312944fa36e
diff --git a/roles/Executor_Consultant.md b/roles/Executor_Consultant.md
index 0ef7cec7..9a8e64a5 100644
--- a/roles/Executor_Consultant.md
+++ b/roles/Executor_Consultant.md
@@ -171,6 +171,10 @@
| 战略定位 | `matrix_2x2.svg` |
| 发展历程 | `timeline.svg` |
+完整图表目录和选择指南:[templates/charts/README.md](../templates/charts/README.md)
+
+> 📖 **建议**:当页面涉及图表时,建议先阅读对应的模板 SVG 文件(如 `templates/charts/bar_chart.svg`),了解其结构和布局,以便绘制出更高质量的图表。
+
## 布局模式
### PPT 16:9 (1280×720)
diff --git a/roles/Executor_Consultant_Top.md b/roles/Executor_Consultant_Top.md
index 02a273b6..4cb2d4a8 100644
--- a/roles/Executor_Consultant_Top.md
+++ b/roles/Executor_Consultant_Top.md
@@ -259,6 +259,10 @@
| 战略定位 | `matrix_2x2.svg` | 双维度分析 |
| 发展历程 | `timeline.svg` | 里程碑展示 |
+完整图表目录和选择指南:[templates/charts/README.md](../templates/charts/README.md)
+
+> 📖 **建议**:当页面涉及图表时,建议先阅读对应的模板 SVG 文件(如 `templates/charts/bar_chart.svg`),了解其结构和布局,以便绘制出更高质量的图表。
+
---
## 布局模式
diff --git a/roles/Executor_General.md b/roles/Executor_General.md
index 8203db74..10af84eb 100644
--- a/roles/Executor_General.md
+++ b/roles/Executor_General.md
@@ -204,6 +204,10 @@
位于 [templates/charts/](../templates/charts/):`kpi_cards` `bar_chart` `line_chart` `donut_chart` `funnel_chart` `matrix_2x2` `timeline` `process_flow`
+完整图表目录和选择指南:[templates/charts/README.md](../templates/charts/README.md)
+
+> 📖 **建议**:当页面涉及图表时,建议先阅读对应的模板 SVG 文件(如 `templates/charts/bar_chart.svg`),了解其结构和布局,以便绘制出更高质量的图表。
+
## 布局参考
### PPT 16:9 (1280×720)
diff --git a/templates/charts/README.md b/templates/charts/README.md
index db49ba6d..431ea877 100644
--- a/templates/charts/README.md
+++ b/templates/charts/README.md
@@ -1,489 +1,95 @@
-# SVG 图表模板库
+# SVG 图表模板库(33 种)
-本目录包含 **33 种**标准化 SVG 图表模板,按使用频率和功能分类,方便快速查找。
+本目录包含 33 种标准化 SVG 图表模板。生成图表页面前,建议先阅读对应模板文件了解其结构和布局。
-## 📋 目录
+## 快速选择
-- [快速选择指南](#快速选择指南)
-- [常用图表](#常用图表)(高频使用)
-- [进阶图表](#进阶图表)(中频使用)
-- [专业图表](#专业图表)(特定场景)
-- [通用规范](#通用规范)
-- [自定义指南](#自定义指南)
-
----
-
-## 快速选择指南
-
-| 我想展示... | 推荐图表 | 文件名 |
+| 我想展示... | 推荐模板 | 文件名 |
|------------|---------|--------|
-| 几个数字指标 | KPI 卡片 | `kpi_cards.svg` |
-| 类别数值对比 | 柱状图 / 条形图 | `bar_chart.svg` |
-| 时间趋势变化 | 折线图 / 面积图 | `line_chart.svg` |
-| 占比构成 | 饼图 / 环形图 | `pie_chart.svg` |
-| 目标完成度 | 进度条 / 仪表盘 | `progress_bar_chart.svg` |
+| 关键数字指标 | KPI 卡片 | `kpi_cards.svg` |
+| 类别数值对比 | 柱状图 | `bar_chart.svg` |
+| 长标签排名 | 水平条形图 | `horizontal_bar_chart.svg` |
+| 多系列对比 | 分组柱状图 | `grouped_bar_chart.svg` |
+| 时间趋势 | 折线图 | `line_chart.svg` |
+| 累积趋势 | 面积图 | `area_chart.svg` |
+| 占比构成 | 饼图 / 环形图 | `pie_chart.svg` / `donut_chart.svg` |
+| 目标完成度 | 进度条 / 仪表盘 | `progress_bar_chart.svg` / `gauge_chart.svg` |
| 转化漏斗 | 漏斗图 | `funnel_chart.svg` |
| 项目排期 | 甘特图 | `gantt_chart.svg` |
+| 里程碑事件 | 时间轴 | `timeline.svg` |
| 多维评估 | 雷达图 | `radar_chart.svg` |
-| 多维排名对比 | 哑铃图 | `dumbbell_chart.svg` |
-| 资金/流量流向 | 桑基图 | `sankey_chart.svg` |
-| 战略分析 | SWOT / 波特五力 | `swot_analysis.svg` |
-
----
-
-## 常用图表
-
-> ⭐ 日常数据展示最常用的图表类型
-
-### 📊 对比类
-
-#### 柱状图 (bar_chart.svg)
-
-**用途**:类别数据对比(垂直柱状)
-
-**特点**:支持 3-8 个柱子 · 数值标签自动对齐 · 可选网格线
-
-**适用场景**:销售额对比、区域排名、年度数据对比
-
----
-
-#### 水平条形图 (horizontal_bar_chart.svg)
-
-**用途**:类别排名、数值对比(适合长标签)
-
-**特点**:支持 5-12 个条形 · 水平布局便于阅读 · 渐变色填充
-
-**适用场景**:品牌排行榜、销售排名、满意度评分
-
----
-
-#### 分组柱状图 (grouped_bar_chart.svg)
-
-**用途**:多系列数据对比
-
-**特点**:支持 3-6 组 × 2-4 系列 · 不同颜色区分系列
-
-**适用场景**:季度产品线对比、同比环比分析、多区域对比
-
----
-
-### 📈 趋势类
-
-#### 折线图 (line_chart.svg)
-
-**用途**:趋势和变化展示
-
-**特点**:线条 2-3px · 数据点圆形标记 · 支持多条折线对比
-
-**适用场景**:时间序列分析、增长趋势、多指标对比
-
----
-
-#### 面积图 (area_chart.svg)
-
-**用途**:趋势变化、累积数据展示
-
-**特点**:渐变填充强调累积量 · 峰值标注功能 · 底部统计卡片
-
-**适用场景**:网站流量趋势、用户增长、销售累积
-
----
-
-#### 双Y轴折线图 (dual_axis_line_chart.svg)
-
-**用途**:两个不同量纲指标的时序对比
-
-**特点**:左右独立Y轴 · 实线+虚线区分 · 阶段分隔标注
-
-**适用场景**:销量与利润率、流量与转化率、产量与能耗
-
----
-
-### 🥧 占比类
-
-#### 饼图 (pie_chart.svg)
-
-**用途**:占比和构成分析(基础版)
-
-**特点**:支持 3-6 个分块 · 渐变色填充 · 右侧详细图例
-
-**适用场景**:市场份额、预算分配、类别构成(3-5类)
-
----
-
-#### 环形图 (donut_chart.svg)
-
-**用途**:占比和构成分析(带中心数据)
-
-**特点**:中心可显示总计 · 起始角度12点方向 · 视觉更现代
-
-**适用场景**:市场份额、结构占比、类别构成(3-6类)
-
----
-
-#### 堆叠柱状图 (stacked_bar_chart.svg)
-
-**用途**:多类别构成对比、占比趋势
-
-**特点**:支持 3-6 个堆叠类别 · 顶部显示总计 · 图例清晰
-
-**适用场景**:收入构成分析、市场份额变化、预算分配对比
-
----
-
-### 🎯 指标类
-
-#### KPI 卡片 (kpi_cards.svg)
-
-**用途**:展示关键业绩指标
-
-**特点**:2×2 或 1×4 布局 · 大号数字 48-56px · 趋势箭头
-
-**适用场景**:财务指标总览、业务数据看板、增长率展示
-
----
-
-#### 仪表盘图 (gauge_chart.svg)
-
-**用途**:单一指标达成度展示
-
-**特点**:半圆仪表盘 · 三色分区 · 指针指示 · 状态标签
-
-**适用场景**:KPI完成率、健康指数、性能监控
-
----
-
-#### 进度条图 (progress_bar_chart.svg)
-
-**用途**:多项目标完成进度对比
-
-**特点**:水平进度条 · 目标线标注 · 四色状态 · 概览卡片
-
-**适用场景**:OKR进度追踪、项目完成度、预算执行情况
-
----
-
-## 进阶图表
-
-> 📈 业务分析和项目管理常用图表
-
-### 📊 对比类(进阶)
-
-#### 哑铃图 / 点阵范围图 (dumbbell_chart.svg)
-
-**用途**:同一对象多维度得分对比、多指标评估
-
-**特点**:8-12 个类别 · 3-5 个维度 · 彩色数据点 · 连接线展示范围
-
-**适用场景**:国家/城市排名对比、竞品多维评估、综合指数展示、能力雷达替代方案
-
----
-
-#### 对比条形图 / 蝴蝶图 (butterfly_chart.svg)
-
-**用途**:左右双向数据对比
-
-**特点**:中轴对称布局 · 渐变色区分 · 百分比标签
-
-**适用场景**:人口金字塔、男女用户对比、AB测试、收支对比
-
----
-
-#### 子弹图 (bullet_chart.svg)
-
-**用途**:目标vs实际对比(比仪表盘更省空间)
-
-**特点**:三色背景范围 · 目标线标注 · 达成率标签
-
-**适用场景**:年度KPI达成、销售目标对比、绩效评估
-
----
-
-#### 瀑布图 (waterfall_chart.svg)
-
-**用途**:增减变化分析、财务分解
-
-**特点**:增加项绿色 / 减少项红色 · 连接线展示累计
-
-**适用场景**:年度利润分解、预算变化、成本构成变化
-
----
-
-### 📈 趋势类(进阶)
-
-#### 堆叠面积图 (stacked_area_chart.svg)
-
-**用途**:多系列累积趋势、构成变化
-
-**特点**:支持 4 个系列堆叠 · 渐变色填充 · 峰值标注
-
-**适用场景**:营收来源趋势、流量来源变化、市场份额演进
-
----
-
-### 🔍 分析类
-
-#### 雷达图 (radar_chart.svg)
-
-**用途**:多维度能力评估、综合对比
-
-**特点**:支持 4-8 个维度 · 多边形网格 · 多系列对比
-
-**适用场景**:能力素质评估、竞品对比、员工绩效、产品特性
-
----
-
-#### 散点图 (scatter_chart.svg)
-
-**用途**:相关性分析、数据分布展示
-
-**特点**:支持 2 个系列 · 趋势线 · 统计信息面板
-
-**适用场景**:广告投入vs销售额、价格vs需求、投入产出分析
-
----
-
-#### 漏斗图 (funnel_chart.svg)
-
-**用途**:转化流程分析
-
-**特点**:3-5 个阶段 · 渐变色填充 · 转化率计算 · 损失标注
-
-**适用场景**:销售漏斗、用户转化、流程效率分析
-
----
-
-#### 矩阵图 / 四象限 (matrix_2x2.svg)
-
-**用途**:四象限分析
-
-**特点**:2×2 布局 · 坐标轴清晰 · 数据点可定制
-
-**适用场景**:波士顿矩阵、风险评估、优先级分析
-
----
-
-### 📅 项目管理类
-
-#### 甘特图 (gantt_chart.svg)
-
-**用途**:项目进度规划、时间线管理
-
-**特点**:6-12 个任务 · 时间轴 · 依赖关系线 · 里程碑标记
-
-**适用场景**:项目管理看板、产品路线图、任务排期
-
----
-
-#### 时间轴 (timeline.svg)
-
-**用途**:时序事件展示
-
-**特点**:水平/垂直布局 · 节点清晰 · 支持 3-8 个节点
-
-**适用场景**:项目里程碑、历史演进、产品路线图
-
----
-
-#### 流程图 (process_flow.svg)
-
-**用途**:业务流程、操作步骤展示
-
-**特点**:标准化步骤卡片 · 决策节点菱形 · 三种节点类型
-
-**适用场景**:业务流程图、操作指南、决策流程
-
----
-
-### 🏢 关系类
-
-#### 组织结构图 (org_chart.svg)
-
-**用途**:层级关系展示、组织架构可视化
-
-**特点**:支持 2-4 层 · 卡片式节点 · 清晰连接线
-
-**适用场景**:公司组织架构、团队结构、汇报关系
-
----
-
-## 专业图表
-
-> 🔬 特定分析场景使用的专业图表
-
-### 📊 统计分析类
-
-#### 箱线图 (box_plot_chart.svg)
-
-**用途**:数据分布和统计分析
-
-**特点**:5组对比 · 四分位数 · 异常值标记 · 统计摘要
-
-**适用场景**:薪资分布分析、成绩统计、质量控制、异常检测
-
----
-
-#### 热力图 (heatmap_chart.svg)
-
-**用途**:矩阵数据可视化、密度展示
-
-**特点**:7×8 矩阵 · 蓝-黄-红色阶 · 数值标签 · 洞察卡片
-
-**适用场景**:用户活跃度时段、相关性矩阵、日历热图
-
----
-
-#### 帕累托图 (pareto_chart.svg)
-
-**用途**:80/20分析,识别关键因素
-
-**特点**:柱状图+累计折线 · 80%高亮 · 双Y轴 · 洞察建议框
-
-**适用场景**:质量问题归因、销售贡献分析、客户投诉分类
-
----
-
-### 🌊 流向类
-
-#### 桑基图 (sankey_chart.svg)
-
-**用途**:数据流向、转化路径可视化
-
-**特点**:三层级节点 · 贝塞尔曲线 · 流量宽度代表数值
-
-**适用场景**:预算分配流向、能源流向、用户转化路径
-
----
-
-### 📦 层级占比类
-
-#### 矩形树图 (treemap_chart.svg)
-
-**用途**:层级数据占比可视化
-
-**特点**:多层级嵌套 · 面积代表数值 · 颜色区分类别
-
-**适用场景**:预算分配可视化、磁盘空间、市场份额构成
-
----
-
-### 🎯 多维数据类
-
-#### 气泡图 (bubble_chart.svg)
-
-**用途**:三维数据展示(X轴、Y轴、气泡大小)
-
-**特点**:四象限背景 · 气泡大小代表第三维度 · 产品列表面板
-
-**适用场景**:波士顿矩阵、市场规模vs增长率vs份额、竞品分析
-
----
-
-### 🎯 战略框架类
-
-#### SWOT 分析图 (swot_analysis.svg)
-
-**用途**:战略分析、竞争态势评估
-
-**特点**:四象限卡片 · 颜色编码(绿/红/蓝/橙)· 中心品牌标识
-
-**适用场景**:商业计划书、战略规划、竞品分析、可行性评估
-
----
-
-#### 波特五力图 (porter_five_forces.svg)
-
-**用途**:行业竞争分析、战略规划
-
-**特点**:五力放射状布局 · 威胁程度进度条 · 战略建议面板
-
-**适用场景**:行业分析报告、市场进入评估、竞争策略制定
-
----
-
-## 通用规范
-
-### 画布格式
-
-所有模板默认为 **1280×720 (16:9)** 画布。其他格式按比例调整:
-
-| 格式 | 尺寸 | 适配建议 |
-|------|------|---------|
-| PPT 4:3 | 1024×768 | 宽度缩放至 80% |
-| 小红书 | 1242×1660 | 竖屏布局,元素垂直排列 |
-| 方形 | 1080×1080 | 居中布局,调整边距 |
-| Story | 1080×1920 | 竖屏长图,增加垂直间距 |
-
-### 配色方案
-
-**咨询风格**(专业、沉稳):
-```
-主色:#005587 辅色:#0076A8
-强调:#F5A623 警示:#E74C3C 成功:#27AE60
-```
-
-**通用风格**(现代、活力):
-```
-蓝色组:#2196F3, #42A5F5, #90CAF9
-绿色组:#4CAF50, #66BB6A, #81C784
-橙色组:#FF9800, #FFA726, #FFB74D
-```
-
-### 文本规范
-
-| 元素 | 字号 | 字重 |
-|------|------|------|
-| 标题 | 24-32px | bold |
-| 正文 | 16-20px | normal |
-| 数值 | 32-56px | bold |
-| 标注 | 13-15px | normal |
-
-### 必须遵守
-
-❌ 禁止使用 `<foreignObject>` → ✅ 使用 `<tspan>` 手动换行
-❌ 禁止混用字体 → ✅ 统一使用系统 UI 字体栈
-
----
-
-## 自定义指南
-
-### 修改颜色
-
-```xml
-<!-- 修改前 -->
-<rect fill="#2196F3" />
-<!-- 修改后 -->
-<rect fill="#FF5722" />
-```
-
-### 更换数据
-
-1. **文本内容**:修改 `<text>` 中的 `<tspan>` 内容
-2. **数值**:同步修改图表元素(如柱高)和文本标签
-3. **数据点数量**:复制已有元素结构,调整位置
-
----
-
-## 质量检查清单
-
-- [ ] **对齐**:所有元素沿网格线对齐
-- [ ] **对比**:标题、数值、标注层次清晰
-- [ ] **重复**:相同类型元素样式一致
-- [ ] **亲密性**:相关元素靠近,不相关元素分离
-- [ ] `viewBox` 与画布格式一致
-- [ ] 无 `<foreignObject>` 元素
-
----
-
-## 参考资源
-
-- **设计规范**:`docs/design_guidelines.md`
-- **画布格式**:`docs/canvas_formats.md`
-- **工作流程**:`docs/workflow_tutorial.md`
-- **示例项目**:`examples/`
-
----
-
-**维护者**:PPT Master Team
-**最后更新**:2025-12-12
-**模板数量**:33 种图表类型
+| 左右双向对比 | 蝴蝶图 | `butterfly_chart.svg` |
+| 增减分解 | 瀑布图 | `waterfall_chart.svg` |
+| 流量/资金流向 | 桑基图 | `sankey_chart.svg` |
+| 战略分析 | SWOT / 波特五力 | `swot_analysis.svg` / `porter_five_forces.svg` |
+| 四象限分析 | 矩阵图 | `matrix_2x2.svg` |
+
+## 完整图表索引
+
+### 对比类
+
+| 文件名 | 用途 | 适用场景 |
+|--------|------|---------|
+| `bar_chart.svg` | 垂直柱状对比(3-8 柱) | 销售额对比、区域排名 |
+| `horizontal_bar_chart.svg` | 水平条形排名(5-12 条) | 品牌排行、满意度评分 |
+| `grouped_bar_chart.svg` | 多系列分组对比 | 季度产品线对比、同比环比 |
+| `stacked_bar_chart.svg` | 堆叠构成对比 | 收入构成、市场份额变化 |
+| `butterfly_chart.svg` | 左右双向对比 | 人口金字塔、AB 测试、收支对比 |
+| `bullet_chart.svg` | 目标 vs 实际 | KPI 达成、绩效评估 |
+| `dumbbell_chart.svg` | 多维度得分对比 | 竞品评估、综合指数 |
+| `waterfall_chart.svg` | 增减变化分解 | 利润分解、预算变化 |
+
+### 趋势类
+
+| 文件名 | 用途 | 适用场景 |
+|--------|------|---------|
+| `line_chart.svg` | 折线趋势(支持多条) | 时间序列、增长趋势 |
+| `area_chart.svg` | 面积累积趋势 | 流量趋势、用户增长 |
+| `stacked_area_chart.svg` | 多系列堆叠趋势 | 营收来源、流量来源变化 |
+| `dual_axis_line_chart.svg` | 双 Y 轴不同量纲对比 | 销量与利润率、流量与转化率 |
+
+### 占比类
+
+| 文件名 | 用途 | 适用场景 |
+|--------|------|---------|
+| `pie_chart.svg` | 基础占比(3-6 块) | 市场份额、预算分配 |
+| `donut_chart.svg` | 环形占比(带中心数据) | 结构占比、类别构成 |
+| `treemap_chart.svg` | 层级面积占比 | 预算分配、市场份额构成 |
+
+### 指标类
+
+| 文件名 | 用途 | 适用场景 |
+|--------|------|---------|
+| `kpi_cards.svg` | 关键指标卡片(2×2 / 1×4) | 财务总览、数据看板 |
+| `gauge_chart.svg` | 仪表盘达成度 | KPI 完成率、性能监控 |
+| `progress_bar_chart.svg` | 多项进度条对比 | OKR 进度、项目完成度 |
+
+### 分析类
+
+| 文件名 | 用途 | 适用场景 |
+|--------|------|---------|
+| `radar_chart.svg` | 多维度评估(4-8 维) | 能力评估、竞品对比 |
+| `scatter_chart.svg` | 相关性 / 分布 | 投入产出、价格需求 |
+| `funnel_chart.svg` | 转化漏斗(3-5 阶段) | 销售漏斗、用户转化 |
+| `matrix_2x2.svg` | 四象限分析 | 波士顿矩阵、优先级分析 |
+| `bubble_chart.svg` | 三维气泡(X/Y/大小) | 市场规模 vs 增长率 vs 份额 |
+| `heatmap_chart.svg` | 矩阵热力图 | 用户活跃时段、相关性矩阵 |
+| `pareto_chart.svg` | 80/20 帕累托分析 | 质量归因、销售贡献 |
+| `box_plot_chart.svg` | 箱线图分布统计 | 薪资分布、质量控制 |
+
+### 项目管理 / 关系类
+
+| 文件名 | 用途 | 适用场景 |
+|--------|------|---------|
+| `gantt_chart.svg` | 甘特图排期(6-12 任务) | 项目管理、产品路线图 |
+| `timeline.svg` | 时间轴事件(3-8 节点) | 里程碑、历史演进 |
+| `process_flow.svg` | 流程图步骤 | 业务流程、操作指南 |
+| `org_chart.svg` | 组织结构(2-4 层) | 公司架构、汇报关系 |
+| `sankey_chart.svg` | 数据流向(三层级) | 预算流向、用户转化路径 |
+
+### 战略框架类
+
+| 文件名 | 用途 | 适用场景 |
+|--------|------|---------|
+| `swot_analysis.svg` | SWOT 四象限分析 | 战略规划、竞品分析 |
+| `porter_five_forces.svg` | 波特五力模型 | 行业分析、市场进入评估 |