elite-ppt-pro

Elite PPT Pro — 顶级咨询PPT融合技能

融合 consult-ppt-style（多风格版式库）× McKinsey Presentation Generator（数据驱动工作流）的最佳实践

---

核心设计理念

---

工作流（必须按顺序执行）

Step 1：研究阶段（绝不跳过）

数据质量决定PPT质量。先收集，再设计。

必须收集的信息

1. 市场规模、CAGR、增速数据
2. 竞争对手份额与对比
3. 历史趋势数据（用于图表）
4. 关键指标与里程碑
5. 行业预测与展望

数据来源优先级

完成研究的最低标准

• ≥15个具体数据点（带数字）
• ≥5个不同来源
• 每张内容幻灯片均有对应数据
• 至少1组历史趋势数据（用于折线/柱状图）
• 竞争对比数据
• 所有引用标注来源名称和日期

研究记录格式

## 研究摘要

### 主题：[主题名称]
研究日期：[当前日期]

---

### 第N页：[页面标题]

**关键数据：**
1. [数据点] - [数值/比率]  来源：[机构名] [日期]
2. ...

**图表数据（如适用）：**
| 年份 | 数值 | 同比增长 |
|------|------|---------|
| 2023 | $XX  | +XX%    |
| 2024 | $XX  | +XX%    |

**引用标注：** Source: [机构1], [机构2] | [时间段]

---

### 所有来源汇总
| # | 来源名 | 类型 | 日期 | 可靠性 |
|---|--------|------|------|--------|
| 1 | [名称] | 报告/新闻/官方 | [日期] | 高/中 |

---

Step 2：策划幻灯片结构

基于研究结果规划页面：

默认10页结构：

1. 封面 Cover
2. 核心洞察摘要（3-4个结论） 3-8. 内容页（数据+图表+分析，每页对应一个核心观点）
3. 执行建议
4. 附录/数据来源

典型页数：8-15页

---

Step 3：选择风格

根据场景选择合适风格（可跨风格混搭）：

---

Step 4：选择版式（38种）

详见 slide-types.md

数据驱动版式推荐：

---

Step 5：生成PPTX代码

使用 pptxgenjs 生成 .pptx 文件，规范见技术规范章节。

每页代码结构模板

function createSlide_N(pres, theme, data) {
  // data = 从研究阶段收集的实际数据对象
  const slide = pres.addSlide();
  slide.background = { color: "FFFFFF" };

  // 1. 顶部标题条（必须）
  addEliteHeader(slide, pres, "结论性标题，直接写出洞察", "Conclusion as Title");

  // 2. 内容区域（至少4个区域）
  // 区域1：关键指标/数字
  // 区域2：图表（柱状/折线/散点）
  // 区域3：分析要点（3-5条）
  // 区域4：背景/对比数据

  // 3. 数据来源引用（必须）
  addDataSource(slide, pres, "Source: [机构], [机构] | [时间段]");

  // 4. 页码徽章（非封面页必须）
  addPageBadge(slide, pres, N);

  return slide;
}

---

Step 6：HTML预览版（可选但推荐）

在生成PPTX同时，生成对应HTML版本用于：

• 浏览器全屏演示（无需PPT软件）
• 在线分享链接
• 高保真效果预览

HTML版遵循麦肯锡设计规范：

• 白色背景强制（内容页）
• SVG图表（矢量，无失真）
• 数据来源标注在每页底部

---

Step 7：QA检查

生成后必须执行以下检查，详见 qa-checklist.md：

• 标题是结论，不是话题
• 每个数据点有来源标注
• 每页≥4个内容区域
• 全文最多2个强调色（图表多系列除外）
• 文字无截断（wrap: true）
• 布局不超出幻灯片边界

---

七大风格配色体系

风格A：咨询青绿色（麦肯锡/BCG风格）

const themeA = {
  primary:   "1A1A2E",  // 深藏青
  secondary: "2D6A6A",  // 深青绿
  accent:    "00A69C",  // 亮青绿（主强调色）
  light:     "E8F7F6",  // 浅青绿
  bg:        "FFFFFF",
  darkText:  "333333",
  midText:   "666666",
  border:    "DDDDDD",
};

风格B：职场汇报紫色

const themeB = {
  primary:   "4527A0",
  secondary: "7B5EA7",
  accent:    "9575CD",
  light:     "EDE7F6",
  bg:        "FAFAFA",
  darkText:  "1A1A1A",
  midText:   "666666",
  border:    "D1C4E9",
};

风格C：InsightX商业绿

const themeC = {
  primary:   "1B5E4A",
  secondary: "2D8A6A",
  accent:    "4CAF50",
  light:     "E8F7F0",
  bg:        "FFFFFF",
  darkText:  "333333",
  midText:   "666666",
  border:    "CCEECC",
};

风格D：贝恩红（消费者洞察）

const themeD = {
  primary:   "C41E3A",
  secondary: "E53935",
  accent:    "FFCDD2",
  light:     "FDEAEA",
  bg:        "FFFFFF",
  darkText:  "1A1A1A",
  midText:   "666666",
  border:    "EEEEEE",
};

风格E：埃森哲蓝（数字化转型）

const themeE = {
  primary:   "0369A1",
  secondary: "0288D1",
  accent:    "E3F2FD",
  light:     "F5FAFF",
  bg:        "FFFFFF",
  darkText:  "1A1A1A",
  midText:   "666666",
  border:    "BBDEFB",
};

风格F：消费者橙

const themeF = {
  primary:   "E65100",
  secondary: "FF9800",
  accent:    "FFF3E0",
  light:     "FFF8E1",
  bg:        "FFFFFF",
  darkText:  "333333",
  midText:   "666666",
  border:    "FFCC80",
};

风格G：数据科技蓝

const themeG = {
  primary:   "1A237E",
  secondary: "3949AB",
  accent:    "C5CAE9",
  light:     "E8EAF6",
  bg:        "FFFFFF",
  darkText:  "212121",
  midText:   "666666",
  border:    "9FA8DA",
};

麦肯锡标准深海军蓝

const themeMcK = {
  primary:   "0B1F3A",  // 深海军蓝
  secondary: "1B5AB5",  // 钴蓝
  accent:    "2E8BC0",  // 青蓝
  light:     "E8EEF7",
  bg:        "FFFFFF",
  darkText:  "2D2D2D",
  midText:   "8C8C8C",
  border:    "E0E0E0",
};

---

技术规范（pptxgenjs）

基础设置

const pptxgen = require("pptxgenjs");
const pres = new pptxgen();
pres.layout = "LAYOUT_16x9";  // 10 x 5.625 英寸

通用辅助函数

// ─── 顶部标题条 ───────────────────────────────────────
function addEliteHeader(slide, pres, titleCN, titleEN = "", theme = themeA) {
  // 顶部底色条
  slide.addShape("rect", {
    x: 0, y: 0, w: 10, h: 0.55,
    fill: { color: "FFFFFF" },
    line: { color: theme.border, width: 0.5 }
  });
  // 左侧强调竖条
  slide.addShape("rect", {
    x: 0, y: 0, w: 0.06, h: 0.55,
    fill: { color: theme.accent }, line: { color: theme.accent }
  });
  // 主标题（结论性语句）
  slide.addText(titleCN, {
    x: 0.15, y: 0.06, w: 8.3, h: 0.28,
    fontSize: 10, fontFace: "Microsoft YaHei",
    color: theme.primary, bold: true, wrap: true
  });
  // 英文副标题（可选）
  if (titleEN) {
    slide.addText(titleEN, {
      x: 0.15, y: 0.32, w: 7, h: 0.18,
      fontSize: 7.5, fontFace: "Arial",
      color: theme.midText, wrap: true
    });
  }
  // 右上角来源标注区
  slide.addText("Elite PPT Pro", {
    x: 8.5, y: 0.08, w: 1.4, h: 0.35,
    fontSize: 6, fontFace: "Arial",
    color: theme.midText, align: "right"
  });
}

// ─── 数据来源引用（页面底部）────────────────────────────
function addDataSource(slide, pres, sourceText, theme = themeA) {
  slide.addShape("line", {
    x: 0.2, y: 5.38, w: 9.6, h: 0,
    line: { color: theme.border, width: 0.5 }
  });
  slide.addText("Source: " + sourceText, {
    x: 0.2, y: 5.42, w: 8.5, h: 0.15,
    fontSize: 7.5, fontFace: "Arial",
    color: theme.midText, wrap: false
  });
}

// ─── 页码徽章 ─────────────────────────────────────────
function addPageBadge(slide, pres, pageNum, theme = themeA) {
  slide.addShape("rect", {
    x: 9.55, y: 5.2, w: 0.35, h: 0.25,
    fill: { color: theme.accent }, line: { color: theme.accent }
  });
  slide.addText(String(pageNum).padStart(2, "0"), {
    x: 9.55, y: 5.2, w: 0.35, h: 0.25,
    fontSize: 9, fontFace: "Arial",
    color: "FFFFFF", bold: true,
    align: "center", valign: "middle"
  });
}

// ─── 关键指标卡片 ─────────────────────────────────────
function addKPICard(slide, x, y, w, h, value, label, delta, theme = themeA) {
  // 卡片底色
  slide.addShape("rect", {
    x, y, w, h,
    fill: { color: theme.light }, line: { color: theme.border, width: 1 }
  });
  // 大数字
  slide.addText(value, {
    x: x + 0.1, y: y + 0.12, w: w - 0.2, h: 0.45,
    fontSize: 28, fontFace: "Arial", bold: true,
    color: theme.accent, align: "center"
  });
  // 指标标签
  slide.addText(label, {
    x: x + 0.1, y: y + 0.6, w: w - 0.2, h: 0.22,
    fontSize: 9, fontFace: "Microsoft YaHei",
    color: theme.darkText, align: "center", wrap: true
  });
  // 变化率（可选）
  if (delta) {
    const isPositive = delta.startsWith("+");
    slide.addText(delta, {
      x: x + 0.1, y: y + 0.82, w: w - 0.2, h: 0.18,
      fontSize: 9, fontFace: "Arial",
      color: isPositive ? "2D8A6A" : "C41E3A",
      align: "center", bold: true
    });
  }
}

// ─── 分析要点列表 ─────────────────────────────────────
function addBulletPoints(slide, x, y, w, h, title, points, theme = themeA) {
  // 标题
  slide.addText(title, {
    x, y, w, h: 0.28,
    fontSize: 10, fontFace: "Microsoft YaHei",
    color: theme.primary, bold: true
  });
  // 要点
  const bulletText = points.map(p => "▸ " + p).join("\n");
  slide.addText(bulletText, {
    x, y: y + 0.32, w, h: h - 0.32,
    fontSize: 10, fontFace: "Microsoft YaHei",
    color: theme.darkText, wrap: true, valign: "top",
    lineSpacingMultiple: 1.4
  });
}

// ─── 数据卡片（带来源）───────────────────────────────
function addDataCard(slide, x, y, w, h, title, content, source, borderColor, theme = themeA) {
  slide.addShape("rect", {
    x, y, w, h,
    fill: { color: "F8F9FA" }, line: { color: borderColor, width: 1.5 }
  });
  // 顶部色条
  slide.addShape("rect", {
    x, y, w, h: 0.06,
    fill: { color: borderColor }, line: { color: borderColor }
  });
  slide.addText(title, {
    x: x + 0.12, y: y + 0.1, w: w - 0.24, h: 0.26,
    fontSize: 11, fontFace: "Microsoft YaHei",
    color: borderColor, bold: true
  });
  slide.addText(content, {
    x: x + 0.12, y: y + 0.42, w: w - 0.24, h: h - 0.58,
    fontSize: 10, fontFace: "Microsoft YaHei",
    color: theme.darkText, wrap: true, valign: "top"
  });
  if (source) {
    slide.addText(source, {
      x: x + 0.12, y: y + h - 0.2, w: w - 0.24, h: 0.16,
      fontSize: 7, fontFace: "Arial",
      color: theme.midText, wrap: false
    });
  }
}

文字换行规则（关键！）

// ❌ 错误：文字会重叠
slide.addText('第一行\n第二行', { x:0.5, y:1, w:4, h:1 });

// ✅ 正确：必须加 wrap: true
slide.addText('第一行\n第二行', {
  x: 0.5, y: 1, w: 4, h: 1,
  wrap: true,    // 关键！
  valign: "top"
});

颜色规范

// ✅ 正确：6字符hex，无#前缀
color: "00A69C"

// ❌ 错误
color: "#00A69C"   // 带#
color: "00A69C33"  // 带透明度（pptxgenjs不支持）

形状类型（字符串形式）

// ✅ 使用字符串
slide.addShape("rect", { ... })
slide.addShape("oval", { ... })
slide.addShape("line", { ... })
slide.addShape("roundRect", { ... })

// ❌ 不要用 pres.ShapeType.xxx（可能不存在）

保存文件

pres.writeFile({ fileName: "output.pptx" })
    .then(() => console.log("✅ 生成成功！"))
    .catch(err => console.error("❌ 错误：", err));

---

设计规范（强制）

必须遵守

明确禁止

---

版式库（38种）

详见 slide-types.md

---

快速开始示例

const pptxgen = require("pptxgenjs");
const pres = new pptxgen();
pres.layout = "LAYOUT_16x9";

const theme = { /* 选择上面任一风格配色 */ ...themeA };

// 封面页
const cover = pres.addSlide();
cover.background = { color: theme.primary };
cover.addText("AI行业竞争格局深度分析", {
  x: 1, y: 1.6, w: 8, h: 1.2,
  fontSize: 40, fontFace: "Microsoft YaHei",
  color: "FFFFFF", bold: true, align: "center", wrap: true
});
cover.addText("全球AI市场规模2026年预计突破5000亿美元，竞争进入决战期", {
  x: 1.5, y: 3.0, w: 7, h: 0.5,
  fontSize: 14, fontFace: "Microsoft YaHei",
  color: theme.accent, align: "center", wrap: true
});
cover.addText("Source: Gartner, IDC, Goldman Sachs | 2025", {
  x: 3, y: 5.1, w: 4, h: 0.3,
  fontSize: 9, fontFace: "Arial",
  color: "FFFFFF88", align: "center"  // 注意：封面可用透明色
});

// 内容页（使用辅助函数）
const s1 = pres.addSlide();
s1.background = { color: "FFFFFF" };
addEliteHeader(s1, pres,
  "头部三家公司市占率合计超过65%，AI行业马太效应持续强化",
  "Top-3 Players control 65%+ market share", theme);

// KPI区域（4个指标卡片）
const kpis = [
  { v: "$847B", l: "全球AI市场规模", d: "+38% YoY" },
  { v: "65%",   l: "头部3家市占率", d: "+8pp YoY" },
  { v: "$2.1T", l: "2030年预测规模", d: "CAGR 42%" },
  { v: "1,240", l: "AI独角兽数量",   d: "+340 新增" }
];
kpis.forEach((k, i) => {
  addKPICard(s1, 0.25 + i * 2.38, 0.65, 2.2, 1.15, k.v, k.l, k.d, theme);
});

// 分析要点
addBulletPoints(s1, 0.25, 1.95, 5.5, 1.8, "核心洞察", [
  "OpenAI、Google、Anthropic三家占据基础模型市场2/3份额",
  "2025年AI投资同比增长180%，资金向头部集中趋势明显",
  "开源模型崛起：Llama生态年下载量超过10亿次",
  "企业级AI应用渗透率从12%升至34%，B端需求爆发"
], theme);

addDataSource(s1, pres, "Goldman Sachs AI Report, IDC Market Forecast | Q4 2025", theme);
addPageBadge(s1, pres, 2, theme);

pres.writeFile({ fileName: "ai-industry-analysis.pptx" })
    .then(() => console.log("✅ 生成完成！"));