# pptx-generator

**Repository Path**: leftxiaojun/pptx-generator

## Basic Information

- **Project Name**: pptx-generator
- **Description**: Hermes PPTX Generator Skill
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-21
- **Last Updated**: 2026-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



Based on the provided code map, this is a **PPTX Generator** skill project for AI agents. Since the actual repository files are not accessible via the search tools, I'll create a README based on the code map structure you provided.

---

# PPTX Generator

一个用于 AI Agent 生成 PowerPoint (.pptx) 文件的技能项目。

## 项目简介

本项目定义了 AI Agent 如何使用 PptxGenJS 库从零创建或编辑现有的 PPTX 文件。项目包含完整的设计系统参考、常见坑指南和幻灯片类型模板。

## 技能职责

- 从零创建 PPTX 演示文稿
- 基于模板编辑现有 PPTX 文件
- 生成符合设计规范的幻灯片

## 触发条件

当用户请求创建、生成或编辑 PowerPoint 演示文稿时触发。

## 工作流程

### 工作流 1：从零创建（PptxGenJS）

使用 PptxGenJS 库从零开始构建 PPTX 文件。

```javascript
const PptxGenJS = require("pptxgenjs");
let pptx = new PptxGenJS();
pptx.layout = "LAYOUT_16x9";
// 添加幻灯片
let slide = pptx.addSlide();
// 添加内容
slide.addText("标题", { x: 1, y: 1, w: 8, h: 1, fontSize: 24, color: "363636" });
// 保存文件
pptx.writeFile({ fileName: "output.pptx" });
```

### 工作流 2：XML 编辑工作流

基于现有模板进行编辑。

## 幻灯片类型

项目支持以下幻灯片类型：

1. **封面页** - 演示文稿标题页
2. **目录页** - 内容目录
3. **章节分隔页** - 章节划分
4. **内容页** - 主要内容展示
5. **总结/结尾页** - 总结与结束

## 设计系统

參考 `references/design-system.md` 获取完整的色彩、字体和排版规范。

### 色彩规范

- 主色：蓝色系（Primary Action）
- 背景：白色系
- 强调：金色系（铂金商务风格）
- 文本：灰色系

### 字体规范

- 推荐使用系统默认字体
- 正文不使用粗体

## 常见坑

⚠️ **重要警告**：

- **禁止**在 `createSlide()` 中使用 async/await
- **禁止**使用 "#" 开头的十六进制颜色值
- **禁止**在十六进制字符串中编码透明度
- 标题文本禁止换行
- 禁止跨调用重用选项对象
- 中文弯引号可能破坏 JS 字符串解析

详细说明请参阅 `references/pitfalls.md`。

## 参考文档

- `references/pptxgenjs.md` - PptxGenJS 详细教程
- `references/editing.md` - 模板编辑指南
- `references/design-system.md` - 设计系统规范
- `references/slide-types.md` - 幻灯片类型模板
- `references/pitfalls.md` - 常见问题与陷阱

## 使用前提

- Node.js 环境
- 安装 PptxGenJS：`npm install pptxgenjs`

---

基于代码 map 结构生成此 README。详细功能实现和代码示例请参阅 references 目录下的各个文档文件。