name: ppt-light-corporate version: 1.1.0 description: | Generate polished corporate PPTs using a light-themed company template. Activate when: (1) User asks to create/make/generate a PPT/PowerPoint/幻灯片/演示文稿 (2) User provides content and wants it turned into slides (3) User asks to improve or redo a PPT Uses a pre-analyzed H3C-style light corporate template (white bg + China red accent). NOT for: dark theme PPTs, creative/artistic decks, or Keynote files.

PPT Light Corporate Skill

基于 python-pptx 的企业PPT自动生成引擎。H3C浅色企业模板，白底+中国红点缀，16:9画布。

核心文件

Quick Start

import sys
sys.path.insert(0, '<skill_dir>/scripts')
from ppt_helpers import TemplateBuilder

tb = TemplateBuilder()
s = tb.add_cover_slide()
tb.text(s, 0.8, 1.5, 8.4, 0.6, '标题', sz=32, color=tb.RED2, bold=True)

s = tb.add_content_slide('页面标题')
tb.three_col_icon_cards(s, [
    {'icon_text': '', 'title': '功能一', 'body': '说明'},
    {'icon_text': '', 'title': '功能二', 'body': '说明'},
    {'icon_text': '', 'title': '功能三', 'body': '说明'},
])

# 放置白色矢量图标到红色圆圈上（自动检测圆圈位置）
def find_circles(slide):
    circles = []
    for shape in slide.shapes:
        if 'Oval' in shape.name:
            x, y = shape.left / 914400, shape.top / 914400
            w, h = shape.width / 914400, shape.height / 914400
            circles.append({'cx': x + w/2, 'cy': y + h/2, 'w': w})
    return circles

for circle, query in zip(find_circles(s), ['server', 'wifi', 'database']):
    sz = circle['w'] * 0.55
    tb.place_icon(s, query, circle['cx'] - sz/2, circle['cy'] - sz/2, size=sz, color='FFFFFF')

tb.save('output.pptx')

设计系统

色板

配色法则

• 60% 白色(背景) / 30% 灰黑(正文) / 10% 红色(强调)
• 颜色只从色板里选，不引入新颜色

字体规范

• 字体：微软雅黑（latin + ea 同时设置）
• 页标题：20pt 粗体 RED
• 小节标题：12-14pt 粗体 RED/RED3
• 正文：10-11pt DARK/MID
• 最小字号：10pt（确保投屏可读）

画布规则

• 画布：10" × 5.625"（16:9）
• 安全边距：≥ 0.4"
• 内容区起点：y = 1.0"（标题下方）
• 所有 body 文本启用 shrink=True（自动缩字防溢出）
• 多栏布局自动水平居中：start_x = (10 - total_width) / 2

24种内容布局

两栏/两行（5种）

三栏/三行（5种）

四栏/四行（6种）

时间轴/流程（5种）

特殊布局（3种）

矢量图标系统

279个简洁矢量图标，支持搜索、复制和变色。

图标调用

# 搜索并放置（自动变白色）
tb.place_icon(slide, 'server', x=2.0, y=1.5, size=0.5, color='FFFFFF')

# 搜索关键词（中英文均可）
results = tb.icons.search('数据库', limit=3)

图标使用原则

• 红色/灰色圆圈上放白色图标（color='FFFFFF'）
• 图标占圆圈直径的 55% 最佳
• 使用 find_circles() 自动检测圆圈位置，确保居中
• 每页最多4个图标
• 大小 0.4-0.8"

分类

制作流程

需求理解 → 大纲(等确认) → 生成 → QA审校(修到0) → 评分 → 发送 → 迭代

关键规则

1. 先出大纲，等用户确认再生成
2. 相邻页布局不能重复，同一布局全篇最多2次
3. 每页 60-220 字，填充率 40-75%
4. 红色只用于标题和重点强调，交替配色用红/灰
5. 所有 body 文本必须有 shrink=True
6. 多行标题自动调整高度，避免文字与装饰线重叠
7. 修改模板前必须先备份原文件
8. 所有反馈记录到 memory/ppt-feedback.md

v1.1.0 更新内容

• 新增布局: timeline_zigzag（上下交替时间线）
• 图标系统重建: 279个简洁矢量图标，支持搜索/复制/变色(copy_icon color参数)
• 图标居中机制: bounding box 居中算法，配合 find_circles 自动检测
• 边距对称修复: 多栏布局自动水平居中
• 标题高度自适应: 多行标题自动扩大，下方元素跟随下移
• 字体统一: text()/multi_text() 同时设置 latin + ea 为微软雅黑
• 最小字号: 全局 10pt（从 8pt/9pt 升级）