✨ 案例展示

5 种风格，5 种场景 — 每个案例包含封面 + 内容页，AI 配图由 Seedream 生成

🏢 Professional Modern — 企业融资路演

深蓝商务风 · 金色点缀 · 左侧导航栏 · 四宫格数据卡片

🌌 Dark Tech — 科技产品发布

赛博朋克风 · 霓虹蓝紫粉 · Consolas 等宽字体 · 三列特性卡片

🏛️ Warm Elegant — 奢侈品牌策略

金色大理石风 · Georgia 衬线字体 · 居中编辑式排版 · 菱形装饰符

🚀 Vibrant Startup — 创业融资路演

紫粉渐变风 · Segoe UI · 进度条数据可视化 · 半透明统计胶囊

🌿 Nature Calm — 可持续发展报告

森林绿风 · 圆形装饰符 · 四列影响卡片 · 左侧窄边栏

🚀 快速开始

安装为 Skill（推荐）

git clone https://github.com/sunchaokun/PPT-Design-Skill.git
cd PPT-Design-Skill

# 一键安装（自动覆盖旧版本）
python install.py                     # 自动检测平台
python install.py --platform opencode # 指定平台
python install.py --force             # 强制覆盖已有安装

安装后 ppt_pro_max 注册为全局 Python 包，任何项目下可直接 from ppt_pro_max.build_helpers import *。

支持 13 个平台：OpenCode · Claude Code · Codex · Cursor · Windsurf · Roo Code · Gemini · Trae · Continue · Droid · KiloCode · Augment · Copilot

作为 Python 包使用

pip install --upgrade git+https://github.com/sunchaokun/PPT-Design-Skill.git

安装后即可在任何项目直接 import：

from ppt_pro_max.build_helpers import *
from ppt_pro_max import generate_ppt

更新

# Skill 安装方式
cd PPT-Design-Skill && git pull && python install.py --force

# pip 安装方式
pip install --force-reinstall --upgrade git+https://github.com/sunchaokun/PPT-Design-Skill.git

在 AI 编码工具中使用

安装后，在 OpenCode / Claude Code / Codex 中直接输入：

用Build模式生成一份AI融资路演PPT，dark cyberpunk风格

AI 会自动加载 skill 并生成 .pptx 文件。

Build Script — 逐页精确控制（推荐 ⭐）

Build 模式是推荐的主力模式——用 build_helpers 工具箱逐像素控制每一页、每个元素，3 种结构化方案自动对比，质量最高、确定性最强。

from ppt_pro_max.build_helpers import *

# 设计令牌：暗色 AI 科技主题
C = {
    "primary": "#4F46E5", "accent": "#22D3EE", "background": "#0B1020",
    "card_bg": "#141B33", "text_dark": "#E2E8F0", "text_body": "#B6C2D6",
    "font_heading": "Orbitron", "font_body": "JetBrains Mono", "font_cjk": "微软雅黑",
}
T = Typography(hero=46, h1=30, h2=20, h3=16, body=14, caption=12, micro=11)

prs = Presentation()
set_widescreen(prs)
set_dark_theme(prs, C)

s = add_slide(prs)
rect(s, 0, 0, 13.333, 7.5, C["background"])
grid_background(s, spacing=0.85, color=C["divider"], alpha=7)
gradient_text(s, 1.0, 2.0, 11.3, 1.5, "让智能的成本，下降一个数量级",
              stops=[("#22D3EE", 0), ("#818CF8", 100)],
              font_size=46, bold=True, font_name="Orbitron", cjk_font="微软雅黑")
kpi_card(s, 1.0, 4.5, 3.5, 1.1, "92", "综合能力指数", C=C, typo=T)
native_chart(s, 5.0, 1.5, 7.5, 4.5, "bar",
             categories=["DeepSeek", "GPT-5", "Claude 4"],
             series=[{"name": "综合能力", "values": [92, 95, 93]}], C=C)

clean_save(prs, "output.pptx")

核心工具箱：rect · rrect · oval · text · gradient_text · kpi_card · native_chart · donut_chart · code_block · section_divider · neon_border · grid_background · page_header · highlight_cards · set_widescreen · set_dark_theme · clean_save

暗色主题支持：set_dark_theme(prs, C) 自动修正主题 dk1/lt1，确保默认文字为浅色；clean_save(prs, path) 清除 printerSettings、修复空 <a:ln/>、保证 PPTX 合法性。

FreeStyle — Agent 驱动 / 一句话生成

Path A（推荐）— 写 content.json，渲染高质量 deck：agent 写真实内容 + 每页 goal，generate_ppt 直通渲染。这是确定性最高、质量最好的 FreeStyle 路径：

{
  "slides": [
    {"goal": "hook", "title": "让智能的成本下降一个数量级", "subtitle": "DeepSeek B 轮融资"},
    {"goal": "problem", "title": "大模型竞争白热化", "bullets": ["推理成本是商业化瓶颈", "参数军备竞赛撞墙"]},
    {"goal": "data", "title": "推理成本对比",
     "chart": {"type": "bar", "categories": ["DeepSeek", "GPT-5"], "series": [{"name": "价格", "values": [0.14, 2.5]}]}},
    {"goal": "section", "title": "融资计划", "section_number": "01"},
    {"goal": "features", "title": "三大护城河", "cards": [{"title": "MoE", "text": "..."}, {"title": "RL 新范式", "text": "..."}]},
    {"goal": "cta", "title": "融资 500 亿元", "subtitle": "..."}
  ]
}

from ppt_pro_max import generate_ppt
result = generate_ppt(content_file="content.json", style="dark-tech")  # 预设名 = 确定性输出

• 支持 11 种 goal（hook/problem/features/data/code/exercise/diagram/section/testimonials/cta/content）+ 图表/卡片/图形/代码等字段
• 统一版式系统：渐变背景 + 装饰、自适应字号填满版面、图表文字主题化
• 自然语言风格随机、预设名确定；配图用 --fetch-images --llm-provider seedream

Path B — 一句话快速草稿：

ppt-design "AI产品融资路演"
ppt-design "融资路演" --style "warm fintech"
ppt-design "产品发布" --style "dark cyberpunk tech"
ppt-design "ESG报告" --style "calm nature"

# AI 配图 + 动画
ppt-design "融资路演" --style "dark cyberpunk" \
  --fetch-images --llm-provider seedream --llm-api-key $ARK_API_KEY \
  --motion 7 --density 6

VI Build — 基于企业模板精确生成

python -m ppt_pro_max.enterprise.template_analyzer template.pptx > analysis.txt
# 将 analysis.txt 交给 LLM 生成 build.py，然后：
python build.py

🔥 核心特性

🏗️ 三模式架构

推荐工作流：FreeStyle 快速原型 → Build 精细交付（主力模式）

🎨 设计系统

自然语言风格 — 描述即生成。自然语言 style 走 mood 检测 + 内置设计数据库（BM25 搜索 colors/typography/styles），未指定 seed 时每次运行随机选取调色板/字体/装饰，不保证固定映射。要确定性输出，用预设名（dark-tech/professional/warm-elegant）或显式 --seed：

ppt-design "融资路演" --style "warm fintech"       # mood=[warm,fintech]，调色板/字体走设计数据库
ppt-design "产品发布" --style "dark cyberpunk"      # mood=[dark,neon] → 装饰多为 neon-lines，深色霓虹配色
ppt-design "品牌策略" --style "elegant luxury"      # mood=[elegant, luxury] → 玫红调 ux 配色（非金色）
ppt-design "山水诗词" --style "水墨"                # mood=[ink-wash] → 纸感浅色 + seal-stamp 装饰

# 确定性输出：预设名 / 显式原子 / 固定 seed
ppt-design "产品发布" --style "dark-tech"           # 固定 → cyber-neon 调色板 + tech-mono 字体 + neon-lines
ppt-design "融资路演" --palette ocean-blue --fonts clean-corporate --decoration accent-bar
ppt-design "融资路演" --style "warm fintech" --style-seed 42

41 种 mood 关键词：professional, tech, dark, warm, elegant, luxury, vibrant, startup, nature, calm, minimal, bold, fresh, industrial, fintech, health, education, sustainability, creative, mckinsey, consulting, pastel, retro, government, legal, pharma, realestate, automotive, aviation, energy, telecom, logistics, ink-wash, zen, sci, neon ...

from ppt_pro_max.build_helpers import *

prs = Presentation()
s = add_slide(prs)
gradient_text(s, 1.0, 1.0, 8.0, 1.5, "标题", preset='gold-shine', font_size=44)
circle_image(s, 6.5, 3.0, 1.0, "photo.jpg")
shape_3d(s, 1.0, 3.5, 3.0, 2.0, depth=15.0, material='metal')
frosted_panel(s, 5.0, 3.0, 6.0, 3.0, tint='#1A1A3A', alpha=20)
brush_divider(s, 1.0, 5.0, 6.0, color='#2C2C2C')
seal_stamp(s, 11.0, 5.5, 0.8, "印", rotation=-15)
prs.save("output.pptx")

🧪 测试

运行测试

# 从项目根目录（conftest.py 自动将 src/ 加入 sys.path，确保加载 V2 源码而非旧版安装包）
python -m pytest tests/ -q

# 仅运行新增的核心严格测试
python -m pytest tests/test_design_search.py tests/test_ui_ux_adapter.py \
  tests/test_build_qa_v2.py tests/test_theme_colors.py -q

⚠️ 源码优先级：系统可能已安装旧版 ppt_pro_max（site-packages）。pytest 由 tests/conftest.py 的 sys.path.insert 保证加载 src/ 下的 V2 源码。但手动运行 python build.py 或 python -m ppt_pro_max 时，需确保加载的是 V2：

$env:PYTHONPATH = "src"; python build.py
# 或安装为开发包
pip install -e .

已知跳过（7 个，数据依赖问题，非代码缺陷）

python -m pytest tests/ -q --ignore=tests/test_group_audit.py \
  --ignore=tests/test_image_fetcher.py --ignore=tests/test_pptx_capabilities.py \
  --ignore=tests/test_xml_extraction.py --ignore=tests/test_analyze_template.py

覆盖矩阵（1479 tests, 0 failures）

License

MIT