BetterPPTSkills

在 GordenSuperPPTSkills 基础上整理：图片型 PPT → 四层可编辑 PPTX，并增加 GetGoAPI 便宜中转，同时保留 Codex/Cursor 原生生图 路径。

上游：AI 用 GPT 出豪华幻灯片图，再拆成背景 + 框架 + 图标 + 真文本框合成可编辑 pptx。
本仓库：流程不变，默认用 GetGoAPI gpt-image-2 降本；需要时可切回 native。

三个技能

技能	作用	输入 → 输出
ImagePPTGen	生成图片型 PPT	主题/内容 → 每页 .png + 图片型 .pptx
Image2PPTX	图片还原可编辑	幻灯片图 → 背景+框架+图标+文本 四层 .pptx
SuperPPTSkill	A→B 一键编排	主题/内容 → 图片型 + 可编辑 + 中间产物

• 只做图片版 → ImagePPTGen
• 只转可编辑 → Image2PPTX
• 全流程 → SuperPPTSkill

详细流程见 docs/WORKFLOW.md；后端选择见 docs/BACKENDS.md。

双后端（核心改动）

# 默认：GetGoAPI 中转（Cursor / 本地 CLI，成本低）
export BETTERPPT_IMAGE_BACKEND=getgo

# 上游原始：Agent 内置 imagegen（Codex 主路径）
export BETTERPPT_IMAGE_BACKEND=native

阶段	getgo（默认）	native（原始）
A 整页出图	shared/backends/generate_image.py	Codex imagegen / Cursor GenerateImage
B 背景/框架/图标	shared/backends/edit_image.py	view_image + 内置 edit
每页 API 次数	A:1 + B:3 = 4	同左（工具不同）

需安装 image-api 同系的 image-api skill（或自备 ~/.agent/skills/image-api），并配置 GETGO_GPT_IMAGE_API_KEY。

效果展示

示例 1：Stage A 原图 → PPT 效果图

示例 2：Stage A 原图 → 可编辑 PPTX 效果图

完整案例（推荐）

Nature 临时 CDR 论文 · 4 页 — 含原始论文 Markdown、GetGoAPI 阶段 A 中间图、temporary-cdr-paper-editable-4slides-v2.pptx 可编辑成品及第 1 页 B2/B3/B4 分层样例。见案例目录内 README.md。

快速开始

git clone https://github.com/<you>/BetterPPTSkills.git
cd BetterPPTSkills
pip install -r shared/requirements.txt

安装到 Codex / Cursor skills 目录（三件套一起复制）：

REPO=/path/to/BetterPPTSkills
SKILLS="${CODEX_HOME:-$HOME/.codex}/skills"   # 或 Cursor 对应目录

cp -R "$REPO/ImagePPTGen"    "$SKILLS/ImagePPTGen"
cp -R "$REPO/Image2PPTX"     "$SKILLS/Image2PPTX"
cp -R "$REPO/SuperPPTSkill"  "$SKILLS/SuperPPTSkill"

示例提示词

用 ImagePPTGen 生成 4 页 PPT，内容：临时 CDR 论文导读；后端 getgo；豪华高密度。

用 Image2PPTX 把 slides/01.png 严格走 B1–B9，生成可编辑 pptx。

用 SuperPPTSkill 全流程：主题 XXX，8 页，交付图片型 + 可编辑。

目录结构

BetterPPTSkills/
├── README.md
├── docs/
│   ├── WORKFLOW.md          # 全流程（A1–A5 + B0–B9）
│   └── BACKENDS.md          # getgo vs native
├── shared/
│   ├── backends/
│   │   ├── generate_image.py   # 文生图（GetGoAPI）
│   │   └── edit_image.py         # 编辑分层（GetGoAPI edits）
│   └── requirements.txt
├── ImagePPTGen/              # 阶段 A
├── Image2PPTX/                # 阶段 B
├── SuperPPTSkill/             # 编排
└── examples/

原理（简图）

flowchart LR
  subgraph A [ImagePPTGen]
    O[outline] --> P[prompts]
    P --> G[gpt-image-2 每页×1]
    G --> S[slides PNG]
    S --> ID[图片型 pptx]
  end
  subgraph B [Image2PPTX]
    S --> B2[背景 edits]
    S --> B3[框架 edits]
    S --> B4[图标 edits]
    B2 --> CK[chroma_key]
    B3 --> CK
    B4 --> SL[slice_grid]
    CK --> L[layout.json]
    SL --> L
    V[视觉提取文字] --> L
    L --> ED[可编辑 pptx]
  end
  A --> B

Loading

协议与来源

本项目遵循 MIT License。BetterPPTSkills 依据 GordenSun/GordenSuperPPTSkills 开发与整理，保留其“图片型 PPT → 四层可编辑 PPTX”的核心流程，并在此基础上增加 GetGoAPI gpt-image-2 中转、双后端入口与项目文档整理。

使用、修改或二次分发时，请同时保留 MIT 协议声明，并在文档或产品说明中标明本项目基于上游 GordenSuperPPTSkills / @Gorden Sun 开发。

致谢

• 核心方法与技能结构来自 GordenSun/GordenSuperPPTSkills（@Gorden Sun）。商用请标明上游出处。
• BetterPPTSkills 仅做目录整理、双后端文档与 shared/backends 统一入口，不改变四层还原铁律。