unipus-office-pptx-generator

PPTX 生成器与编辑器

概述

本 Skill 处理所有 PowerPoint 相关任务：读取/分析已有演示文稿、通过 XML 操作编辑基于模板的幻灯片集，以及使用 PptxGenJS 从零创建演示文稿。包含完整的设计系统（配色方案、字体、样式配方）和每种幻灯片类型的详细指导。

快速参考

任务	方式
读取/分析内容	python -m markitdown presentation.pptx
编辑或基于模板创建	参见 编辑演示文稿
从零创建	参见下方 从零创建工作流

参数	值
尺寸	10" x 5.625"（LAYOUT_16x9）
颜色	6 位十六进制，不含 #（例如 "FF0000"）
英文字体	Arial（默认）或已批准的替代字体
中文字体	Microsoft YaHei（微软雅黑）
页码徽标位置	x: 9.3"，y: 5.1"
主题键名	primary、secondary、accent、light、bg
形状	RECTANGLE、OVAL、LINE、ROUNDED_RECTANGLE
图表	BAR、LINE、PIE、DOUGHNUT、SCATTER、BUBBLE、RADAR

参考文件

文件	内容
slide-types.md	5 种幻灯片页面类型（封面、目录、分节页、内容页、总结页）+ 附加布局模式
design-system.md	配色方案、字体参考、样式配方（Sharp/Soft/Rounded/Pill）、排版与间距
editing.md	基于模板的编辑工作流、XML 操作、格式规则、常见陷阱
pitfalls.md	QA 流程、常见错误、PptxGenJS 关键陷阱
pptxgenjs.md	PptxGenJS 完整 API 参考

---

读取内容

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

---

从零创建工作流

适用于无模板或参考演示文稿时。

第一步：调研与需求确认

搜索了解用户需求——主题、受众、目的、基调、内容深度。

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

使用配色方案参考选择与主题和受众匹配的配色方案。使用字体参考选择字体搭配。

第三步：选择设计风格

使用样式配方选择与演示文稿基调匹配的视觉风格（Sharp、Soft、Rounded 或 Pill）。

第四步：规划幻灯片大纲

将每张幻灯片归类为 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" x 5.625"（LAYOUT_16x9）
5. 字体：中文 = Microsoft YaHei（微软雅黑），英文 = Arial（或已批准替代）
6. 颜色：6 位十六进制，不含 #（例如 "FF0000"）
7. 必须使用主题对象契约（参见主题对象契约）
8. 必须遵循 PptxGenJS API 参考

第六步：编译为最终 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

第七步：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 };

---

主题对象契约（MANDATORY）

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

键名	用途	示例
theme.primary	最深色，用于标题	"22223b"
theme.secondary	深色强调，用于正文	"4a4e69"
theme.accent	中间色强调	"9a8c98"
theme.light	浅色强调	"c9ada7"
theme.bg	背景色	"f2e9e4"

绝不使用其他键名，如 background、text、muted、darkest、lightest。

---

页码徽标（REQUIRED）

除封面页外，所有幻灯片必须在右下角包含页码徽标。

• 位置：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"
});

胶囊形徽标

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 — 图标（可选）