| name | wps-ppt-gen |
| description | PPT生成。根据主题生成完整的PPT文件，
包含封面、目录、内容页、总结页，支持多种风格。
用于帮助用户生成PPT演示文稿。当用户提到PPT、演示文稿、幻灯片时触发。
PPT presentation generator using python-pptx.
|
| license | MIT |
| user-invocable | true |
| argument-hint | [主题/场景] [页数(可选)] |
| allowed-tools | Read, Grep, Glob, Bash, Write, Edit |
| metadata | {"author":"BWKYD","title":"PPT生成","description_zh":"根据主题生成完整的PPT文件，包含封面、目录、内容页和总结页","tags":["PPT","演示","python-pptx","WPS","幻灯片"],"version":"1.0.2","license":"MIT"} |
WPS PPT 生成器
从主题大纲 → 自动生成完整的精美 PPT（.pptx）。
When to Use
- 用户需要制作PPT/演示文稿
- 用户说"帮我做一个PPT"
- 用户需要述职报告/项目汇报/产品介绍/培训课件等PPT
- 用户有内容大纲想转成PPT
When NOT to Use
- 只需要PPT大纲不需要文件 → 使用
wps-ppt-outline
- 已有PPT需要美化 → 使用
wps-ppt-polish
- 需要教学课件特殊排版 → 使用
wps-courseware
风格选择菜单
┌─────────────────────────────────────────────┐
│ WPS PPT 风格选择 │
├─────────────────────────────────────────────┤
│ │
│ [1] 📊 简约商务 白底+深色文字+蓝色强调 │
│ [2] 🚀 科技风 深色底+渐变+几何元素 │
│ [3] 🏛️ 党政风 红色主调+庄重+国徽元素 │
│ [4] 📚 教育风 清新+活泼配色+图文混排 │
│ [5] 🎨 创意风 大图背景+极简文字 │
│ [6] 📈 数据风 图表为主+数据驱动 │
│ │
│ 输入编号或风格名称选择 │
└─────────────────────────────────────────────┘
工作流程
Step 1: 确认需求
- 主题：PPT的主题是什么？
- 场景：述职/汇报/产品/培训/竞标/其他？
- 页数：期望多少页？（默认15-20页）
- 风格：从上方菜单选择（默认简约商务）
- 特殊要求：是否需要图表？是否有固定模板？
Step 2: 生成大纲
根据场景生成PPT结构大纲：
述职报告（推荐15-20页）：
1. 封面（标题+姓名+部门+日期）
2. 目录
3-4. 工作回顾（KPI完成情况）
5-7. 重点项目（每项1-2页）
8-9. 数据成果（图表页）
10-11. 经验总结与反思
12-13. 下阶段计划
14. 需要的支持
15. 感谢页
项目汇报（推荐12-15页）：
1. 封面
2. 目录
3. 项目背景
4-5. 项目目标与范围
6-8. 实施进展（里程碑）
9-10. 关键成果/数据
11. 风险与问题
12. 下一步计划
13. 时间表
14. 资源需求
15. Q&A
产品介绍（推荐10-15页）：
1. 封面（产品名+Slogan）
2. 痛点/市场背景
3. 解决方案概览
4-6. 核心功能（每项1页）
7. 竞品对比
8-9. 客户案例/数据
10. 定价方案
11. 合作流程
12. 联系方式
Step 3: 生成 .pptx 文件
确保依赖：
pip install python-pptx 2>/dev/null || pip3 install python-pptx 2>/dev/null
核心代码框架：
from pptx import Presentation
from pptx.util import Inches, Pt, Mm, Emu
from pptx.dml.color import RGBColor
from pptx.enum.text import PP_ALIGN, MSO_ANCHOR
from pptx.enum.shapes import MSO_SHAPE
import os
class PPTGenerator:
"""中式PPT生成器"""
THEMES = {
'business': {
'name': '简约商务',
'bg': RGBColor(0xFF, 0xFF, 0xFF),
'title': RGBColor(0x1F, 0x38, 0x64),
'accent': RGBColor(0x2B, 0x57, 0x9A),
'text': RGBColor(0x33, 0x33, 0x33),
'light': RGBColor(0xE8, 0xEE, 0xF7),
'title_font': '微软雅黑',
'body_font': '微软雅黑',
},
'tech': {
'name': '科技风',
'bg': RGBColor(0x0A, 0x1A, 0x2F),
'title': RGBColor(0xFF, 0xFF, 0xFF),
'accent': RGBColor(0x00, 0xD4, 0xFF),
'text': RGBColor(0xCC, 0xCC, 0xCC),
'light': RGBColor(0x15, 0x2A, 0x45),
'title_font': '微软雅黑',
'body_font': '微软雅黑',
},
'gov': {
'name': '党政风',
'bg': RGBColor(0xFF, 0xFF, 0xFF),
'title': RGBColor(0xCC, 0x00, 0x00),
'accent': RGBColor(0xCC, 0x00, 0x00),
'text': RGBColor(0x33, 0x33, 0x33),
'light': RGBColor(0xFF, 0xE8, 0xE8),
'title_font': '方正小标宋简体',
'body_font': '仿宋_GB2312',
},
'edu': {
'name': '教育风',
'bg': RGBColor(0xFF, 0xFF, 0xFF),
'title': RGBColor(0x2E, 0x75, 0xB6),
'accent': RGBColor(0x4C, 0xAF, 0x50),
'text': RGBColor(0x33, 0x33, 0x33),
'light': RGBColor(0xE3, 0xF2, 0xFD),
'title_font': '微软雅黑',
'body_font': '微软雅黑',
},
}
def __init__(self, theme='business', widescreen=True):
self.prs = Presentation()
self.theme = self.THEMES.get(theme, self.THEMES['business'])
if widescreen:
self.prs.slide_width = Mm(338.67)
self.prs.slide_height = Mm(190.5)
else:
self.prs.slide_width = Mm(254)
self.prs.slide_height = Mm(190.5)
self.slide_width = self.prs.slide_width
self.slide_height = self.prs.slide_height
def add_bg(self, slide, color=None):
"""设置幻灯片背景色"""
bg = slide.background
fill = bg.fill
fill.solid()
fill.fore_color.rgb = color or self.theme['bg']
def add_shape(self, slide, left, top, width, height, color=None):
"""添加色块装饰"""
shape = slide.shapes.add_shape(
MSO_SHAPE.RECTANGLE, left, top, width, height
)
shape.fill.solid()
shape.fill.fore_color.rgb = color or self.theme['accent']
shape.line.fill.background()
return shape
def add_text_box(self, slide, left, top, width, height, text,
font_size=18, font_color=None, font_name=None,
bold=False, alignment=PP_ALIGN.LEFT):
"""添加文本框"""
txBox = slide.shapes.add_textbox(left, top, width, height)
tf = txBox.text_frame
tf.word_wrap = True
p = tf.paragraphs[0]
p.text = text
p.font.size = Pt(font_size)
p.font.color.rgb = font_color or self.theme['text']
p.font.name = font_name or self.theme['body_font']
p.font.bold = bold
p.alignment = alignment
return txBox
def add_cover(self, title, subtitle='', author='', date=''):
"""封面页"""
slide = self.prs.slides.add_slide(self.prs.slide_layouts[6])
self.add_bg(slide)
self.add_shape(slide, Mm(0), Mm(0), Mm(12), self.slide_height)
self.add_text_box(
slide, Mm(30), Mm(50), Mm(280), Mm(50), title,
font_size=36, font_color=self.theme['title'],
font_name=self.theme['title_font'], bold=True,
alignment=PP_ALIGN.LEFT
)
if subtitle:
self.add_text_box(
slide, Mm(30), Mm(105), Mm(280), Mm(30), subtitle,
font_size=20, font_color=self.theme['accent']
)
info = f'{author} {date}' if author else date
if info.strip():
self.add_text_box(
slide, Mm(30), Mm(150), Mm(280), Mm(20), info,
font_size=14, font_color=self.theme['text']
)
def add_toc(self, items):
"""目录页"""
slide = self.prs.slides.add_slide(self.prs.slide_layouts[6])
self.add_bg(slide)
self.add_text_box(
slide, Mm(30), Mm(15), Mm(100), Mm(20), '目录',
font_size=28, font_color=self.theme['title'],
font_name=self.theme['title_font'], bold=True
)
self.add_shape(slide, Mm(30), Mm(40), Mm(60), Mm(2))
for i, item in enumerate(items):
y = Mm(55 + i * 22)
num_shape = self.add_shape(
slide, Mm(30), y, Mm(10), Mm(10),
self.theme['accent']
)
num_shape.text_frame.paragraphs[0].text = str(i + 1).zfill(2)
num_shape.text_frame.paragraphs[0].font.size = Pt(11)
num_shape.text_frame.paragraphs[0].font.color.rgb = RGBColor(0xFF, 0xFF, 0xFF)
num_shape.text_frame.paragraphs[0].alignment = PP_ALIGN.CENTER
self.add_text_box(
slide, Mm(48), y, Mm(250), Mm(15), item,
font_size=16, bold=False
)
def add_content_slide(self, title, bullets, note=''):
"""内容页（标题+要点列表）"""
slide = self.prs.slides.add_slide(self.prs.slide_layouts[6])
self.add_bg(slide)
self.add_shape(slide, Mm(0), Mm(0), self.slide_width, Mm(40),
self.theme['light'])
self.add_text_box(
slide, Mm(30), Mm(8), Mm(280), Mm(25), title,
font_size=24, font_color=self.theme['title'],
font_name=self.theme['title_font'], bold=True
)
for i, bullet in enumerate(bullets):
y = Mm(55 + i * 25)
self.add_shape(slide, Mm(30), y + Mm(4), Mm(4), Mm(4),
self.theme['accent'])
self.add_text_box(
slide, Mm(40), y, Mm(270), Mm(20), bullet,
font_size=16
)
def add_thank_slide(self, text='感谢聆听', subtext='THANK YOU'):
"""感谢页"""
slide = self.prs.slides.add_slide(self.prs.slide_layouts[6])
self.add_bg(slide)
self.add_text_box(
slide, Mm(0), Mm(60), self.slide_width, Mm(40), text,
font_size=44, font_color=self.theme['title'],
font_name=self.theme['title_font'], bold=True,
alignment=PP_ALIGN.CENTER
)
self.add_text_box(
slide, Mm(0), Mm(110), self.slide_width, Mm(20), subtext,
font_size=18, font_color=self.theme['accent'],
alignment=PP_ALIGN.CENTER
)
def save(self, filename):
self.prs.save(filename)
return os.path.abspath(filename)
Step 4: 交付
- 生成 .pptx 文件
- 告知页数和文件大小
- 提示用WPS演示打开
- 可根据反馈调整内容或风格
排版黄金法则
1. 每页核心信息不超过3点
2. 标题不超过15字
3. 正文字号不小于18pt
4. 每页文字不超过100字
5. 留白 ≥ 40%
6. 配色不超过3种
7. 字体不超过2种
8. 图片和文字比例 6:4 或 7:3
示例
/wps-ppt-gen 2026年Q1述职报告，销售部张三，科技风
/wps-ppt-gen 新产品"智慧办公系统"介绍PPT，15页，简约商务风
/wps-ppt-gen Python入门培训课件，教育风
参考
PPT设计原则详见 reference/ppt-design-rules.md。
