PPTX 生成器与编辑器

概述

本技能可处理所有 PowerPoint 相关任务：读取/分析现有演示文稿、基于模板通过 XML 操作编辑幻灯片，以及使用 PptxGenJS 从零开始创建演示文稿。它包含一整套设计系统（配色方案、字体规范、样式配方），并为每种幻灯片类型提供详细实现指南。

快速参考

参考文件

读取内容

# 文本提取
python -m markitdown presentation.pptx

从零开始创建 — 工作流

适用于无可用模板或参考演示文稿的场景。

第 1 步：调研与需求分析

开展检索，明确用户需求——包括主题、受众、用途、语气风格、内容深度等。

第 2 步：选择配色方案与字体

参考《配色方案参考》选取契合主题与受众的配色；参考《字体参考》确定中英文字体组合。

第 3 步：选择设计风格

依据《样式配方》选择匹配演示文稿语气的设计风格（Sharp / Soft / Rounded / Pill）。

第 4 步：规划幻灯片大纲

将每一张幻灯片严格归类为上述 5 种页面类型之一；为每张幻灯片规划具体内容与布局；确保视觉多样性——避免在多张幻灯片中重复使用相同布局。

第 5 步：生成幻灯片 JS 文件

在 slides/ 目录下为每张幻灯片创建一个独立的 JS 文件。每个文件必须导出一个同步的 createSlide(pres, theme) 函数，并遵循《幻灯片输出格式》规范及 slide-types.md 中对应类型的详细指导。如具备子代理能力，可并发生成最多 5 张幻灯片。

向每个子代理明确说明以下要求：

1. 文件命名：slides/slide-01.js、slides/slide-02.js 等
2. 图片存放路径：slides/imgs/
3. 最终 PPTX 输出路径：slides/output/
4. 尺寸：10" × 5.625"（LAYOUT_16x9）
5. 字体：中文 = Microsoft YaHei，英文 = Arial（或经批准的替代字体）
6. 颜色：6 位十六进制值，不带 # 号（例如："FF0000"）
7. 必须遵守主题对象契约（参见“主题对象契约”章节）
8. 必须遵循 PptxGenJS API 参考文档

第 6 步：编译为最终 PPTX

创建 slides/compile.js 文件以整合全部幻灯片模块：

// slides/compile.js
const pptxgen = require('pptxgenjs');
const pres = new pptxgen();
pres.layout = 'LAYOUT_16x9';

const theme = {
  primary: "22223b",    // 深色，用于背景/标题文字
  secondary: "4a4e69",  // 次要强调色
  accent: "9a8c98",     // 高亮色
  light: "c9ada7",      // 浅色强调色
  bg: "f2e9e4"          // 背景色
};

for (let i = 1; i <= 12; i++) {  // 根据实际数量调整上限
  const num = String(i).padStart(2, '0');
  const slideModule = require(`./slide-${num}.js`);
  slideModule.createSlide(pres, theme);
}

pres.writeFile({ fileName: './output/presentation.pptx' });

执行命令：cd slides && node compile.js

第 7 步：质量保障（QA）（必需）

参见“QA 流程”章节。

输出结构

slides/
├── slide-01.js          # 幻灯片模块
├── slide-02.js
├── ...
├── imgs/                # 幻灯片中使用的图片
└── output/              # 最终产物
    └── presentation.pptx

幻灯片输出格式

每张幻灯片均为一个完整、可独立运行的 JS 文件：

// slide-01.js
const pptxgen = require("pptxgenjs");

const slideConfig = {
  type: 'cover',
  index: 1,
  title: '演示文稿标题'
};

// 必须为同步函数（不可为 async）
function createSlide(pres, theme) {
  const slide = pres.addSlide();
  slide.background = { color: theme.bg };

  slide.addText(slideConfig.title, {
    x: 0.5, y: 2, w: 9, h: 1.2,
    fontSize: 48, fontFace: "Arial",
    color: theme.primary, bold: true, align: "center"
  });

  return slide;
}

// 独立预览功能 —— 使用幻灯片专属文件名
if (require.main === module) {
  const pres = new pptxgen();
  pres.layout = 'LAYOUT_16x9';
  const theme = {
    primary: "22223b",
    secondary: "4a4e69",
    accent: "9a8c98",
    light: "c9ada7",
    bg: "f2e9e4"
  };
  createSlide(pres, theme);
  pres.writeFile({ fileName: "slide-01-preview.pptx" });
}

module.exports = { createSlide, slideConfig };

主题对象契约（强制要求）

编译脚本传入的主题对象必须严格包含以下 精确键名：

禁止使用其他键名，例如 background、text、muted、darkest、lightest 等。

页码标签（强制要求）

除封面页外，所有幻灯片必须在右下角添加页码标签。

• 位置：x: 9.3", y: 5.1"
• 仅显示当前页码（如 3 或 03），不得显示为 “3/12” 等形式
• 使用配色方案中的颜色，保持低调克制

圆形标签（默认）

slide.addShape(pres.shapes.OVAL, {
  x: 9.3, y: 5.1, w: 0.4, h: 0.4,
  fill: { color: theme.accent }
});
slide.addText("3", {
  x: 9.3, y: 5.1, w: 0.4, h: 0.4,
  fontSize: 12, fontFace: "Arial",
  color: "FFFFFF", bold: true,
  align: "center", valign: "middle"
});

胶囊形标签（Pill Badge）

slide.addShape(pres.shapes.ROUNDED_RECTANGLE, {
  x: 9.1, y: 5.15, w: 0.6, h: 0.35,
  fill: { color: theme.accent },
  rectRadius: 0.15
});
slide.addText("03", {
  x: 9.1, y: 5.15, w: 0.6, h: 0.35,
  fontSize: 11, fontFace: "Arial",
  color: "FFFFFF", bold: true,
  align: "center", valign: "middle"
});

依赖项

• pip install "markitdown[pptx]" —— 用于文本提取
• npm install -g pptxgenjs —— 用于从零创建演示文稿
• npm install -g react-icons react react-dom sharp —— 图标支持（可选）