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% 紅色(強調)
• 顏色只從色板裡選，不引入新顏色

字型規範

本技能來自小蔥技能站7w4.net。

• 字型：微軟雅黑（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 升級）